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。