Google Lập chỉ mục API

TL;DR — Đó Google Lập chỉ mục API là một way cho chủ trang web để tell Google “this page changed, please re-crawl it” (bản dịch) «này trang changed, please re-crawl điều này» qua code thay vì clicking buttons. Nhưng ở đây đó catch hầu hết các hướng dẫn skip: Google chỉ officially hỗ trợ điều này cho job-posting các trang và livestream các trang. Điều này là không một shortcut để nhận của bạn blog posts hoặc sản phẩm các trang được lập chỉ mục nhanh hơn — Google có đã nói so over và over.

Điều gì lập chỉ mục API là

Khi bạn publish hoặc thay đổi một trang, bạn thông thường chờ cho Google để come back và re-crawl điều này on của nó own schedule. Đó Lập chỉ mục API là một way để push một notification để Google thay vì — “hey, this URL is new/updated” (bản dịch) «hey, này URL là new/đã cập nhật» hoặc “this URL is gone, drop it.” (bản dịch) «này URL là đã biến mất, drop điều này.» Bạn làm điều này với code (một nhỏ program calling Google các máy chủ), không by clicking khoảng trong một dashboard.

đó sounds powerful, và nó là — cho chính xác điều nó được xây dựng cho.

một điều để understand

Google chỉ officially hỗ trợ lập chỉ mục API cho hai kinds của các trang:

1. Job postings — các trang với JobPosting dữ liệu có cấu trúc (job listings, mà expire và cần để come xuống quickly).
2. Livestreams — các trang với BroadcastEvent dữ liệu có cấu trúc (trực tiếp video events, mà chỉ quan trọng during broadcast).

đó nó. Cả hai là nhạy cảm với thời gian nội dung đó goes stale fast, mà là Vì sao Google được xây dựng fast lane cho them.

Nếu bạn không có job listings hoặc livestreams, đó Lập chỉ mục API không phải của bạn tool — không quan trọng điều gì một “get indexed in hours” (bản dịch) «nhận được lập chỉ mục trong hours» plugin hoặc SaaS tells bạn.

myth để bỏ qua

Đó single biggest myth online là: “Use the Indexing API to get any page indexed fast.” (bản dịch) «Dùng đó Lập chỉ mục API để nhận bất kỳ trang được lập chỉ mục fast.» Điều này không hoạt động đó way, và Google có repeatedly called dùng điều này cho thông thường các trang misuse. Mọi người làm điều này anyway vì tools sell điều này as một growth hack — nhưng Google có thể (và says điều này sẽ) revoke của bạn access cho abusing điều này.

có thứ hai trap, cũng: Khi bạn submit URL và nhận “success” phản hồi, đó chỉ có nghĩ là Google đã nhận của bạn yêu cầu. nó làm không có nghĩa là trang đã nhận được lập chỉ mục. Plenty của tools blur đó line; tài liệu củ chính Google là clear về nó.

Điều gì để làm thay vì cho nhanh hơn lập chỉ mục

cho regular các trang (blogs, các sản phẩm, các bài viết), điều đó thực ra help là boring nhưng thực:

• Submit an XML sitemap trong Google Search Console.
• Link để của bạn new các trang từ other các trang trên trang web của bạn.
• Làm đó trang genuinely worth lập chỉ mục (quality, không thin filler).
• Cho một một-off, dùng “Request indexing” (bản dịch) «Yêu cầu lập chỉ mục» trong Search Console’s URL Inspection tool — sparingly.

Muốn kỹ thuật version — setup, thực tế API các phương thức, quotas, và chính xác Google quotes? Switch để Nâng cao tab.

TL;DR — Đó Lập chỉ mục API là một Google Cloud–authenticated REST API (v3) đó accepts URL_UPDATED và URL_DELETED notifications. Google officially hỗ trợ điều này chỉ cho JobPosting và BroadcastEvent-trong-VideoObject (livestream) các trang — không chung nội dung. MỘT 200 từ đó status endpoint xác nhận receipt, không lập chỉ mục. Google stance có hardened over năm: 2022 (“doesn’t make sense” (bản dịch) «không làm hợp lý») → Sept 2024 (một spam warning đã thêm để đó tài liệu) → Có thể 2025 (Mueller: “spammers misuse the Indexing API… use it properly, or not use it” (bản dịch) «spammers misuse đó Lập chỉ mục API… dùng điều này properly, hoặc không dùng điều này»). Misuse, including multiple accounts để inflate quota, có thể nhận access revoked. Cho chung các trang, của bạn levers là sitemaps, liên kết nội bộ, quality, và occasional GSC “Request indexing” (bản dịch) «Yêu cầu lập chỉ mục» — và remember Google làm không hỗ trợ IndexNow.

Điều gì lập chỉ mục API thực ra là

