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
undFUNNEL_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
undAD_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 wirdaccountId
im Feldparent
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 einreporting_dimension_id
-Feld für mehrere Ressourcen verfügbar. - Das Feld
kind
wurde aus allen Ressourcen entfernt.
Konto
- Das Feld
name
wurde indisplay_name
geändert. - Das Feld
timezone
wurde von einem String in einengoogle.type.TimeZone
-Wert geändert. - Das Feld
creation_time
(Typ int64) wurde increate_time
(Typgoogle.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 MethodelistChildAccounts
verfügbar. Die vollständige Baumstruktur des untergeordneten Kontos kann in Version 2 durch rekursives Aufrufen vonlistChildAccounts
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 Feldreporting_dimension_id
ersetzt. Es steht für die eindeutige ID des Ad-Clients, die in der BerichtsdimensionAD_CLIENT_ID
verwendet wird. Istreporting_dimension_id
leer, unterstützt der AdClient keine Berichterstellung.
AdUnit
- Das Feld „
status
“ wurde in „state
“ umbenannt. Außerdem gibt der StatusACTIVE
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 Feldsname
(nach dem letzten Schrägstrich). - Das Feld
contentAdsSettings.backupOption
wurde entfernt. - Das Feld
type
wurde auf die WerteTYPE_UNSPECIFIED
,DISPLAY
,FEED
,ARTICLE
,MATCHED_CONTENT
undLINK
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
undfeed_ads_settings
.
Benachrichtigung
- Die Methode
delete
wurde entfernt. - Das Feld „
is_dismissible
“ wurde entfernt. - Das Feld
locale
wurde inlanguage_code
umbenannt.
CustomChannel
- Das Feld „
code
“ wurde entfernt. Dieser Wert befindet sich weiterhin am Ende des Feldsname
(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 indate
umbenannt und vom Typ „String“ in den Typgoogle.type.Date
geändert. - Die Felder
payment_amount
undpayment_amount_currency_code
wurden zu einem einzigenpayment
-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
undMetadata.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 inaccount
umbenannt. - Das Feld
dimension
wurde indimensions
umbenannt. - Das Feld
metric
wurde inmetrics
umbenannt. - Das Feld
filter
wurde infilters
umbenannt. - Das Feld
sort
wurde inorder_by
umbenannt. - Das Feld
locale
wurde inlanguage_code
umbenannt. - Das Feld
currency
wurde incurrency_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
undLAST_30_DAYS
) oder Sie gebenstart_date
undend_date
an, indem Siedate_range
aufCUSTOM
setzen. - Die Felder
start_date
undend_date
wurden von Typstring in Typgoogle.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 durchreporting_time_zone
ersetzt, das entweder einen von zwei Werten haben kann:ACCOUNT_TIME_ZONE
oderGOOGLE_TIME_ZONE
(für PST/PDT). Der Standardwert in v2 istACCOUNT_TIME_ZONE
, was sich vom Standardwert in v1.4 unterscheidet. - Das Feld „
start_index
“ wurde entfernt. - Das Feld
max_results
wurde inlimit
umbenannt.
- Das Feld
-
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 inlanguage_code
umbenannt. - Das Feld „
start_index
“ wurde entfernt. - Das Feld „
max_results
“ wurde entfernt.
- Datumsfelder (
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.
Version 1.4
Diese Version bietet folgende Funktionen:
- Du kannst Zahlungen für dein AdSense-Konto jetzt in der entsprechenden Währung auflisten.
- Sie können Benachrichtigungen jetzt schließen, indem Sie die Methode
delete
aufrufen. Dadurch wird die Benachrichtigung in der API und in AdSense ausgeblendet. - Die Berichtsantwort enthält jetzt Start- und Enddatum. Das ist wichtig, wenn Sie beim Generieren von Berichten relative Datumsangaben verwenden (z. B.
today
,yesterday
oderfirstDayOfMonth-1m
), enthält die Antwort jetzt den angeforderten Zeitraum.
Bekannte Probleme
Das Feld currency
in Berichten wird in dieser Version nicht unterstützt.
Version 1.3
Diese Version bietet folgende Funktionen:
- Die Möglichkeit, Benachrichtigungen abzurufen
- Die Möglichkeit, Messwerte und Dimensionsmetadaten abzurufen
- Die Möglichkeit, Berichte in der lokalen Zeitzone des Kontos zu erstellen
Bekannte Probleme
Das Feld currency
in Berichten wird in dieser Version nicht unterstützt.
Version 1.2
Diese Version bietet folgende Funktionen:
- Die Möglichkeit, Anzeigendesigns abzurufen
- Die Möglichkeit, die im Front-End definierten gespeicherten Berichte abzurufen und auszuführen.
Bekannte Probleme
Das Feld currency
in Berichten wird in dieser Version nicht unterstützt.
Version 1.1
Diese Version bietet folgende Funktionen:
- Die Möglichkeit, Konten aufzulisten, auf die der Nutzer Zugriff hat
- Die Möglichkeit, einen GET-Aufruf an ein bestimmtes Konto zu senden
- GET-Aufrufe an Anzeigenblöcke und benutzerdefinierte Channels
- Die Möglichkeit, die Verbindungen zwischen Anzeigenblöcken und benutzerdefinierten Channels zu bestimmen
- Benutzerdefinierte Channels enthalten mehr Daten zu Ausrichtungsinformationen.
Außerdem können Sie jetzt über Ihr Standardkonto oder über ein bestimmtes Konto auf Daten zugreifen.
Bekannte Probleme
Das Feld currency
in Berichten wird in dieser Version nicht unterstützt.
Version 1
Dies ist die erste Version der API. Sie umfasst Support für das Abrufen von Ad-Clients, Anzeigenblöcken, benutzerdefinierten Channels und URL-Channels sowie die Erstellung von Berichten.
Bekannte Probleme
Das Feld currency
in Berichten wird in dieser Version nicht unterstützt.