Method: advertisers.adAssets.upload

上傳及建立廣告素材資源。

如果成功，則傳回新建立的廣告素材資源 ID。

僅支援上傳 AdAssetType AD_ASSET_TYPE_IMAGE 的素材資源。

HTTP 要求

  • 上傳 URI，適用於媒體上傳要求：
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/adAssets:uploadAdAsset
  • 中繼資料 URI (僅限中繼資料要求)：
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adAssets:uploadAdAsset

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

路徑參數

參數
advertiserId

string (int64 format)

必填。廣告素材資源所屬廣告主的 ID。

要求主體

要求主體會包含結構如下的資料：

JSON 表示法 
{
  "filename": string,
  "adAssetType": enum (AdAssetType),
  "syntheticContentAttestationStatus": enum (SyntheticContentAttestationStatus)
}
欄位
filename

string

必填。廣告素材資源的檔案名稱，包括副檔名。

檔案名稱必須採用 UTF-8 編碼，大小上限為 240 個位元組。
adAssetType

enum (AdAssetType)

必填。廣告素材資源類型。

僅支援 AD_ASSET_TYPE_IMAGE。
syntheticContentAttestationStatus

enum (SyntheticContentAttestationStatus)

(選用步驟) 在有當地 AI 標籤法規的地區放送時，是否要將素材資源標示為使用 AI 生成或編輯。

回應主體

adAssets.upload 的回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "adAsset": {
    object (AdAsset)
  }
}
欄位
adAsset

object (AdAsset)

建立的廣告素材資源。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/display-video

詳情請參閱OAuth 2.0 Overview。