本節適用於已熟悉 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}" \