Diese Seite wurde von der Cloud Translation API übersetzt.

Versionshinweise

Diese Seite enthält Versionshinweise für die AdSense-Verwaltungs-API.

Version 2

Mit dieser Version werden die folgenden Änderungen eingeführt, um nicht mehr unterstützte Funktionen zu entfernen und die AdSense Management API an die aktuellen Google API-Standards anzupassen. Gemäß dem Versionsverwaltungsschema für die Google API wird diese Version im Laufe der Zeit aktualisiert, um zusätzliche (abwärtskompatible) Funktionen aufzunehmen, anstatt neue Funktionen in separaten Nebenversionen veröffentlicht zu haben.

2023-06-19

Zahlungen

payments.list gibt jetzt Details zu Zahlungen für Premium-Publisher zurück.

2023-06-13

Berichte

Die Messwerte FUNNEL_REQUESTS, FUNNEL_IMPRESSIONS, FUNNEL_CLICKS und FUNNEL_RPM wurden hinzugefügt, die Informationen zur Leistung von Anzeigenblöcken ohne Anzeigenblöcke (z. B. Anzeigenblöcke für ähnliche Suchanfragen) enthalten.

2023-03-30

Berichte

Die Dimension PAGE_URL wurde hinzugefügt, mit der Messwerte nach Seiten-URL aufgeschlüsselt werden können (mit einigen Einschränkungen siehe Aufschlüsselung der Seiten-URLs).

2022-09-21

AdUnits

Die Methoden zum Erstellen und Patchen wurden hinzugefügt. Diese Methoden können nur von Projekten verwendet werden, die für AdSense für Plattformen aktiviert sind.

CustomChannels

Es wurden die Methoden zum Erstellen, Patchen und Aktualisieren hinzugefügt. Diese Methoden können nur von Projekten verwendet werden, die für AdSense für Plattformen aktiviert sind.
Der Ressource wurde das aktive Feld hinzugefügt.

Konten

Die Methode „getAdBlockingRecoveryTag“ wurde hinzugefügt.

2022-08-25

Berichte

Die Dimension HOSTED_AD_CLIENT_ID wurde hinzugefügt, mit der Host- und Plattform-Publisher Messwerte nach den Konten ihrer Publisher (Host-Publisher) und nach Unterkonten (Plattform-Publisher) aufschlüsseln können.

2022-05-03

AdClient

Die get-Methode wurde hinzugefügt.

Berichte

Die getGespeicherte-Methode wurde hinzugefügt.

UrlChannels

Die get-Methode wurde hinzugefügt.

2022-03-31

Konto

Inaktive Konten werden jetzt von der API zurückgegeben. Das Feld state enthält den Status des Kontos.

AdClient

Ähnlich wie bei den oben genannten Kontoänderungen werden jetzt inaktive Ad-Clients von der API zurückgegeben. Das Feld state enthält den Status des Ad-Clients.

2022-02-24

Zahlung

Das Format von Ressourcennamen wurde erweitert, um separate Ressourcen für YouTube-Einnahmen zu unterstützen. Diese Änderung erfolgt vor der stufenweisen Einführung der verbesserten AdSense-Oberfläche für YouTube-Creator, bei der YouTube-Einnahmen einem eigenen Zahlungskonto zugeordnet werden. Die YouTube-Zahlungsinformationen werden auch über die Methode der Zahlungsliste zurückgegeben, sobald du ein spezielles Zahlungskonto für YouTube-Einnahmen hast. YouTube-Einnahmen haben folgendes Format für Ressourcennamen:
- accounts/{account}/payments/youtube-unpaid für unbezahlte (aktuelle) YouTube-Einnahmen.
- accounts/{account}/payments/youtube-yyyy-MM-dd für bezahlte YouTube-Einnahmen.
Hinweis:Die Ressourcennamen für AdSense-Einnahmen bleiben unverändert:
- accounts/{account}/payments/unpaid für unbezahlte (aktuelle) AdSense-Einnahmen.
- accounts/{account}/payments/yyyy-MM-dd für bezahlte AdSense-Einnahmen.

