MediaFile

Một tệp nội dung nghe nhìn.

Biểu diễn dưới dạng 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.
}
Các trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của tệp nội dung nghe nhìn. Tên tài nguyên tệp đa phương tiện có dạng:

customers/{customerId}/mediaFiles/{media_file_id}

type

enum (MediaType)

Không thể thay đổi. Loại tệp nội dung nghe nhìn.

mimeType

enum (MimeType)

Chỉ có đầu ra. Loại MIME của tệp nội dung đa phương tiện.

id

string (int64 format)

Chỉ có đầu ra. Mã của tệp nội dung nghe nhìn.

sourceUrl

string

Không thể thay đổi. URL của nơi tải tệp đa phương tiện gốc xuống (hoặc tên tệp). Chỉ dùng cho nội dung nghe nhìn thuộc loại AUDIO và IMAGE.

name

string

Không thể thay đổi. Tên của tệp nội dung nghe nhìn. Khách hàng có thể sử dụng tên này để xác định nội dung nghe nhìn đã tải lên trước đó.

fileSize

string (int64 format)

Chỉ có đầu ra. Kích thước của tệp nội dung nghe nhìn tính bằng byte.

Trường nhóm mediatype. Loại cụ thể của tệp nội dung nghe nhìn. mediatype chỉ có thể là một trong những trạng thái sau đây:
image

object (MediaImage)

Không thể thay đổi. Đóng gói hình ảnh.

mediaBundle

object (MediaBundle)

Không thể thay đổi. Một tệp lưu trữ ZIP chứa nội dung của các thành phần HTML5.

audio

object (MediaAudio)

Chỉ có đầu ra. Đóng gói âm thanh.

video

object (MediaVideo)

Không thể thay đổi. Đóng gói video.

MediaType

Loại nội dung nghe nhìn.

Enum
UNSPECIFIED Loại phương tiện chưa được chỉ định.
UNKNOWN

Không xác định được giá trị đã nhận trong phiên bản này.

Đây là giá trị chỉ để phản hồi.

IMAGE Hình ảnh tĩnh, được sử dụng cho quảng cáo hình ảnh.
ICON Hình ảnh nhỏ, được sử dụng cho quảng cáo bản đồ.
MEDIA_BUNDLE ZIP, được sử dụng trong các trường của quảng cáo mẫu.
AUDIO Tệp âm thanh.
VIDEO Tệp video.
DYNAMIC_IMAGE Hình ảnh động, chẳng hạn như GIF động.

MediaImage

Đóng gói hình ảnh.

Biểu diễn dưới dạng JSON
{
  "data": string,
  "fullSizeImageUrl": string,
  "previewSizeImageUrl": string
}
Các trường
data

string (bytes format)

Không thể thay đổi. Dữ liệu hình ảnh thô.

Chuỗi được mã hoá base64.

fullSizeImageUrl

string

Chỉ có đầu ra. URL đến phiên bản có kích thước đầy đủ của hình ảnh.

previewSizeImageUrl

string

Chỉ có đầu ra. URL dẫn đến phiên bản kích thước xem trước của hình ảnh.

MediaBundle

Đại diện cho nội dung của phương tiện lưu trữ ZIP chứa nội dung HTML5.

Biểu diễn dưới dạng JSON
{
  "data": string,
  "url": string
}
Các trường
data

string (bytes format)

Không thể thay đổi. Dữ liệu nén thô.

Chuỗi được mã hoá base64.

url

string

Chỉ có đầu ra. URL để truy cập dữ liệu nén đã tải lên. Ví dụ: https://tpc.googlesyndication.com/simgad/123 Trường này chỉ có thể đọc.

MediaAudio

Đóng gói âm thanh.

Biểu diễn dưới dạng JSON
{
  "adDurationMillis": string
}
Các trường
adDurationMillis

string (int64 format)

Chỉ có đầu ra. Thời lượng của Âm thanh tính bằng mili giây.

MediaVideo

Đóng gói video.

Biểu diễn dưới dạng JSON
{
  "adDurationMillis": string,
  "youtubeVideoId": string,
  "advertisingIdCode": string,
  "isciCode": string
}
Các trường
adDurationMillis

string (int64 format)

Chỉ có đầu ra. Thời lượng của Video tính bằng mili giây.

youtubeVideoId

string

Không thể thay đổi. ID video trên YouTube (như bạn thấy trong URL YouTube). Thêm tiền tố "https://www.youtube.com/watch?v=" vào mã nhận dạng này sẽ nhận được URL phát trực tuyến trên YouTube của video này.

advertisingIdCode

string

Chỉ có đầu ra. Mã nhận dạng kỹ thuật số quảng cáo cho video này, do Hiệp hội các công ty quảng cáo Hoa Kỳ xác định, chủ yếu dùng cho quảng cáo truyền hình.

isciCode

string

Chỉ có đầu ra. Mã nhận dạng thương mại tiêu chuẩn của ngành cho video này, chủ yếu dùng cho quảng cáo truyền hình.