Wenn Sie die Search Ads 360 Reporting API aufrufen, benötigen Sie OAuth 2.0-Anmeldedaten. Wenn Sie API-Aufrufe über ein Search Ads 360-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 Search Ads 360 Reporting API verwendet Anmeldedaten der Anwendung, um API-Anfragen zu identifizieren und zu autorisieren. OAuth 2.0-Clients können konfiguriert werden. Alle Search Ads 360 Reporting API-Aufrufe müssen über OAuth2 autorisiert sein. Mit OAuth2 kann Ihre Search Ads 360 Reporting API-Clientanwendung auf das Search Ads 360-Konto eines Nutzers zugreifen, ohne dass die Anmeldedaten des Nutzers verarbeitet oder gespeichert werden müssen.
Wenn Sie mit Google APIs noch nicht vertraut sind, können Sie mit oauth2l oder dem OAuth 2.0 Playground mit den Anmeldedaten der Anwendung und der Search Ads 360 Reporting API experimentieren, bevor Sie den Code für Ihre App schreiben. Sie können auch ein OAuth-Aktualisierungstoken generieren, indem Sie das bereitgestellte Script zum Generieren von Nutzeranmeldedaten ausführen.
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/token
Verwenden Sie dann das Zugriffstoken, das von der curl-Anfrage im Authorization-HTTP-Header jedes API-Aufrufs an die Search Ads 360 Reporting API zurückgegeben wird:
GET /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN
Anfrageheader
Kundennummer für die Anmeldung
Bei Search Ads 360 Reporting API-Aufrufen, die von einem Verwaltungskonto an ein Kundenkonto gesendet werden (d. h. wenn Sie sich als Verwaltungskonto anmelden, um API-Aufrufe an eines seiner Kundenkonten zu senden), müssen Sie auch den login-customer-id-HTTP-Header angeben. Dieser Wert entspricht der Search Ads 360-Kundennummer des Verwaltungskontos, über das der API-Aufruf erfolgt.
Wenn Sie diese Überschrift einfügen, ist das so, als würden Sie in der Search Ads 360-Benutzeroberfläche ein Konto auswählen, nachdem Sie sich angemeldet oder rechts oben 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 /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN
login-customer-id: MANAGER_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 beim Kontakt mit dem Google-Entwicklersupport zur Hand haben sollten.
request-id: 2a5Cj89VV7CNhya1DZjjrC