Dieser Abschnitt richtet sich an fortgeschrittene Nutzer, die bereits mit der OAuth 2.0-Spezifikation vertraut sind und wissen, wie sie OAuth 2.0 mit Google APIs verwenden.
Bereich
Ein einzelnes Zugriffstoken kann unterschiedliche Zugriffsebenen für mehrere APIs gewähren. Ein variabler Parameter namens scope steuert die Gruppe von Ressourcen und Vorgängen, die ein Zugriffstoken zulässt. Während der Zugriffstokenanfrage sendet Ihre App einen oder mehrere Werte im Parameter scope.
Der Bereich für die Google Ads API ist:
https://www.googleapis.com/auth/adwords
Offlinezugriff und Token-Lebensdauer
Eine Google Ads API-Client-Anwendung fordert häufig Offlinezugriff an. Beispielsweise möchte Ihre Anwendung möglicherweise Batchjobs ausführen, wenn der Nutzer nicht physisch online ist und Ihre Website besucht. Zugriffstokens haben eine Lebensdauer von 3.600 Sekunden (1 Stunde). Danach muss Ihre App ein Aktualisierungstoken gegen ein neues Zugriffstoken eintauschen.
Wenn Sie Offlinezugriff für einen Webanwendungstyp anfordern möchten, müssen Sie den Parameter access_type auf offline setzen. Weitere Informationen finden Sie im OAuth 2.0-Leitfaden von Google.
Für den Typ „Desktop-Anwendung“ ist der Offlinezugriff standardmäßig aktiviert. Sie müssen ihn nicht explizit anfordern.
Anfrageheader
Alle Anfragen an die Google Ads API müssen das OAuth 2.0-Zugriffstoken im Anfrageheader enthalten. In den folgenden Abschnitten wird beschrieben, wie Sie diese Anmeldedaten mit gRPC und REST übergeben.
gRPC-Header
Wenn Sie die gRPC API verwenden, fügen Sie das Zugriffstoken in jede Anfrage ein. Sie können einen Credential an einen Channel binden, um ihn für alle Anfragen auf diesem Kanal zu verwenden. Sie können auch für jeden Aufruf einen benutzerdefinierten Berechtigungsnachweis senden. Weitere Informationen zur Autorisierung finden Sie im gRPC-Autorisierungsleitfaden.
REST-Header
Wenn Sie die REST API verwenden, übergeben Sie das Zugriffstoken über den HTTP-Header Authorization: Bearer <ACCESS_TOKEN>. Hier sehen Sie ein Beispiel für eine HTTP-Anfrage:
# Returns the resource names of customers directly accessible by the user
# authenticating the call.
#
# Variables:
# API_VERSION,
# OAUTH2_ACCESS_TOKEN:
# See https://developers.google.com/google-ads/api/rest/auth#request_headers
# for details.
#
curl -f --request GET \
"https://googleads.googleapis.com/v${API_VERSION}/customers:listAccessibleCustomers" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \