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

僅供輸出。這部影片的業界標準商業識別碼，主要用於電視廣告。