Google pengindeksan API

TL;DR — Google pengindeksan API adalah sebuah cara untuk situs owners untuk tell Google “ini halaman changed, please re-crawl it” (terjemahan) “ini halaman changed, please re-crawl ini” melalui code alih-alih clicking buttons. tetapi di sini’s catch sebagian besar guides skip: Google hanya officially mendukung ini untuk job-posting halaman dan livestream halaman. ini adalah tidak sebuah shortcut untuk mendapatkan Anda blog posts atau product halaman terindeks lebih cepat — Google memiliki mengatakan so di atas dan di atas.

Apa pengindeksan API adalah

Ketika Anda publish atau perubahan sebuah halaman, Anda biasanya tunggu untuk Google untuk come back dan re-crawl ini pada -nya own schedule. pengindeksan API adalah sebuah cara untuk push sebuah notification untuk Google alih-alih — “hey, ini URL adalah new/diperbarui” (terjemahan) “hey, ini URL adalah baru/diperbarui” atau “ini URL adalah gone, drop it.” (terjemahan) “ini URL adalah hilang, drop ini.” Anda melakukan ini dengan code (sebuah kecil program calling Google’s server), tidak oleh clicking sekitar di sebuah dashboard.

itu sounds powerful, dan ini adalah — untuk tepat hal ini adalah dibangun untuk.

satu hal untuk memahami

Google hanya officially mendukung pengindeksan API untuk dua jenis dari halaman:

1. Job postings — halaman dengan JobPosting data terstruktur (job listings, yang expire dan perlu untuk come down quickly).
2. Livestreams — halaman dengan BroadcastEvent data terstruktur (langsung video events, yang hanya penting selama broadcast).

itu’s ini. Keduanya adalah time-sensitive konten itu goes stale fast, yang adalah mengapa Google dibangun sebuah fast lane untuk them.

jika Anda tidak memiliki job listings atau livestreams, ** pengindeksan API adalah tidak Anda alat** — Tidak penting apa sebuah “get indexed in hours” (terjemahan) “mendapatkan terindeks di hours” plugin atau SaaS tells Anda.

myth untuk ignore

single biggest myth online adalah: “Use the Indexing API to get any page indexed fast.” (terjemahan) “Gunakan API Pengindeksan untuk mendapatkan halaman apa pun terindeks dengan cepat.”* ini tidak berfungsi itu cara, dan Google memiliki repeatedly called menggunakan ini untuk wajar halaman misuse. Orang melakukan ini anyway karena alat sell ini sebagai sebuah growth hack — tetapi Google dapat (dan says ini akan) revoke Anda access untuk abusing ini.

ada sebuah kedua trap, too: ketika Anda submit sebuah URL dan mendapatkan sebuah “success” (terjemahan) “success” respons, itu hanya berarti Google diterima Anda permintaan. ini melakukan tidak berarti halaman mendapat terindeks. Plenty dari alat blur itu line; Google’s own docs adalah jelas tentang ini.

Apa untuk melakukan alih-alih untuk lebih cepat pengindeksan

untuk regular halaman (blogs, products, artikel), hal itu sebenarnya help adalah boring tetapi nyata:

• Submit sebuah sitemap XML di Google Search Console.
• tautan untuk Anda baru halaman dari lainnya halaman pada Anda situs.
• membuat halaman genuinely worth pengindeksan (quality, tidak thin filler).
• untuk sebuah satu kali, gunakan “Request indexing” (terjemahan) “permintaan pengindeksan” di Search Console’s pemeriksaan URL alat — sparingly.

ingin teknis versi — setup, sebenarnya API metode, quotas, dan tepat Google quotes? Switch untuk Advanced tab.

TL;DR — pengindeksan API adalah sebuah Google Cloud–authenticated REST API (v3) itu accepts URL_UPDATED dan URL_DELETED notifications. Google officially mendukung ini hanya untuk JobPosting dan BroadcastEvent-di-VideoObject (livestream) halaman — tidak umum konten. sebuah 200 dari status endpoint mengonfirmasi receipt, tidak pengindeksan. Google’s stance memiliki hardened di atas tahun: 2022 (“tidak membuat sense” (terjemahan) “tidak membuat sense”) → Sept 2024 (sebuah spam warning ditambahkan untuk docs) → dapat 2025 (Mueller: “spammers misuse itu Indexing API… gunakan it properly, atau tidak gunakan it” (terjemahan) “spammers misuse pengindeksan API… gunakan ini properly, atau tidak gunakan ini”). Misuse, including multiple accounts untuk inflate quota, dapat mendapatkan access revoked. untuk umum halaman, Anda levers adalah sitemaps, tautan internal, quality, dan occasional GSC “Request indexing” (terjemahan) “permintaan pengindeksan” — dan remember Google melakukan tidak mendukung IndexNow.

