Wenn Sie die Google Ads API aufrufen, benötigen Sie sowohl OAuth 2.0-Anmeldedaten als auch ein Entwicklertoken. Wenn Sie API-Aufrufe mit einem Google Ads-Verwaltungskonto ausführen, müssen Sie bei jeder Anfrage auch einen login-customer-id-Header angeben. Auf dieser Seite wird beschrieben, wie Sie diese Werte festlegen. Außerdem werden mehrere zusätzliche API-spezifische HTTP-Header beschrieben, die bei Verwendung der REST-Benutzeroberfläche gesendet und empfangen werden.
OAuth 2.0-Anmeldedaten
Die Google Ads API verwendet Anmeldedaten der Anwendung, um API-Anfragen zu identifizieren und zu autorisieren. Sowohl OAuth 2.0-Clients als auch Dienstkonten können konfiguriert werden. Weitere Informationen zum Konfigurieren der clientseitigen Autorisierung finden Sie unter OAuth2 in der Google Ads API.
Wenn Sie neu bei Google APIs sind, können Sie oauth2l oder den OAuth 2.0 Playground verwenden, um mit Anmeldedaten für Anwendungen und der Google Ads API zu experimentieren, bevor Sie den Code für Ihre App schreiben.
Desktop- oder Web-App-Abläufe verwenden
Folgen Sie der Anleitung, um ein Google API Console-Projekt für die Google Ads API zu konfigurieren. Notieren Sie sich die Client-ID und den Clientschlüssel und kehren Sie dann zu dieser Seite zurück.
Nachdem Sie einen OAuth-Client erstellt haben, folgen Sie der Anleitung für den Ablauf für Desktop-Anwendungen oder der Anleitung für den Ablauf für Webanwendungen, um ein Aktualisierungstoken und ein Zugriffstoken zu generieren.
Dienstkonten verwenden
Folgen Sie der allgemeinen Anleitung im Leitfaden zu Dienstkonten, um den Dienstkontozugriff für die Google Ads API einzurichten.
Nachdem Sie ein Dienstkonto für den Zugriff auf Ihr Google Ads-Konto eingerichtet haben, folgen Sie der Anleitung unter OAuth 2.0 für Server-zu-Server-Anwendungen verwenden. Achten Sie dabei darauf, den Tab HTTP/REST auszuwählen. Die für den Zugriff auf die Google Ads API zu verwendende scope lautet https://www.googleapis.com/auth/adwords.
Neue Zugriffstokens generieren
Sobald du eine Client-ID, ein Client-Secret und ein Aktualisierungstoken hast, kannst du mit dem Befehlszeilentool curl ein neues Zugriffstoken für die Verwendung in API-Aufrufen generieren:
curl \
--data "grant_type=refresh_token" \
--data "client_id=CLIENT_ID " \
--data "client_secret=CLIENT_SECRET " \
--data "refresh_token=REFRESH_TOKEN " \
https://www.googleapis.com/oauth2/v3/tokenVerwenden Sie dann das Zugriffstoken, das von der curl-Anfrage zurückgegeben wurde, im Authorization-HTTP-Header jedes API-Aufrufs an die Google Ads API:
GET /v19/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
Anfrageheader
Entwickler-Token
Für die Google Ads API ist außerdem ein Entwicklertoken erforderlich, um die API aufzurufen. Sie können ein Token für Ihr Verwaltungskonto direkt über die Google Ads-Benutzeroberfläche beantragen. Weitere Informationen zur Einrichtung mit einem Entwicklertoken finden Sie unter Entwicklertoken abrufen.
Sie müssen den Wert Ihres Entwicklertokens im developer-token HTTP-Header jedes API-Aufrufs an die Google Ads API angeben:
GET /v19/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
Kundennummer für die Anmeldung
Bei Google Ads API-Aufrufen, die von einem Verwaltungskonto an ein Kundenkonto gesendet werden (d. h. wenn Sie sich als Verwaltungskonto anmelden, um API-Aufrufe an eines der zugehörigen Kundenkonten zu senden), müssen Sie auch den login-customer-id-HTTP-Header angeben. Dieser Wert entspricht der Google Ads-Kundennummer des Managers, der den API-Aufruf ausführt.
Wenn Sie diese Überschrift einfügen, ist das so, als würden Sie in der Google Ads-Benutzeroberfläche ein Konto auswählen, nachdem Sie sich angemeldet oder oben rechts auf der Seite auf Ihr Profilbild geklickt haben. Entfernen Sie bei der Angabe der Kundennummer alle Bindestriche (–), z. B. 1234567890, nicht 123-456-7890.
GET /v19/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
Verknüpfte Kundennummer
Dieser Header wird nur von Drittanbietern für App-Analysen verwendet, wenn Conversions in ein verknüpftes Google Ads-Konto hochgeladen werden. Weitere Informationen finden Sie im Leitfaden API-Aufrufstruktur.
...
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
linked-customer-id: LINKED_CUSTOMER_ID
Antwortheader
Die folgenden Header werden in HTTP-Antworten von der API zurückgegeben.
Antrags‑ID
request-id ist ein String, der die API-Anfrage eindeutig identifiziert. Wenn Sie Probleme mit bestimmten API-Aufrufen beheben oder Fehler beheben, ist die request-id eine wichtige Kennung, die Sie bei der Kontaktaufnahme mit dem Google-Entwicklersupport zur Hand haben sollten.
request-id: 2a5Cj89VV7CNhya1DZjjrC