MediaFile

  • A media file is identified by a resource name in the format customers/{customer_id}/mediaFiles/{media_file_id} and has a unique ID.

  • Media files have an immutable type (AUDIO, IMAGE, MEDIA_BUNDLE, VIDEO) and an output-only mime type.

  • Optional immutable fields include the original download source URL (for AUDIO and IMAGE only) and a client-defined name.

  • The size of the media file in bytes is an output-only field.

  • The specific media type (image, media bundle, audio, or video) is encapsulated in a union field.

A media file.

Fields

resource_name

string

Immutable. The resource name of the media file. Media file resource names have the form:

customers/{customer_id}/mediaFiles/{media_file_id}

type

MediaType

Immutable. Type of the media file.

mime_type

MimeType

Output only. The mime type of the media file.

id

int64

Output only. The ID of the media file.

source_url

string

Immutable. The URL of where the original media file was downloaded from (or a file name). Only used for media of type AUDIO and IMAGE.

name

string

Immutable. The name of the media file. The name can be used by clients to help identify previously uploaded media.

file_size

int64

Output only. The size of the media file in bytes.
Union field

mediatype

mediatype. The specific type of the media file. mediatype can be only one of the following:

image

MediaImage

Immutable. Encapsulates an Image.

media_bundle

MediaBundle

Immutable. A ZIP archive media the content of which contains HTML5 assets.

audio

MediaAudio

Output only. Encapsulates an Audio.

video

MediaVideo

Immutable. Encapsulates a Video.