lập chỉ mục API là programmatic push channel: REST API (v3), authenticated qua Google Cloud service account, đó bạn call để tell Google URL là đã thêm/đã cập nhật (URL_UPDATED) hoặc nên là đã xóa (URL_DELETED). nó sits alongside sitemaps và Search Console as way cho Google để discover và refresh các URL — nhưng nó narrowest của bunch by nội dung loại.

Trong my Cách Tìm kiếm Hoạt động deck, I list đó Lập chỉ mục API as một URL-phát hiện nguồn với đó tag “limited use cases” (bản dịch) «limited dùng cases» — mà là đó toàn bộ story trong hai words. đây là real, điều này hoạt động, và đây là chỉ sanctioned cho một sliver of đó web.

Điều gì Google officially hỗ trợ nó cho

Này là đó load-bearing fact, so I’ll state điều này đó way Google làm. Đó Lập chỉ mục API “can only be used to crawl pages with either JobPosting or BroadcastEvent embedded in a VideoObject.” (bản dịch) «có thể chỉ là được dùng để crawl các trang với either JobPosting hoặc BroadcastEvent embedded trong một VideoObject.» đó là điều này — hai structured-dữ liệu types:

• JobPosting — job-listing các trang. họ expire, và stale jobs là bad người dùng experience, so timely thêm/xóa matters.
• BroadcastEvent trong VideoObject — livestream event các trang. họ’re chỉ relevant during (và chỉ khoảng) broadcast.

Vì sao chỉ những điều này hai? Cả hai là inherently nhạy cảm với thời gian và ngắn-lived. rationale Google cho là đó fast notification của thay đổi matters far nhiều hơn cho những điều này hơn cho evergreen các trang, mà thông thường crawl xử lý fine.

Cách nó hoạt động

Prerequisites

Setup là non-trivial — điều này không phải một-nhấp feature:

• MỘT Google Cloud project với đó Lập chỉ mục API enabled. As Google puts điều này, bạn “need to tell Google about your client and activate access to the API.” (bản dịch) «cần để tell Google về của bạn client và activate access để đó API.»
• MỘT service account với một JSON key file, stored securely.
• Search Console verification of đó site, thì thêm của bạn service account as một delegated chủ trang web.
• OAuth: “Every call to the Indexing API must be authenticated with an OAuth token that you get in exchange for your private key,” (bản dịch) «Mỗi call để đó Lập chỉ mục API phải được authenticated với an OAuth token đó bạn nhận trong exchange cho của bạn riêng tư key,» dùng đó phạm vi https://www.googleapis.com/auth/indexing.

hai các phương thức (plus status kiểm tra)

• URL_UPDATED — “To notify Google of a new URL to crawl or that content at a previously-submitted URL has been updated.” (bản dịch) «Để notify Google of một new URL để crawl hoặc đó nội dung tại một previously-được gửi URL đã được đã cập nhật.» POST đó URL với "type": "URL_UPDATED". MỘT successful call nhận an HTTP 200 — Google own wording là đó này “means that Google may try to recrawl this URL soon,” (bản dịch) «có nghĩa là đó Google có thể try để recrawl này URL soon,» không đó điều này sẽ, hoặc đó crawl sẽ kết quả trong lập chỉ mục.
• URL_DELETED — trước khi bạn yêu cầu removal, Google requires đó “the URL must return a 404 or 410 status code or the page must contain” (bản dịch) «đó URL phải trả về một 404 hoặc 410 mã trạng thái hoặc đó trang phải contain» một noindex meta tag — đây là an either/hoặc, không “delete the page and also add noindex.” (bản dịch) «delete đó trang và cũng thêm noindex.» Khi đó là đúng, POST đó URL với "type": "URL_DELETED" so Google drops điều này.
• Status (GET) — trả về metadata (latest_update, latest_remove, notify_time). Đó cốt yếu caveat, verbatim: đó GET yêu cầu “only returns whether you successfully submitted a request.” (bản dịch) «chỉ trả về liệu bạn successfully được gửi một yêu cầu.» Điều này làm không tell bạn liệu Google thực ra được lập chỉ mục hoặc đã xóa bất cứ điều gì.
• Batching — để cut xuống on HTTP connections, bạn có thể “combine up to 100 calls to the Indexing API into a single HTTP request.” (bản dịch) «gộp tối đa 100 lệnh gọi để đó Lập chỉ mục API vào một single HTTP yêu cầu.» Quota là vẫn được tính theo URL: 10 các yêu cầu trong một batch vẫn dùng 10 các yêu cầu of quota.

Quotas

Google default quota có three tách biệt dimensions, không chỉ một number:

• 200 publish các yêu cầu/day theo project — covers cả hai URL_UPDATED và URL_DELETED calls combined. Đây là number phần lớn các hướng dẫn cite.
• 180 getMetadata (status) các yêu cầu/minute theo project.
• 380 các yêu cầu/minute theo project across all endpoints combined.

All three là described as “initial default quota for testing” (bản dịch) «ban đầu default quota cho kiểm thử» — going beyond them “requires additional approval for usage and resource provisioning,” (bản dịch) «requires additional approval cho usage và tài nguyên provisioning,» qua một yêu cầu form, và Google notes “the quota may increase or decrease based on the document quality.” (bản dịch) «đó quota có thể increase hoặc decrease dựa trên đó document quality.» Đó phổ biến “hack” of spinning lên multiple service accounts hoặc projects để inflate đó daily quota là chính xác điều gì Google forbids (see dưới).

có thể bạn sử dụng nó cho thông thường các trang? Điều gì Google thực ra nói

Ngắn câu trả lời: không, không trong supported way — và Google có là remarkably consistent và increasingly blunt về nó.

Đó tài liệu carry một spam warning. Khoảng September 2024, Google đã thêm language để đó quickstart đang làm đó stance rõ ràng: “All submissions through the Indexing API undergo rigorous spam detection,” (bản dịch) «All submissions qua đó Lập chỉ mục API undergo rigorous spam detection,» và “any attempts to abuse the Indexing API, including the use of multiple accounts or other means to exceed usage quotas, may result in access being revoked.” (bản dịch) «bất kỳ attempts để abuse đó Lập chỉ mục API, including đó dùng of multiple accounts hoặc other có nghĩa là để exceed usage quotas, có thể kết quả trong access đang revoked.»

Đó reps có đã nói điều này cho năm. Back trong Có thể 2022, John Mueller được diễn đạt điều này với his construction-vehicles analogy: đó API “is meant for very specific kinds of content,” (bản dịch) «là meant cho very cụ thể kinds of nội dung,» và dùng điều này elsewhere “doesn’t really make sense.” (bản dịch) «không thực sự làm hợp lý.» By Có thể 2025 đó tone đã là sharper — Mueller: “We see a lot of spammers misuse the Indexing API like this, so I’d recommend just sticking to the documented & supported use-cases,” (bản dịch) «We see một lot of spammers misuse đó Lập chỉ mục API như này, so I’d khuyến nghị chỉ sticking để đó được ghi lại & supported dùng-cases,» và “I’d just use it properly, or not use it. If we wanted to suggest that people could use it regardless, we’d document it as such.” (bản dịch) «I’d chỉ dùng điều này properly, hoặc không dùng điều này. Nếu we wanted để suggest đó mọi người có thể dùng điều này regardless, we’d document điều này as such.»

Đó arc — 2022 “doesn’t make sense” (bản dịch) «không làm hợp lý» → 2024 spam warning trong đó tài liệu → 2025 “spammers misuse… use it properly or not use it” (bản dịch) «spammers misuse… dùng điều này properly hoặc không dùng điều này» — là một multi-năm pattern, không một một-off. Coverage có cũng noted đó API nhận effectively inundated by bloggers và SEOs treating thông thường các trang as nếu they qualified.

** thực risk, stated precisely.** Mueller dừng ngắn của promising algorithmic hình phạt. honest cách diễn đạt là: nó unsupported và so với guidelines, nội dung pushed trong improperly có thể không stay được lập chỉ mục, và của bạn access có thể là revoked. không overstate nó as guaranteed manual hành động — nhưng không pretend nó free, either.

status-điểm cuối myth

Này một deserves của nó own line vì so nhiều tools nhận điều này sai: một successful submission là receipt xác nhận, không an lập chỉ mục promise. Đó status GET “only returns whether you successfully submitted a request.” (bản dịch) «chỉ trả về liệu bạn successfully được gửi một yêu cầu.» Nếu một dashboard cho thấy bạn một green “được lập chỉ mục” badge off đó back of một 200, đây là inferring điều gì đó API không bao giờ told điều này.

lập chỉ mục API so với yêu cầu lập chỉ mục so với IndexNow

Three điều nhận conflated constantly. họ’re khác mechanisms:

• lập chỉ mục API (Google): programmatic, nhưng nội dung-restricted để JobPosting/BroadcastEvent. narrowest của three.
• yêu cầu lập chỉ mục (GSC URL Inspection): hoạt động cho bất kỳ trang bạn own, nhưng nó manual, một URL tại time, và meant cho occasional sử dụng — và nó yêu cầu, không bảo đảm.
• IndexNow: open, cross-engine push giao thức (Bing, Yandex, Yep, Seznam, Naver) — và Google không sử dụng nó. nó cross-engine analog để lập chỉ mục API, và một I thực ra champion: I helped ship IndexNow integration trong Ahrefs trang web Audit. nhưng nó không reach Google.

(đầy đủ breakdown trong Các framework tab.)

Điều gì để làm thay vì cho chung các trang

nếu bạn’re không posting jobs hoặc livestreams, lập chỉ mục API không phải của bạn tool, và Google có đã nói so repeatedly. của bạn thực Google levers là unglamorous ones:

• Sitemaps — cho coverage và phát hiện.
• Liên kết nội bộ — orphan các trang struggle; linked các trang nhận được tìm thấy.
• Nội dung quality — Google decides điều gì là worth lập chỉ mục; thin các trang stall tại “Discovered – currently not indexed” (bản dịch) «Discovered – hiện tại không được lập chỉ mục» không quan trọng cách hard bạn push them.
• GSC “Request indexing” (bản dịch) «Yêu cầu lập chỉ mục» — cho genuine một-offs, sparingly.

cho cross-engine pushing (Bing và friends, không Google), IndexNow là right tool. và nếu bạn care về Vì sao các trang không phải getting được lập chỉ mục trong đầu tiên place, đó crawl-frequency và quality câu hỏi, không API câu hỏi.

AI summary

condensed take on Nâng cao version:

• Điều gì điều này là: một Google Cloud–authenticated REST API (v3) cho pushing URL_UPDATED / URL_DELETED notifications để Google.
• Đó một fact đó matters: officially supported chỉ cho JobPosting và BroadcastEvent (livestream) các trang — không chung nội dung. Cả hai là nhạy cảm với thời gian by design.
• Đó #1 myth: “it indexes any page fast.” (bản dịch) «điều này indexes bất kỳ trang fast.» Điều này không; Google calls rộng hơn dùng misuse. MỘT successful submission chỉ xác nhận Google đã nhận đó yêu cầu, không đó bất cứ điều gì đã là được lập chỉ mục.
• Google stance hardened theo thời gian: 2022 “doesn’t make sense” (bản dịch) «không làm hợp lý» → Sept 2024 spam warning đã thêm để đó tài liệu → Có thể 2025 Mueller “spammers misuse… use it properly, or not use it.” (bản dịch) «spammers misuse… dùng điều này properly, hoặc không dùng điều này.»
• Risk: unsupported/so với guidelines; multiple accounts để beat đó ~200/day quota có thể nhận access revoked. Không nhất thiết một manual hình phạt — nhưng nội dung có thể không stick.
• Không đó giống nhau as IndexNow (cross-engine, Bing/Yandex/etc. — Google không dùng điều này) hoặc GSC Yêu cầu Lập chỉ mục (bất kỳ trang, manual, occasional).
• Cho thông thường các trang: sitemaps + liên kết nội bộ + quality + occasional GSC Yêu cầu Lập chỉ mục.

Tài liệu chính thức

Chính-nguồn tài liệu từ Google.

Google — lập chỉ mục API

• lập chỉ mục API Quickstart — overview, JobPosting/BroadcastEvent restriction, và spam-detection warning.
• Cách sử dụng lập chỉ mục API — URL_UPDATED / URL_DELETED các phương thức và status-điểm cuối caveat.
• Prerequisites — Cloud project, service account, OAuth phạm vi, và Search Console delegated quyền sở hữu.
• Quota và pricing — default quota (200) và approval needed cho nhiều hơn.

Google — context cho chung các trang

• Ask Google để recrawl của bạn URLs — sitemaps và đó Search Console “Request indexing” (bản dịch) «Yêu cầu lập chỉ mục» path cho thông thường nội dung.
• Trong-Depth Hướng dẫn để Cách Google Search Hoạt động — nơi phát hiện URL và đó crawl → chỉ mục → serve pipeline fit.

Quotes từ nguồn

On—record statements từ Google. mỗi link là deep link đó jumps để quoted passage on nguồn trang.

Google tài liệu — restriction

• “The Indexing API can only be used to crawl pages with either JobPosting or BroadcastEvent embedded in a VideoObject.” (bản dịch) «Đó Lập chỉ mục API có thể chỉ là được dùng để crawl các trang với either JobPosting hoặc BroadcastEvent embedded trong một VideoObject.» — Google Search Central, Lập chỉ mục API Quickstart. Nhảy đến trích dẫn
• “The Indexing API allows site owners to directly notify Google when their job posting or livestreaming video pages are added or removed.” (bản dịch) «Đó Lập chỉ mục API cho phép chủ trang web để trực tiếp notify Google khi của họ job posting hoặc livestreaming video các trang là đã thêm hoặc đã xóa.» Nhảy đến trích dẫn

Google tài liệu — spam warning (đã thêm để tài liệu khoảng September 2024)

• “All submissions through the Indexing API undergo rigorous spam detection.” (bản dịch) «All submissions qua đó Lập chỉ mục API undergo rigorous spam detection.» Nhảy đến trích dẫn
• “Any attempts to abuse the Indexing API, including the use of multiple accounts or other means to exceed usage quotas, may result in access being revoked.” (bản dịch) «Bất kỳ attempts để abuse đó Lập chỉ mục API, including đó dùng of multiple accounts hoặc other có nghĩa là để exceed usage quotas, có thể kết quả trong access đang revoked.» Nhảy đến trích dẫn