Apa pengindeksan API sebenarnya adalah

pengindeksan API adalah sebuah programmatic push channel: sebuah REST API (v3), authenticated melalui sebuah Google Cloud service account, itu Anda panggil untuk tell Google sebuah URL adalah ditambahkan/diperbarui (URL_UPDATED) atau seharusnya menjadi dihapus (URL_DELETED). ini sits alongside sitemaps dan Search Console sebagai sebuah cara untuk Google untuk menemukan dan refresh URLs — tetapi ini adalah narrowest dari bunch oleh konten jenis.

di my Bagaimana Penelusuran berfungsi deck, I list pengindeksan API sebagai sebuah URL-penemuan sumber dengan tag “limited gunakan cases” (terjemahan) “limited gunakan cases” — yang adalah seluruh story di dua kata. ini adalah nyata, ini berfungsi, dan ini adalah hanya sanctioned untuk sebuah sliver dari web.

Apa Google officially mendukung ini untuk

ini adalah muat-bearing fact, so I’ll state ini cara Google melakukan. pengindeksan API “The Indexing API can only be used to crawl pages with either JobPosting or BroadcastEvent embedded in a VideoObject.” (terjemahan) “API Pengindeksan hanya dapat digunakan untuk merayapi halaman dengan jenis konten yang didukung secara resmi oleh Google.”* itu’s ini — dua structured-data jenis:

• JobPosting — job-listing halaman. mereka expire, dan stale jobs adalah sebuah buruk pengguna experience, so timely tambahkan/hapus penting.
• BroadcastEvent di sebuah VideoObject — livestream event halaman. mereka’re hanya relevant selama (dan hanya sekitar) broadcast.

Mengapa hanya ini dua? Keduanya adalah inherently time-sensitive dan pendek-lived. rationale Google memberikan adalah itu fast notification dari perubahan penting far lebih untuk ini daripada untuk evergreen halaman, yang wajar crawl menangani fine.

Bagaimana ini berfungsi

Prerequisites

Setup adalah non-trivial — ini tidak sebuah satu-click fitur:

• sebuah Google Cloud project dengan pengindeksan API enabled. sebagai Google puts ini, Anda “perlu untuk tell Google tentang Anda client dan activate access untuk itu API.” (terjemahan) “perlu untuk tell Google tentang Anda client dan activate access untuk API.”
• sebuah service account dengan sebuah JSON key file, stored securely.
• Search Console verification dari situs, lalu tambahkan Anda service account sebagai sebuah delegated situs owner.
• OAuth: “Setiap call untuk itu Indexing API harus menjadi authenticated dengan an OAuth token itu Anda mendapatkan di exchange untuk Anda privat key,” (terjemahan) “setiap panggil untuk pengindeksan API harus menjadi authenticated dengan sebuah OAuth token itu Anda mendapatkan di exchange untuk Anda privat key,” menggunakan cakupan https://www.googleapis.com/auth/indexing.

dua metode (plus sebuah status periksa)

• URL_UPDATED — “Untuk notify Google dari a new URL untuk crawl atau itu konten di a previously-submitted URL memiliki telah diperbarui.” (terjemahan) “untuk notify Google dari sebuah baru URL untuk crawl atau itu konten di sebuah previously-submitted URL memiliki telah diperbarui.” POST URL dengan "type": "URL_UPDATED". sebuah successful panggil mendapatkan sebuah HTTP 200 — Google’s own wording adalah itu ini “means that Google may try to recrawl this URL soon,” (terjemahan) “Google mungkin segera mencoba merayapi ulang URL tersebut,”* tidak itu ini akan, atau itu crawl akan hasil di pengindeksan.
• URL_DELETED — sebelum Anda permintaan removal, Google memerlukan itu “the URL must return a 404 or 410 status code or the page must contain” (terjemahan) “URL harus mengembalikan kode status tersebut atau halaman harus berisi”* sebuah noindex meta tag — ini adalah sebuah either/atau, tidak “delete itu halaman dan juga add noindex.” (terjemahan) “delete halaman dan juga tambahkan noindex.” Setelah itu’s benar, POST URL dengan "type": "URL_DELETED" so Google drops ini.
• Status (GET) — mengembalikan metadata (latest_update, latest_remove, notify_time). critical caveat, verbatim: GET permintaan “hanya returns apakah Anda successfully submitted a request.” (terjemahan) “hanya mengembalikan apakah Anda successfully submitted sebuah permintaan.” ini melakukan tidak tell Anda apakah Google sebenarnya terindeks atau dihapus apa pun.
• Batching — untuk cut down pada HTTP connections, Anda dapat “combine up untuk 100 calls untuk itu Indexing API menjadi a single HTTP request.” (terjemahan) “combine up untuk 100 panggilan untuk pengindeksan API ke sebuah single HTTP permintaan.” Quota adalah masih counted per URL: 10 permintaan di satu batch masih menggunakan 10 permintaan dari quota.

