Method: creatives.create

建立廣告素材。成功完成時,會在 response 欄位中傳回廣告素材,失敗時則會傳回 google.rpc.Code。傳回 CreateCreativeOperationMetadata,包括 metadata 欄位中的攝入狀態。

HTTP 要求

POST https://dai.googleapis.com/v1/creatives

這個網址使用 gRPC 轉碼語法。

要求主體

要求主體的資料會採用以下結構:

JSON 表示法
{
  "creative": {
    object (Creative)
  },
  "dynamicCreativeInfo": {
    object (DynamicCreativeInfo)
  }
}
欄位
creative

object (Creative)

要擷取的廣告素材。

dynamicCreativeInfo

object (DynamicCreativeInfo)

動態廣告素材的相關資訊。如果要攝入的廣告素材為動態廣告素材,則為必填欄位。

回應主體

如果成功,回應主體會包含新建立的 Operation 例項。

DynamicCreativeInfo

動態廣告素材執行 VCL 處理作業所需的必要資訊。

JSON 表示法
{
  "dynamicGroupId": string,
  "activeDuration": string
}
欄位
dynamicGroupId

string

代表廣告素材核心影片廣告的 ID。同一個動態群組 ID 下的所有動態廣告素材,可視為具有相同內容,但動態廣告素材的動態面向不同。

activeDuration

string (Duration format)

廣告素材處於有效狀態且可供使用的時間長度。過了這個時間點,系統就會在影片廣告素材存放區中刪除廣告素材。期限上限為 180 天。如果未指定這個欄位,系統會套用預設的 30 天時間長度。

以秒為單位的時間長度,最多可有 9 個小數位數,並應以「s」結尾,例如:"3.5s"