向 ReachPlanService
發出的要求必須提供已核准的開發人員權杖、OAuth 憑證,以及 OAuth 憑證可存取的客戶 ID。
本指南說明 ReachPlanService
專屬的驗證詳細資料。如果您尚未完成「開始使用」一文所述的步驟,請先完成相關步驟,再回到這裡。
開發人員權杖和 OAuth 憑證
除了開始使用提供的指南外,請注意下列事項:
- 開發人員權杖必須列入許可清單才能連結至
ReachPlanService
,即使該權杖已獲準與其他 Google Ads API 服務搭配使用也一樣。詳情請參閱資格規定。 - 您必須接受《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。如有疑問,請根據您的工具類型採用第一種建議做法。