Google tài liệu — status-điểm cuối caveat (myth-buster)

• “The GET request doesn’t tell you when Google indexes or removes a URL; it only returns whether you successfully submitted a request.” (bản dịch) «Đó GET yêu cầu không tell bạn khi Google indexes hoặc xóa một URL; điều này chỉ trả về liệu bạn successfully được gửi một yêu cầu.» — Google Search Central, Cách Dùng đó Lập chỉ mục API. Nhảy đến trích dẫn

Google tài liệu — quota

• “The default value is set to 200.” (bản dịch) «Đó default giá trị là set để 200.» (publish các yêu cầu/day) — Google Search Central, quota & pricing. Nhảy đến trích dẫn
• “The default value is set to 180.” (bản dịch) «Đó default giá trị là set để 180.» (getMetadata status các yêu cầu/minute) và “The default value is set to 380.” (bản dịch) «Đó default giá trị là set để 380.» (all endpoints/minute) — đó hai other quota dimensions hầu hết các hướng dẫn skip. Jump để 180 · Jump để 380
• “The quota may increase or decrease based on the document quality.” (bản dịch) «Đó quota có thể increase hoặc decrease dựa trên đó document quality.» — Google Search Central, quota & pricing. Nhảy đến trích dẫn

Google tài liệu — batching và removal

• “…you can combine up to 100 calls to the Indexing API into a single HTTP request.” (bản dịch) «…bạn có thể gộp tối đa 100 lệnh gọi để đó Lập chỉ mục API vào một single HTTP yêu cầu.» — Google Search Central, Cách Dùng đó Lập chỉ mục API. Nhảy đến trích dẫn
• “…the URL must return a 404 or 410 status code or the page must contain” (bản dịch) «…đó URL phải trả về một 404 hoặc 410 mã trạng thái hoặc đó trang phải contain» một noindex meta tag — trước requesting removal. — Google Search Central, Cách Dùng đó Lập chỉ mục API. Nhảy đến trích dẫn
• “An HTTP 200 response means that Google may try to recrawl this URL soon.” (bản dịch) «An HTTP 200 phản hồi có nghĩa là đó Google có thể try để recrawl này URL soon.» — Google Search Central, Cách Dùng đó Lập chỉ mục API (on URL_UPDATED). Nhảy đến trích dẫn

John Mueller, Google Search Advocate — Bluesky, ~có thể 2025

• “We see a lot of spammers misuse the Indexing API like this, so I’d recommend just sticking to the documented & supported use-cases.” (bản dịch) «We see một lot of spammers misuse đó Lập chỉ mục API như này, so I’d khuyến nghị chỉ sticking để đó được ghi lại & supported dùng-cases.»
• “I’d just use it properly, or not use it. If we wanted to suggest that people could use it regardless, we’d document it as such.” (bản dịch) «I’d chỉ dùng điều này properly, hoặc không dùng điều này. Nếu we wanted để suggest đó mọi người có thể dùng điều này regardless, we’d document điều này as such.» Đọc bài đưa tin

John Mueller, Google — SEO office-hours, Có thể 2022 (đó “construction vehicles” (bản dịch) «phương tiện xây dựng» cách diễn đạt)

• “The indexing API is meant for very specific kinds of content. And using it for other kinds of content doesn’t really make sense.” (bản dịch) «Đó lập chỉ mục API là meant cho very cụ thể kinds of nội dung. Và dùng điều này cho other kinds of nội dung không thực sự làm hợp lý.»
• “It’s not that it’s illegal or that it will cause problems if you put construction vehicles on your medical website. But it doesn’t really make sense.” (bản dịch) «đây là không đó đây là illegal hoặc đó điều này sẽ nguyên nhân các vấn đề nếu bạn put phương tiện xây dựng on của bạn medical website. Nhưng điều này không thực sự làm hợp lý.» Đọc bài đưa tin

lập chỉ mục API — bảng tra nhanh

Supported sử dụng cases (Đây là toàn bộ list)

** hai các phương thức**

Batching: combine lên để 100 calls vào một HTTP yêu cầu — quota vẫn được tính theo URL, không theo batch.

Fast facts

• Default quota có three parts: 200 publish các yêu cầu/day, 180 status (getMetadata) các yêu cầu/minute, 380 các yêu cầu/minute across all endpoints. Quota beyond đó cần Google approval và có thể shift với document quality.
• 200 ≠ được lập chỉ mục. thành công phản hồi xác nhận submission đã nhận, không có gì nhiều hơn.
• Multiple accounts để beat quota = access revoked (theo tài liệu).
• Auth: Google Cloud project + service account + OAuth, phạm vi https://www.googleapis.com/auth/indexing, service account đã thêm as GSC delegated owner.
• không IndexNow (cross-engine, không Google). không replacement cho sitemaps hoặc GSC yêu cầu lập chỉ mục.

