準備好讓用戶端應用程式與 Google Ad Manager 搭配運作

收集用戶端應用程式所需的資訊

您必須提供下列資訊,讓 Google Ad Manager 建立 VOD 素材資源工作階段:

欄位說明
projectNumber用於建立支援 Ad Manager 的工作階段的 Google Cloud 專案編號 (PROJECT_NUMBER);您也可以使用專案 ID。
region 您希望 IMA SDK 用來建立 VOD 工作階段的位置 (LOCATION)。
vodConfigId用於透過 Video Stitcher API 註冊 VOD 串流的 VOD 設定 ID。以下是完整設定資源名稱的格式:
projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID
VOD 設定 ID 是全名 (VOD_CONFIG_ID) 的最後一個部分。請注意,設定的位置必須與建立 VOD 工作階段的位置相同。
networkCodeAd Manager 聯播網的數字 ID (NETWORK_CODE)。
oAuthToken服務帳戶的短期 OAuth 權杖,具有 Video Stitcher User 角色。請參閱「產生短期 OAuth 權杖」。

表 1. 啟用 Ad Manager 的 VOD 素材資源工作階段所需資訊

產生短期 OAuth 權杖以供測試

如要產生與服務帳戶相關聯的短期 OAuth 權杖,並具有Video Stitcher 使用者角色,請按照下列步驟操作:

  1. PATH_TO_YOUR_SERVICE_KEY 改為您下載至本機的 JSON 檔案路徑。
    gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
  2. 從服務帳戶擷取 OAuth 2.0 不記名憑證:
    gcloud auth print-access-token

由於這是短期權杖,您必須定期使用 gcloud auth print-access-token 指令再次產生權杖,並將新的權杖傳送至用戶端應用程式。如要進一步瞭解如何建構正式版服務以提供短期權杖,請參閱下節。

建立服務,為用戶端應用程式提供資訊

建立可提供必要資訊的服務,以便傳遞給用戶端。當應用程式向您的服務要求有關如何播放 VOD 資產的資訊時,服務應傳回表 1 所述的資訊。

具體來說,服務必須能夠以安全的方式,將 OAuth 權杖提供給用戶端應用程式。使用兩個服務帳戶設定這項服務,其中一個帳戶會模擬另一個帳戶。一個服務帳戶具有「服務帳戶憑證建立者」角色,並為具有「Video Stitcher User」角色的服務帳戶建立 OAuth 權杖。例如:

  • 服務帳戶 1:這是呼叫端服務帳戶。這個帳戶具有服務帳戶 2 的「Service Token Creator」權限,並在用戶端應用程式中冒用服務帳戶 2。
  • 服務帳戶 2:這是具有Video Stitcher 使用者角色的權限服務帳戶,可用於建立工作階段。

如要瞭解如何透過服務提供 OAuth 權杖 (包括用戶端程式庫程式碼範例),請參閱「建立短期存取權杖」。