驗證

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。如有疑問,請根據您的工具類型採用第一個建議方法。