Authentication

ReachPlanService 的要求必須提供已核准的開發人員權杖、OAuth 憑證,以及 OAuth 憑證可存取的客戶 ID。

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

開發人員權杖和 OAuth 憑證

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

  1. 即使開發人員權杖已獲准用於其他 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 適用於影片規劃活動,您可能在放送廣告活動前,就已知道特定客戶 ID。

內部工具

如果您為貴機構建構內部使用的工具,請參考下列建議。

無法直接存取客戶帳戶的企劃人員

如果企劃人員無法存取客戶的 Google Ads 帳戶,請使用已安裝的應用程式流程,為可存取開發人員符記管理員帳戶的使用者產生 OAuth 認證。然後為使用您工具的每個團隊建立或取得 Google Ads 帳戶,並將這些帳戶連結至管理員帳戶。向 ReachPlanService 提出要求,取得與使用者團隊相應的客戶 ID。

可存取客戶帳戶的企劃人員

如果您的規劃人員有權存取管理客戶帳戶的 Google Ads 管理員帳戶,請導入網頁應用程式流程,允許應用程式使用規劃人員的 OAuth 憑證。然後傳入與方案客戶相應的客戶 ID。

外部工具

如果您為外部使用者建構工具,建議採用類似方法:

每個客戶帳戶

使用已安裝的應用程式流程,為有權存取開發人員權杖管理員帳戶的使用者產生 OAuth 憑證。為每位外部客戶建立一個 Google Ads 帳戶,然後連結至管理員帳戶。接著,請設定工具,在產生規劃時提供客戶的相應客戶 ID。

使用者授予的存取權

使用網頁應用程式流程,讓使用者授予工具帳戶存取權。使用者授予權限後,請使用 CustomerService 提供可存取的 Google Ads 帳戶清單。

目標是確保規劃人員使用 ReachPlanService 時,能盡可能減少阻礙。整合 API 前,請根據您的情況選取其中一種方法,並找出幾個客戶 ID 進行測試。如有疑問,請使用工具類型的第一個建議方法。

後續步驟

瞭解如何指定媒體企劃書