--- v22/services/shareable_preview_service.proto 2026-03-19 17:15:59.000000000 +0000 +++ v23/services/shareable_preview_service.proto 2026-03-19 17:16:06.000000000 +0000 @@ -59,9 +60,22 @@ // A shareable preview with its identifier. message ShareablePreview { - // Required. Asset group of the shareable preview. + // Optional. Asset group of the shareable preview. Only supported for preview + // type UI_PREVIEW or unset. AssetGroupIdentifier asset_group_identifier = 1 - [(google.api.field_behavior) = REQUIRED]; + [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The type of preview to generate. + google.ads.googleads.v23.enums.PreviewTypeEnum.PreviewType preview_type = 3 + [(google.api.field_behavior) = OPTIONAL]; + + // The identifier of the shareable preview. + oneof identifier { + // Ad group ad of the shareable preview. Only supported for preview type + // YOUTUBE_LIVE_PREVIEW. + // Format: customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id} + string ad_group_ad = 2; + } } // Asset group of the shareable preview. @@ -90,6 +104,13 @@ // The shareable preview partial failure error. google.rpc.Status partial_failure_error = 2; } + + // The identifier of the shareable preview. + oneof identifier { + // The ad group ad of the shareable preview. + // Format: customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id} + string ad_group_ad = 4; + } } // Message to hold a shareable preview result. @@ -94,9 +115,26 @@ // Message to hold a shareable preview result. message ShareablePreviewResult { - // The shareable preview URL. + // The shareable preview URL. Only populated if preview type is UI_PREVIEW + // or unset. string shareable_preview_url = 1; // Expiration date time using the ISO-8601 format. string expiration_date_time = 2; + + // The result of the shareable preview. + oneof result { + // The result of a YouTube live preview. Only populated for preview type + // YOUTUBE_LIVE_PREVIEW. + YouTubeLivePreviewResult youtube_live_preview_result = 3; + } +} + +// Message to hold a YouTube live preview result. +message YouTubeLivePreviewResult { + // The shareable preview URL for YouTube videos. + string youtube_preview_url = 1; + + // The shareable preview URL for YouTube TV. + string youtube_tv_preview_url = 2; }
/services/shareable_preview_service.proto
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-03-24 UTC.