Quotas

Google’s default quota memiliki three terpisah dimensions, tidak hanya satu angka:

• 200 publish permintaan/day per project — covers keduanya URL_UPDATED dan URL_DELETED panggilan combined. ini adalah angka sebagian besar guides cite.
• 180 getMetadata (status) permintaan/minute per project.
• 380 permintaan/minute per project di seluruh semua endpoints combined.

semua three adalah described sebagai “awal default quota untuk testing” (terjemahan) “awal default quota untuk testing” — going beyond them “requires additional approval untuk usage dan resource provisioning,” (terjemahan) “memerlukan additional approval untuk usage dan resource provisioning,” melalui sebuah permintaan form, dan Google notes “the quota may increase or decrease based on the document quality.” (terjemahan) “Google menyatakan bahwa kuota dapat bertambah atau berkurang berdasarkan kualitas dokumen.”* umum “hack” (terjemahan) “hack” dari spinning up multiple service accounts atau projects untuk inflate daily quota adalah persis apa Google forbids (see di bawah).

dapat Anda gunakan ini untuk wajar halaman? Apa Google sebenarnya says

pendek jawaban: Tidak, tidak di sebuah didukung cara — dan Google memiliki telah remarkably consistent dan increasingly blunt tentang ini.

** docs carry sebuah spam warning.** sekitar September 2024, Google ditambahkan language untuk quickstart membuat stance jelas: “All submissions melalui itu Indexing API undergo rigorous spam detection,” (terjemahan) “semua submissions melalui pengindeksan API undergo rigorous spam detection,” dan “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.” (terjemahan) “apa pun attempts untuk abuse pengindeksan API, including gunakan dari multiple accounts atau lainnya berarti untuk exceed usage quotas, dapat hasil di access menjadi revoked.”

** reps memiliki mengatakan ini untuk tahun.** Back di dapat 2022, John Mueller dibingkai ini dengan his construction-vehicles analogy: API “is meant for very specific kinds of content,” (terjemahan) “adalah dimaksudkan untuk very spesifik jenis dari konten,” dan menggunakan ini elsewhere “doesn’t really make sense.” (terjemahan) “tidak benar-benar membuat sense.” oleh dapat 2025 tone adalah 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,” (terjemahan) “kami see sebuah lot dari spammers misuse pengindeksan API like ini, so I’d merekomendasikan hanya sticking untuk terdokumentasi & didukung gunakan-cases,” dan “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.” (terjemahan) “Saya akan menggunakannya dengan benar saja; jika ingin menyarankan penggunaan tanpa memandang jenis halaman, kami akan mendokumentasikannya demikian.”*

itu arc — 2022 “doesn’t make sense” (terjemahan) “tidak membuat sense” → 2024 spam warning di docs → 2025 “spammers misuse… use it properly or not use it” (terjemahan) “spammers misuse… gunakan ini properly atau tidak gunakan ini” — adalah sebuah multi-tahun pattern, tidak sebuah satu kali. Coverage memiliki juga noted API mendapatkan effectively inundated oleh bloggers dan SEOs treating wajar situs sebagai jika mereka qualified.

** nyata risk, stated precisely.** Mueller berhenti pendek dari promising sebuah algorithmic penalty. honest framing adalah: ini adalah unsupported dan terhadap guidelines, konten pushed di improperly dapat tidak stay terindeks, dan Anda access dapat menjadi revoked. jangan overstate ini sebagai sebuah guaranteed manual tindakan — tetapi jangan pretend ini adalah free, either.

status-endpoint myth

ini satu deserves -nya own line karena so banyak alat mendapatkan ini wrong: sebuah successful submission adalah receipt konfirmasi, tidak sebuah pengindeksan promise. status GET “only returns whether you successfully submitted a request.” (terjemahan) “hanya mengembalikan apakah Anda successfully submitted sebuah permintaan.” jika sebuah dashboard menampilkan Anda sebuah green “indexed” (terjemahan) “terindeks” badge off back dari sebuah 200, ini adalah inferring sesuatu API tidak pernah told ini.

pengindeksan API vs permintaan pengindeksan vs IndexNow

Three hal mendapatkan conflated constantly. mereka’re berbeda mechanisms:

