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

変更不可。元のメディア ファイルをダウンロードした場所の URL(またはファイル名)。AUDIO タイプと IMAGE タイプのメディアにのみ使用されます。

name

string

変更不可。メディア ファイルの名前。クライアントはこの名前を使用して、過去にアップロードしたメディアを識別できます。

fileSize

string (int64 format)

出力のみ。メディア ファイルのサイズ(バイト単位)。

共用体フィールド mediatype。メディア ファイルの特定のタイプ。mediatype は次のいずれかになります。
image

object (MediaImage)

変更不可。Image をカプセル化します。

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

Image をカプセル化します。

JSON 表現
{
  "data": string,
  "fullSizeImageUrl": string,
  "previewSizeImageUrl": string
}
フィールド
data

string (bytes format)

変更不可。未加工の画像データ。

Base64 でエンコードされた文字列。

fullSizeImageUrl

string

出力のみ。画像のフルサイズ バージョンの URL です。

previewSizeImageUrl

string

出力のみ。画像のプレビュー サイズ バージョンの URL。

MediaBundle

コンテンツに HTML5 アセットが含まれている ZIP アーカイブ メディアを表します。

JSON 表現
{
  "data": string,
  "url": string
}
フィールド
data

string (bytes format)

変更不可。圧縮された元データ。

Base64 でエンコードされた文字列。

url

string

出力のみ。アップロードした圧縮データにアクセスするための URL。(例: 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 の URL に表示されます)。この ID にプレフィックス「https://www.youtube.com/watch?v=」を追加すると、この動画の YouTube ストリーミング URL を取得できます。

advertisingIdCode

string

出力のみ。この動画の Advertising Digital Identification Code。主にテレビ コマーシャルに使用され、American Association of Advertising Agencies が定義します。

isciCode

string

出力のみ。この動画の Industry Standard Commercial Identifier コードです。主にテレビ コマーシャルに使用されます。