Search Analytics

Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.

Ressourcendarstellungen

Mit dieser Ressource sind keine nichtflüchtigen Daten verknüpft.

Methoden

query

Sie können Ihre Daten zu Suchzugriffen mit von Ihnen definierten Filtern und Parametern abfragen. Die Methode gibt null oder mehr Zeilen zurück, die nach den von Ihnen definierten Zeilenschlüsseln (Dimensionen) gruppiert sind. Sie müssen einen Datumsbereich von einem oder mehreren Tagen festlegen.

Wenn „Datum“ eine der Dimensionen ist, werden alle Tage ohne Daten aus der Ergebnisliste ausgeschlossen. Um zu erfahren, für welche Tage Daten verfügbar sind, geben Sie für den gewünschten Zeitraum eine Abfrage ohne nach Datum gruppierte Filter aus.

Die Ergebnisse werden absteigend nach der Anzahl der Klicks sortiert. Wenn zwei Zeilen die gleiche Anzahl an Klicks aufweisen, werden sie beliebig sortiert.

Informationen zum Aufrufen dieser Methode finden Sie im Python-Beispiel.

Die API unterliegt internen Einschränkungen der Search Console und gibt keine Garantie dafür, dass alle Datenzeilen zurückgegeben werden, sondern nur die obersten.

Hier finden Sie Informationen zu den Limits für die verfügbare Datenmenge.

Beispiel für JSON POST:
POST https://www.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fwww.example.com%2F/searchAnalytics/query?key={MY_API_KEY}
{
  "startDate": "2015-04-01",
  "endDate": "2015-05-01",
  "dimensions": ["country","device"]
}