Diese Seite wurde von der Cloud Translation API übersetzt.

Versionshinweise

Auf dieser Seite finden Sie Versionshinweise für die AdSense Management API.

Version 2

Mit 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 Versionierungsschema der Google API wird diese Version im Laufe der Zeit aktualisiert, um zusätzliche (abwärtskompatible) Funktionen hinzuzufügen. Neue Funktionen werden nicht in separaten Nebenversionen veröffentlicht.

2025-02-24

PolicyIssues

Es wurde ein policyTopics[].type-Feld hinzugefügt, um anzugeben, ob ein Richtlinienthema einen Richtlinienverstoß, ein rechtliches Problem oder eine Einstellung des Werbetreibenden darstellt. Damit wird policyTopics[].must_fix ersetzt, das jetzt als eingestelltes Feld markiert ist.

2024-04-03

PolicyIssues

Es wurde eine neue Sammlung hinzugefügt, in der aktuelle Richtlinienverstöße und Warnungen für ein Konto aufgeführt werden.

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. Sie liefern Informationen zur Leistung von Anzeigenblöcken, die keine Anzeigen enthalten (z. B. ähnliche Suchblöcke).

2023-03-30

Berichte

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

2022-09-21

AdUnits

Es wurden die Methoden „create“ und „patch“ 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 „aktiv“ 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 Plattform-Publisher Messwerte nach den Konten des Publishers (Host-Publisher) und nach Unterkonten (Plattform-Publisher) aufschlüsseln.

2022-05-03

AdClient

Die Get-Methode wurde hinzugefügt.

Berichte

Die Methode „getSaved“ wurde hinzugefügt.

UrlChannels

Die Get-Methode wurde hinzugefügt.

2022-03-31

Konto

Inaktive Konten werden jetzt von der API mit einem state-Feld zurückgegeben, das den Status des Kontos angibt.

AdClient

Ähnlich wie bei den oben genannten Kontoänderungen werden jetzt auch inaktive Anzeigenkunden von der API zurückgegeben. Dabei gibt das Feld state den Status des Anzeigenclients an.

2022-02-24

Zahlung

Das Format für Ressourcennamen wurde erweitert, um separate Ressourcen für YouTube-Einnahmen zu unterstützen. Diese Änderung erfolgt vor der schrittweisen Einführung der verbesserten AdSense-Oberfläche für YouTube-Creator, bei der YouTube-Einnahmen in einem separaten Zahlungskonto erfasst werden. Zahlungsinformationen für YouTube werden auch über die Zahlungsliste zurückgegeben, sobald du ein eigenes Zahlungskonto für YouTube-Einnahmen hast. YouTube-Einnahmen haben das folgende Ressourcennamenformat:
- „accounts/{account}/payments/youtube-unpaid“ für noch nicht ausgezahlte (aktuelle) YouTube-Einnahmen.
- accounts/{account}/payments/youtube-yyyy-MM-dd für Einnahmen aus kostenpflichtigen YouTube-Inhalten
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 ausgezahlte AdSense-Einnahmen.

2021-06-30

Bericht

Die Dimensionen AD_FORMAT_NAME und AD_FORMAT_CODE wurden hinzugefügt. Sie geben an, wie eine Anzeige den Nutzern auf Ihrer Website präsentiert wird (z. B. In-Page-Anzeige oder Vignettenanzeige). In Version 1.4 gab es (veraltete) Dimensionen mit denselben Namen, aber unterschiedlichen Mitgliedern. Die beiden in Version 2 hinzugefügten Dimensionen unterscheiden sich von denen in Version 1.4.

19. April 2021 (erste Version)

Allgemein

Alle veralteten Methoden in Version 1.4 wurden entfernt. Dazu gehören auch Ressourcenmethoden, für die keine accountId erforderlich war. In Version 2 wird accountId im Feld parent angegeben.
Gemäß den Google API-Standards werden Ressourcen jetzt durch das Feld name identifiziert. Der Name eines AdClients könnte 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 ein reporting_dimension_id-Feld 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 in einen google.type.TimeZone geändert.
Das Feld creation_time (Typ „int64“) wurde in create_time (Typ google.protobuf.Timestamp) geändert.
Es wurde ein pending_tasks-Feld hinzugefügt, das eine Liste ausstehender Aufgaben enthält, die im Rahmen der Registrierung für ein neues Konto erledigt werden müssen. Aufgaben können sich beispielsweise auf Ihr Abrechnungsprofil oder die Bestätigung Ihrer Telefonnummer beziehen.
Das Feld sub_accounts wurde entfernt. In Version 2 kann eine ähnliche Funktion mit der benutzerdefinierten Methode listChildAccounts erreicht werden. Der vollständige untergeordnete Kontobaum kann in Version 2 generiert werden, indem listChildAccounts rekursiv aufgerufen wird.

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, die in der Berichtsdimension AD_CLIENT_ID verwendet wird. Wenn reporting_dimension_id leer ist, unterstützt der AdClient keine Berichte.

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 auf diesem 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 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 Vorwärts-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.
Das Feld payment_amount und das Feld payment_amount_currency_code wurden in ein einzelnes payment-Feld kombiniert (z.B. „1.235 JPY“, „1.234,57 $“, "87,65 £").

Bericht

Mit 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 über die 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.
Bei der Erstellung von Ad-hoc-Berichten wurden einige Felder 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.
- Mit date_range können Sie jetzt mehrere gängige Bereiche 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 Stringtyp in den Typ google.type.Date geändert. Hinweis: Daher werden Keywords mit relativen Zeiträumen (z.B. „today-6d“) werden nicht mehr unterstützt.
- Das boolesche Feld use_timezone_reporting wurde durch reporting_time_zone ersetzt, das einen der beiden Werte ACCOUNT_TIME_ZONE oder GOOGLE_TIME_ZONE (PST/PDT) haben kann. Der Standardwert in Version 2 ist ACCOUNT_TIME_ZONE. Dieser unterscheidet sich vom Standardwert in Version 1.4.
- Das Feld start_index wurde entfernt.
- Das Feld max_results wurde in limit umbenannt.
Bei der Generierung gespeicherter Berichte wurden einige Felder 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 oder NEEDS_ATTENTION.
Das Feld auto_ads_enabled ist ein boolescher Wert, der angibt, ob automatische Anzeigen auf einer bestimmten Website aktiviert sind.