2021-06-30

Bericht

Die Dimensionen AD_FORMAT_NAME und AD_FORMAT_CODE wurden hinzugefügt, um anzugeben, wie Nutzern auf Ihrer Website eine Anzeige präsentiert wird (In-Page, Vignetten usw.). In Version 1.4 wurden Dimensionen mit demselben Namen, aber unterschiedlichen Mitgliedern nicht mehr unterstützt. Die beiden Dimensionen, die in Version 2 hinzugefügt wurden, unterscheiden sich von denen in Version 1.4.

19.04.2021 (Erste Version)

Allgemein

Alle in v1.4 eingestellten Methoden wurden entfernt. Dazu gehören Ressourcenmethoden, für die kein accountId erforderlich war. In v2 wird accountId im Feld parent angegeben.
Gemäß den Google API-Standards werden Ressourcen jetzt durch das Feld name gekennzeichnet. Der Name eines AdClients würde beispielsweise so aussehen: accounts/{accountId}/adclients/{adClientId}. Außerdem wurde in Version 1.4 die Ressourcen-ID als Berichtsdimension verwendet. In Version 2 ist dieser Wert jetzt für mehrere Ressourcen über ein reporting_dimension_id-Feld verfügbar.
Das Feld kind wurde aus allen Ressourcen entfernt.

Konto

Das Feld name wurde in display_name geändert.
Das Feld timezone wurde von einem String in einen google.type.TimeZone-Wert geändert.
Das Feld creation_time (Typ int64) wurde in create_time (Typ google.protobuf.Timestamp) geändert.
Das Feld pending_tasks wurde hinzugefügt. Es enthält eine Liste ausstehender Aufgaben, die im Rahmen der Registrierung für ein neues Konto erledigt werden müssen. Aufgaben können z. B. mit Ihrem Abrechnungsprofil oder der telefonischen Bestätigung zusammenhängen.
Das Feld sub_accounts wurde entfernt. Eine ähnliche Funktionalität wird in Version 2 mit der benutzerdefinierten Methode listChildAccounts realisiert. Die vollständige Struktur des untergeordneten Kontos kann in Version 2 durch rekursives Aufrufen von listChildAccounts generiert werden.

AdClient

Das Feld arc_opt_in wurde entfernt, da es bereits von der AdSense-Benutzeroberfläche entfernt wurde.
Das Feld supports_reporting wird durch das Feld reporting_dimension_id ersetzt. Es steht für die eindeutige ID des Ad-Clients, die in der Berichtsdimension AD_CLIENT_ID verwendet wird. Ist reporting_dimension_id leer, unterstützt der AdClient keine Berichterstellung.

AdUnit

Das Feld status wurde in state umbenannt. Außerdem gibt der Status ACTIVE nicht mehr an, ob in den letzten sieben Tagen Aktivitäten für diesen Anzeigenblock stattgefunden haben. In Version 2 bedeutet dies, dass der Anzeigenblock vom Nutzer aktiviert wurde und Anzeigen ausliefern können.
Das Feld code wurde entfernt. Dieser Wert befindet sich weiterhin am Ende des Felds name (nach dem letzten Schrägstrich).
Das Feld contentAdsSettings.backupOption wurde entfernt.
Das Feld type wurde auf die Werte TYPE_UNSPECIFIED, DISPLAY, FEED, ARTICLE, MATCHED_CONTENT und LINK beschränkt.
Andere Felder, die bereits in der AdSense-Benutzeroberfläche entfernt wurden, werden ebenfalls entfernt: custom_style, saved_style_id, mobile_content_ads_settings und feed_ads_settings.

Benachrichtigung

Die Methode delete wurde entfernt.
Das Feld is_dismissible wurde entfernt.
Das Feld locale wurde in language_code umbenannt.

