Video API, gRPC: ThumbnailService.BatchGenerateDownloadURLs
Generates download URLs for multiple thumbnails in a single request.
The response includes URLs for both original and scaled versions of each thumbnail.
This is useful for efficiently retrieving multiple thumbnails at once.
gRPC request
rpc BatchGenerateDownloadURLs (BatchGenerateDownloadURLsRequest) returns (BatchGenerateDownloadURLsResponse)
BatchGenerateDownloadURLsRequest
{
"channel_id": "string",
"thumbnail_ids": [
"string"
]
}
|
Field |
Description |
|
channel_id |
string Required field. ID of the channel containing the thumbnails. The maximum string length in characters is 50. |
|
thumbnail_ids[] |
string List of thumbnail IDs for which to generate download URLs. The number of elements must be in the range 1-100. The maximum string length in characters for each value is 50. |
BatchGenerateDownloadURLsResponse
{
"download_urls": [
{
"thumbnail_id": "string",
"original_url": "string",
"scaled_urls": [
{
"url": "string",
"max_width": "int64",
"max_height": "int64",
"image_format": "ImageFormat"
}
]
}
]
}
|
Field |
Description |
|
download_urls[] |
List of download URLs for the requested thumbnails. |
ThumbnailDownloadURL
|
Field |
Description |
|
thumbnail_id |
string ID of the thumbnail for which download URLs are provided. |
|
original_url |
string URL for downloading the original, unmodified thumbnail image. |
|
scaled_urls[] |
List of URLs for downloading scaled versions of the thumbnail. |
ScaledURL
Represents a URL for a specific scaled version of a thumbnail image.
|
Field |
Description |
|
url |
string URL for downloading this scaled version of the thumbnail. |
|
max_width |
int64 Maximum width in pixels of the scaled image. |
|
max_height |
int64 Maximum height in pixels of the scaled image. |
|
image_format |
enum ImageFormat Format of the scaled image (JPEG, WebP, etc.).
|