minimal publish call (cho supported nội dung chỉ)

Đây là shape của single URL_UPDATED notification. chỉ sử dụng nó Đối với các trang với JobPosting hoặc BroadcastEvent dữ liệu có cấu trúc — đó Điều gì API là sanctioned cho. auth step (exchanging của bạn service-account mấu chốt cho OAuth token) là omitted cho brevity; trên thực tế bạn’d sử dụng Google API client library để nhận token.

** yêu cầu**

POST https://indexing.googleapis.com/v3/urlNotifications:publish
Authorization: Bearer <OAUTH_TOKEN>
Content-Type: application/json

{
  "url": "https://example.com/jobs/senior-seo-analyst",
  "type": "URL_UPDATED"
}

để tín hiệu removal (sau khi trang là đã biến mất hoặc noindexed):

{
  "url": "https://example.com/jobs/senior-seo-analyst",
  "type": "URL_DELETED"
}

Kiểm tra status — note phản hồi tells bạn chỉ đó yêu cầu là đã nhận, không liệu bất cứ điều gì là được lập chỉ mục:

GET https://indexing.googleapis.com/v3/urlNotifications/metadata?url=https%3A%2F%2Fexample.com%2Fjobs%2Fsenior-seo-analyst
Authorization: Bearer <OAUTH_TOKEN>

MỘT 200 ở đây có nghĩa là “we got your submission” (bản dịch) «we đã nhận của bạn submission» — điều này là không một xác nhận đó Google được lập chỉ mục (hoặc đã xóa) đó URL.

Batching multiple các URL: Bạn có thể combine lên để 100 individual calls vào single multi-part HTTP yêu cầu để https://indexing.googleapis.com/batch thay vì firing 100 tách biệt các yêu cầu — nhưng quota là vẫn được tính theo URL, so 100-call batch vẫn dùng 100 các yêu cầu của bạn daily allowance. Google API client libraries (Java, Python, JavaScript, PHP,.NET) xử lý batch formatting cho bạn; hand-rolling nó là rarely worth nó.

lập chỉ mục API so với yêu cầu lập chỉ mục so với IndexNow

decision framework: hình out Điều gì bạn có và mà engine bạn care về, sau đó pick channel.

Cách chọn

1. Đã nhận job postings hoặc livestreams, và muốn để automate? → Lập chỉ mục API.
2. Muốn để push chung các trang để Bing/Yandex/Yep? → IndexNow.
3. Muốn Google để recrawl một thông thường trang, khi? → GSC “Request indexing.” (bản dịch) «Yêu cầu lập chỉ mục.»
4. Muốn chung các trang được lập chỉ mục tại scale on Google? → có không push button. Sitemaps + liên kết nội bộ + quality. (Và patience — see crawl frequency.)

** mental model:** lập chỉ mục API sounds như phần lớn powerful của three vì nó API, nhưng by nội dung loại nó narrowest. Power và phạm vi không phải giống nhau điều.

Tools

• Google Cloud Console — tạo đó project, enable đó Lập chỉ mục API, và generate đó service-account JSON key bạn’ll authenticate với.
• Google Search Console — URL Inspection — cho thông thường các trang, này là của bạn real tool: kiểm tra cách một URL đã là được crawl/được kết xuất/được lập chỉ mục, và dùng “Request indexing” (bản dịch) «Yêu cầu lập chỉ mục» cho occasional một-offs.
• Google Search Console — Sitemaps & Coverage — submit sitemaps và see điều gì là được lập chỉ mục, “Discovered – currently not indexed,” (bản dịch) «Discovered – hiện tại không được lập chỉ mục,» hoặc excluded.
• Google API client libraries — đó sạch nhất way để xử lý đó OAuth token-exchange cho Lập chỉ mục API calls (thay vì hand-rolling JWT signing).
• IndexNow integration (Ahrefs Site Audit, etc.) — cho đó cross-engine push channel (Bing và others, không Google). Đó right tool khi bạn muốn đó programmatic-push behavior mọi người wish đó Lập chỉ mục API gave them cho chung các trang.

các tài nguyên worth của bạn time

My related writing

• Điều gì Là Googlebot & Cách Làm Điều này Hoạt động? — nơi đó Lập chỉ mục API sits among Google URL-phát hiện sources (links, sitemaps, RSS, GSC, và đó API).
• Cách sửa “Discovered – currently not indexed” (bản dịch) «Discovered – hiện tại không được lập chỉ mục» — đó real “why won’t my pages index” (bản dịch) «vì sao sẽ không my các trang chỉ mục» trang; đó cách sửa là quality và liên kết nội bộ, không một push API.
• Đó Beginner Hướng dẫn để SEO kỹ thuật — nơi crawling và lập chỉ mục fit trong đó bigger picture.

My speaking