• pengindeksan API (Google): programmatic, tetapi konten-restricted untuk JobPosting/BroadcastEvent. narrowest dari three.
• permintaan pengindeksan (GSC pemeriksaan URL): berfungsi untuk apa pun halaman Anda own, tetapi ini adalah manual, satu URL di sebuah time, dan dimaksudkan untuk occasional gunakan — dan ini adalah sebuah permintaan, tidak sebuah jaminan.
• IndexNow: open, cross-mesin push protocol (Bing, Yandex, Yep, Seznam, Naver) — dan Google melakukan tidak gunakan ini. ini adalah cross-mesin analog untuk pengindeksan API, dan satu I sebenarnya champion: I helped ship IndexNow integration di Ahrefs situs Audit. tetapi ini tidak reach Google.

(Penuh breakdown di Kerangka kerja tab.)

Apa untuk melakukan alih-alih untuk umum halaman

jika Anda’re tidak posting jobs atau livestreams, pengindeksan API adalah tidak Anda alat, dan Google memiliki mengatakan so repeatedly. Anda nyata Google levers adalah unglamorous ones:

• Sitemaps — untuk coverage dan penemuan.
• tautan internal — orphan halaman struggle; ditautkan halaman mendapatkan ditemukan.
• konten quality — Google decides apa worth pengindeksan; thin halaman stall di “Discovered – saat ini tidak indexed” (terjemahan) “ditemukan – saat ini tidak terindeks” Tidak penting bagaimana hard Anda push them.
• GSC “Request indexing” (terjemahan) “permintaan pengindeksan” — untuk genuine satu-offs, sparingly.

untuk cross-mesin pushing (Bing dan friends, tidak Google), IndexNow adalah right alat. dan jika Anda care tentang mengapa halaman tidak getting terindeks di pertama place, itu’s sebuah crawl-frequency dan quality pertanyaan, tidak sebuah API pertanyaan.

AI summary

sebuah condensed take pada Advanced versi:

• Apa ini adalah: sebuah Google Cloud–authenticated REST API (v3) untuk pushing URL_UPDATED / URL_DELETED notifications untuk Google.
• ** satu fact itu penting:** officially didukung hanya untuk JobPosting dan BroadcastEvent (livestream) halaman — tidak umum konten. Keduanya adalah time-sensitive oleh design.
• ** #1 myth:** “it indexes any halaman fast.” (terjemahan) “ini indeks apa pun halaman fast.” ini tidak; Google panggilan lebih luas gunakan misuse. sebuah successful submission hanya mengonfirmasi Google diterima permintaan, tidak itu apa pun adalah terindeks.
• Google’s stance hardened di atas time: 2022 “doesn’t make sense” (terjemahan) “tidak membuat sense” → Sept 2024 spam warning ditambahkan untuk docs → dapat 2025 Mueller “spammers misuse… gunakan it properly, atau tidak gunakan it.” (terjemahan) “spammers misuse… gunakan ini properly, atau tidak gunakan ini.”
• Risk: unsupported/terhadap guidelines; multiple accounts untuk beat ~200/day quota dapat mendapatkan access revoked. Tidak niscaya sebuah manual penalty — tetapi konten dapat tidak stick.
• Tidak yang sama sebagai IndexNow (cross-mesin, Bing/Yandex/dan seterusnya. — Google tidak gunakan ini) atau GSC permintaan pengindeksan (apa pun halaman, manual, occasional).
• untuk wajar halaman: sitemaps + tautan internal + quality + occasional GSC permintaan pengindeksan.

Dokumentasi resmi

Utama-sumber documentation dari Google.

Google — pengindeksan API

• pengindeksan API Quickstart — overview, JobPosting/BroadcastEvent restriction, dan spam-detection warning.
• cara gunakan pengindeksan API — URL_UPDATED / URL_DELETED metode dan status-endpoint caveat.
• Prerequisites — Cloud project, service account, OAuth cakupan, dan Search Console delegated kepemilikan.
• Quota dan pricing — default quota (200) dan approval needed untuk lebih.

Google — context untuk umum halaman

• tanyakan Google untuk recrawl Anda URLs — sitemaps dan Search Console “Request indexing” (terjemahan) “permintaan pengindeksan” path untuk wajar konten.
• di-Depth Guide untuk Bagaimana Google Search berfungsi — di mana URL penemuan dan crawl → indeks → sajikan pipeline fit.

Quotes dari sumber

pada—record statements dari Google. setiap tautan adalah sebuah deep tautan itu jumps untuk quoted passage pada sumber halaman.

Google docs — restriction

• “The Indexing API can only be used to crawl pages with either JobPosting or BroadcastEvent embedded in a VideoObject.” (terjemahan) “API Pengindeksan hanya dapat digunakan untuk merayapi halaman dengan jenis konten yang didukung secara resmi oleh Google.”* — Google Search Central, pengindeksan API Quickstart. Jump untuk quote
• “The Indexing API allows site owners to directly notify Google when their job posting or livestreaming video pages are added or removed.” (terjemahan) “ pengindeksan API memungkinkan situs owners untuk secara langsung notify Google ketika mereka job posting atau livestreaming video halaman adalah ditambahkan atau dihapus.” Jump untuk quote

Google docs — spam warning (ditambahkan untuk documentation sekitar September 2024)

• “All submissions through the Indexing API undergo rigorous spam detection.” (terjemahan) “semua submissions melalui pengindeksan API undergo rigorous spam detection.” Jump untuk quote
• “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.” (terjemahan) “apa pun attempts untuk abuse pengindeksan API, including gunakan dari multiple accounts atau lainnya berarti untuk exceed usage quotas, dapat hasil di access menjadi revoked.” Jump untuk quote

Google docs — status-endpoint 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.” (terjemahan) “Permintaan tersebut tidak memberi tahu kapan Google mengindeks atau menghapus URL; permintaan itu hanya mengembalikan apakah pengajuan berhasil dikirim.”* — Google Search Central, cara gunakan pengindeksan API. Jump untuk quote

Google docs — quota

• “The default value is set to 200.” (terjemahan) “ default nilai adalah atur ke 200.” (publish permintaan/day) — Google Search Central, quota & pricing. Jump untuk quote
• “The default value is set to 180.” (terjemahan) “ default nilai adalah atur ke 180.” (getMetadata status permintaan/minute) dan “The default value is set to 380.” (terjemahan) “ default nilai adalah atur ke 380.” (semua endpoints/minute) — dua lainnya quota dimensions sebagian besar guides skip. Jump untuk 180 · Jump untuk 380
• “The quota may increase or decrease based on the document quality.” (terjemahan) “ quota dapat increase atau decrease berdasarkan document quality.” — Google Search Central, quota & pricing. Jump untuk quote

Google docs — batching dan removal

• “…you can combine up to 100 calls to the Indexing API into a single HTTP request.” (terjemahan) “…Anda dapat menggabungkan hingga 100 panggilan ke API Pengindeksan dalam satu permintaan HTTP.”* — Google Search Central, cara gunakan pengindeksan API. Jump untuk quote
• “…the URL must return a 404 or 410 status code or the page must contain” (terjemahan) “…URL harus mengembalikan kode status yang sesuai atau halaman harus berisi”* sebuah noindex meta tag — sebelum requesting removal. — Google Search Central, cara gunakan pengindeksan API. Jump untuk quote
• “An HTTP 200 response means that Google may try to recrawl this URL soon.” (terjemahan) “Respons HTTP tersebut berarti Google mungkin segera mencoba merayapi ulang URL ini.”* — Google Search Central, cara gunakan pengindeksan API (pada URL_UPDATED). Jump untuk quote

John Mueller, Google Search Advocate — Bluesky, ~dapat 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.” (terjemahan) “kami see sebuah lot dari spammers misuse pengindeksan API like ini, so I’d merekomendasikan hanya sticking untuk terdokumentasi & didukung gunakan-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.” (terjemahan) “I’d hanya gunakan ini properly, atau tidak gunakan ini. jika kami wanted untuk suggest itu orang dapat gunakan ini regardless, kami’d document ini sebagai such.” Baca coverage

John Mueller, Google — SEO office-hours, dapat 2022 ( “construction vehicles” (terjemahan) “kendaraan konstruksi” framing)

• “The indexing API is meant for very specific kinds of content. And using it for other kinds of content doesn’t really make sense.” (terjemahan) “ pengindeksan API adalah dimaksudkan untuk very spesifik jenis dari konten. dan menggunakan ini untuk lainnya jenis dari konten tidak benar-benar membuat sense.”
• “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.” (terjemahan) “ini adalah tidak itu ini adalah illegal atau itu ini akan penyebab masalah jika Anda put construction vehicles pada Anda medical situs web. tetapi ini tidak benar-benar membuat sense.” Baca coverage

pengindeksan API — cheat sheet

didukung gunakan cases (ini adalah seluruh list)

** dua metode**

Batching: combine up untuk 100 panggilan ke satu HTTP permintaan — quota masih counts per URL, tidak per batch.

Fast facts

