對 ReachPlanService
的要求必須提供已核准的開發人員權杖、OAuth 憑證,以及 OAuth 憑證可存取的客戶 ID。
本指南涵蓋ReachPlanService
專屬的驗證詳細資料。如果尚未完成,請先完成「開始使用」一文中的步驟,再回到這個步驟。
開發人員權杖和 OAuth 憑證
除了「開始使用」提供的指引外,請注意下列事項:
- 即使開發人員權杖已獲准用於其他 Google Ads API 服務,也必須加入允許清單,才能連線至
ReachPlanService
。詳情請參閱資格規定。 - 您必須接受 Google Ads API 服務條款,才能連線至 Google Ads API。
- OAuth 重新整理權杖的擁有者決定您可以在
ReachPlanService
中查詢哪些客戶 ID。 這項資訊會影響整合作業,詳情請參閱下文。
客戶 ID
Google Ads API 中的大多數服務,都是針對特定 Google Ads 帳戶和廣告活動運作。因此,大多數要求都需要客戶 ID,才能識別您管理或查詢的帳戶,以及有權存取該客戶 ID 的 OAuth 憑證。不過,ReachPlanService
適用於影片規劃活動,您可能在放送廣告活動前,就已知道特定客戶 ID。
如果合作夥伴要為自家機構建構內部使用的工具,我們建議採取下列任一做法:
如果企劃人員無法存取客戶的 Google Ads 帳戶: 使用已安裝的應用程式流程,為有權存取開發人員符記管理員帳戶的使用者產生 OAuth 憑證。然後為使用您工具的每個團隊建立或取得 Google Ads 帳戶,並將這些帳戶連結至管理員帳戶。向
ReachPlanService
提出要求,提供與使用者團隊相應的客戶 ID。如果規劃人員有權存取管理客戶帳戶的 Google Ads 管理員帳戶:請實作網頁應用程式流程,允許應用程式使用規劃人員的 OAuth 憑證。然後傳入與方案客戶相應的客戶 ID。
如果合作夥伴為外部使用者建構工具,建議採用類似方法:
使用已安裝的應用程式流程,為有權存取開發人員權杖管理員帳戶的使用者產生 OAuth 憑證。為每位外部客戶建立一個 Google Ads 帳戶,然後將這些帳戶連結至管理員帳戶。然後設定工具,在產生規劃時提供客戶的相應客戶 ID。
使用網頁應用程式流程,讓使用者授予工具帳戶存取權。使用者授予權限後,請使用
CustomerService
提供可存取的 Google Ads 帳戶清單。
目標是確保規劃人員在使用 ReachPlanService
時,能盡可能減少阻礙。整合 API 前,請根據情況選擇其中一種做法,並找出幾個客戶 ID 進行測試。如有疑問,請使用工具類型的第一個建議方法。