Diese Seite wurde von der Cloud Translation API übersetzt.

Versionshinweise

Auf dieser Seite finden Sie Versionshinweise zur AdSense Management API.

Version 2

In dieser Version werden die folgenden Änderungen eingeführt, um eingestellte Funktionen zu entfernen und die AdSense Management API an die aktuellen Google-API-Standards anzupassen. Gemäß dem Google-API-Versionsschema wird diese Version im Laufe der Zeit aktualisiert, um zusätzliche (abwärtskompatible) Funktionen zu enthalten. Neue Funktionen werden nicht in separaten Nebenversionen veröffentlicht.

2025-10-02

Berichte

Die Dimension TRAFFIC_SOURCE wurde hinzugefügt. Damit lassen sich Messwerte nach Zugriffsquelle aufschlüsseln, z. B. „Google“, „Bing“, „Facebook“ oder „Andere“. Weitere Informationen finden Sie unter Aufschlüsselung nach Traffic-Quelle.

2025-05-06

PolicyIssues

Das eingestellte Feld policyTopics[].must_fix (siehe vorherige Aktualisierung) wird jetzt immer auf false gesetzt.

2025-02-24

PolicyIssues

Es wurde ein policyTopics[].type-Feld hinzugefügt, um anzugeben, ob ein Richtlinienthema ein Richtlinienproblem, ein rechtliches Problem oder eine Einstellung des Werbetreibenden darstellt. Dieses Feld ersetzt policyTopics[].must_fix, das jetzt als verworfenes Feld markiert ist.

2024-04-03

PolicyIssues

Es wurde eine neue Sammlung hinzugefügt, mit der Sie Berichte zu aktuellen Richtlinienverstößen und Warnungen für ein Konto erstellen können.

2023-06-19

Zahlungen

Mit payments.list werden jetzt Details zu Zahlungen für Premium-Publisher zurückgegeben.

2023-06-13

Berichte

Die Messwerte FUNNEL_REQUESTS, FUNNEL_IMPRESSIONS, FUNNEL_CLICKS und FUNNEL_RPM wurden hinzugefügt. Sie liefern Informationen zur Leistung von Anzeigenblöcken, die keine Anzeigen enthalten, z. B. Einheiten für die zugehörige Suche.

2023-03-30

Berichte

Die Dimension PAGE_URL wurde hinzugefügt. Damit lassen sich Messwerte nach Seiten-URL aufschlüsseln (mit einigen Einschränkungen, siehe Aufschlüsselung nach Seiten-URL).

2022-09-21

AdUnits

Die Methoden „create“ und „patch“ wurden hinzugefügt. Diese Methoden können nur für Projekte verwendet werden, für die das Produkt AdSense für Plattformen aktiviert ist.

CustomChannels

Die Methoden „create“, „patch“ und „update“ wurden hinzugefügt. Diese Methoden können nur für Projekte verwendet werden, für die das Produkt AdSense für Plattformen aktiviert ist.
Der Ressource wurde das Feld „active“ hinzugefügt.

Konten

Die Methode „getAdBlockingRecoveryTag“ wurde hinzugefügt.

2022-08-25

Berichte

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

2022-05-03

AdClient

Die Methode „get“ wurde hinzugefügt.

Berichte

Die Methode „getSaved“ wurde hinzugefügt.

UrlChannels

Die Methode „get“ wurde hinzugefügt.

2022-03-31

Konto

Inaktive Konten werden jetzt von der API zurückgegeben. Das Feld state gibt den Status des Kontos an.

AdClient

Ähnlich wie bei den Kontoänderungen werden inaktive AdSense-Clients jetzt von der API zurückgegeben. Das Feld state gibt den Status des AdSense-Clients an.

2022-02-24

Zahlung