• Default quota memiliki three bagian: 200 publish permintaan/day, 180 status (getMetadata) permintaan/minute, 380 permintaan/minute di seluruh semua endpoints. Quota beyond itu perlu Google’s approval dan dapat shift dengan document quality.
• 200 ≠ terindeks. sebuah success respons mengonfirmasi submission diterima, tidak ada apa pun lebih.
• Multiple accounts untuk beat quota = access revoked (per docs).
• Auth: Google Cloud project + service account + OAuth, cakupan https://www.googleapis.com/auth/indexing, service account ditambahkan sebagai sebuah GSC delegated owner.
• Tidak IndexNow (cross-mesin, tidak Google). Tidak sebuah replacement untuk sitemaps atau GSC permintaan pengindeksan.

sebuah minimal publish panggil (untuk didukung konten hanya)

ini adalah shape dari sebuah single URL_UPDATED notification. hanya gunakan ini untuk halaman dengan JobPosting atau BroadcastEvent data terstruktur — itu’s apa API adalah sanctioned untuk. auth langkah (exchanging Anda service-account key untuk sebuah OAuth token) adalah omitted untuk brevity; dalam praktik Anda’d gunakan Google API client library untuk mendapatkan token.

** permintaan**

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"
}

untuk sinyal sebuah removal (setelah halaman adalah hilang atau noindexed):

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

memeriksa status — note respons tells Anda hanya itu permintaan adalah diterima, tidak apakah apa pun adalah terindeks:

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

sebuah 200 di sini berarti “we mendapat Anda submission” (terjemahan) “kami mendapat Anda submission” — ini adalah tidak sebuah konfirmasi itu Google terindeks (atau dihapus) URL.

Batching multiple URLs: Anda dapat combine up untuk 100 individual panggilan ke sebuah single multi-bagian HTTP permintaan untuk https://indexing.googleapis.com/batch alih-alih firing 100 terpisah permintaan — tetapi quota adalah masih counted per URL, so sebuah 100-panggil batch masih menggunakan 100 permintaan dari Anda daily allowance. Google’s API client libraries (Java, Python, JavaScript, PHP,.NET) tangani batch formatting untuk Anda; hand-rolling ini adalah rarely worth ini.

pengindeksan API vs permintaan pengindeksan vs IndexNow

decision kerangka kerja: figure out apa Anda memiliki dan yang mesin Anda care tentang, lalu pick channel.

cara choose

1. Mendapat job postings atau livestreams, dan ingin untuk automate? → pengindeksan API.
2. ingin untuk push umum halaman untuk Bing/Yandex/Yep? → IndexNow.
3. ingin Google untuk recrawl satu wajar halaman, setelah? → GSC “Request indexing.” (terjemahan) “permintaan pengindeksan.”
4. ingin umum halaman terindeks di scale pada Google? → ada Tidak push button. Sitemaps + tautan internal + quality. (dan patience — see crawl frequency.)

** mental model:** pengindeksan API sounds like paling powerful dari three karena ini adalah sebuah API, tetapi oleh konten jenis ini adalah narrowest. Power dan cakupan tidak yang sama hal.

alat

• Google Cloud Console — buat project, enable pengindeksan API, dan generate service-account JSON key Anda’ll authenticate dengan.
• Google Search Console — pemeriksaan URL — untuk wajar halaman, ini adalah Anda nyata alat: periksa bagaimana sebuah URL adalah di-crawl/dirender/terindeks, dan gunakan “Request indexing” (terjemahan) “permintaan pengindeksan” untuk occasional satu-offs.
• Google Search Console — Sitemaps & Coverage — submit sitemaps dan see apa terindeks, “Discovered – saat ini tidak indexed,” (terjemahan) “ditemukan – saat ini tidak terindeks,” atau excluded.
• Google API client libraries — paling bersih cara untuk tangani OAuth token-exchange untuk pengindeksan API panggilan (alih-alih hand-rolling JWT signing).
• IndexNow integration (Ahrefs situs Audit, dan seterusnya.) — untuk cross-mesin push channel (Bing dan others, tidak Google). right alat ketika Anda ingin programmatic-push perilaku orang wish pengindeksan API gave them untuk umum halaman.

Resources worth Anda time

My related writing

• Apa adalah Googlebot & Bagaimana melakukan ini berfungsi? — di mana pengindeksan API sits among Google’s URL-penemuan sources (tautan, sitemaps, RSS, GSC, dan API).
• cara Perbaiki “Discovered – saat ini tidak indexed” (terjemahan) “ditemukan – saat ini tidak terindeks” — nyata “mengapa tidak akan my halaman index” (terjemahan) “mengapa tidak akan my halaman indeks” halaman; perbaiki adalah quality dan tautan internal, tidak sebuah push API.
• Beginner’s Guide untuk SEO teknis — di mana crawling dan pengindeksan fit di bigger picture.

My speaking

