Autorisierung und HTTP-Header

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 außerdem 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 Anwendungsanmeldedaten zum Identifizieren und Autorisieren von API-Anfragen. OAuth 2.0-Clients können konfiguriert werden. Alle Aufrufe der Search Ads 360 Reporting API müssen über OAuth2 autorisiert werden. 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 oauth2l oder den OAuth 2.0 Playground verwenden, um mit Anwendungsanmeldedaten und der Search Ads 360 Reporting API zu experimentieren, bevor Sie den Code für Ihre Anwendung schreiben. Sie können auch ein OAuth-Aktualisierungstoken generieren, indem Sie das bereitgestellte Script zur Generierung 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

Anschließend verwenden Sie das von der curl-Anfrage zurückgegebene Zugriffstoken im HTTP-Header Authorization jedes API-Aufrufs an die Search Ads 360 Reporting API:

GET /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN

Anfrageheader

Kundennummer für 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 steht für die Search Ads 360-Kundennummer des Managers, der den API-Aufruf durchführt.

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 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