Google Search Console¶
Đang trong giai đoạn thử nghiệm
Base URL:
Đường dẫn, tham số và response giống hệt Search Console API — Search
Analytics.
Gốc là https://www.googleapis.com/webmasters/v3.
Một kết nối = một tài khoản Google. Một tài khoản thường xác minh nhiều
site — site_url là tham số của từng request, không phải định danh kết nối.
Điều Logidata làm hộ bạn¶
| Việc | Gọi thẳng Search Console | Qua Logidata |
|---|---|---|
| Đăng ký project Google Cloud + xác minh OAuth | Bạn làm | Đã có |
| Luồng OAuth | Bạn dựng | Bấm một nút trên portal |
| Access token sống 1 giờ — đổi refresh token lấy token mới | Bạn dựng cron | Tự động |
url-encode site_url (sc-domain: và https://) đúng cách |
Bạn tự xử lý | Tự động |
Nhóm dữ liệu¶
Allowlist chỉ đọc, đúng một endpoint:
| Method | Đường dẫn gốc | Dùng để |
|---|---|---|
POST |
/sites/{site_url}/searchAnalytics/query |
Query thật người dùng gõ trên Google Search để vào website của bạn, kèm impression, click, CTR và vị trí trung bình |
Endpoint này là POST dù thuần đọc
Search Console nhận bộ lọc (startDate, endDate, dimensions) trong JSON
body chứ không phải query string, và không có bản GET tương đương. Gọi bằng
GET sẽ nhận 403 path_not_allowed. Allowlist vẫn chỉ đọc: chỉ đúng
endpoint này được mở cho POST, mọi PUT/PATCH/DELETE bị chặn.
site_url phải khớp đúng site đã xác minh trong Search Console — dạng
https://vidu.vn/ (có dấu / cuối) hoặc sc-domain:vidu.vn. dimensions mặc
định là query; ghép thêm page, country, device bằng dấu phẩy.
Vì sao dữ liệu này đáng giá¶
Đây là từ khoá thật người dùng gõ, của riêng bạn — không mua được ở đâu khác. Khác với gợi ý từ khoá của Google Ads Keyword Planner (volume thị trường, ước lượng), Search Console cho bạn con số đã xảy ra trên chính domain của bạn. Miễn phí, không cần audit bảo mật.
Xác thực và mã lỗi¶
X-API-Key + X-Account-Id (trỏ tới một tài khoản Google) như mọi nền tảng
khác. Xem Xác thực và Mã lỗi.
| HTTP | code |
Nghĩa |
|---|---|---|
| 401 | token_revoked |
Tài khoản Google đã thu hồi quyền. Vào portal cấp lại quyền. |