• Bagaimana Penelusuran berfungsi (SlideShare) — my walkthrough dari penemuan, crawling, rendering, pengindeksan, dan peringkat; URL-penemuan slide tags pengindeksan API “limited gunakan cases.” (terjemahan) “limited gunakan cases.” (My standing disclaimer applies: “Ini adalah my understanding dari sistem… tidak going untuk menjadi 100% menyelesaikan atau accurate.” (terjemahan) “ini adalah my understanding dari sistem… tidak going untuk menjadi 100% menyelesaikan atau accurate.”)

pada IndexNow ( cross-mesin sibling — note Google melakukan tidak gunakan ini)

• IndexNow integration di Ahrefs situs Audit — push channel I sebenarnya endorse, untuk Bing/Yandex/Yep alih-alih Google.
• cara submit halaman untuk IndexNow di dalam situs Audit.

dari others

• Google menambahkan Spam Warning untuk pengindeksan API Documentation (mesin pencari Journal, Sept 2024) — documents ketika spam-detection language went di.
• Google Again Says Berhenti menggunakan pengindeksan API untuk Unsupported konten (mesin pencari Roundtable, dapat 2025) — Barry Schwartz covers Mueller’s Bluesky warning untuk berhenti misusing API.
• Misuse dari pengindeksan API dapat Lead untuk SEO Issues (StanVentures, dapat 2025) — reproduces Mueller’s dapat 2025 Bluesky quotes verbatim dan menjelaskan access-revocation risk.
• Google jawaban Apakah menggunakan pengindeksan API untuk sebuah Wajar situs web adalah baik atau buruk (iLoveSEO, dapat 2022) — transcript dari Mueller’s “construction vehicles” (terjemahan) “kendaraan konstruksi” office-hours framing.
• Google Says -nya pengindeksan API adalah Inundated oleh Bloggers (Optimixed) — covers bagaimana off-label gunakan oleh bloggers dan SEOs memiliki overwhelmed API.
• r/TechSEO — community untuk crawl/indeks debugging.

umum issues

masalah orang sebenarnya jalankan ke dengan pengindeksan API, di symptom → penyebab → perbaiki order.

”I got a 200 response but the page still isn’t indexed” (terjemahan) “I mendapat sebuah 200 respons tetapi halaman masih tidak terindeks”

• Symptom: URL_UPDATED panggil (atau status GET) mengembalikan success, tetapi halaman tidak pernah menampilkan up di penelusuran, atau Search Console masih says “Discovered – currently not indexed.” (terjemahan) “ditemukan – saat ini tidak terindeks.”
• Penyebab: sebuah 200 hanya mengonfirmasi Google diterima notification. Per Google’s own docs, status endpoint “only returns whether you successfully submitted a request” (terjemahan) “hanya mengembalikan apakah Anda successfully submitted sebuah permintaan” — ini tidak tell Anda apakah apa pun adalah di-crawl, terindeks, atau dihapus.
• Perbaiki: Berhenti treating API respons sebagai sebuah pengindeksan konfirmasi. periksa sebenarnya pengindeksan status di pemeriksaan URL alat di Search Console, atau Coverage report. jika halaman masih tidak terindeks setelah sebuah reasonable tunggu, issue adalah penemuan/quality (see “What to do instead” (terjemahan) “Apa untuk melakukan alih-alih” di Advanced tab), tidak API panggil.

”My Indexing API access got revoked” (terjemahan) “My pengindeksan API access mendapat revoked”

• Symptom: panggilan itu digunakan untuk berfungsi mulai failing, atau Google Cloud/Penelusuran Console menampilkan service account’s access memiliki telah pulled.
• Penyebab: Google status plainly itu “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.” (terjemahan) “apa pun attempts untuk abuse pengindeksan API, including gunakan dari multiple accounts atau lainnya berarti untuk exceed usage quotas, dapat hasil di access menjadi revoked.” paling umum trigger adalah submitting non-JobPosting/non-BroadcastEvent halaman, atau spinning up extra service accounts untuk mendapatkan sekitar ~200/day default quota.
• Perbaiki: Audit apa Anda’ve telah submitting — jika ini adalah umum konten (blog posts, product halaman, apa pun tanpa JobPosting atau BroadcastEvent data terstruktur), berhenti. API adalah tidak terdokumentasi untuk mendukung ini, dan Mueller memiliki mengatakan secara langsung: “I’d just use it properly, or not use it.” (terjemahan) “I’d hanya gunakan ini properly, atau tidak gunakan ini.” ada Tidak terdokumentasi appeal path beyond staying di dalam didukung gunakan case going forward.

”Submissions for normal pages don’t seem to do anything” (terjemahan) “Submissions untuk wajar halaman jangan seem untuk melakukan apa pun”

