收集用戶端應用程式所需的資訊
您必須提供下列資訊,Google Ad Manager 才能建立直播工作階段:
欄位 | 說明 |
---|---|
projectNumber | 用於建立支援 Ad Manager 的工作階段的 Google Cloud 專案編號 (PROJECT_NUMBER );您也可以使用專案 ID。 |
region |
註冊即時設定的位置 (LOCATION )。 |
liveConfigId | 用於向 Video Stitcher API 註冊直播事件的即時設定 ID。以下是完整設定資源名稱的格式:projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID LIVE_CONFIG_ID ) 的最後一個部分。請注意,設定的位置必須與建立工作階段的位置相同。 |
customAssetKey | 在直播設定註冊期間建立的自訂素材資源金鑰 (CUSTOM_ASSET_KEY );IMA SDK 需要這個值才能建立串流。 |
networkCode | Ad Manager 聯播網的數字 ID (NETWORK_CODE )。 |
oAuthToken | 服務帳戶的短期 OAuth 權杖,具有 Video Stitcher User 角色。請參閱「產生短期 OAuth 權杖」。 |
表 1. 啟用 Ad Manager 的直播活動工作階段所需的資訊
產生短期 OAuth 權杖以供測試
如要產生與服務帳戶相關聯的短期 OAuth 權杖,並具備Video Stitcher 使用者角色,請按照下列步驟操作:
- 將
PATH_TO_YOUR_SERVICE_KEY
替換為您下載至本機的 JSON 檔案路徑。gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
- 從服務帳戶擷取 OAuth 2.0 不記名憑證:
gcloud auth print-access-token
由於這是短期權杖,您必須定期使用 gcloud auth print-access-token
指令再次產生權杖,並將新的權杖傳送至用戶端應用程式。如要進一步瞭解如何建構正式版服務以提供短期權杖,請參閱下節。
建立服務,為用戶端應用程式提供資訊
建立可提供必要資訊的服務,以便傳遞給用戶端。當應用程式向您的服務要求有關播放直播的資訊時,服務應傳回表 1 所述的資訊。
具體來說,服務必須能夠以安全的方式,將 OAuth 權杖提供給用戶端應用程式。使用兩個服務帳戶設定這項服務,其中一個帳戶會模擬另一個帳戶。一個服務帳戶具有「服務帳戶憑證建立者」角色,並為具有「Video Stitcher User」角色的服務帳戶建立 OAuth 權杖。例如:
- 服務帳戶 1:這是呼叫端服務帳戶。這個帳戶具有服務帳戶 2 的「Service Token Creator」權限,並在用戶端應用程式中冒用服務帳戶 2。
- 服務帳戶 2:這是具有Video Stitcher 使用者角色的權限服務帳戶,可用於建立工作階段。
如要瞭解如何透過服務提供 OAuth 權杖 (包括用戶端程式庫程式碼範例),請參閱「建立短期存取權杖」。