Dieser Abschnitt richtet sich an fortgeschrittene Nutzer, die 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 auf mehrere APIs gewähren. Ein variabler Parameter namens scope steuert die Gruppe von Ressourcen und Vorgängen, die ein Zugriffstoken zulässt. Bei der Anforderung eines Zugriffstokens 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 Lebensdauer von Tokens
Eine Google Ads API-Client-Anwendung fordert häufig Offlinezugriff an. Ihre App kann beispielsweise Batchjobs ausführen, wenn der Nutzer nicht online ist und Ihre Website nicht aufruft. Zugriffstokens haben eine Lebensdauer von 3.600 Sekunden (1 Stunde). Danach muss Ihre App ein Aktualisierungstoken gegen ein neues Zugriffstoken austauschen.
Wenn Sie Offlinezugriff für eine Web-App anfordern möchten, legen Sie den Parameter access_type auf offline fest. Weitere Informationen finden Sie in
Google's OAuth 2.0-Leitfaden.
Für Desktop-Apps 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 ein Credential an einen Channel binden, um es für alle Anfragen in diesem Channel zu verwenden. Sie können auch für jeden Aufruf benutzerdefinierte Anmeldedaten senden. Weitere Informationen zur Autorisierung finden Sie im gRPC-Autorisierungs
leitfaden.
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}" \