Aktualisierungen der Search Console API

Mittwoch, 9. Dezember 2020

Vor einigen Monaten haben wir ein Upgrade der API-Infrastruktur bekannt gegeben, mit dem wegen steigender Nachfrage die Leistung der Search Console API verbessert wurde. Heute haben wir weitere Neuigkeiten über Aktualisierungen der API für euch:

  • Neuer Filter für aktuelle Daten und Nachrichten in der Search Console API
  • Unterstützung für Domain-Properties in der Sitemaps API
  • Richtlinien für die Migration des Discovery-Dokuments

Im Folgenden findet ihr weitere Informationen zu API-Aufrufen.

Filter für aktuelle Daten und Nachrichten in der Search Console API

Der Leistungsbericht unterstützt bereits aktuelle Daten, die weniger als einen Tag alt sind. Ihr könnt jetzt über die API auf diese Daten zugreifen. Dazu müsst ihr den Anfrageparameter dataState mit dem Wert all angeben. Die Daten, die ihr für diesen Wert bekommt, enthalten auch aktuelle Daten, die noch nicht endgültig sind. Wenn ihr nur endgültige Daten abrufen möchtet, könnt ihr diesen Parameter entweder mit dem Wert final oder gar nicht angeben. Dann erhaltet ihr standardmäßig nur die endgültigen Daten.

Vor einigen Monaten haben wir dem Leistungsbericht den Tab „News“ im Suchfilter hinzugefügt. Diese Informationen sind jetzt auch in der API verfügbar. Dazu müsst ihr für den Parameter searchType in der Anfrage den Wert news festlegen.

Unterstützung für Domain-Properties in der Sitemaps API

Die Sitemaps API unterstützt jetzt Domain-Properties, wie dies bereits bei anderen Search Console-APIs der Fall ist. Ihr könnt eure Sitemaps für Domain-Properties abfragen, hinzufügen und löschen. Beispiel:

GET https://www.googleapis.com/webmasters/v3/sites/sc-domain:example.com/sitemaps

Migration des Discovery-Dokuments

Die Unterstützung wird im Discovery-Dokument der Webmaster API eingestellt. Wenn ihr die Search Console API mithilfe einer externen API-Bibliothek oder das Discovery-Dokument der Webmaster API direkt abfragt, müsst ihr eure API-Aufrufe aktualisieren, um die folgenden Änderungen vorzunehmen:

Änderungen an der API-Bibliothek

Informationen zu aktualisierten Änderungen der API-Bibliothek sowie zur API-Verwendung findet ihr in den Kurzanleitungen für Java und Python.

Java

Für alle dienstleistungsrelevanten Importe von Webmastern müsst ihr das webmasters-Paket zum searchconsole.v1-Paket ändern und den Dienstnamen von Webmasters in SearchConsole. Beispiele:

  • API-Dienst importieren:

    import com.google.api.services.webmasters.Webmasters;

    import com.google.api.services.searchconsole.v1.SearchConsole;

  • Antwortobjekt importieren:

    import com.google.api.services.webmasters.model.WmxSite;

    import com.google.api.services.searchconsole.v1.model.WmxSite;

Die anderen API-Objekte sind abgesehen vom Dienstobjekt dieselben wie zuvor, nur das Paket ändert sich.

Python

Nehmt beim Erstellen des Objekts für den Webmaster-Dienst folgende Änderung vor:

webmasters_service = build('webmasters', 'v3', http=http)

webmasters_service = build('searchconsole', 'v1', http=http)

Auch hier ändert sich das Verhalten von Objekten nicht.

Direkte Abfrage des Discovery-Dokuments

Die Änderungen der Abfrage des Discovery-Dokuments umfassen Folgendes:

  • Änderung der URL

    https://www.googleapis.com/discovery/v1/apis/webmasters/v3/rest

    https://searchconsole.googleapis.com/$discovery/rest

  • Inhaltsänderung
    • Das Feld name wurde von webmasters zu searchconsole geändert.
    • Das Feld version wurde von v3 zu v1 geändert.

Eure Fragen könnt ihr uns einfach in der Community von Google Search Central oder auf Twitter stellen.

Beitrag von Nati Yosephian, Gilad Amar und Michael Huzman, Search Console-Team