google-api-python-client 2.161.0__py2.py3-none-any.whl → 2.163.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/displayvideo.v2.json

@@ -4832,7 +4832,7 @@
 ]
 },
 "patch": {
-"description": "Updates an existing custom bidding algorithm. Returns the updated custom bidding algorithm if successful.",
+"description": "Updates an existing custom bidding algorithm. Returns the updated custom bidding algorithm if successful. *Warning*: Starting **April 1, 2025**, requests updating custom bidding algorithms that are assigned to line items will return an error. [Read more about this announced change](/display-video/api/deprecations#features.custom_bidding_floodlight).",
 "flatPath": "v2/customBiddingAlgorithms/{customBiddingAlgorithmsId}",
 "httpMethod": "PATCH",
 "id": "displayvideo.customBiddingAlgorithms.patch",
@@ -4909,7 +4909,7 @@
 "scripts": {
 "methods": {
 "create": {
-"description": "Creates a new custom bidding script. Returns the newly created script if successful.",
+"description": "Creates a new custom bidding script. Returns the newly created script if successful. *Warning*: Starting **April 1, 2025**, requests updating custom bidding algorithms that are assigned to line items will return an error. [Read more about this announced change](/display-video/api/deprecations#features.custom_bidding_floodlight).",
 "flatPath": "v2/customBiddingAlgorithms/{customBiddingAlgorithmsId}/scripts",
 "httpMethod": "POST",
 "id": "displayvideo.customBiddingAlgorithms.scripts.create",
@@ -8010,7 +8010,7 @@
 }
 }
 },
-"revision": "20250205",
+"revision": "20250220",
 "rootUrl": "https://displayvideo.googleapis.com/",
 "schemas": {
 "ActivateManualTriggerRequest": {
@@ -8587,10 +8587,10 @@
 "properties": {
 "asset": {
 "$ref": "Asset",
-"description": "The associated asset."
+"description": "Optional. The associated asset."
 },
 "role": {
-"description": "The role of this asset for the creative.",
+"description": "Optional. The role of this asset for the creative.",
 "enum": [
 "ASSET_ROLE_UNSPECIFIED",
 "ASSET_ROLE_MAIN",
@@ -8620,24 +8620,24 @@
 "The asset is the main asset of the creative.",
 "The asset is a backup asset of the creative.",
 "The asset is a polite load asset of the creative.",
-"Headline of a native creative. The content must be UTF-8 encoded with a length of no more than 25 characters. This role is only supported in following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_NATIVE_VIDEO`",
-"Long headline of a native creative. The content must be UTF-8 encoded with a length of no more than 50 characters. This role is only supported in following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_NATIVE_VIDEO`",
-"Body text of a native creative. The content must be UTF-8 encoded with a length of no more than 90 characters. This role is only supported in following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_NATIVE_VIDEO`",
-"Long body text of a native creative. The content must be UTF-8 encoded with a length of no more than 150 characters. This role is only supported in following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_NATIVE_VIDEO`",
-"A short, friendly version of the landing page URL to show in the creative. This URL gives people an idea of where they'll arrive after they click on the creative. The content must be UTF-8 encoded with a length of no more than 30 characters. For example, if the landing page URL is 'http://www.example.com/page', the caption URL can be 'example.com'. The protocol (http://) is optional, but the URL can't contain spaces or special characters. This role is only supported in following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_NATIVE_VIDEO`",
-"The text to use on the call-to-action button of a native creative. The content must be UTF-8 encoded with a length of no more than 15 characters. This role is only supported in following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_NATIVE_VIDEO`",
-"The text that identifies the advertiser or brand name. The content must be UTF-8 encoded with a length of no more than 25 characters. This role is only supported in following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_NATIVE_VIDEO`",
+"Headline of a native creative. The content must be UTF-8 encoded with a length of no more than 25 characters. This role is only supported in the following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_NATIVE_VIDEO`",
+"Long headline of a native creative. The content must be UTF-8 encoded with a length of no more than 50 characters. This role is only supported in the following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_NATIVE_VIDEO`",
+"Body text of a native creative. The content must be UTF-8 encoded with a length of no more than 90 characters. This role is only supported in the following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_NATIVE_VIDEO`",
+"Long body text of a native creative. The content must be UTF-8 encoded with a length of no more than 150 characters. This role is only supported in the following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_NATIVE_VIDEO`",
+"A short, friendly version of the landing page URL to show in the creative. This URL gives people an idea of where they'll arrive after they click on the creative. The content must be UTF-8 encoded with a length of no more than 30 characters. For example, if the landing page URL is 'http://www.example.com/page', the caption URL can be 'example.com'. The protocol (http://) is optional, but the URL can't contain spaces or special characters. This role is only supported in the following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_NATIVE_VIDEO`",
+"The text to use on the call-to-action button of a native creative. The content must be UTF-8 encoded with a length of no more than 15 characters. This role is only supported in the following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_NATIVE_VIDEO`",
+"The text that identifies the advertiser or brand name. The content must be UTF-8 encoded with a length of no more than 25 characters. This role is only supported in the following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_NATIVE_VIDEO`",
 "The purchase price of your app in the Google play store or iOS app store (for example, $5.99). Note that this value is not automatically synced with the actual value listed in the store. It will always be the one provided when save the creative. The content must be UTF-8 encoded with a length of no more than 15 characters. Assets of this role are read-only.",
-"The ID of an Android app in the Google play store. You can find this ID in the App\u2019s Google Play Store URL after \u2018id\u2019. For example, in https://play.google.com/store/apps/details?id=com.company.appname the identifier is com.company.appname. Assets of this role are read-only.",
-"The ID of an iOS app in the Apple app store. This ID number can be found in the Apple App Store URL as the string of numbers directly after \"id\". For example, in https://apps.apple.com/us/app/gmail-email-by-google/id422689480 the ID is 422689480. Assets of this role are read-only.",
+"The ID of an Android app in the Google play store. You can find this ID in the App\u2019s Google Play Store URL after \u2018id\u2019. For example, in `https://play.google.com/store/apps/details?id=com.company.appname` the identifier is com.company.appname. Assets of this role are read-only.",
+"The ID of an iOS app in the Apple app store. This ID number can be found in the Apple App Store URL as the string of numbers directly after \"id\". For example, in `https://apps.apple.com/us/app/gmail-email-by-google/id422689480` the ID is 422689480. Assets of this role are read-only.",
 "The rating of an app in the Google play store or iOS app store. Note that this value is not automatically synced with the actual rating in the store. It will always be the one provided when save the creative. Assets of this role are read-only.",
-"The icon of a creative. This role is only supported and required in following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE`",
-"The cover image of a native video creative. This role is only supported and required in following creative_type: * `CREATIVE_TYPE_VIDEO`",
-"The main color to use in a creative. This role is only supported and required in following creative_type: * `CREATIVE_TYPE_ASSET_BASED_CREATIVE`",
-"The accent color to use in a creative. This role is only supported and required in following creative_type: * `CREATIVE_TYPE_ASSET_BASED_CREATIVE`",
-"Whether the creative must use a logo asset. This role is only supported and required in following creative_type: * `CREATIVE_TYPE_ASSET_BASED_CREATIVE`",
-"Whether the creative must use an image asset. This role is only supported and required in following creative_type: * `CREATIVE_TYPE_ASSET_BASED_CREATIVE`",
-"Whether asset enhancements can be applied to the creative. This role is only supported and required in following creative_type: * `CREATIVE_TYPE_ASSET_BASED_CREATIVE`"
+"The icon of a creative. This role is only supported and required in the following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE`",
+"The cover image of a native video creative. This role is only supported and required in the following creative_type: * `CREATIVE_TYPE_VIDEO`",
+"The main color to use in a creative. This role is only supported and required in the following creative_type: * `CREATIVE_TYPE_ASSET_BASED_CREATIVE`",
+"The accent color to use in a creative. This role is only supported and required in the following creative_type: * `CREATIVE_TYPE_ASSET_BASED_CREATIVE`",
+"Whether the creative must use a logo asset. This role is only supported and required in the following creative_type: * `CREATIVE_TYPE_ASSET_BASED_CREATIVE`",
+"Whether the creative must use an image asset. This role is only supported and required in the following creative_type: * `CREATIVE_TYPE_ASSET_BASED_CREATIVE`",
+"Whether asset enhancements can be applied to the creative. This role is only supported and required in the following creative_type: * `CREATIVE_TYPE_ASSET_BASED_CREATIVE`"
 ],
 "type": "string"
 }
@@ -9081,24 +9081,24 @@
 "type": "object"
 },
 "AudienceGroupAssignedTargetingOptionDetails": {
-"description": "Assigned audience group targeting option details. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_AUDIENCE_GROUP`. The relation between each group is UNION, except for excluded_first_and_third_party_audience_group and excluded_google_audience_group, of which COMPLEMENT is used as an INTERSECTION with other groups. NEXT_ID: 9",
+"description": "Assigned audience group targeting option details. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_AUDIENCE_GROUP`. The relation between each group is UNION, except for excluded_first_and_third_party_audience_group and excluded_google_audience_group, of which COMPLEMENT is used as an INTERSECTION with other groups.",
 "id": "AudienceGroupAssignedTargetingOptionDetails",
 "properties": {
 "excludedGoogleAudienceGroup": {
 "$ref": "GoogleAudienceGroup",
-"description": "The Google audience ids of the excluded Google audience group. Used for negative targeting. The COMPLEMENT of the UNION of this group and other excluded audience groups is used as an INTERSECTION to any positive audience targeting. Only contains Affinity, In-market and Installed-apps type Google audiences. All items are logically \u2018OR\u2019 of each other."
+"description": "Optional. The Google audience ids of the excluded Google audience group. Used for negative targeting. The COMPLEMENT of the UNION of this group and other excluded audience groups is used as an INTERSECTION to any positive audience targeting. Only contains Affinity, In-market and Installed-apps type Google audiences. All items are logically \u2018OR\u2019 of each other."
 },
 "includedCombinedAudienceGroup": {
 "$ref": "CombinedAudienceGroup",
-"description": "The combined audience ids of the included combined audience group. Contains combined audience ids only."
+"description": "Optional. The combined audience ids of the included combined audience group. Contains combined audience ids only."
 },
 "includedCustomListGroup": {
 "$ref": "CustomListGroup",
-"description": "The custom list ids of the included custom list group. Contains custom list ids only."
+"description": "Optional. The custom list ids of the included custom list group. Contains custom list ids only."
 },
 "includedGoogleAudienceGroup": {
 "$ref": "GoogleAudienceGroup",
-"description": "The Google audience ids of the included Google audience group. Contains Google audience ids only."
+"description": "Optional. The Google audience ids of the included Google audience group. Contains Google audience ids only."
 }
 },
 "type": "object"
@@ -9182,12 +9182,12 @@
 "id": "AudioVideoOffset",
 "properties": {
 "percentage": {
-"description": "The offset in percentage of the audio or video duration.",
+"description": "Optional. The offset in percentage of the audio or video duration.",
 "format": "int64",
 "type": "string"
 },
 "seconds": {
-"description": "The offset in seconds from the start of the audio or video.",
+"description": "Optional. The offset in seconds from the start of the audio or video.",
 "format": "int64",
 "type": "string"
 }
@@ -10026,7 +10026,7 @@
 },
 "frequencyCap": {
 "$ref": "FrequencyCap",
-"description": "Required. The frequency cap setting of the campaign."
+"description": "Required. The frequency cap setting of the campaign. *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap)"
 },
 "name": {
 "description": "Output only. The resource name of the campaign.",
@@ -10342,17 +10342,17 @@
 "id": "CmTrackingAd",
 "properties": {
 "cmAdId": {
-"description": "The ad ID of the campaign manager 360 tracking Ad.",
+"description": "Optional. The ad ID of the campaign manager 360 tracking Ad.",
 "format": "int64",
 "type": "string"
 },
 "cmCreativeId": {
-"description": "The creative ID of the campaign manager 360 tracking Ad.",
+"description": "Optional. The creative ID of the campaign manager 360 tracking Ad.",
 "format": "int64",
 "type": "string"
 },
 "cmPlacementId": {
-"description": "The placement ID of the campaign manager 360 tracking Ad.",
+"description": "Optional. The placement ID of the campaign manager 360 tracking Ad.",
 "format": "int64",
 "type": "string"
 }
@@ -10387,7 +10387,7 @@
 "id": "CombinedAudienceGroup",
 "properties": {
 "settings": {
-"description": "Required. All combined audience targeting settings in combined audience group. Repeated settings with same id will be ignored. The number of combined audience settings should be no more than five, error will be thrown otherwise.",
+"description": "Required. All combined audience targeting settings in combined audience group. Repeated settings with the same id will be ignored. The number of combined audience settings should be no more than five, error will be thrown otherwise.",
 "items": {
 "$ref": "CombinedAudienceTargetingSetting"
 },
@@ -10736,7 +10736,7 @@
 "id": "ConversionCountingConfig",
 "properties": {
 "floodlightActivityConfigs": {
-"description": "The Floodlight activity configs used to track conversions. The number of conversions counted is the sum of all of the conversions counted by all of the Floodlight activity IDs specified in this field.",
+"description": "The Floodlight activity configs used to track conversions. The number of conversions counted is the sum of all of the conversions counted by all of the Floodlight activity IDs specified in this field. *Warning*: Starting **April 1, 2025**, this field will no longer be writable while a custom bidding algorithm is assigned to the line item. If you set this field and assign a custom bidding algorithm in the same request, the floodlight activities must match the ones used by the custom bidding algorithm. [Read more about this announced change](/display-video/api/deprecations#features.custom_bidding_floodlight).",
 "items": {
 "$ref": "TrackingFloodlightActivityConfig"
 },
@@ -10996,7 +10996,7 @@ false
 "id": "Creative",
 "properties": {
 "additionalDimensions": {
-"description": "Additional dimensions. Applicable when creative_type is one of: * `CREATIVE_TYPE_STANDARD` * `CREATIVE_TYPE_EXPANDABLE` * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_LIGHTBOX` * `CREATIVE_TYPE_PUBLISHER_HOSTED` If this field is specified, width_pixels and height_pixels are both required and must be greater than or equal to 0.",
+"description": "Optional. Additional dimensions. Applicable when creative_type is one of: * `CREATIVE_TYPE_STANDARD` * `CREATIVE_TYPE_EXPANDABLE` * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_LIGHTBOX` * `CREATIVE_TYPE_PUBLISHER_HOSTED` If this field is specified, width_pixels and height_pixels are both required and must be greater than or equal to 0.",
 "items": {
 "$ref": "Dimensions"
 },
@@ -11009,7 +11009,7 @@ false
 "type": "string"
 },
 "appendedTag": {
-"description": "Third-party HTML tracking tag to be appended to the creative tag.",
+"description": "Optional. Third-party HTML tracking tag to be appended to the creative tag.",
 "type": "string"
 },
 "assets": {
@@ -11027,10 +11027,10 @@ false
 },
 "cmTrackingAd": {
 "$ref": "CmTrackingAd",
-"description": "The Campaign Manager 360 tracking ad associated with the creative. Optional for the following creative_type when created by an advertiser that uses both Campaign Manager 360 and third-party ad serving: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` Output only for other cases."
+"description": "Optional. The Campaign Manager 360 tracking ad associated with the creative. Optional for the following creative_type when created by an advertiser that uses both Campaign Manager 360 and third-party ad serving: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` Output only for other cases."
 },
 "companionCreativeIds": {
-"description": "The IDs of companion creatives for a video creative. You can assign existing display creatives (with image or HTML5 assets) to serve surrounding the publisher's video player. Companions display around the video player while the video is playing and remain after the video has completed. Creatives contain additional dimensions can not be companion creatives. This field is only supported for following creative_type: * `CREATIVE_TYPE_AUDIO` * `CREATIVE_TYPE_VIDEO`",
+"description": "Optional. The IDs of companion creatives for a video creative. You can assign existing display creatives (with image or HTML5 assets) to serve surrounding the publisher's video player. Companions display around the video player while the video is playing and remain after the video has completed. Creatives contain additional dimensions can not be companion creatives. This field is only supported for the following creative_type: * `CREATIVE_TYPE_AUDIO` * `CREATIVE_TYPE_VIDEO`",
 "items": {
 "format": "int64",
 "type": "string"
@@ -11038,7 +11038,7 @@ false
 "type": "array"
 },
 "counterEvents": {
-"description": "Counter events for a rich media creative. Counters track the number of times that a user interacts with any part of a rich media creative in a specified way (mouse-overs, mouse-outs, clicks, taps, data loading, keyboard entries, etc.). Any event that can be captured in the creative can be recorded as a counter. Leave it empty or unset for creatives containing image assets only.",
+"description": "Optional. Counter events for a rich media creative. Counters track the number of times that a user interacts with any part of a rich media creative in a specified way (mouse-overs, mouse-outs, clicks, taps, data loading, keyboard entries, etc.). Any event that can be captured in the creative can be recorded as a counter. Leave it empty or unset for creatives containing image assets only.",
 "items": {
 "$ref": "CounterEvent"
 },
@@ -11112,7 +11112,7 @@ false
 "Publisher hosted creative. Create and update methods are **not** supported for this creative type.",
 "Native video creative. Create and update methods are supported for this creative type if the hosting_source is `HOSTING_SOURCE_HOSTED`",
 "Templated app install mobile video creative. Create and update methods are **not** supported for this creative type.",
-"Asset based creative. Create and update methods are supported for this creative type if the hosting_source is `HOSTING_SOURCE_HOSTED`."
+"Asset-based creative. Create and update methods are supported for this creative type if the hosting_source is `HOSTING_SOURCE_HOSTED`."
 ],
 "type": "string"
 },
@@ -11218,15 +11218,15 @@ false
 "type": "boolean"
 },
 "iasCampaignMonitoring": {
-"description": "Indicates whether Integral Ad Science (IAS) campaign monitoring is enabled. To enable this for the creative, make sure the Advertiser.creative_config.ias_client_id has been set to your IAS client ID.",
+"description": "Optional. Indicates whether Integral Ad Science (IAS) campaign monitoring is enabled. To enable this for the creative, make sure the Advertiser.creative_config.ias_client_id has been set to your IAS client ID.",
 "type": "boolean"
 },
 "integrationCode": {
-"description": "ID information used to link this creative to an external system. Must be UTF-8 encoded with a length of no more than 10,000 characters.",
+"description": "Optional. ID information used to link this creative to an external system. Must be UTF-8 encoded with a length of no more than 10,000 characters.",
 "type": "string"
 },
 "jsTrackerUrl": {
-"description": "JavaScript measurement URL from supported third-party verification providers (ComScore, DoubleVerify, IAS, Moat). HTML script tags are not supported. This field is only writeable in following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_NATIVE_VIDEO`",
+"description": "Optional. JavaScript measurement URL from supported third-party verification providers (ComScore, DoubleVerify, IAS, Moat). HTML script tags are not supported. This field is only writeable in the following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_NATIVE_VIDEO`",
 "type": "string"
 },
 "lineItemIds": {
@@ -11255,12 +11255,12 @@ false
 "type": "string"
 },
 "notes": {
-"description": "User notes for this creative. Must be UTF-8 encoded with a length of no more than 20,000 characters.",
+"description": "Optional. User notes for this creative. Must be UTF-8 encoded with a length of no more than 20,000 characters.",
 "type": "string"
 },
 "obaIcon": {
 "$ref": "ObaIcon",
-"description": "Specifies the OBA icon for a video creative. This field is only supported in following creative_type: * `CREATIVE_TYPE_VIDEO`"
+"description": "Optional. Specifies the OBA icon for a video creative. This field is only supported in the following creative_type: * `CREATIVE_TYPE_VIDEO`"
 },
 "oggAudio": {
 "description": "Output only. Indicates the third-party audio creative supports OGG. Output only and only valid for third-party audio creatives. Third-party audio creatives are creatives with following hosting_source: * `HOSTING_SOURCE_THIRD_PARTY` combined with following creative_type: * `CREATIVE_TYPE_AUDIO`",
@@ -11269,7 +11269,7 @@ false
 },
 "progressOffset": {
 "$ref": "AudioVideoOffset",
-"description": "Amount of time to play the video before counting a view. This field is required when skippable is true. This field is only supported for the following creative_type: * `CREATIVE_TYPE_VIDEO`"
+"description": "Optional. Amount of time to play the video before counting a view. This field is required when skippable is true. This field is only supported for the following creative_type: * `CREATIVE_TYPE_VIDEO`"
 },
 "requireHtml5": {
 "description": "Optional. Indicates that the creative relies on HTML5 to render properly. Optional and only valid for third-party tag creatives. Third-party tag creatives are creatives with following hosting_source: * `HOSTING_SOURCE_THIRD_PARTY` combined with following creative_type: * `CREATIVE_TYPE_STANDARD` * `CREATIVE_TYPE_EXPANDABLE`",
@@ -11290,10 +11290,10 @@ false
 },
 "skipOffset": {
 "$ref": "AudioVideoOffset",
-"description": "Amount of time to play the video before the skip button appears. This field is required when skippable is true. This field is only supported for the following creative_type: * `CREATIVE_TYPE_VIDEO`"
+"description": "Optional. Amount of time to play the video before the skip button appears. This field is required when skippable is true. This field is only supported for the following creative_type: * `CREATIVE_TYPE_VIDEO`"
 },
 "skippable": {
-"description": "Whether the user can choose to skip a video creative. This field is only supported for the following creative_type: * `CREATIVE_TYPE_VIDEO`",
+"description": "Optional. Whether the user can choose to skip a video creative. This field is only supported for the following creative_type: * `CREATIVE_TYPE_VIDEO`",
 "type": "boolean"
 },
 "thirdPartyTag": {
@@ -11301,28 +11301,28 @@ false
 "type": "string"
 },
 "thirdPartyUrls": {
-"description": "Tracking URLs from third parties to track interactions with a video creative. This field is only supported for the following creative_type: * `CREATIVE_TYPE_AUDIO` * `CREATIVE_TYPE_VIDEO` * `CREATIVE_TYPE_NATIVE_VIDEO`",
+"description": "Optional. Tracking URLs from third parties to track interactions with a video creative. This field is only supported for the following creative_type: * `CREATIVE_TYPE_AUDIO` * `CREATIVE_TYPE_VIDEO` * `CREATIVE_TYPE_NATIVE_VIDEO`",
 "items": {
 "$ref": "ThirdPartyUrl"
 },
 "type": "array"
 },
 "timerEvents": {
-"description": "Timer custom events for a rich media creative. Timers track the time during which a user views and interacts with a specified part of a rich media creative. A creative can have multiple timer events, each timed independently. Leave it empty or unset for creatives containing image assets only.",
+"description": "Optional. Timer custom events for a rich media creative. Timers track the time during which a user views and interacts with a specified part of a rich media creative. A creative can have multiple timer events, each timed independently. Leave it empty or unset for creatives containing image assets only.",
 "items": {
 "$ref": "TimerEvent"
 },
 "type": "array"
 },
 "trackerUrls": {
-"description": "Tracking URLs for analytics providers or third-party ad technology vendors. The URLs must start with https (except on inventory that doesn't require SSL compliance). If using macros in your URL, use only macros supported by Display & Video 360. Standard URLs only, no IMG or SCRIPT tags. This field is only writeable in following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_NATIVE_VIDEO`",
+"description": "Optional. Tracking URLs for analytics providers or third-party ad technology vendors. The URLs must start with `https:` (except on inventory that doesn't require SSL compliance). If using macros in your URL, use only macros supported by Display & Video 360. Standard URLs only, no IMG or SCRIPT tags. This field is only writeable in the following creative_type: * `CREATIVE_TYPE_NATIVE` * `CREATIVE_TYPE_NATIVE_SITE_SQUARE` * `CREATIVE_TYPE_NATIVE_VIDEO`",
 "items": {
 "type": "string"
 },
 "type": "array"
 },
 "transcodes": {
-"description": "Output only. Audio/Video transcodes. Display & Video 360 transcodes the main asset into a number of alternative versions that use different file formats or have different properties (resolution, audio bit rate, and video bit rate), each designed for specific video players or bandwidths. These transcodes give a publisher's system more options to choose from for each impression on your video and ensures that the appropriate file serves based on the viewer\u2019s connection and screen size. This field is only supported in following creative_type: * `CREATIVE_TYPE_VIDEO` * `CREATIVE_TYPE_NATIVE_VIDEO` * `CREATIVE_TYPE_AUDIO`",
+"description": "Output only. Audio/Video transcodes. Display & Video 360 transcodes the main asset into a number of alternative versions that use different file formats or have different properties (resolution, audio bit rate, and video bit rate), each designed for specific video players or bandwidths. These transcodes give a publisher's system more options to choose from for each impression on your video and ensures that the appropriate file serves based on the viewer\u2019s connection and screen size. This field is only supported in the following creative_type: * `CREATIVE_TYPE_VIDEO` * `CREATIVE_TYPE_NATIVE_VIDEO` * `CREATIVE_TYPE_AUDIO`",
 "items": {
 "$ref": "Transcode"
 },
@@ -11391,7 +11391,7 @@ false
 "Publisher hosted creative. Create and update methods are **not** supported for this creative type.",
 "Native video creative. Create and update methods are supported for this creative type if the hosting_source is `HOSTING_SOURCE_HOSTED`",
 "Templated app install mobile video creative. Create and update methods are **not** supported for this creative type.",
-"Asset based creative. Create and update methods are supported for this creative type if the hosting_source is `HOSTING_SOURCE_HOSTED`."
+"Asset-based creative. Create and update methods are supported for this creative type if the hosting_source is `HOSTING_SOURCE_HOSTED`."
 ],
 "type": "string"
 },
@@ -11667,7 +11667,7 @@ false
 "id": "CustomListGroup",
 "properties": {
 "settings": {
-"description": "Required. All custom list targeting settings in custom list group. Repeated settings with same id will be ignored.",
+"description": "Required. All custom list targeting settings in custom list group. Repeated settings with the same id will be ignored.",
 "items": {
 "$ref": "CustomListTargetingSetting"
 },
@@ -13392,11 +13392,11 @@ false
 "id": "ExitEvent",
 "properties": {
 "name": {
-"description": "The name of the click tag of the exit event. The name must be unique within one creative. Leave it empty or unset for creatives containing image assets only.",
+"description": "Optional. The name of the click tag of the exit event. The name must be unique within one creative. Leave it empty or unset for creatives containing image assets only.",
 "type": "string"
 },
 "reportingName": {
-"description": "The name used to identify this event in reports. Leave it empty or unset for creatives containing image assets only.",
+"description": "Optional. The name used to identify this event in reports. Leave it empty or unset for creatives containing image assets only.",
 "type": "string"
 },
 "type": {
@@ -13564,7 +13564,7 @@ false
 "type": "integer"
 },
 "timeUnit": {
-"description": "The time unit in which the frequency cap will be applied. Required when unlimited is `false`.",
+"description": "The time unit in which the frequency cap will be applied. Required when unlimited is `false`. *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. This field will no longer accept the value `TIME_UNIT_LIFETIME`. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap).",
 "enum": [
 "TIME_UNIT_UNSPECIFIED",
 "TIME_UNIT_LIFETIME",
@@ -13586,7 +13586,7 @@ false
 "type": "string"
 },
 "timeUnitCount": {
-"description": "The number of time_unit the frequency cap will last. Required when unlimited is `false`. The following restrictions apply based on the value of time_unit: * `TIME_UNIT_LIFETIME` - this field is output only and will default to 1 * `TIME_UNIT_MONTHS` - must be between 1 and 2 * `TIME_UNIT_WEEKS` - must be between 1 and 4 * `TIME_UNIT_DAYS` - must be between 1 and 6 * `TIME_UNIT_HOURS` - must be between 1 and 23 * `TIME_UNIT_MINUTES` - must be between 1 and 59",
+"description": "The number of time_unit the frequency cap will last. Required when unlimited is `false`. The following restrictions apply based on the value of time_unit: * `TIME_UNIT_LIFETIME` - this field is output only and will default to 1 * `TIME_UNIT_MONTHS` - must be between 1 and 2 * `TIME_UNIT_WEEKS` - must be between 1 and 4 * `TIME_UNIT_DAYS` - must be between 1 and 6 * `TIME_UNIT_HOURS` - must be between 1 and 23 * `TIME_UNIT_MINUTES` - must be between 1 and 59 *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. This field will no longer accept the value 2 if the value of time_unit is `TIME_UNIT_MONTHS`. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap).",
 "format": "int32",
 "type": "integer"
 },
@@ -13989,7 +13989,7 @@ false
 "id": "GoogleAudienceGroup",
 "properties": {
 "settings": {
-"description": "Required. All Google audience targeting settings in Google audience group. Repeated settings with same id will be ignored.",
+"description": "Required. All Google audience targeting settings in Google audience group. Repeated settings with the same id will be ignored.",
 "items": {
 "$ref": "GoogleAudienceTargetingSetting"
 },
@@ -14486,7 +14486,7 @@ false
 },
 "bidStrategy": {
 "$ref": "BiddingStrategy",
-"description": "The bidding strategy of the insertion order. By default, fixed_bid is set."
+"description": "Optional. The bidding strategy of the insertion order. By default, fixed_bid is set."
 },
 "billableOutcome": {
 "description": "Immutable. The billable outcome of the insertion order. Outcome based buying is deprecated. `BILLABLE_OUTCOME_PAY_PER_IMPRESSION` is the only valid value.",
@@ -14545,7 +14545,7 @@ true
 },
 "frequencyCap": {
 "$ref": "FrequencyCap",
-"description": "Required. The frequency capping setting of the insertion order."
+"description": "Required. The frequency capping setting of the insertion order. *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap)"
 },
 "insertionOrderId": {
 "description": "Output only. The unique ID of the insertion order. Assigned by the system.",
@@ -14554,7 +14554,7 @@ true
 "type": "string"
 },
 "insertionOrderType": {
-"description": "The type of insertion order. If this field is unspecified in creation, the value defaults to `RTB`.",
+"description": "Optional. The type of insertion order. If this field is unspecified in creation, the value defaults to `RTB`.",
 "enum": [
 "INSERTION_ORDER_TYPE_UNSPECIFIED",
 "RTB",
@@ -14569,7 +14569,7 @@ true
 },
 "integrationDetails": {
 "$ref": "IntegrationDetails",
-"description": "Additional integration details of the insertion order."
+"description": "Optional. Additional integration details of the insertion order."
 },
 "name": {
 "description": "Output only. The resource name of the insertion order.",
@@ -14581,7 +14581,7 @@ true
 "description": "Required. The budget spending speed setting of the insertion order. pacing_type `PACING_TYPE_ASAP` is not compatible with pacing_period `PACING_PERIOD_FLIGHT`."
 },
 "partnerCosts": {
-"description": "The partner costs associated with the insertion order. If absent or empty in CreateInsertionOrder method, the newly created insertion order will inherit partner costs from the partner settings.",
+"description": "Optional. The partner costs associated with the insertion order. If absent or empty in CreateInsertionOrder method, the newly created insertion order will inherit partner costs from the partner settings.",
 "items": {
 "$ref": "PartnerCost"
 },
@@ -14626,7 +14626,7 @@ true
 "id": "InsertionOrderBudget",
 "properties": {
 "automationType": {
-"description": "The type of automation used to manage bid and budget for the insertion order. If this field is unspecified in creation, the value defaults to `INSERTION_ORDER_AUTOMATION_TYPE_NONE`.",
+"description": "Optional. The type of automation used to manage bid and budget for the insertion order. If this field is unspecified in creation, the value defaults to `INSERTION_ORDER_AUTOMATION_TYPE_NONE`.",
 "enum": [
 "INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED",
 "INSERTION_ORDER_AUTOMATION_TYPE_BUDGET",
@@ -14675,7 +14675,7 @@ true
 "type": "string"
 },
 "campaignBudgetId": {
-"description": "The budget_id of the campaign budget that this insertion order budget segment is a part of.",
+"description": "Optional. The budget_id of the campaign budget that this insertion order budget segment is a part of.",
 "format": "int64",
 "type": "string"
 },
@@ -14684,7 +14684,7 @@ true
 "description": "Required. The start and end date settings of the budget segment. They are resolved relative to the parent advertiser's time zone. * When creating a new budget segment, both `start_date` and `end_date` must be in the future. * An existing budget segment with a `start_date` in the past has a mutable `end_date` but an immutable `start_date`. * `end_date` must be the `start_date` or later, both before the year 2037."
 },
 "description": {
-"description": "The budget segment description. It can be used to enter Purchase Order information for each budget segment and have that information printed on the invoices. Must be UTF-8 encoded.",
+"description": "Optional. The budget segment description. It can be used to enter Purchase Order information for each budget segment and have that information printed on the invoices. Must be UTF-8 encoded.",
 "type": "string"
 }
 },
@@ -15618,7 +15618,7 @@ true
 },
 "conversionCounting": {
 "$ref": "ConversionCountingConfig",
-"description": "The conversion tracking setting of the line item."
+"description": "The conversion tracking setting of the line item. *Warning*: Starting **April 1, 2025**, the floodlight_activity_configs field will no longer be writable while a custom bidding algorithm is assigned to the line item. If you set this field and assign a custom bidding algorithm in the same request, the floodlight activities must match the ones used by the custom bidding algorithm. [Read more about this announced change](/display-video/api/deprecations#features.custom_bidding_floodlight)."
 },
 "creativeIds": {
 "description": "The IDs of the creatives associated with the line item.",
@@ -15662,7 +15662,7 @@ true
 },
 "frequencyCap": {
 "$ref": "FrequencyCap",
-"description": "Required. The impression frequency cap settings of the line item. The max_impressions field in this settings object must be used if assigning a limited cap."
+"description": "Required. The impression frequency cap settings of the line item. The max_impressions field in this settings object must be used if assigning a limited cap. *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap)"
 },
 "insertionOrderId": {
 "description": "Required. Immutable. The unique ID of the insertion order that the line item belongs to.",
@@ -16660,7 +16660,7 @@ true
 "id": "MaximizeSpendBidStrategy",
 "properties": {
 "customBiddingAlgorithmId": {
-"description": "The ID of the Custom Bidding Algorithm used by this strategy. Only applicable when performance_goal_type is set to `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO`.",
+"description": "The ID of the Custom Bidding Algorithm used by this strategy. Only applicable when performance_goal_type is set to `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO`. *Warning*: Starting **April 1, 2025**, assigning a custom bidding algorithm that uses floodlight activities not identified in floodlightActivityConfigs will return an error. [Read more about this announced change](/display-video/api/deprecations#features.custom_bidding_floodlight).",
 "format": "int64",
 "type": "string"
 },
@@ -16912,19 +16912,19 @@ true
 "id": "ObaIcon",
 "properties": {
 "clickTrackingUrl": {
-"description": "Required. The click tracking URL of the OBA icon. Only URLs of the following domains are allowed: * https://info.evidon.com * https://l.betrad.com",
+"description": "Required. The click tracking URL of the OBA icon. Only URLs of the following domains are allowed: * `https://info.evidon.com` * `https://l.betrad.com`",
 "type": "string"
 },
 "dimensions": {
 "$ref": "Dimensions",
-"description": "The dimensions of the OBA icon."
+"description": "Optional. The dimensions of the OBA icon."
 },
 "landingPageUrl": {
-"description": "Required. The landing page URL of the OBA icon. Only URLs of the following domains are allowed: * https://info.evidon.com * https://l.betrad.com",
+"description": "Required. The landing page URL of the OBA icon. Only URLs of the following domains are allowed: * `https://info.evidon.com` * `https://l.betrad.com`",
 "type": "string"
 },
 "position": {
-"description": "The position of the OBA icon on the creative.",
+"description": "Optional. The position of the OBA icon on the creative.",
 "enum": [
 "OBA_ICON_POSITION_UNSPECIFIED",
 "OBA_ICON_POSITION_UPPER_RIGHT",
@@ -16942,19 +16942,19 @@ true
 "type": "string"
 },
 "program": {
-"description": "The program of the OBA icon. For example: \u201cAdChoices\u201d.",
+"description": "Optional. The program of the OBA icon. For example: \u201cAdChoices\u201d.",
 "type": "string"
 },
 "resourceMimeType": {
-"description": "The MIME type of the OBA icon resource.",
+"description": "Optional. The MIME type of the OBA icon resource.",
 "type": "string"
 },
 "resourceUrl": {
-"description": "The URL of the OBA icon resource.",
+"description": "Optional. The URL of the OBA icon resource.",
 "type": "string"
 },
 "viewTrackingUrl": {
-"description": "Required. The view tracking URL of the OBA icon. Only URLs of the following domains are allowed: * https://info.evidon.com * https://l.betrad.com",
+"description": "Required. The view tracking URL of the OBA icon. Only URLs of the following domains are allowed: * `https://info.evidon.com` * `https://l.betrad.com`",
 "type": "string"
 }
 },
@@ -17608,7 +17608,7 @@ false
 "id": "PerformanceGoalBidStrategy",
 "properties": {
 "customBiddingAlgorithmId": {
-"description": "The ID of the Custom Bidding Algorithm used by this strategy. Only applicable when performance_goal_type is set to `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO`.",
+"description": "The ID of the Custom Bidding Algorithm used by this strategy. Only applicable when performance_goal_type is set to `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO`. *Warning*: Starting **April 1, 2025**, assigning a custom bidding algorithm that uses floodlight activities not identified in floodlightActivityConfigs will return an error. [Read more about this announced change](/display-video/api/deprecations#features.custom_bidding_floodlight).",
 "format": "int64",
 "type": "string"
 },
@@ -18892,7 +18892,7 @@ true
 "id": "ThirdPartyUrl",
 "properties": {
 "type": {
-"description": "The type of interaction needs to be tracked by the tracking URL",
+"description": "Optional. The type of interaction needs to be tracked by the tracking URL",
 "enum": [
 "THIRD_PARTY_URL_TYPE_UNSPECIFIED",
 "THIRD_PARTY_URL_TYPE_IMPRESSION",
@@ -18932,7 +18932,7 @@ true
 "type": "string"
 },
 "url": {
-"description": "Tracking URL used to track the interaction. Provide a URL with optional path or query string, beginning with `https:`. For example, https://www.example.com/path",
+"description": "Optional. Tracking URL used to track the interaction. Provide a URL with optional path or query string, beginning with `https:`. For example, `https://www.example.com/path`",
 "type": "string"
 }
 },
@@ -19057,44 +19057,44 @@ true
 "id": "Transcode",
 "properties": {
 "audioBitRateKbps": {
-"description": "The bit rate for the audio stream of the transcoded video, or the bit rate for the transcoded audio, in kilobits per second.",
+"description": "Optional. The bit rate for the audio stream of the transcoded video, or the bit rate for the transcoded audio, in kilobits per second.",
 "format": "int64",
 "type": "string"
 },
 "audioSampleRateHz": {
-"description": "The sample rate for the audio stream of the transcoded video, or the sample rate for the transcoded audio, in hertz.",
+"description": "Optional. The sample rate for the audio stream of the transcoded video, or the sample rate for the transcoded audio, in hertz.",
 "format": "int64",
 "type": "string"
 },
 "bitRateKbps": {
-"description": "The transcoding bit rate of the transcoded video, in kilobits per second.",
+"description": "Optional. The transcoding bit rate of the transcoded video, in kilobits per second.",
 "format": "int64",
 "type": "string"
 },
 "dimensions": {
 "$ref": "Dimensions",
-"description": "The dimensions of the transcoded video."
+"description": "Optional. The dimensions of the transcoded video."
 },
 "fileSizeBytes": {
-"description": "The size of the transcoded file, in bytes.",
+"description": "Optional. The size of the transcoded file, in bytes.",
 "format": "int64",
 "type": "string"
 },
 "frameRate": {
-"description": "The frame rate of the transcoded video, in frames per second.",
+"description": "Optional. The frame rate of the transcoded video, in frames per second.",
 "format": "float",
 "type": "number"
 },
 "mimeType": {
-"description": "The MIME type of the transcoded file.",
+"description": "Optional. The MIME type of the transcoded file.",
 "type": "string"
 },
 "name": {
-"description": "The name of the transcoded file.",
+"description": "Optional. The name of the transcoded file.",
 "type": "string"
 },
 "transcoded": {
-"description": "Indicates if the transcoding was successful.",
+"description": "Optional. Indicates if the transcoding was successful.",
 "type": "boolean"
 }
 },
@@ -19105,11 +19105,11 @@ true
 "id": "UniversalAdId",
 "properties": {
 "id": {
-"description": "The unique creative identifier.",
+"description": "Optional. The unique creative identifier.",
 "type": "string"
 },
 "registry": {
-"description": "The registry provides unique creative identifiers.",
+"description": "Optional. The registry provides unique creative identifiers.",
 "enum": [
 "UNIVERSAL_AD_REGISTRY_UNSPECIFIED",
 "UNIVERSAL_AD_REGISTRY_OTHER",
@@ -19903,7 +19903,7 @@ true
 },
 "viewFrequencyCap": {
 "$ref": "FrequencyCap",
-"description": "The view frequency cap settings of the line item. The max_views field in this settings object must be used if assigning a limited cap."
+"description": "The view frequency cap settings of the line item. The max_views field in this settings object must be used if assigning a limited cap. *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap)"
 }
 },
 "type": "object"