Google Ads API 的 OAuth 2.0 內部機制

本節適用於已熟悉 OAuth 2.0 規格,且瞭解如何搭配 Google API 使用 OAuth 2.0 的進階使用者。

範圍

單一存取權杖可授予多個 API 不同程度的存取權。名為 scope 的變數參數可控管存取權杖允許的資源和作業集。在存取權杖要求期間,應用程式會在 scope 參數中傳送一或多個值。

Google Ads API 的範圍為:

https://www.googleapis.com/auth/adwords

離線存取

Google Ads API 用戶端應用程式通常會要求離線存取權。舉例來說,使用者未實際連線瀏覽網站時,應用程式可能想執行批次作業。

如要為網頁應用程式類型要求離線存取權,請務必將 access_type 參數設為 offline。詳情請參閱 Google 的 OAuth2 指南

如果是電腦應用程式類型,系統預設會啟用離線存取權,您不必明確要求。

要求標頭

gRPC 標頭

使用 gRPC API 時,請在每個要求中加入存取權杖。您可以將 Credential 繫結至 Channel,以便在該管道的所有要求中使用。您也可以為每次呼叫傳送自訂憑證。如要進一步瞭解如何處理授權,請參閱 gRPC 授權指南

REST 標頭

使用 REST API 時,請透過 HTTP 標頭 Authorization 傳遞存取權杖。HTTP 要求範例如下:

# Returns the resource names of customers directly accessible by the user
# authenticating the call.
#
# Variables:
#   API_VERSION,
#   DEVELOPER_TOKEN,
#   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 "developer-token: ${DEVELOPER_TOKEN}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \