Zum Aufrufen der Search Ads 360 Reporting API benötigen Sie Anmeldedaten für OAuth 2.0. Wenn Sie API-Aufrufe als Search Ads 360-Verwaltungskonto ausführen, müssen Sie auch bei jeder Anfrage 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 dokumentiert, die bei Verwendung der REST-Schnittstelle gesendet und empfangen werden.
Anmeldedaten für OAuth 2.0
Die Search Ads 360 Reporting API verwendet Anmeldedaten, um API-Anfragen zu identifizieren und zu autorisieren. 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 Clientanwendung der Search Ads 360 Reporting API auf das Search Ads 360-Konto eines Nutzers zugreifen, ohne die Anmeldedaten des Nutzers verarbeiten oder speichern zu 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 Skript zum Generieren von Nutzeranmeldedaten ausführen.
Neue Zugriffstokens werden generiert
Sobald Sie eine Client-ID, einen Clientschlüssel und ein Aktualisierungstoken haben, können Sie ein neues Zugriffstoken zur Verwendung in API-Aufrufen mit dem curl-Befehlszeilentool erstellen:
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 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
Log-in-Kundennummer
Für Search Ads 360 Reporting API-Aufrufe, die ein Kontoverwalter an ein Kundenkonto ausführt (d. h. wenn Sie sich als Administrator anmelden, um API-Aufrufe an ein Kundenkonto auszuführen), müssen Sie auch den HTTP-Header login-customer-id angeben. Dieser Wert steht für die Search Ads 360-Kundennummer des Managers, der den API-Aufruf durchführt.
Das Einfügen dieser Kopfzeile entspricht der Auswahl eines Kontos in der Search Ads 360-Benutzeroberfläche, nachdem Sie sich angemeldet oder oben rechts auf Ihr Profilbild geklickt haben. Entfernen Sie bei Angabe der Kundennummer alle Bindestriche (–), z. B. 1234567890 und 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. Beim Debuggen oder Beheben von Problemen mit bestimmten API-Aufrufen ist die request-id eine wichtige Kennung, die du zur Hand haben solltest, wenn du dich an den Google-Entwicklersupport wendest.
request-id: 2a5Cj89VV7CNhya1DZjjrC