Reports: generate

Autorisierung erforderlich

Hiermit wird ein AdSense-Bericht basierend auf der Berichtanforderung erstellt, die in den Abfrageparametern gesendet wurde. Das Ergebnis wird im JSON-Format zurückgegeben. Geben Sie "alt=csv" als Abfrageparameter an, um eine Ausgabe im CSV-Format zu erhalten. Probieren Sie es aus.

Anfrage

HTTP-Anfrage

GET https://www.googleapis.com/adsense/v1.4/reports

Parameter

Parametername Wert Beschreibung
Erforderliche Abfrageparameter
endDate string Hiermit wird das Ende des Zeitraums für die Berichterstellung im Format "JJJJ-MM-TT" (einschließlich) angegeben.
startDate string Hiermit wird der Beginn des Zeitraums für die Berichterstellung im Format "JJJJ-MM-TT" (einschließlich) angegeben.
Optionale Abfrageparameter
accountId string Die Konten, für die ein Bericht erstellt werden soll
currency string Die optionale Währung für Berichte, die zu monetären Messwerten erstellt werden. Erfolgt keine Angabe, wird standardmäßig die Währung des Kontos verwendet.
dimension string Die Dimensionen, auf denen der Bericht basiert. Die verfügbaren Dimensionen sind unter Messwerte und Dimensionen aufgeführt. Weitere Informationen zu den einzelnen Dimensionen finden Sie im AdSense-Glossar.
filter string Die für den Bericht anzuwendenden Filter
locale string Optionale Sprache zur Übersetzung der Ausgabe des Berichts in eine lokale Sprache. Erfolgt keine Angabe, wird standardmäßig "en_US" verwendet.
maxResults integer Die maximale Anzahl an Zeilen mit zurückzugebenden Berichtdaten. Wenn "startIndex" nicht festgelegt oder null ist, werden mit der API so viele Zeilen zurückgegeben, wie mit dem Wert unter "maxResults" angegeben. Wenn "maxResults" nicht festgelegt ist, werden mit der API so viele Zeilen wie möglich zurückgegeben (bis zu 50.000). Wenn für "startIndex" nicht null eingestellt ist, darf die Summe von "startIndex" und "maxResults" nicht größer als 5.000 sein. Andernfalls wird folgender Fehler zurückgegeben: "paging past row 5000 is unsupported" (Seitenordnung über Zeile 5.000 hinaus nicht möglich). Zulässige Werte sind 0 bis 50000 (einschließlich).
metric string Die Messwerte, auf denen der Bericht basiert. Die verfügbaren Messwerte sind unter Messwerte und Dimensionen aufgeführt. Weitere Informationen zu den einzelnen Messwerten finden Sie im AdSense-Glossar.
sort string Der Name einer Dimension oder eines Messwerts, nach der bzw. dem der erstellte Bericht sortiert werden soll. Optional kann "+" oder "-" vorangestellt werden, um aufsteigend bzw. absteigend zu sortieren. Ist kein Präfix vorhanden, wird die Spalte aufsteigend sortiert.
startIndex integer Index der ersten Zeile mit Berichtdaten, die zurückgegeben werden sollen. Wenn "startIndex" nicht festgelegt oder null ist, werden mit der API so viele Zeilen zurückgegeben, wie mit dem Wert unter "maxResults" angegeben. Wenn "maxResults" nicht festgelegt ist, werden mit der API so viele Zeilen wie möglich zurückgegeben (bis zu 50.000). Wenn für "startIndex" nicht null eingestellt ist, darf die Summe von "startIndex" und "maxResults" nicht größer als 5.000 sein. Andernfalls wird folgender Fehler zurückgegeben: "paging past row 5.000 is unsupported" (Seitenordnung über Zeile 5.000 hinaus nicht möglich). Zulässige Werte sind 0 bis 5000 (einschließlich).
useTimezoneReporting boolean Gibt an, ob der Bericht in der lokalen Zeitzone des AdSense-Kontos generiert werden soll. Ist der Wert "false", wird die standardmäßige PST/PDT-Zeitzone verwendet.

Autorisierung

Für diese Anfrage ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich. Weitere Informationen zur Authentifizierung und Autorisierung

Bereich
https://www.googleapis.com/auth/adsense
https://www.googleapis.com/auth/adsense.readonly

Anfragetext

Geben Sie für diese Methode keinen Anfragetext an.

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode ein Antworttext mit folgender Struktur zurückgegeben:

JSON

{
  "kind": "adsense#report",
  "totalMatchedRows": long,
  "headers": [
    {
      "name": string,
      "type": string,
      "currency": string
    }
  ],
  "rows": [
    [
      string
    ]
  ],
  "totals": [
    string
  ],
  "averages": [
    string
  ],
  "warnings": [
    string
  ],
  "startDate": string,
  "endDate": string
}
Name der Eigenschaft Wert Beschreibung Hinweise
kind string Der Typ, in diesem Fall "adsense#report"
totalMatchedRows long Die Gesamtzahl der Zeilen, für die sich eine Übereinstimmung mit der Berichtanforderung ergibt. Möglicherweise werden in der Antwort weniger Zeilen zurückgegeben, weil eine Einschränkung durch die angeforderte Zeilenanzahl oder das Zeilenlimit des Berichts vorliegt.
headers[] list Die Kopfzeileninformationen der Spalten, die im Bericht angefordert werden. Dies ist eine Liste mit Kopfzeilen mit folgender Struktur: eine für jede Dimension in der Anfrage, gefolgt von einer Kopfzeile für jeden Messwert in der Anfrage.
headers[].name string Der Name der Kopfzeile
headers[].type string Der Typ der Kopfzeile. Mögliche Werte: DIMENSION, METRIC_TALLY, METRIC_RATIO oder METRIC_CURRENCY.

Zulässige Werte:
  • "DIMENSION":
  • "METRIC_CURRENCY":
  • "METRIC_RATIO":
  • "METRIC_TALLY":
headers[].currency string Die Währung der Spalte. Ist nur vorhanden, wenn der Kopfzeilentyp "METRIC_CURRENCY" lautet.
rows[] list Die Ausgabezeilen des Berichts. Jede Zeile besteht aus einer Liste von Zellen: eine für jede Dimension in der Anfrage, gefolgt von einer Zelle für jeden Messwert in der Anfrage. Die Dimensionszellen enthalten Strings und die Messwertzellen enthalten Zahlen.
totals[] list Die Gesamtsummen des Berichts. Entspricht der Länge der anderen Zeilen im Bericht. Zellen von Dimensionsspalten sind leer.
averages[] list Die Durchschnittswerte des Berichts. Entspricht der Länge der anderen Zeilen im Bericht. Zellen von Dimensionsspalten sind leer.
warnings[] list Sämtliche Warnungen, die mit der Berichterstellung in Verbindung stehen
startDate string Das angeforderte Startdatum im Format jjjj-mm-tt
endDate string Das angeforderte Enddatum im Format jjjj-mm-tt

CSV

"(dynamic)"
(foreach)
  string
(/foreach)
Name der Eigenschaft Wert Beschreibung Hinweise
(dynamic) string

Jetzt ausprobieren

Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Live-Daten aufzurufen und sich die Antwort anzusehen.