Method: media.download

AI-generated Key Takeaways

• Download media via the /download/{resourceName=**}?alt=media URI, ensuring to include alt=media.

• The request uses the GET method and requires an empty request body.

• A successful response returns a Media object containing the downloaded content.

• Authorization requires the https://www.googleapis.com/auth/display-video OAuth scope.

• The resourceName path parameter specifies the name of the media to be downloaded.

Display & Video 360 API v3 is deprecated and will sunset on October 7, 2025. Migrate to Display & Video 360 API v4 before sunset to avoid an interruption in service.

• HTTP request
• Path parameters
• Request body
• Response body
• Authorization scopes
• Try it!

Downloads media. Download is supported on the URI /download/{resourceName=**}?alt=media.

Note: Download requests will not be successful without including alt=media query string.

HTTP request

GET https://displayvideo.googleapis.com/download/{resourceName=**}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
resourceName	string Name of the media that is being downloaded. See ReadRequest.resource_name.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of Media.

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/display-video

For more information, see the OAuth 2.0 Overview.