• Symptom: Anda submit URL_UPDATED untuk sebuah regular artikel atau product halaman dan tidak ada apa pun perubahan — Tidak lebih cepat crawl, Tidak lebih cepat pengindeksan.
• Penyebab: konten jenis tidak satu dari dua Google mendukung. pengindeksan API “The Indexing API can only be used to crawl pages with either JobPosting or BroadcastEvent embedded in a VideoObject.” (terjemahan) “API Pengindeksan hanya dapat digunakan untuk merayapi halaman dengan jenis konten yang didukung secara resmi oleh Google.”* Submissions di luar itu cakupan tidak sebuah terdokumentasi, didukung sinyal.
• Perbaiki: ini tidak sebuah bug untuk perbaiki — ini adalah wrong alat. untuk umum halaman, gunakan sebuah sitemap, tautan internal, dan (untuk occasional satu-offs) “Request indexing” (terjemahan) “permintaan pengindeksan” di Search Console’s pemeriksaan URL alat alih-alih.

”I’m hitting the quota limit” (terjemahan) “I’m hitting quota limit”

• Symptom: Submissions mulai failing atau getting throttled — either sekitar 200/day, atau di lebih singkat bursts bahkan di bawah 200/day.
• Penyebab: Google sebenarnya enforces three terpisah default quotas: 200 publish (URL_UPDATED/URL_DELETED) permintaan per day, 180 status (getMetadata) permintaan per minute, dan 380 permintaan per minute di seluruh semua endpoints combined. sebuah burst dari status memeriksa dapat throttle Anda pada per-minute limits well sebelum Anda hit daily 200. Going beyond apa pun dari ini “requires additional approval for usage and resource provisioning,” (terjemahan) “memerlukan additional approval untuk usage dan resource provisioning,” dan Google notes granted quota “may increase or decrease based on the document quality.” (terjemahan) “dapat increase atau decrease berdasarkan document quality.”
• Perbaiki: jika Anda’re legitimately penerbitan/updating itu banyak JobPosting atau BroadcastEvent halaman sebuah day, permintaan sebuah quota increase melalui Google Cloud — jangan buat extra service accounts atau projects untuk berfungsi sekitar ini, since itu’s explicitly named sebagai jenis dari abuse itu mendapatkan access revoked.

Checklists

sebelum Anda touch pengindeksan API

• Konfirmasi halaman Anda ingin submit sebenarnya carry JobPosting data terstruktur, atau BroadcastEvent embedded di sebuah VideoObject — satu-satunya dua konten jenis Google mendukung.
• jika neither applies, berhenti di sini. gunakan sitemaps, tautan internal, konten quality, dan occasional GSC “Request indexing” (terjemahan) “permintaan pengindeksan” alih-alih — tidak API.
• Decide apakah Anda submission volume akan realistically fit di dalam default ~200/day quota, atau apakah Anda’ll perlu untuk permintaan sebuah increase.

Setting ini up

• buat (atau choose) sebuah Google Cloud project dan enable pengindeksan API di ini.
• buat service account dan download -nya JSON key file; store ini securely (tidak pernah commit ini untuk sebuah publik repo).
• Verify Anda situs di Search Console jika ini tidak sudah.
• tambahkan service account’s email sebagai sebuah delegated situs owner di Penelusuran Console.
• Konfirmasi Anda dapat exchange service-account key untuk sebuah OAuth token dengan cakupan https://www.googleapis.com/auth/indexing (typically melalui sebuah Google API client library alih-alih hand-rolled JWT signing).

Submitting sebuah notification

• Pick right metode: URL_UPDATED untuk sebuah baru atau changed didukung halaman, URL_DELETED setelah halaman adalah hilang atau noindexed.
• POST URL dengan correct type field untuk https://indexing.googleapis.com/v3/urlNotifications:publish.
• Treat sebuah 200 respons sebagai receipt konfirmasi hanya — tidak proof halaman adalah terindeks atau dihapus.
• ikuti up di Search Console (pemeriksaan URL atau Coverage) jika Anda perlu konfirmasi sebenarnya pengindeksan status.

Staying di dalam guidelines

• hanya submit JobPosting/BroadcastEvent halaman melalui ini API — tidak ada apa pun else.
• jangan buat multiple service accounts atau projects hanya untuk exceed quota; permintaan sebuah legitimate increase alih-alih.
• jika Anda’re tidak sure apakah sebuah halaman qualifies, treat itu sebagai “it tidak” (terjemahan) “ini tidak” dan gunakan sitemaps/tautan internal/permintaan pengindeksan untuk ini alih-alih.

Quiz

Five pertanyaan untuk periksa apa sebenarnya stuck tentang pengindeksan API.

Log perubahan