Method: advertisers.assets.upload

上傳素材資源。如果上傳成功,會傳回新上傳資產的 ID。素材資源的檔案大小不得超過 10 MB,ZIP 檔案不得超過 200 MB,影片則為 1 GB。

必須在多部分媒體上傳程序內使用。您可以參閱製作廣告素材指南,瞭解使用我們提供的用戶端程式庫的範例。

HTTP 要求

  • 上傳 URI (適用於媒體上傳要求):
    POST https://displayvideo.googleapis.com/upload/v3/advertisers/{advertiserId}/assets

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

路徑參數

參數
advertiserId

string (int64 format)

必要欄位。這項資產所屬廣告主的 ID。

要求主體

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

JSON 表示法
{
  "filename": string
}
欄位
filename

string

必要欄位。素材資源的檔案名稱,包括副檔名。

檔案名稱必須使用 UTF-8 編碼,且大小上限為 240 個位元組。

回應主體

assets.upload 的回應訊息。

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

JSON 表示法
{
  "asset": {
    object (Asset)
  }
}
欄位
asset

object (Asset)

上傳的素材資源 (如果成功)。

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱 OAuth 2.0 總覽