Authentication

向 ReachPlanService 傳送要求時,必須提供 OAuth 憑證,以及該憑證可存取的客戶 ID。此外,與 OAuth 憑證相關聯的 Google Cloud 雲端專案必須獲得核准,才能使用這項服務。

本指南涵蓋 ReachPlanService 專屬的驗證詳細資料。如果尚未完成,請先完成「開始使用」一文所述的步驟,再返回本指南。

OAuth 憑證

除了「開始使用」中的指引外,請留意下列事項:

  1. 即使您的 Google Cloud 專案編號已獲准用於其他 Google Ads API 服務,仍須加入適當的許可清單,才能連結 ReachPlanService。詳情請參閱資格規定。
  2. 您必須接受《Google Ads API 服務條款》,才能連結 Google Ads API。
  3. 擁有 OAuth 更新權杖的使用者,會決定您可以在 ReachPlanService 中查詢哪些客戶 ID。這項資訊會影響整合方式,詳情請參閱下文。

客戶 ID

Google Ads API 中的多數服務,都是針對特定 Google Ads 帳戶和廣告活動運作。因此,大多數要求都需要客戶 ID 來識別目標帳戶,以及有權存取該客戶 ID 的 OAuth 憑證。

不過,ReachPlanService 適用於影片規劃活動,這些活動可能會在您建立特定客戶帳戶來放送廣告活動之前發生。

內部工具

如果您建構的工具僅供貴組織內部使用,請考慮下列選項:

  • 無法直接存取客戶帳戶的企劃書:如果企劃書無法存取客戶的 Google Ads 帳戶,請使用單一使用者驗證流程,為有權存取管理員帳戶的使用者產生 OAuth 憑證。接著,為使用工具的每個團隊建立或取得 Google Ads 帳戶,並連結至管理員帳戶。向 ReachPlanService 提出要求時,請提供與使用者團隊對應的客戶 ID。
  • 可存取客戶帳戶的規劃人員:如果規劃人員可存取管理客戶帳戶的 Google Ads 管理員帳戶,請導入多使用者驗證流程,讓應用程式使用規劃人員的 OAuth 憑證。接著,您可以傳遞與客戶方案對應的客戶 ID。

外部工具

如果您為第三方或外部使用者建構工具,建議您採用下列選項:

  • 個別客戶帳戶:使用單一使用者驗證流程,為有權存取管理員帳戶的使用者產生 OAuth 憑證。為每位外部客戶建立 Google Ads 帳戶,並連結至管理員帳戶。請設定工具,在產生企劃書時提供客戶對應的客戶 ID。
  • 使用者授予存取權:允許使用者透過多使用者驗證流程,授予工具帳戶存取權。使用者授予權限後,請使用 CustomerService 擷取他們可存取的 Google Ads 帳戶清單。

整合 API 前,請根據系統需求選取上述其中一種方法,並找出幾個測試客戶 ID。如有疑問,請先使用已連結帳戶的單一使用者驗證流程。

後續步驟

瞭解如何指定媒體企劃書。