Method: advertisers.sdfuploadtasks.upload

建立 SDF 上傳工作。傳回 Operation。

SDF 上傳工作是長時間執行的非同步作業。這項作業的 metadata 類型為 SdfUploadTaskMetadata。如果要求成功，作業的 response 類型會是 SdfUploadTask。回應中不會包含產生的檔案，您可以使用 media.download 擷取這些檔案。

您可以使用 sdfuploadtask.operations.get 擷取作業狀態。

您可以在 error.message 中找到任何錯誤。請注意，error.details 應為空白。

HTTP 要求

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

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

路徑參數

參數
advertiserId

string (int64 format)

必要欄位。要上傳 SDF 的廣告主 ID。

要求主體

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

JSON 表示法 
{
  "filename": string,
  "sdfVersion": enum (SdfVersion)
}
欄位
filename

string

必要欄位。素材資源的檔案名稱，包括副檔名。檔案名稱必須採用 UTF-8 編碼，且大小不得超過 240 位元組。
sdfVersion

enum (SdfVersion)

必要欄位。上傳檔案的 SDF 版本。如果設為 SDF_VERSION_UNSPECIFIED，則預設為已識別廣告主指定的版本。除非另有設定，否則廣告主會沿用夥伴的 SDF 版本。

回應主體

如果成功，回應主體會包含 Operation 的執行例項。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 Overview。