建立廣告素材。成功完成時,會在 response 欄位中傳回廣告素材,失敗時則會傳回 google.rpc.Code。傳回 CreateCreativeOperationMetadata,包括 metadata 欄位中的攝入狀態。
HTTP 要求
POST https://dai.googleapis.com/v1/creatives
這個網址使用 gRPC 轉碼語法。
要求主體
要求主體的資料會採用以下結構:
| JSON 表示法 |
|---|
{ "creative": { object ( |
| 欄位 | |
|---|---|
creative |
要擷取的廣告素材。 |
dynamicCreativeInfo |
動態廣告素材的相關資訊。如果要攝入的廣告素材為動態廣告素材,則為必填欄位。 |
回應主體
如果成功,回應主體會包含新建立的 Operation 例項。
DynamicCreativeInfo
動態廣告素材執行 VCL 處理作業所需的必要資訊。
| JSON 表示法 |
|---|
{ "dynamicGroupId": string, "activeDuration": string } |
| 欄位 | |
|---|---|
dynamicGroupId |
代表廣告素材核心影片廣告的 ID。同一個動態群組 ID 下的所有動態廣告素材,可視為具有相同內容,但動態廣告素材的動態面向不同。 |
activeDuration |
廣告素材處於有效狀態且可供使用的時間長度。過了這個時間點,系統就會在影片廣告素材存放區中刪除廣告素材。期限上限為 180 天。如果未指定這個欄位,系統會套用預設的 30 天時間長度。 以秒為單位的時間長度,最多可有 9 個小數位數,並應以「 |