• Cách Tìm kiếm Hoạt động (SlideShare) — my walkthrough of phát hiện, crawling, kết xuất, lập chỉ mục, và xếp hạng; đó URL-phát hiện slide tags đó Lập chỉ mục API “limited use cases.” (bản dịch) «limited dùng cases.» (My standing disclaimer áp dụng: “This is my understanding of systems… not going to be 100% complete or accurate.” (bản dịch) «Này là my understanding of các hệ thống… không going để là 100% hoàn tất hoặc chính xác.»)

On IndexNow ( cross-engine sibling — note Google làm không sử dụng nó)

• IndexNow integration trong Ahrefs trang web Audit — push channel I thực ra endorse, cho Bing/Yandex/Yep thay vì Google.
• Cách submit các trang để IndexNow trong trang web Audit.

Từ others

• Google Adds Spam Warning Để Lập chỉ mục API Tài liệu (Search Engine Journal, Sept 2024) — documents khi đó spam-detection language went trong.
• Google Again Says Dừng Dùng Lập chỉ mục API Cho Unsupported Nội dung (Công cụ tìm kiếm Roundtable, Có thể 2025) — Barry Schwartz covers Mueller Bluesky warning để dừng misusing đó API.
• Misuse of Lập chỉ mục API Có thể Lead để SEO Các vấn đề (StanVentures, Có thể 2025) — reproduces Mueller Có thể 2025 Bluesky quotes verbatim và giải thích đó access-revocation risk.
• Google Các câu trả lời Liệu Dùng đó Lập chỉ mục API cho một Thông thường Website Là Good hoặc Bad (iLoveSEO, Có thể 2022) — transcript of Mueller “construction vehicles” (bản dịch) «phương tiện xây dựng» office-hours cách diễn đạt.
• Google Says Của nó Lập chỉ mục API Là Inundated by Bloggers (Optimixed) — covers cách off-label dùng by bloggers và SEOs có overwhelmed đó API.
• r/TechSEO — đó community cho crawl/chỉ mục gỡ lỗi.

phổ biến các vấn đề

Các vấn đề mọi người thực ra chạy vào với lập chỉ mục API, trong symptom → nguyên nhân → khắc phục order.

”I got a 200 response but the page still isn’t indexed” (bản dịch) «I đã nhận một 200 phản hồi nhưng đó trang vẫn không được lập chỉ mục»

• Symptom: Đó URL_UPDATED call (hoặc đó status GET) trả về success, nhưng đó trang không bao giờ cho thấy lên trong tìm kiếm, hoặc Search Console vẫn says “Discovered – currently not indexed.” (bản dịch) «Discovered – hiện tại không được lập chỉ mục.»
• Nguyên nhân: MỘT 200 chỉ xác nhận Google đã nhận đó notification. Theo Google own tài liệu, đó status endpoint “only returns whether you successfully submitted a request” (bản dịch) «chỉ trả về liệu bạn successfully được gửi một yêu cầu» — điều này không tell bạn liệu bất cứ điều gì đã là được crawl, được lập chỉ mục, hoặc đã xóa.
• Cách sửa: Dừng treating đó API phản hồi as an lập chỉ mục xác nhận. Kiểm tra thực tế lập chỉ mục status trong đó URL Inspection tool trong Search Console, hoặc đó Coverage báo cáo. Nếu đó trang vẫn không được lập chỉ mục sau một reasonable chờ, đó vấn đề là phát hiện/quality (see “What to do instead” (bản dịch) «Điều cần làm thay vì» trong đó Advanced tab), không đó API call.

”My Indexing API access got revoked” (bản dịch) «My Lập chỉ mục API access đã nhận revoked»

• Symptom: Calls đó được dùng để hoạt động bắt đầu failing, hoặc Google Cloud/Tìm kiếm Console cho thấy đó service account access đã được pulled.
• Nguyên nhân: Google trạng thái plainly đó “any attempts to abuse the Indexing API, including the use of multiple accounts or other means to exceed usage quotas, may result in access being revoked.” (bản dịch) «bất kỳ attempts để abuse đó Lập chỉ mục API, including đó dùng of multiple accounts hoặc other có nghĩa là để exceed usage quotas, có thể kết quả trong access đang revoked.» Đó hầu hết phổ biến trigger là submitting non-JobPosting/non-BroadcastEvent các trang, hoặc spinning lên extra service accounts để nhận khoảng đó ~200/day default quota.
• Cách sửa: Audit điều gì bạn đã submitting — nếu đây là chung nội dung (blog posts, sản phẩm các trang, bất cứ điều gì không có JobPosting hoặc BroadcastEvent dữ liệu có cấu trúc), dừng. Đó API không phải được ghi lại để hỗ trợ điều này, và Mueller có đã nói trực tiếp: “I’d just use it properly, or not use it.” (bản dịch) «I’d chỉ dùng điều này properly, hoặc không dùng điều này.» có không được ghi lại appeal path beyond staying bên trong đó supported dùng case going forward.

