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