CustomChannel

Das Feld code wurde entfernt. Dieser Wert befindet sich weiterhin am Ende des Felds name (nach dem letzten Schrägstrich).
Das Feld „targeting_info“ wurde entfernt, da es bereits aus der AdSense-Benutzeroberfläche entfernt wurde.

Zahlung

Das Feld payment_date wurde in date umbenannt und vom Typ „String“ in den Typ google.type.Date geändert.
Die Felder payment_amount und payment_amount_currency_code wurden zu einem einzigen payment-Feld zusammengefasst (z.B. „1.235 JPY“, „1.234,57 $“, „87,65 £“).

Bericht

In Version 2 entsprechen die Berichtsdaten der AdSense Management API jetzt der AdSense-Benutzeroberfläche. Das bedeutet, dass AdMob- und YouTube-Properties nicht mehr unterstützt werden. Außerdem unterstützt die API nur Berichtsdaten, die bis zu drei Jahre zurückreichen.
Die Ressourcen Metadata.dimensions und Metadata.metrics wurden entfernt.
Es wurden neue Methoden zum Generieren einer CSV-Version des Berichts hinzugefügt, die die Abfrageparameter in Version 1.4 ersetzt. Hinweis: Für die Komprimierung können Sie weiterhin den HTTP-Header „Accept-Encoding: gzip“ verwenden.
Einige Felder wurden bei der Ad-hoc-Berichterstellung geändert.
- Das Feld account_id wurde in account umbenannt.
- Das Feld dimension wurde in dimensions umbenannt.
- Das Feld metric wurde in metrics umbenannt.
- Das Feld filter wurde in filters umbenannt.
- Das Feld sort wurde in order_by umbenannt.
- Das Feld locale wurde in language_code umbenannt.
- Das Feld currency wurde in currency_code umbenannt.
- Sie können jetzt mit date_range mehrere gemeinsame Bereiche angeben (z.B. TODAY, YESTERDAY, MONTH_TO_DATE, YEAR_TO_DATE, LAST_7_DAYS und LAST_30_DAYS. Sie können auch start_date und end_date angeben, indem Sie date_range auf CUSTOM setzen.
- Die Felder start_date und end_date wurden von Typ String in Typ google.type.Date geändert. Hinweis: Daher können relative Datums-Keywords (z.B. „today-6d“), nicht mehr unterstützt.
- Das boolesche Feld use_timezone_reporting wurde durch reporting_time_zone ersetzt, das einen von zwei Werten haben kann: ACCOUNT_TIME_ZONE oder GOOGLE_TIME_ZONE (für PST/PDT). Der Standardwert in v2 ist ACCOUNT_TIME_ZONE, was sich vom Standard in v1.4 unterscheidet.
- Das Feld start_index wurde entfernt.
- Das Feld max_results wurde in limit umbenannt.
Einige Felder wurden bei der Erstellung gespeicherter Berichte geändert.
- Datumsfelder (date_range, start_date, end_date, reporting_time_zone) wurden hinzugefügt.
- Das Feld currency_code wurde hinzugefügt.
- Das Feld locale wurde in language_code umbenannt.
- Das Feld start_index wurde entfernt.
- Das Feld max_results wurde entfernt.

SavedAdStyle

SavedAdStyle wurde entfernt, da es bereits aus der AdSense-Benutzeroberfläche entfernt wurde.

Website

Sites wurden hinzugefügt, um Daten zu Websites abzurufen, die du deinem AdSense-Konto hinzugefügt hast.
Mit dem Feld state wird angegeben, ob die Website einen der folgenden Status hat: REQUIRES_REVIEW, GETTING_READY, READY, NEEDS_ATTENTION.
Das Feld auto_ads_enabled enthält einen booleschen Wert, der angibt, ob automatische Anzeigen auf einer bestimmten Website aktiviert wurden.