MediaFile

媒体文件。

JSON 表示法 
{
  "resourceName": string,
  "type": enum (MediaType),
  "mimeType": enum (MimeType),
  "id": string,
  "sourceUrl": string,
  "name": string,
  "fileSize": string,

  // Union field mediatype can be only one of the following:
  "image": {
    object (MediaImage)
  },
  "mediaBundle": {
    object (MediaBundle)
  },
  "audio": {
    object (MediaAudio)
  },
  "video": {
    object (MediaVideo)
  }
  // End of list of possible types for union field mediatype.
}
字段
resourceName

string

不可变。媒体文件的资源名称。媒体文件资源名称采用以下格式：

customers/{customerId}/mediaFiles/{media_file_id}
type

enum (MediaType)

不可变。媒体文件的类型。
mimeType

enum (MimeType)

仅供输出。媒体文件的 MIME 类型。
id

string (int64 format)

仅供输出。媒体文件的 ID。
sourceUrl

string

不可变。原始媒体文件的下载网址（或文件名）。仅用于 AUDIO 和 IMAGE 类型的媒体。
name

string

不可变。媒体文件的名称。客户端可以使用该名称来帮助识别之前上传的媒体。
fileSize

string (int64 format)

仅供输出。媒体文件的大小（以字节为单位）。
联合字段 mediatype。媒体文件的特定类型的。mediatype 只能是下列其中一项：
image

object (MediaImage)

不可变。封装图像。
mediaBundle

object (MediaBundle)

不可变。内容包含 HTML5 素材资源的 ZIP 归档文件。
audio

object (MediaAudio)

仅供输出。封装音频。
video

object (MediaVideo)

不可变。封装视频。

MediaType

媒体的类型。

枚举
UNSPECIFIED 尚未指定媒体类型。
UNKNOWN

此版本中未知接收的值。

这是一个仅用于响应的值。
IMAGE 静态图片，用于图片广告。
ICON 小图片，用于地图广告。
MEDIA_BUNDLE ZIP 文件，在模板广告的字段中使用。
AUDIO 音频文件。
VIDEO 视频文件。
DYNAMIC_IMAGE 动画图片，例如动画 GIF。

MediaImage

封装图像。

JSON 表示法 
{
  "data": string,
  "fullSizeImageUrl": string,
  "previewSizeImageUrl": string
}
字段
data

string (bytes format)

不可变。原始图片数据。

使用 base64 编码的字符串。
fullSizeImageUrl

string

仅供输出。图片的完整尺寸版本的网址。
previewSizeImageUrl

string

仅供输出。指向图片的预览尺寸版本的网址。

MediaBundle

表示其内容包含 HTML5 素材资源的 ZIP 归档媒体。

JSON 表示法 
{
  "data": string,
  "url": string
}
字段
data

string (bytes format)

不可变。原始压缩数据。

使用 base64 编码的字符串。
url

string

仅供输出。用于访问上传的压缩数据的网址。例如，https://tpc.googlesyndication.com/simgad/123。此字段是只读的。

MediaAudio

封装音频。

JSON 表示法 
{
  "adDurationMillis": string
}
字段
adDurationMillis

string (int64 format)

仅供输出。音频的时长（以毫秒为单位）。

MediaVideo

封装视频。

JSON 表示法 
{
  "adDurationMillis": string,
  "youtubeVideoId": string,
  "advertisingIdCode": string,
  "isciCode": string
}
字段
adDurationMillis

string (int64 format)

仅供输出。视频的时长（以毫秒为单位）。
youtubeVideoId

string

不可变。YouTube 视频 ID（如 YouTube 网址中所示）。向此 ID 添加前缀“https://www.youtube.com/watch?v=”将会获得该视频的 YouTube 直播网址。
advertisingIdCode

string

仅供输出。该视频的广告数字标识代码，由美国广告代理协会定义，主要用于电视广告。
isciCode

string

仅供输出。此视频的业界标准商业广告标识符 (Industry Standard Commercial Identifier) 代码，主要用于电视广告。