Das Format der Ressourcennamen wurde erweitert, um separate Ressourcen für YouTube-Einnahmen zu unterstützen. Diese Änderung erfolgt vor der schrittweisen Einführung der verbesserten AdSense-Nutzung für YouTube-Creator, bei der YouTube-Einnahmen in einem separaten Zahlungskonto ausgewiesen werden. YouTube-Zahlungsinformationen werden auch über die Methode „payments.list“ zurückgegeben, sobald du ein eigenes Zahlungskonto für YouTube-Einnahmen hast. YouTube-Einnahmen haben das folgende Ressourcenname-Format:
- accounts/{account}/payments/youtube-unpaid für nicht ausgezahlte (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 ausstehende (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. Sie geben an, wie eine Anzeige Nutzern auf Ihrer Website präsentiert wird (z. B. auf der Seite oder als Vignette). In Version 1.4 gab es Dimensionen mit denselben Namen, aber unterschiedlichen Elementen. Die beiden in Version 2 hinzugefügten Dimensionen unterscheiden sich von denen in Version 1.4.

19.04.2021 (Erste Version)

Allgemein

Alle veralteten Methoden in Version 1.4 wurden entfernt. Dazu gehören Ressourcenmethoden, für die kein accountId erforderlich war. In Version 2 wird die accountId im Feld parent angegeben.
Gemäß den Google API-Standards werden Ressourcen jetzt durch das Feld name identifiziert. Der Name eines AdClient-Objekts 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 über das Feld reporting_dimension_id für mehrere Ressourcen 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 zu einem google.type.TimeZone 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 der ausstehenden Aufgaben, die im Rahmen der Registrierung für ein neues Konto erledigt werden müssen. Aufgaben können sich beispielsweise auf Ihr Abrechnungsprofil oder die Telefonbestätigung beziehen.
Das Feld sub_accounts wurde entfernt. Eine ähnliche Funktion kann in Version 2 mit der benutzerdefinierten Methode listChildAccounts erreicht werden. Der vollständige Baum 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 aus der AdSense-Benutzeroberfläche entfernt wurde.
Das Feld supports_reporting wird durch das Feld reporting_dimension_id ersetzt, das die eindeutige ID des Anzeigenclients darstellt, wie sie in der Berichtsdimension AD_CLIENT_ID verwendet wird. Wenn reporting_dimension_id leer ist, 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 das, dass der Anzeigenblock vom Nutzer aktiviert wurde und Anzeigen ausgeliefert werden können.
Das Feld code wurde entfernt. Dieser Wert ist weiterhin am Ende des Felds name (nach dem letzten Schrägstrich) zu finden.
Das Feld contentAdsSettings.backupOption wurde entfernt.
Das Feld type ist auf die Werte TYPE_UNSPECIFIED, DISPLAY, FEED, ARTICLE, MATCHED_CONTENT und LINK beschränkt.
Andere Felder, die bereits aus der AdSense-Benutzeroberfläche entfernt wurden, werden ebenfalls entfernt: custom_style, saved_style_id, mobile_content_ads_settings, 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 ist weiterhin am Ende des Felds name (nach dem letzten Schrägstrich) zu finden.
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 der Typ wurde von „String“ in google.type.Date geändert.
Das Feld payment_amount und das Feld payment_amount_currency_code wurden in einem einzigen Feld payment zusammengefasst (z.B. „¥1.235 JPY“, „$1.234,57“, „£87,65“).

Bericht

In Version 2 stimmen die Berichtsdaten der AdSense Management API jetzt mit der AdSense-Benutzeroberfläche überein. Das bedeutet, dass AdMob- und YouTube-Properties nicht mehr unterstützt werden. Außerdem werden in der API nur Berichtsdaten der letzten drei Jahre unterstützt.
Die Ressource Metadata.dimensions und die Ressource Metadata.metrics wurden entfernt.
Es wurden neue Methoden zum Generieren einer CSV-Version des Berichts hinzugefügt, die die Abfrageparameter in Version 1.4 ersetzen. Hinweis: Für die Komprimierung können Sie weiterhin den HTTP-Header „Accept-Encoding: gzip“ verwenden.
Einige Felder wurden bei der Erstellung von Ad-hoc-Berichten 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 mehrere gemeinsame Bereiche mit date_range angeben (z.B. TODAY, YESTERDAY, MONTH_TO_DATE, YEAR_TO_DATE, LAST_7_DAYS und LAST_30_DAYS) oder Sie können start_date und end_date angeben, indem Sie date_range auf CUSTOM festlegen.
- Die Felder start_date und end_date wurden vom Typ „String“ in den Typ google.type.Date geändert. Hinweis: Daher werden relative Datums-Keywords (z.B. „today-6d“) werden 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 (was PST/PDT bedeutet). Der Standardwert in Version 2 ist ACCOUNT_TIME_ZONE. Das unterscheidet sich vom Standardwert in Version 1.4.
- Das Feld start_index wurde entfernt.
- Das Feld max_results wurde in limit umbenannt.
Einige Felder wurden bei der Generierung gespeicherter Berichte geändert.
- Datumsfelder hinzugefügt (date_range, start_date, end_date, reporting_time_zone).
- 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 Sie Ihrem AdSense-Konto hinzugefügt haben.
Das Feld state gibt an, ob sich die Website in einem der folgenden Status befindet: REQUIRES_REVIEW, GETTING_READY, READY, NEEDS_ATTENTION.
Das Feld auto_ads_enabled ist ein boolescher Wert, der angibt, ob automatische Anzeigen auf einer bestimmten Website aktiviert wurden.