”Submissions for normal pages don’t seem to do anything” (bản dịch) «Submissions cho thông thường các trang không seem để làm bất cứ điều gì»

• Symptom: Bạn submit URL_UPDATED cho một regular bài viết hoặc sản phẩm trang và không có gì thay đổi — không nhanh hơn crawl, không nhanh hơn lập chỉ mục.
• Nguyên nhân: Đó nội dung loại không một of đó hai Google hỗ trợ. Đó Lập chỉ mục API “can only be used to crawl pages with either JobPosting or BroadcastEvent embedded in a VideoObject.” (bản dịch) «có thể chỉ là được dùng để crawl các trang với either JobPosting hoặc BroadcastEvent embedded trong một VideoObject.» Submissions bên ngoài đó phạm vi không một được ghi lại, supported tín hiệu.
• Cách sửa: Này không một bug để cách sửa — đây là đó sai tool. Cho chung các trang, dùng một sitemap, liên kết nội bộ, và (cho occasional một-offs) “Request indexing” (bản dịch) «Yêu cầu lập chỉ mục» trong Search Console’s URL Inspection tool thay vì.

”I’m hitting the quota limit” (bản dịch) «I’m hitting đó quota limit»

• Symptom: Submissions bắt đầu failing hoặc getting throttled — either khoảng 200/day, hoặc trong ngắn hơn bursts even dưới 200/day.
• Nguyên nhân: Google thực ra enforces three tách biệt default quotas: 200 publish (URL_UPDATED/URL_DELETED) các yêu cầu theo day, 180 status (getMetadata) các yêu cầu theo minute, và 380 các yêu cầu theo minute across all endpoints combined. MỘT burst of status kiểm tra có thể throttle bạn on đó theo-minute limits well trước khi bạn hit đó daily 200. Going beyond bất kỳ of những “requires additional approval for usage and resource provisioning,” (bản dịch) «requires additional approval cho usage và tài nguyên provisioning,» và Google notes đó granted quota “may increase or decrease based on the document quality.” (bản dịch) «có thể increase hoặc decrease dựa trên đó document quality.»
• Cách sửa: Nếu bạn là legitimately xuất bản/updating đó nhiều JobPosting hoặc BroadcastEvent các trang một day, yêu cầu một quota increase qua Google Cloud — không tạo extra service accounts hoặc projects để hoạt động khoảng điều này, since đó là explicitly named as đó kind of abuse đó nhận access revoked.

Checklists

trước khi bạn touch lập chỉ mục API

• Xác nhận đó các trang bạn muốn để submit thực ra carry JobPosting dữ liệu có cấu trúc, hoặc BroadcastEvent embedded trong một VideoObject — đó chỉ hai nội dung types Google hỗ trợ.
• Nếu neither áp dụng, dừng ở đây. Dùng sitemaps, liên kết nội bộ, nội dung quality, và occasional GSC “Request indexing” (bản dịch) «Yêu cầu lập chỉ mục» thay vì — không đó API.
• Decide liệu của bạn submission volume sẽ realistically fit bên trong đó default ~200/day quota, hoặc liệu bạn’ll cần để yêu cầu an increase.

Setting nó lên

• Tạo (hoặc chọn) Google Cloud project và enable lập chỉ mục API trong nó.
• Tạo service account và download của nó JSON mấu chốt file; store nó securely (không bao giờ commit nó để công khai repo).
• Verify của bạn trang web trong Search Console nếu nó không phải đã.
• Thêm service account email as delegated trang web owner trong Tìm kiếm Console.
• xác nhận Bạn có thể exchange service-account mấu chốt cho OAuth token với phạm vi https://www.googleapis.com/auth/indexing (typically qua Google API client library thay vì hand-rolled JWT signing).

Submitting notification

• Pick right phương thức: URL_UPDATED cho new hoặc changed supported trang, URL_DELETED sau khi trang là đã biến mất hoặc noindexed.
• POST URL với đúng type trường để https://indexing.googleapis.com/v3/urlNotifications:publish.
• Treat 200 phản hồi as receipt xác nhận chỉ — không proof trang là được lập chỉ mục hoặc đã xóa.
• Follow lên trong Search Console (URL Inspection hoặc Coverage) nếu bạn cần xác nhận thực tế lập chỉ mục status.

Staying bên trong guidelines

• chỉ submit JobPosting/BroadcastEvent các trang qua điều này API — không có gì khác.
• không tạo multiple service accounts hoặc projects chỉ để exceed quota; yêu cầu legitimate increase thay vì.
• nếu bạn’re không sure liệu trang qualifies, treat đó as “điều này không” và sử dụng sitemaps/liên kết nội bộ/yêu cầu lập chỉ mục cho nó thay vì.

Quiz

Five các câu hỏi để kiểm tra Điều gì thực ra stuck về lập chỉ mục API.

Nhật ký thay đổi