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.