上傳資產。如果上傳成功,會傳回新上傳資產的 ID。素材資源檔案大小上限為:圖片 10 MB、ZIP 檔案 200 MB、影片 1 GB。
HTTP 要求
- 上傳 URI,適用於媒體上傳要求:POST https://displayvideo.googleapis.com/upload/v3/advertisers/{advertiserId}/assets
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 | |
|---|---|
| advertiserId | 
 必要欄位。這項素材資源所屬廣告主的 ID。 | 
要求主體
要求主體會包含結構如下的資料:
| JSON 表示法 | 
|---|
| { "filename": string } | 
| 欄位 | |
|---|---|
| filename | 
 必要欄位。素材資源的檔案名稱,包括副檔名。 檔案名稱必須採用 UTF-8 編碼,大小上限為 240 個位元組。 | 
回應主體
assets.upload 的回應訊息。
如果成功,回應主體會含有以下結構的資料:
| JSON 表示法 | 
|---|
| {
  "asset": {
    object ( | 
| 欄位 | |
|---|---|
| asset | 
 上傳的資產 (如果成功)。 | 
授權範圍
需要下列 OAuth 範圍:
- https://www.googleapis.com/auth/display-video
詳情請參閱OAuth 2.0 Overview。