Sie benötigen sowohl die Anmeldedaten für die OAuth 2.0-Anwendung als auch die Rolle eines Entwicklers
Token beim Aufrufen der Google Ads API. Bei API-Aufrufen
mit einem Google Ads-Verwaltungskonto haben, müssen Sie auch eine login-customer-id angeben
-Header bei jeder Anfrage. Auf dieser Seite wird beschrieben, wie Sie
diese Werte festlegen und
dokumentiert mehrere zusätzliche API-spezifische HTTP-Header, die gesendet und
bei Verwendung der REST-Schnittstelle empfangen werden.
Anmeldedaten für OAuth 2.0
Die Google Ads API verwendet Anmeldedaten zur Identifizierung und Autorisierung der API. -Anfragen. OAuth 2.0-Clients und -Dienste Konten konfiguriert werden. Weitere Informationen zur Konfiguration der clientseitigen Autorisierung siehe OAuth2 in der Google Ads API.
Wenn Sie Google APIs noch nicht kennen, können Sie oauth2l oder OAuth 2.0 Playground zum Experimentieren und die Google Ads API, bevor Sie den Code für Ihr
Desktop- oder Web-App-Abläufe verwenden
Befolgen Sie die Schritte zur Konfiguration eines Google API Console-Projekts für die Google Ads API. Notieren Sie sich die Client-ID und Clientschlüssel und kehren Sie dann zu dieser Seite zurück.
Nachdem du einen OAuth-Client erstellt hast, folge dem Vorgang für Desktop-Apps. Anleitung oder Web-App-Ablauf Aktualisierungstoken und Zugriffstoken generieren
Dienstkonten verwenden
Befolgen Sie die allgemeinen Anweisungen im Service Konten zum Einrichten des Dienstkontozugriffs für die Google Ads API.
Sobald Sie ein Dienstkonto für den Zugriff auf Ihr Google Ads-Konto eingerichtet haben,
OAuth 2.0 für Server-zu-Server verwenden
Anwendungen
und wählen Sie den Tab HTTP/REST aus. Der scope zur Verwendung für die Google Ads API
Zugriff ist https://www.googleapis.com/auth/adwords.
Neue Zugriffstokens generieren
Sobald Sie eine Client-ID, einen Clientschlüssel und ein Aktualisierungstoken haben, können Sie
Generieren Sie ein neues Zugriffstoken zur Verwendung in API-Aufrufen mit der Methode
curl-Befehlszeilentool:
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/token
Anschließend verwenden Sie das von der curl-Anfrage zurückgegebene Zugriffstoken in der
Authorization-HTTP-Header jedes API-Aufrufs an die Google Ads API:
GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
Anfrageheader
Entwickler-Token
Die Google Ads API erfordert außerdem ein Entwickler-Token für Aufrufe an die API verwenden. Sie können ein Token für Ihr Verwaltungskonto direkt über das Google Ads-Benutzeroberfläche Weitere Informationen zur Einrichtung eines Entwicklertokens finden Sie unter Erhalten Sie Ihr Entwicklertoken.
Sie müssen den Wert Ihres Entwicklertokens in den developer-token-HTTP-Code einfügen
jedes API-Aufrufs an die Google Ads API:
GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
Kundennummer für Anmeldung
Bei Google Ads API-Aufrufen, die von einem Kontoverwalter an ein Kundenkonto getätigt wurden (d. h., wenn
sich als Administrator anmelden, um API-Aufrufe an eines seiner Kundenkonten zu senden, können Sie
müssen außerdem den HTTP-Header login-customer-id angeben. Dieser Wert steht für
Google Ads-Kundennummer des Managers, der den API-Aufruf durchführt
Das Hinzufügen dieser Überschrift entspricht der Auswahl eines Kontos in der Google Ads-Benutzeroberfläche
nachdem Sie sich angemeldet oder auf Ihr Profilbild in der oberen rechten Ecke
auf der Seite. Entfernen Sie bei der Angabe der Kundennummer alle Bindestriche (–),
Beispiel: 1234567890, nicht 123-456-7890.
GET /v17/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 von Drittanbietern von App-Analysetools nur verwendet, wenn Conversions in ein verknüpftes Google Ads-Konto hochladen Konto. Weitere Informationen finden Sie in der Leitfaden zur 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 der API zurückgegeben.
Antrags‑ID
request-id ist ein String, der die API-Anfrage eindeutig identifiziert. Wann?
Debugging oder Fehlerbehebung bei bestimmten API-Aufrufen, die request-id
ist eine wichtige Kennung, die Sie bei der Kontaktaufnahme mit dem Google-Entwickler zur Hand haben sollten
Support.
request-id: 2a5Cj89VV7CNhya1DZjjrC