媒体上传

借助媒体上传功能，您可以存储可在 Display & Video 360 中使用的数据。用户可能想要上传的数据的类型包括照片、视频、ZIP 文件等。

上传选项

借助 Display & Video 360 API，您可以上传特定类型的二进制数据或媒体。对于需要上传媒体内容的任何任务，其开发者指南中都详细介绍了您可以上传的数据的特征：

  • 上传文件的大小上限：使用相应方法可以存储的数据量上限。
  • 接受的媒体 MIME 类型：使用相应方法可以存储的二进制数据类型。

您可通过以下任一方法发出上传请求。使用 uploadType 参数指定您要使用的方法。

  • 简单上传：uploadType=media。快速传输大小约为 5 MB 或更小的文件。
  • 多部分上传：uploadType=multipart。快速转移文件和相关元数据。在单个请求中传输文件和元数据。

上传媒体时，您需要使用 /upload URI。您可以在传输媒体数据本身时使用此 URI。

示例：

  POST /upload/media/resource-name

简单上传

简单上传请求是上传文件最直接的方法。在以下情况下，这是一个不错的选择：

  • 文件非常小，如有必要，可以再次上传。
  • 没有元数据要发送。如果元数据不是必需的，或者已包含在请求中的其他位置，就可能没有元数据要发送。

如需使用简单上传，请向该方法的 /upload URI 发出 POST 或 PUT 请求，并在请求中添加查询参数 uploadType=media。例如：

  POST https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media

执行简单上传时要使用的 HTTP 标头包括：

  • Content-Type。请将此项设为该方法接受的某种媒体数据类型。
  • Content-Length。请将此项设为您要上传的字节数。如果您采用的是分块传输编码，则不需要设置此项。

多部分上传

如果您有要随上传的数据一起发送的元数据，则可以发出 multipart/related 请求。如果您要发送的数据非常小，就算需要再次上传也没关系，那么该方法便是您的理想之选。

如要采用多部分上传模式，请向该方法的 /upload URI 发出 POST 或 PUT 请求，并在请求中添加查询参数 uploadType=multipart。例如：

  POST https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart

发出多部分上传请求时要使用的顶级 HTTP 标头包括：

  • Content-Type。请将此项设为 multipart/related，并在其中添加您要用于标识请求各个部分的定界字符串。
  • Content-Length。将此项设为请求正文中的字节总数。请求上传的媒体内容大小必须小于针对该方法规定的文件大小上限。

请求的正文将采用与 multipart/related 内容类型 [RFC2387] 相同的格式，并且包含两个部分。这些部分由定界字符串标识，最后的定界字符串后跟两个连字符。

分段请求的每个部分都需要附加一个 Content-Type 标头：

  1. 元数据部分：必须位于第一部分，且 Content-Type 必须与该方法接受的某一元数据格式匹配。
  2. 媒体部分：必须位于第二部分，且 Content-Type 必须与该方法接受的某一媒体 MIME 类型匹配。

示例

您可以使用 Display & Video 360 API 上传媒体，以执行各种任务。本部分以 curl 请求的形式提供了一些示例。

上传广告素材资源

上传广告素材资源的方法如下：

curl --request POST \
  'https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart' \
  --header 'Authorization: Bearer access-token' \
   -F "data={\"filename\": \"asset-filename\"};type=application/json;charset=UTF-8" \
   -F "file=@asset-path;type=asset-mime-type"

如需了解详情和查看代码示例，请参阅上传广告素材资源指南。

上传自定义出价脚本文件

上传脚本文件的方法如下：

curl --request POST \
  'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' \
  -H 'authorization: Bearer access-token' \
  -H 'Content-Type: text/plain' \
  --data-binary @script-path

如需了解详情和代码示例，请参阅上传脚本指南。