Diese Seite wurde von der Cloud Translation API übersetzt.

Versionshinweise

Diese Seite enthält Versionshinweise zur AdSense-Verwaltungs-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 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 werden.

2024-04-03

PolicyIssues

Es wurde eine neue Sammlung mit Informationen zu aktuellen Richtlinienverstößen und Warnungen für ein Konto hinzugefügt.

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 Nicht-Anzeigenblöcken enthalten, z. B. von Anzeigenblöcken für ähnliche Suchanfragen.

2023-03-30

Berichte

Die Dimension PAGE_URL wurde hinzugefügt, mit der Messwerte nach Seiten-URL aufgeschlüsselt werden können. Es gibt jedoch einige Einschränkungen im Abschnitt Aufschlüsselung nach Seiten-URL.

2022-09-21

AdUnits

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

Die Methoden zum Erstellen, Patchen und Aktualisieren wurden 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 getSaved-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 gibt den Status des Kontos an.

AdClient

Ähnlich wie bei den oben genannten Kontoänderungen werden inaktive Ad-Clients jetzt von der API mit einem state-Feld zurückgegeben, das den Status des Ad-Clients angibt.

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 stufenweisen Einführung der verbesserten AdSense-Nutzung für YouTube-Creator, bei der YouTube-Einnahmen einem eigenen Zahlungskonto zugeordnet werden. Wenn du ein spezielles Zahlungskonto für YouTube-Einnahmen hast, werden auch YouTube-Zahlungsinformationen über die Zahlungsmethode zurückgegeben. YouTube-Einnahmen haben das folgende Format für Ressourcennamen:
- accounts/{account}/payments/youtube-unpaid für unbezahlte (aktuelle) YouTube-Einnahmen.
- accounts/{account}/payments/youtube-yyyy-MM-dd für gezahlte YouTube-Einnahmen.
Hinweis:Die Ressourcennamen für AdSense-Einnahmen bleiben unverändert:
- accounts/{account}/payments/unpaid für nicht gezahlte (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, die angeben, wie eine Anzeige den Nutzern auf Ihrer Website präsentiert wird (In-Page, Vignetten usw.). Hinweis: In Version 1.4 wurden Dimensionen mit denselben Namen, aber unterschiedlichen Elementen (nicht mehr unterstützt) verwendet. Die Dimensionen, die in Version 2 hinzugefügt wurden, unterscheiden sich von denen in Version 1.4.

19.04.2021 (Erste Version)

Allgemein

Alle eingestellten Methoden in v1.4 wurden entfernt. Dazu gehören auch Ressourcenmethoden, für die kein accountId erforderlich war. In v2 wird accountId im Feld parent angegeben.
Gemäß Google API-Standards werden Ressourcen jetzt durch ein name-Feld identifiziert. 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, aber 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-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 der ausstehenden Aufgaben, die im Rahmen der Registrierung für ein neues Konto erledigt werden müssen. Aufgaben können sich z. B. auf das Abrechnungsprofil oder auf die Bestätigung der Telefonnummer beziehen.
Das Feld „sub_accounts“ wurde entfernt. Eine ähnliche Funktionalität ist in v2 mit der benutzerdefinierten Methode listChildAccounts verfügbar. Die vollständige Baumstruktur 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 in Bezug auf diesen Anzeigenblock stattgefunden haben. In v2 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 auf 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 von 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. AdMob- und YouTube-Properties werden daher nicht mehr unterstützt. Außerdem unterstützt die API nur Berichtsdaten, die bis zu drei Jahre zurückliegen.
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 ersetzen. 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) oder Sie geben start_date und end_date an, indem Sie date_range auf CUSTOM setzen.
- Die Felder start_date und end_date wurden von Typstring 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 entweder 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 Standardwert in v1.4 unterscheidet.
- 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 (date_range, start_date, end_date, reporting_time_zone) 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 von der AdSense-Benutzeroberfläche entfernt wurde.

Website

Sites wurden hinzugefügt, um Daten über 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 ist ein boolescher Wert, der angibt, ob automatische Anzeigen auf einer bestimmten Website aktiviert wurden.