Skip to content

Most visited

Recently visited


Video Program Attributes

A video program's attributes depend on the type of its content. The program type tells the system what metadata to expect so that the UI can be filled in appropriately. Video programs can be one of these types:

Use PreviewProgram.Builder to build a program. You can read more about possible values for each field in the java docs for each setter on the builder.

PreviewProgram program = new PreviewProgram.Builder()
                    // Set required attributes

The following table shows the attributes that can be assigned to each type of video program and links to the corresponding setter in PreviewProgram.Builder. Attributes marked are required, those marked (✔) are optional:

Attribute Movie TV Series TV Season TV Episode Clip Event Channel
Author (✔)
Availability (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Canonical Genres (✔)(✔)(✔)(✔)
Channel ID
Content ID (✔)
Content Ratings (✔)(✔)(✔)
DurationMillis (✔)
Episode Number
Episode Title (✔)
Genre (✔)(✔) (✔)(✔)
Intent URI
Interaction Count (✔)(✔)
Interaction Type (✔)(✔)
Internal Provider ID (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Item Count(✔) (✔)
Live (✔)(✔)(✔)(✔)(✔)
Logo URI (*) (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Logo Content Description (*) (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Offer Price (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Poster Art Aspect Ratio
Poster Art URI
Preview Video URI (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Release Date (✔)(✔)(✔)(✔)(✔)(✔)
Review Rating (✔)(✔)(✔)(✔)(✔)
Review Rating Style (✔)(✔)(✔)(✔)(✔)
Season Display Number
Short Description (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Start Time UTC Millis (*)
End Time UTC Millis (*)
Starting Price (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Thumbnail Aspect Ratio (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Thumbnail URI (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Video Height (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Video Width (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Weight (✔)(✔)(✔)(✔)(✔)(✔)(✔)

(*) Notes:
START/END times only appear on the screen when the LIVE attribute is true.
LOGO_CONTENT_DESCRIPTION is required when LOGO_URI is used.

Preview images

The recommended sizes for preview images are:

Attribute Aspect Ratio Width Height
ASPECT_RATIO_16_9 16:9 272dp 153dp
ASPECT_RATIO_3_2 3:2 229.5dp 153dp
ASPECT_RATIO_4_3 4:3 204dp 153dp
ASPECT_RATIO_1_1 1:1 153dp 153dp
ASPECT_RATIO_2_3 2:3 102dp 153dp
ASPECT_RATIO_MOVIE_POSTER 1:1.441 106dp 153dp

For best quality, preview videos should be 16:9 or 4:3 and at least the sizes specified in the table above. The logo should also be opaque for the best user experience.

You can specify the exact preview video sizes using VIDEO_WIDTH and VIDEO_HEIGHT.

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields


Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience. (April 2018 — Developer Survey)