Google Search Console

Hướng dẫn cấp quyền cho Indexing Bot

Các bước dành cho chủ website muốn cho phép công cụ gửi thông báo URL thuộc property của mình.

Trước khi bắt đầu

Công cụ sử dụng Google Cloud Service Account. Service Account phải có quyền Owner trên Search Console property chứa URL được gửi.

Bạn không cần tạo tài khoản tại công cụ và không bao giờ cần cung cấp mật khẩu Google. Thêm bot trong Search Console là một bước cấp quyền riêng, tách biệt với việc sử dụng biểu mẫu công khai.

Google API tiếp nhận thông báo không đảm bảo URL sẽ được thu thập, lập chỉ mục hoặc cải thiện thứ hạng.

Điều kiện cần

Không kiểm tra trực tiếp
  • Website đã được xác minh trong Google Search Console.
  • Tài khoản Google hiện tại có đủ quyền Owner để thêm người dùng.
  • URL cần gửi thuộc property sẽ cấp quyền.
  • URL có thể truy cập công khai.
  • URL không bị chủ website cố ý chặn lập chỉ mục.

Thiết lập từng bước

  1. Chọn đúng website property

    Mở Google Search Console và chọn property thực sự bao phủ URL bạn dự định gửi.

  2. Mở trang quản lý quyền

    Trong property đã chọn, đi theo đường dẫn:

    Cài đặt Người dùng và quyền

  3. Thêm email Indexing Bot

    Dùng chính xác email Service Account công khai dưới đây:

    indexing-bot@gg-indexing-tool.iam.gserviceaccount.com

  4. Cấp quyền Owner

    Chọn quyền Owner. “Full user” và “Owner” không phải cùng một cấp quyền; Full user không đáp ứng yêu cầu sở hữu của Indexing API.

  5. Quay lại công cụ và nhập URL

    Chỉ nhập URL thuộc property vừa cấp quyền. Một lượt gửi sử dụng cùng một hostname.

  6. Đọc trạng thái trả về

    • SUBMITTED: API đã tiếp nhận thông báo, không có nghĩa URL đã được lập chỉ mục.
    • FAILED: có thể liên quan đến quyền sở hữu, quota, validation hoặc Google API.
    • SKIPPED: công cụ không gửi mục đó.

Hiểu phạm vi property

Hãy chọn property thực sự bao phủ URL, không chỉ property có tên gần giống hostname.

Domain property

hikid.vn

Thông thường bao phủ các biến thể giao thức và subdomain của domain. Đây là lựa chọn rộng hơn khi property đã được xác minh ở cấp domain.

URL-prefix property

https://hikid.vn/

Chỉ bao phủ URL khớp prefix đã cấu hình. https://hikid.vn/ và https://www.hikid.vn/ có thể là hai phạm vi khác nhau.

Xác minh quyền trước khi thử

  1. 1. Kiểm tra emailEmail bot xuất hiện trong danh sách người dùng của đúng property.
  2. 2. Kiểm tra vai tròVai trò hiển thị là Owner, không phải Full user.
  3. 3. Kiểm tra URLProtocol, hostname và prefix nằm trong phạm vi property.

Quy trình gửi thử

Quay lại trang chủ, nhập tối đa 10 URL cùng hostname, chạy kiểm tra cục bộ, xem lại từng dòng rồi gửi. Chế độ mặc định vẫn là mô phỏng; chế độ API thật chỉ dành cho thử nghiệm nội bộ khi được bật rõ ràng ở frontend và máy chủ. Live mode yêu cầu hoàn tất Turnstile và có thể trả về giới hạn request, giới hạn URL cá nhân hoặc shared operational quota.

Lỗi thường gặp

403

Không xác minh được quyền sở hữu URL

  • Kiểm tra đã chọn đúng Search Console property.
  • Đảm bảo bot được thêm là Owner, không phải Full user.
  • So sánh hostname và subdomain của URL với phạm vi property.
  • Nếu vừa cấp quyền, chờ một khoảng ngắn để quyền được cập nhật.
400

Yêu cầu không hợp lệ

  • Kiểm tra URL và định dạng yêu cầu.
  • Loại bỏ dữ liệu sai cấu trúc rồi thử lại.
429

Đã chạm quota hoặc giới hạn yêu cầu

  • Quota hệ thống hoặc quota Google có thể đã hết.
  • Không gửi liên tục; hãy thử lại sau.
5xx

Dịch vụ Google tạm thời gặp lỗi

  • Thử lại sau.
  • Không lặp lại cùng một URL trong khoảng thời gian quá ngắn.
Metadata 404

Không có metadata thông báo

  • Metadata của thông báo có thể chưa sẵn sàng.
  • Điều này không tự động phủ nhận một phản hồi publish thành công.

Bảo mật và thu hồi quyền

  • Email Service Account là thông tin công khai.
  • Khóa riêng không bao giờ được cung cấp cho người dùng công khai.
  • Không tải lên hoặc chia sẻ Service Account JSON của riêng bạn qua công cụ này.
  • Khi không còn sử dụng, chủ website có thể xóa Indexing Bot khỏi Search Console để ngăn các lượt gửi được cấp quyền trong tương lai.
  • Công cụ không thể và không được cam kết lập chỉ mục.