驗證

ReachPlanService 發出的要求必須提供已核准的開發人員權杖、OAuth 憑證,以及 OAuth 憑證可存取的客戶 ID。

本指南說明 ReachPlanService 專屬的驗證詳細資料。如果您尚未完成「開始使用」一文所述的步驟,請先完成相關步驟,再回到這裡。

開發人員權杖和 OAuth 憑證

除了開始使用提供的指南外,請注意下列事項:

  1. 開發人員權杖必須列入許可清單才能連結至 ReachPlanService,即使該權杖已獲準與其他 Google Ads API 服務搭配使用也一樣。詳情請參閱資格規定
  2. 您必須接受《Google Ads API 服務條款》,才能連結 Google Ads API。
  3. 擁有 OAuth 更新權杖的使用者會決定您可以在 ReachPlanService 中查詢的客戶 ID。這有助於整合服務,詳情請參閱下文。

客戶 ID

Google Ads API 中的大部分服務會在特定 Google Ads 帳戶和廣告活動中運作。因此,大多數要求都需要客戶 ID 來識別您管理或查詢的帳戶,以及具有存取該客戶 ID 的 OAuth 憑證。不過,ReachPlanService 專供影片規劃活動在您知道要放送廣告活動的特定客戶 ID 之前發生的。

如果合作夥伴為機構內部用途建立工具,我們建議採用下列其中一個選項:

  1. 如果規劃人員無法存取客戶的 Google Ads 帳戶:請透過安裝的應用程式流程,為有權存取開發人員權杖管理員帳戶的使用者產生 OAuth 憑證。接著,為每個使用您工具的團隊建立或取得 Google Ads 帳戶,並將其連結至管理員帳戶。對 ReachPlanService 提出要求時,請提供與使用者團隊相對應的客戶 ID。

  2. 如果規劃人員可以存取用來管理客戶帳戶的 Google Ads 管理員帳戶:請導入網頁應用程式流程,允許應用程式使用規劃人員的 OAuth 憑證。接著,您可以傳入與方案客戶相對應的客戶 ID。

針對為外部使用者建構工具的合作夥伴,建議您採用類似方法:

  1. 透過安裝的應用程式流程,為使用者產生 OAuth 憑證,但該使用者必須具備開發人員權杖的管理員帳戶存取權。為每個外部客戶建立 Google Ads 帳戶,然後將其連結至管理員帳戶。接著設定您的工具,以在客戶產生方案時提供其對應的客戶 ID。

  2. 透過網頁應用程式流程,讓使用者授予您的工具帳戶存取權。使用者授予權限後,請使用 CustomerService 為他們提供能夠存取的 Google Ads 帳戶清單。

目標是確保企劃人員在使用 ReachPlanService 時,能夠盡量簡化操作。整合 API 之前,請根據您的情況選擇以下其中一種做法,然後找出要測試的客戶 ID。如有疑問,請根據您的工具類型採用第一種建議做法。