English

Die Google Indexing API ist eine Programmierschnittstelle, über die Website-Betreiber Google melden, dass sich eine URL geändert hat oder gelöscht wurde. Google darf die Seite dann zeitnah neu crawlen.

Wofür darf man die Indexing API nutzen?

Laut Google ist die API ausschließlich für Seiten mit strukturierten Daten vom Typ JobPosting oder BroadcastEvent gedacht, wobei BroadcastEvent in ein VideoObject eingebettet ist. Das sind Inhalte, die kurzlebig sind und deren Aktualität zählt, etwa Stellenanzeigen und Livestreams.

Es gibt zwei Meldungsarten. URL_UPDATED meldet eine neue oder geänderte URL, URL_DELETED eine entfernte. Die Nutzung ist kostenlos. Das Standardkontingent liegt bei 200 Veröffentlichungsanfragen pro Tag und Projekt, bis zu 100 Aufrufe lassen sich in einer Batch-Anfrage bündeln. Mehr Kontingent gibt es nur nach einem Antrag und nur für Seiten mit den beiden Markup-Typen. Laut Google kann das Kontingent je nach Qualität der Dokumente steigen oder sinken.

Für normale Seiten wie Artikel, Produktseiten oder Kategorien ist die API nicht vorgesehen. Für eingereichte Inhalte gelten Googles Spam-Richtlinien. Wer die API missbraucht, etwa mit mehreren Konten zur Umgehung des Kontingents, riskiert laut Google den Entzug des Zugangs. Für andere Seiten bleiben Sitemaps und die URL-Prüfung in der Search Console.

Beispiel

Eine Jobbörse meldet eine neue Stellenanzeige per POST an die Schnittstelle:

JSON
{
  "url": "https://www.example.com/jobs/seo-manager",
  "type": "URL_UPDATED"
}

Der Aufruf geht an den Endpunkt https://indexing.googleapis.com/v3/urlNotifications:publish Voraussetzung sind ein Google-Cloud-Projekt mit aktivierter API und ein Dienstkonto, das in der Search Console als Inhaber der Property eingetragen ist.

Häufige Fehler

  • Nicht unterstützte Seitentypen. Die API ist laut Google nur für Seiten mit JobPosting oder mit BroadcastEvent in einem VideoObject vorgesehen.
  • Falscher Content-Type. Alle Aufrufe an den Endpunkt müssen application/json als Content-Type senden.
  • Löschmeldung für eine erreichbare Seite. Vor URL_DELETED muss die URL 404 oder 410 liefern oder ein noindex-Tag tragen.
  • Kontingent umgehen. Google weist ausdrücklich darauf hin, die Limits nicht zu umgehen, etwa mit mehreren Konten.

Häufige Fragen

Was ist die Google Indexing API? Eine Schnittstelle, mit der Betreiber Google über neue, geänderte oder gelöschte Seiten mit JobPosting- oder BroadcastEvent-Markup informieren.

Kann man jede Seite per Indexing API melden? Laut Google ist sie nur für Seiten mit JobPosting- oder BroadcastEvent-Markup vorgesehen. Anleitungen, die sie für beliebige Seiten empfehlen, widersprechen der Google-Dokumentation. Eine Meldung fordert außerdem nur zum Crawlen auf und garantiert keine Indexierung.

Quellen

  1. Indexing API Quickstart – Google Search Centraldevelopers.google.com
  2. Indexing API verwenden – Google Search Centraldevelopers.google.com
  3. Kontingente und Preise der Indexing API – Google Search Centraldevelopers.google.com
  4. Google bitten, URLs noch einmal zu crawlen – Google Search Centraldevelopers.google.com

Stand: