向 ReachPlanService 傳送要求時,必須提供 OAuth 憑證,以及該憑證可存取的客戶 ID。此外,與 OAuth 憑證相關聯的 Google Cloud 雲端專案必須獲得核准,才能使用這項服務。
本指南涵蓋 ReachPlanService 專屬的驗證詳細資料。如果尚未完成,請先完成「開始使用」一文所述的步驟,再返回本指南。
OAuth 憑證
除了「開始使用」中的指引外,請留意下列事項:
- 即使您的 Google Cloud 專案編號已獲准用於其他 Google Ads API 服務,仍須加入適當的許可清單,才能連結
ReachPlanService。詳情請參閱資格規定。 - 您必須接受《Google Ads API 服務條款》,才能連結 Google Ads API。
- 擁有 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。如有疑問,請先使用已連結帳戶的單一使用者驗證流程。
後續步驟
瞭解如何指定媒體企劃書。