From 032536a9e7a72cae8805b6769e51333ce82946c6 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Sun, 2 Nov 2025 09:42:09 +0000 Subject: [PATCH] feat: Automated regeneration of displayvideo v4 client --- .../google-apis-displayvideo_v4/CHANGELOG.md | 4 + .../google/apis/displayvideo_v4/classes.rb | 206 +++++++++--------- .../apis/displayvideo_v4/gem_version.rb | 4 +- .../google/apis/displayvideo_v4/service.rb | 153 +++++++------ 4 files changed, 198 insertions(+), 169 deletions(-) diff --git a/generated/google-apis-displayvideo_v4/CHANGELOG.md b/generated/google-apis-displayvideo_v4/CHANGELOG.md index d6833745be0..91358a44297 100644 --- a/generated/google-apis-displayvideo_v4/CHANGELOG.md +++ b/generated/google-apis-displayvideo_v4/CHANGELOG.md @@ -1,5 +1,9 @@ # Release history for google-apis-displayvideo_v4 +### v0.14.0 (2025-11-02) + +* Regenerated from discovery document revision 20251027 + ### v0.13.0 (2025-10-26) * Regenerated from discovery document revision 20251023 diff --git a/generated/google-apis-displayvideo_v4/lib/google/apis/displayvideo_v4/classes.rb b/generated/google-apis-displayvideo_v4/lib/google/apis/displayvideo_v4/classes.rb index 3f0fe6b967c..b508a785f7d 100644 --- a/generated/google-apis-displayvideo_v4/lib/google/apis/displayvideo_v4/classes.rb +++ b/generated/google-apis-displayvideo_v4/lib/google/apis/displayvideo_v4/classes.rb @@ -73,11 +73,12 @@ def update!(**args) end end - # A single ad asset. Next ID: 6 + # A single ad asset. class AdAsset include Google::Apis::Core::Hashable - # Output only. Asset ID of the ad asset. + # Output only. The ID of the ad asset. Referred to as the asset ID when assigned + # to an ad. # Corresponds to the JSON property `adAssetId` # @return [Fixnum] attr_accessor :ad_asset_id @@ -97,7 +98,7 @@ class AdAsset # @return [String] attr_accessor :name - # The youtube video asset data of the ad asset. + # Data for a YouTube video ad asset. # Corresponds to the JSON property `youtubeVideoAsset` # @return [Google::Apis::DisplayvideoV4::YoutubeVideoAsset] attr_accessor :youtube_video_asset @@ -202,7 +203,10 @@ class AdGroupAd # @return [Fixnum] attr_accessor :ad_group_ad_id - # The unique ID of the ad group that the ad belongs to. + # The unique ID of the ad group that the ad belongs to. *Caution*: Parent ad + # groups for Demand Gen ads are not currently retrieveable using `advertisers. + # adGroups.list` or `advertisers.adGroups.get`. Demand Gen ads can be identified + # by the absence of the `ad_details` union field. # Corresponds to the JSON property `adGroupId` # @return [Fixnum] attr_accessor :ad_group_id @@ -334,20 +338,20 @@ def update!(**args) class AdPolicy include Google::Apis::Core::Hashable - # The policy approval status of an ad. Indicating the ad policy approval - # decision. + # The policy approval status of an ad, indicating the approval decision. # Corresponds to the JSON property `adPolicyApprovalStatus` # @return [String] attr_accessor :ad_policy_approval_status - # The policy review status of an ad. Indicating where the review process the ad - # is currently at. + # The policy review status of an ad, indicating where in the review process the + # ad is currently. # Corresponds to the JSON property `adPolicyReviewStatus` # @return [String] attr_accessor :ad_policy_review_status - # The policy topic entries for the ad, including the topic, restriction level, - # and guidance on how to fix policy issues. + # The entries for each policy topic identified as relating to the ad. Each entry + # includes the topic, restriction level, and guidance on how to fix policy + # issues. # Corresponds to the JSON property `adPolicyTopicEntry` # @return [Array] attr_accessor :ad_policy_topic_entry @@ -364,17 +368,16 @@ def update!(**args) end end - # Represents a criterion that is restricted. Today only used to represent a - # country restriction. Used by both policy evidence and policy constraints. + # Represents a country restriction. class AdPolicyCriterionRestriction include Google::Apis::Core::Hashable - # Only used today to represent a country criterion id. + # The country criterion id. # Corresponds to the JSON property `countryCriterionId` # @return [Fixnum] attr_accessor :country_criterion_id - # Localized name for the country. Could be empty. + # Localized name for the country. May be empty. # Corresponds to the JSON property `countryLabel` # @return [String] attr_accessor :country_label @@ -390,16 +393,17 @@ def update!(**args) end end - # Appeal related information for a policy topic. + # Information on how to appeal a policy decision. class AdPolicyTopicAppealInfo include Google::Apis::Core::Hashable - # Only available when appeal_type is APPEAL_FORM. + # Only available when appeal_type is `APPEAL_FORM`. # Corresponds to the JSON property `appealFormLink` # @return [String] attr_accessor :appeal_form_link - # Indicate whether the policy topic can be self-service appeal or appeal form. + # Whether the decision can be appealed through a self-service appeal or an + # appeal form. # Corresponds to the JSON property `appealType` # @return [String] attr_accessor :appeal_type @@ -415,8 +419,7 @@ def update!(**args) end end - # Additional constraints information that explains restrictions applied to this - # policy. + # Details on ad serving constraints. class AdPolicyTopicConstraint include Google::Apis::Core::Hashable @@ -446,7 +449,7 @@ class AdPolicyTopicConstraint # @return [Google::Apis::DisplayvideoV4::AdPolicyTopicConstraintAdPolicyGlobalCertificateMissingConstraint] attr_accessor :global_certificate_missing - # Link to the form to request a certificate for the policy topic constraint. + # Link to the form to request a certificate for the constraint. # Corresponds to the JSON property `requestCertificateFormLink` # @return [String] attr_accessor :request_certificate_form_link @@ -533,11 +536,11 @@ def update!(**args) end end - # Policy topic entry. + # An entry describing how an ad has been identified as relating to an ad policy. class AdPolicyTopicEntry include Google::Apis::Core::Hashable - # Appeal related information for a policy topic. + # Information on how to appeal a policy decision. # Corresponds to the JSON property `appealInfo` # @return [Google::Apis::DisplayvideoV4::AdPolicyTopicAppealInfo] attr_accessor :appeal_info @@ -557,32 +560,33 @@ class AdPolicyTopicEntry # @return [String] attr_accessor :policy_enforcement_means - # Localized label text for policy. (Trademarks in text, Contains Alcohol, etc.) + # Localized label text for policy. Examples include "Trademarks in text", " + # Contains Alcohol", etc. # Corresponds to the JSON property `policyLabel` # @return [String] attr_accessor :policy_label - # The policy topic of an ad policy topic entry. (TRADEMARKS, ALCOHOL, etc.) + # The policy topic. Examples include "TRADEMARKS", "ALCOHOL", etc. # Corresponds to the JSON property `policyTopic` # @return [String] attr_accessor :policy_topic - # The policy topic constraints. + # The serving constraints relevant to the policy decision. # Corresponds to the JSON property `policyTopicConstraints` # @return [Array] attr_accessor :policy_topic_constraints - # Short summary description of the policy topic. + # A short summary description of the policy topic. # Corresponds to the JSON property `policyTopicDescription` # @return [String] attr_accessor :policy_topic_description - # The policy topic evidences. + # The evidence used in the policy decision. # Corresponds to the JSON property `policyTopicEvidences` # @return [Array] attr_accessor :policy_topic_evidences - # The policy topic entry type. + # How ad serving will be affected due to the relation to the ad policy topic. # Corresponds to the JSON property `policyTopicType` # @return [String] attr_accessor :policy_topic_type @@ -606,21 +610,21 @@ def update!(**args) end end - # Additional evidence information that explains a policy decision. + # Evidence information used in the policy decision. class AdPolicyTopicEvidence include Google::Apis::Core::Hashable - # Counterfeit enforcement that caused a policy violation. + # Details on the counterfeit enforcement that caused a policy violation. # Corresponds to the JSON property `counterfeit` # @return [Google::Apis::DisplayvideoV4::AdPolicyTopicEvidenceCounterfeit] attr_accessor :counterfeit - # A list of destination mismatch URL types. + # Details on a mismatch between destination URL types. # Corresponds to the JSON property `destinationMismatch` # @return [Google::Apis::DisplayvideoV4::AdPolicyTopicEvidenceDestinationMismatch] attr_accessor :destination_mismatch - # Evidence details for destination not working policy violations. + # Details for on HTTP or DNS errors related to the ad destination. # Corresponds to the JSON property `destinationNotWorking` # @return [Google::Apis::DisplayvideoV4::AdPolicyTopicEvidenceDestinationNotWorking] attr_accessor :destination_not_working @@ -635,20 +639,21 @@ class AdPolicyTopicEvidence # @return [Fixnum] attr_accessor :http_code - # The language the ad was detected to be written in. This is an IETF language - # tag such as "en-US". + # The language the ad was detected to be written in. This field uses IETF + # language tags, such as "en-US". # Corresponds to the JSON property `languageCode` # @return [String] attr_accessor :language_code - # Legal related regulation enforcement, either from DMCA or local legal. + # Legal related regulation enforcement, either from DMCA or local legal + # regulation. # Corresponds to the JSON property `legalRemoval` # @return [Google::Apis::DisplayvideoV4::AdPolicyTopicEvidenceLegalRemoval] attr_accessor :legal_removal - # T&S proactive enforcement for policies meant to address regional requirements. - # This is considered as Google owned investigation instead of regulation notice - # since it's a T&S proactive enforcement. + # Trust & Safety (T&S) proactive enforcement for policies meant to address + # regional requirements. This is considered a Google-owned investigation instead + # of a regulation notice since it's proactive T&S enforcement. # Corresponds to the JSON property `regionalRequirements` # @return [Google::Apis::DisplayvideoV4::AdPolicyTopicEvidenceRegionalRequirements] attr_accessor :regional_requirements @@ -688,11 +693,11 @@ def update!(**args) end end - # Counterfeit enforcement that caused a policy violation. + # Details on the counterfeit enforcement that caused a policy violation. class AdPolicyTopicEvidenceCounterfeit include Google::Apis::Core::Hashable - # The content or product owners that make the complainants. + # The content or product owners that made a complaint. # Corresponds to the JSON property `owners` # @return [Array] attr_accessor :owners @@ -707,15 +712,14 @@ def update!(**args) end end - # A list of destination mismatch URL types. + # Details on a mismatch between destination URL types. class AdPolicyTopicEvidenceDestinationMismatch include Google::Apis::Core::Hashable - # The set of URLs that do not match each other. The list can include single or - # multiple uri types. Example 1: [DISPLAY_URL, FINAL_URL] means ad display URL - # does not match with the ad final URL. Example 2: [FINAL_URL] means ad final - # URL did not match the crawled url, which is also considered as - # destinationmismatch. + # The set of URLs that do not match. The list can include single or multiple uri + # types. Example 1: [`DISPLAY_URL`, `FINAL_URL`] means ad display URL does not + # match with the ad final URL. Example 2: [`FINAL_URL`] means ad final URL did + # not match the crawled url, which is also considered as destination mismatch. # Corresponds to the JSON property `uriTypes` # @return [Array] attr_accessor :uri_types @@ -730,11 +734,11 @@ def update!(**args) end end - # Evidence details for destination not working policy violations. + # Details for on HTTP or DNS errors related to the ad destination. class AdPolicyTopicEvidenceDestinationNotWorking include Google::Apis::Core::Hashable - # The device platform of the not working url. + # The device where visiting the URL resulted in the error. # Corresponds to the JSON property `device` # @return [String] attr_accessor :device @@ -754,7 +758,7 @@ class AdPolicyTopicEvidenceDestinationNotWorking # @return [Fixnum] attr_accessor :http_error_code - # The last checked time of the not working url. + # The last time the error was seen when navigating to URL. # Corresponds to the JSON property `lastCheckedTime` # @return [String] attr_accessor :last_checked_time @@ -792,31 +796,32 @@ def update!(**args) end end - # Legal related regulation enforcement, either from DMCA or local legal. + # Legal related regulation enforcement, either from DMCA or local legal + # regulation. class AdPolicyTopicEvidenceLegalRemoval include Google::Apis::Core::Hashable - # The legal removal complaint type. + # The type of complaint causing the legal removal. # Corresponds to the JSON property `complaintType` # @return [String] attr_accessor :complaint_type - # The restricted countries due to the legal removal. + # The countries restricted due to the legal removal. # Corresponds to the JSON property `countryRestrictions` # @return [Array] attr_accessor :country_restrictions - # DMCA related regulation enforcement. + # DMCA complaint details. # Corresponds to the JSON property `dmca` # @return [Google::Apis::DisplayvideoV4::AdPolicyTopicEvidenceLegalRemovalDmca] attr_accessor :dmca - # Local legal related regulation enforcement. + # Local legal regulation details. # Corresponds to the JSON property `localLegal` # @return [Google::Apis::DisplayvideoV4::AdPolicyTopicEvidenceLegalRemovalLocalLegal] attr_accessor :local_legal - # The urls that are restricted due to the legal removal. + # The urls restricted due to the legal removal. # Corresponds to the JSON property `restrictedUris` # @return [Array] attr_accessor :restricted_uris @@ -835,11 +840,11 @@ def update!(**args) end end - # DMCA related regulation enforcement. + # DMCA complaint details. class AdPolicyTopicEvidenceLegalRemovalDmca include Google::Apis::Core::Hashable - # The entity who makes the legal complaint. + # The entity who made the legal complaint. # Corresponds to the JSON property `complainant` # @return [String] attr_accessor :complainant @@ -854,7 +859,7 @@ def update!(**args) end end - # Local legal related regulation enforcement. + # Local legal regulation details. class AdPolicyTopicEvidenceLegalRemovalLocalLegal include Google::Apis::Core::Hashable @@ -873,9 +878,9 @@ def update!(**args) end end - # T&S proactive enforcement for policies meant to address regional requirements. - # This is considered as Google owned investigation instead of regulation notice - # since it's a T&S proactive enforcement. + # Trust & Safety (T&S) proactive enforcement for policies meant to address + # regional requirements. This is considered a Google-owned investigation instead + # of a regulation notice since it's proactive T&S enforcement. class AdPolicyTopicEvidenceRegionalRequirements include Google::Apis::Core::Hashable @@ -898,12 +903,12 @@ def update!(**args) class AdPolicyTopicEvidenceRegionalRequirementsRegionalRequirementsEntry include Google::Apis::Core::Hashable - # The restricted countries due to the legal policy. + # The countries restricted due to the legal policy. # Corresponds to the JSON property `countryRestrictions` # @return [Array] attr_accessor :country_restrictions - # The legal policy that is violated. + # The legal policy that is being violated. # Corresponds to the JSON property `legalPolicy` # @return [String] attr_accessor :legal_policy @@ -942,7 +947,7 @@ def update!(**args) class AdPolicyTopicEvidenceTrademark include Google::Apis::Core::Hashable - # Criteria that are geo restrictions. + # Countries where the policy violation is relevant. # Corresponds to the JSON property `countryRestrictions` # @return [Array] attr_accessor :country_restrictions @@ -3055,7 +3060,8 @@ def update!(**args) class BulkCreateAdAssetsRequest include Google::Apis::Core::Hashable - # Required. Ad assets to create. Only supports youtube video assets for now. + # Required. Ad assets to create. Only supports assets of AdAssetType ` + # AD_ASSET_TYPE_YOUTUBE_VIDEO`. # Corresponds to the JSON property `adAssets` # @return [Array] attr_accessor :ad_assets @@ -3074,7 +3080,7 @@ def update!(**args) class BulkCreateAdAssetsResponse include Google::Apis::Core::Hashable - # The uploaded video ad assets, if successful. + # The created ad assets. # Corresponds to the JSON property `adAssets` # @return [Array] attr_accessor :ad_assets @@ -5051,7 +5057,7 @@ def update!(**args) class CreateAdAssetRequest include Google::Apis::Core::Hashable - # A single ad asset. Next ID: 6 + # A single ad asset. # Corresponds to the JSON property `adAsset` # @return [Google::Apis::DisplayvideoV4::AdAsset] attr_accessor :ad_asset @@ -9451,7 +9457,8 @@ def update!(**args) class ListAdAssetsResponse include Google::Apis::Core::Hashable - # The list of ad assets. This list will be absent if empty. + # The list of ad assets. The list will only contain assets of AdAssetType ` + # AD_ASSET_TYPE_YOUTUBE_VIDEO`. This list will be absent if empty. # Corresponds to the JSON property `adAssets` # @return [Array] attr_accessor :ad_assets @@ -10440,12 +10447,14 @@ def update!(**args) class ListYoutubeAssetAssociationsResponse include Google::Apis::Core::Hashable - # A token to retrieve the next page of results. + # A token to retrieve the next page of results. Pass this value in the + # page_token field in the subsequent call to `ListYoutubeAssetAssociations` + # method to retrieve the next page of results. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token - # The list of associations. This list will be absent if empty. + # The list of asset associations. This list will be absent if empty. # Corresponds to the JSON property `youtubeAssetAssociations` # @return [Array] attr_accessor :youtube_asset_associations @@ -13359,11 +13368,11 @@ def update!(**args) end end - # A request message for UploadAdAsset. Next ID: 6 + # A request message for UploadAdAsset. class UploadAdAssetRequest include Google::Apis::Core::Hashable - # Required. The type of the ad asset. Only supports image assets for now. + # Required. The type of the ad asset. Only `AD_ASSET_TYPE_IMAGE` is supported. # Corresponds to the JSON property `adAssetType` # @return [String] attr_accessor :ad_asset_type @@ -13389,7 +13398,7 @@ def update!(**args) class UploadAdAssetResponse include Google::Apis::Core::Hashable - # A single ad asset. Next ID: 6 + # A single ad asset. # Corresponds to the JSON property `adAsset` # @return [Google::Apis::DisplayvideoV4::AdAsset] attr_accessor :ad_asset @@ -14024,31 +14033,32 @@ def update!(**args) end end - # A YouTube asset association between one linked entity and one YouTube asset. + # An association between a resource and a YouTube asset. class YoutubeAssetAssociation include Google::Apis::Core::Hashable - # The YouTube asset linked with the entity in a YouTube asset association. + # A YouTube asset linked to a resource in a YoutubeAssetAssociation. # Corresponds to the JSON property `linkedYoutubeAsset` # @return [Google::Apis::DisplayvideoV4::YoutubeAssetAssociationLinkedYouTubeAsset] attr_accessor :linked_youtube_asset - # Identifier. The resource name of the association. For line item level + # Identifier. The resource name of the association. For line item-level # associations: The name pattern is `advertisers/`advertiser_id`/lineItems/` # line_item_id`/youtubeAssetTypes/`youtube_asset_type`/youtubeAssetAssociations/` - # youtube_asset_association_id``. For ad group level associations: The name + # youtube_asset_association_id``. For ad group-level associations: The name # pattern is `advertisers/`advertiser_id`/adGroups/`ad_group_id`/ # youtubeAssetTypes/`youtube_asset_type`/youtubeAssetAssociations/` - # youtube_asset_association_id``. For location and affiliate location - # associations: `youtube_asset_association_id` is the linked asset set ID if the - # YouTube asset type (location or affiliate location) is enabled on the linked - # line item or ad group, 0 if disabled. For sitelink associations: ` - # youtube_asset_association_id` is the linked asset ID. + # youtube_asset_association_id``. For `YOUTUBE_ASSET_TYPE_LOCATION` and ` + # YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION` associations: ` + # youtube_asset_association_id` is the ID of the asset set linked, or 0 if the + # location_matching_type or affiliate_location_matching_type is `DISABLED`. For ` + # YOUTUBE_ASSET_TYPE_SITELINK` associations: `youtube_asset_association_id` is + # be the ID of the sitelink asset linked. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # Required. The type of the linked YouTube asset in the association. + # Required. The type of YouTube asset associated with the resource. # Corresponds to the JSON property `youtubeAssetType` # @return [String] attr_accessor :youtube_asset_type @@ -14097,7 +14107,7 @@ def update!(**args) end end - # A chain for affiliate locations. + # A chain of affiliate locations. class YoutubeAssetAssociationAffiliateLocationAssetFilterAffiliateLocationChain include Google::Apis::Core::Hashable @@ -14120,9 +14130,8 @@ def update!(**args) class YoutubeAssetAssociationAffiliateLocationAssetFilterAffiliateLocationMatchingFunction include Google::Apis::Core::Hashable - # Optional. The chains that match the affiliate location assets for serving. - # This is required to set when linking with affiliate location asset filters of - # AffiliateLocationMatchingType#SELECTED_CHAINS. + # Optional. The selected affiliate location chain IDs. This field is required if + # affiliate_location_matching_type is `SELECTED_CHAINS`. # Corresponds to the JSON property `chains` # @return [Array] attr_accessor :chains @@ -14137,7 +14146,7 @@ def update!(**args) end end - # The YouTube asset linked with the entity in a YouTube asset association. + # A YouTube asset linked to a resource in a YoutubeAssetAssociation. class YoutubeAssetAssociationLinkedYouTubeAsset include Google::Apis::Core::Hashable @@ -14204,23 +14213,20 @@ def update!(**args) class YoutubeAssetAssociationLocationAssetFilterLocationMatchingFunction include Google::Apis::Core::Hashable - # Optional. The business name filter. This can be set only when linking with - # location asset filters of LocationMatchingType#FILTER. This is optional when - # linking with location asset filters of LocationMatchingType#FILTER. + # Optional. The business name to match with. This field is optional and can only + # be set if location_matching_type is `FILTER`. # Corresponds to the JSON property `business` # @return [String] attr_accessor :business - # Optional. The label filters. Label filters are OR'ed together. This can be set - # only when linking with location asset filters of LocationMatchingType#FILTER. - # This is optional when linking with location asset filters of - # LocationMatchingType#FILTER. + # Optional. The labels to match with. Labels are logically OR'ed together. This + # field is optional and can only be set if location_matching_type is `FILTER`. # Corresponds to the JSON property `labels` # @return [Array] attr_accessor :labels - # Optional. The selected location asset IDs. This is required to set when - # linking with location asset filters of LocationMatchingType#SELECTED_ASSETS. + # Optional. The selected location asset IDs. This field is required if + # location_matching_type is `SELECTED_ASSETS`. # Corresponds to the JSON property `locationAssetIds` # @return [Array] attr_accessor :location_asset_ids @@ -14284,12 +14290,12 @@ def update!(**args) end end - # The youtube video asset data of the ad asset. + # Data for a YouTube video ad asset. class YoutubeVideoAsset include Google::Apis::Core::Hashable - # Required. The youtube video id of the asset. This is the 11 char string value - # used in the Youtube video URL. + # Required. The YouTube video id of the asset. This is the 11 char string value + # used in the YouTube video URL. # Corresponds to the JSON property `youtubeVideoId` # @return [String] attr_accessor :youtube_video_id diff --git a/generated/google-apis-displayvideo_v4/lib/google/apis/displayvideo_v4/gem_version.rb b/generated/google-apis-displayvideo_v4/lib/google/apis/displayvideo_v4/gem_version.rb index e87c9f4a307..df4001c994b 100644 --- a/generated/google-apis-displayvideo_v4/lib/google/apis/displayvideo_v4/gem_version.rb +++ b/generated/google-apis-displayvideo_v4/lib/google/apis/displayvideo_v4/gem_version.rb @@ -16,13 +16,13 @@ module Google module Apis module DisplayvideoV4 # Version of the google-apis-displayvideo_v4 gem - GEM_VERSION = "0.13.0" + GEM_VERSION = "0.14.0" # Version of the code generator used to generate this client GENERATOR_VERSION = "0.18.0" # Revision of the discovery document this client was generated from - REVISION = "20251023" + REVISION = "20251027" end end end diff --git a/generated/google-apis-displayvideo_v4/lib/google/apis/displayvideo_v4/service.rb b/generated/google-apis-displayvideo_v4/lib/google/apis/displayvideo_v4/service.rb index 5d1a3e588a1..e3cf18cd31b 100644 --- a/generated/google-apis-displayvideo_v4/lib/google/apis/displayvideo_v4/service.rb +++ b/generated/google-apis-displayvideo_v4/lib/google/apis/displayvideo_v4/service.rb @@ -384,9 +384,11 @@ def patch_advertiser(advertiser_id, advertiser_object = nil, update_mask: nil, f execute_or_queue_command(command, &block) end - # BulkCreate video assets for Ad. Only supports youtube video assets for now. + # Creates multiple ad assets in a single request. Returns the newly-created ad + # assets if successful. Only supports the creation of assets of AdAssetType ` + # AD_ASSET_TYPE_YOUTUBE_VIDEO`. # @param [Fixnum] advertiser_id - # Required. The ID of the advertiser this ad asset belongs to. + # Required. The ID of the advertiser these ad assets belong to. # @param [Google::Apis::DisplayvideoV4::BulkCreateAdAssetsRequest] bulk_create_ad_assets_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -417,7 +419,8 @@ def bulk_create_ad_assets(advertiser_id, bulk_create_ad_assets_request_object = execute_or_queue_command(command, &block) end - # Create a video asset for Ad. Only supports youtube video assets for now. + # Creates an ad asset. Returns the newly-created ad asset if successful. Only + # supports the creation of assets of AdAssetType `AD_ASSET_TYPE_YOUTUBE_VIDEO`. # @param [Fixnum] advertiser_id # Required. The ID of the advertiser this ad asset belongs to. # @param [Google::Apis::DisplayvideoV4::CreateAdAssetRequest] create_ad_asset_request_object @@ -450,11 +453,13 @@ def create_ad_asset(advertiser_id, create_ad_asset_request_object = nil, fields: execute_or_queue_command(command, &block) end - # Get an ad asset by ad asset ID. Only supports youtube video assets. + # Gets an ad asset. Only supports the retrieval of assets of AdAssetType ` + # AD_ASSET_TYPE_YOUTUBE_VIDEO`. # @param [Fixnum] advertiser_id # Required. The ID of the advertiser this ad asset belongs to. # @param [Fixnum] ad_asset_id - # Required. The ID of the ad asset to fetch. + # Required. The ID of the ad asset to fetch. Only supports assets of AdAssetType + # `AD_ASSET_TYPE_YOUTUBE_VIDEO` # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -483,18 +488,21 @@ def get_advertiser_ad_asset(advertiser_id, ad_asset_id, fields: nil, quota_user: execute_or_queue_command(command, &block) end - # List ad assets by advertiser ID. Only supports youtube video ad assets. + # Lists ad assets under an advertiser ID. Only supports the retrieval of assets + # of AdAssetType `AD_ASSET_TYPE_YOUTUBE_VIDEO`. # @param [Fixnum] advertiser_id - # Required. The ID of the advertiser to list assets for. + # Required. The ID of the advertiser the ad assets belong to. # @param [String] filter - # Optional. Filter expression to restrict the ad assets to return. The supported - # fields are: * `youtubeVideoAsset.youtubeVideoId` * `entityStatus` Examples: * ` - # entityStatus=ENTITY_STATUS_ACTIVE` + # Optional. Allows filtering of the results by ad asset fields. Supported syntax: + # * A restriction has the form of ``field` `operator` `value``. * All fields + # must use the `EQUALS (=)` operator. Supported fields: * `youtubeVideoAsset. + # youtubeVideoId` * `entityStatus` Examples: * All active YouTube video ad + # assets under an advertiser: `entityStatus=ENTITY_STATUS_ACTIVE` # @param [String] order_by # Optional. Field by which to sort the list. Acceptable values are: * ` # entityStatus` * `youtubeVideoAsset.youtubeVideoId` * `adAssetId` (default) The # default sorting order is ascending. To specify descending order for a field, a - # suffix "desc" should be added to the field name. Example: `assetId desc`. + # suffix "desc" should be added to the field name. Example: `adAssetId desc`. # @param [Fixnum] page_size # Optional. Requested page size. Must be between `1` and `5000`. If unspecified # will default to `5000`. Returns error code `INVALID_ARGUMENT` if an invalid @@ -502,8 +510,8 @@ def get_advertiser_ad_asset(advertiser_id, ad_asset_id, fields: nil, quota_user: # @param [String] page_token # Optional. A token identifying a page of results the server should return. # Typically, this is the value of next_page_token returned from the previous - # call to `ListAssets` method. If not specified, the first page of results will - # be returned. + # call to `ListAdAssets` method. If not specified, the first page of results + # will be returned. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -535,8 +543,9 @@ def list_advertiser_ad_assets(advertiser_id, filter: nil, order_by: nil, page_si execute_or_queue_command(command, &block) end - # Uploads an ad asset. Returns the ID of the newly uploaded ad asset if - # successful. + # Uploads and creates an ad asset. Returns the ID of the newly-created ad asset + # if successful. Only supports the uploading of assets with the AdAssetType ` + # AD_ASSET_TYPE_IMAGE`. # @param [Fixnum] advertiser_id # Required. The ID of the advertiser this ad asset belongs to. # @param [Google::Apis::DisplayvideoV4::UploadAdAssetRequest] upload_ad_asset_request_object @@ -952,17 +961,18 @@ def list_advertiser_ad_group_targeting_type_assigned_targeting_options(advertise execute_or_queue_command(command, &block) end - # Creates a new association between an entity (line item or ad group) and a - # YouTube asset. Returns the newly created association if successful. + # Creates a new association between the identified resource and a YouTube asset. + # Returns the newly-created association. *Warning:* This method is only + # available to an informed subset of users. # @param [Fixnum] advertiser_id - # Required. The ID of the advertiser this request is for. + # Required. The ID of the advertiser that the linked entity belongs to. # @param [Fixnum] ad_group_id - # The unique ID of the ad group linked. + # The ID of an ad group. # @param [String] youtube_asset_type - # Required. The type of the linked YouTube asset in the association. + # Required. The type of YouTube asset associated with the resource. # @param [Google::Apis::DisplayvideoV4::YoutubeAssetAssociation] youtube_asset_association_object # @param [Fixnum] linked_entity_line_item_id - # The unique ID of the line item linked. + # The ID of a line item. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -995,23 +1005,23 @@ def create_advertiser_ad_group_youtube_asset_type_youtube_asset_association(adve execute_or_queue_command(command, &block) end - # Deletes an existing association between an entity (line item or ad group) and - # a YouTube asset. + # Deletes an existing association between the identified resource and a YouTube + # asset. *Warning:* This method is only available to an informed subset of users. # @param [Fixnum] advertiser_id - # Required. The ID of the advertiser this request is for. + # Required. The ID of the advertiser that the linked entity belongs to. # @param [Fixnum] ad_group_id - # The unique ID of the ad group linked. + # The ID of an ad group. # @param [String] youtube_asset_type - # Required. The YouTube asset type this request is for. + # Required. The type of YouTube asset associated with the resource. # @param [Fixnum] youtube_asset_association_id - # Required. The ID of the YouTube asset in the association. For location + # Required. The ID of the YouTube asset in the association. For ` + # YOUTUBE_ASSET_TYPE_LOCATION` and `YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION` # associations: This should be the ID of the asset set linked, or 0 if the - # association stands for location asset is disabled. For affiliate location - # associations: This should be the ID of the asset set linked, or 0 if the - # association stands for affiliate location asset is disabled. For sitelink - # associations: This should be the ID of the sitelink asset linked. + # location_asset_filter or affiliate_location_asset_filter is `DISABLED`. For ` + # YOUTUBE_ASSET_TYPE_SITELINK` associations: This should be the ID of the + # sitelink asset linked. # @param [Fixnum] linked_entity_line_item_id - # The unique ID of the line item linked. + # The ID of a line item. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1043,27 +1053,31 @@ def delete_advertiser_ad_group_youtube_asset_type_youtube_asset_association(adve execute_or_queue_command(command, &block) end - # Lists the YouTube asset associations for given resource. + # Lists the YouTube asset associations linked to the given resource. # @param [Fixnum] advertiser_id - # Required. The ID of the advertiser this request is for. + # Required. The ID of the advertiser that the linked entity belongs to. # @param [Fixnum] ad_group_id - # The unique ID of the ad group linked. + # The ID of an ad group. # @param [String] youtube_asset_type - # Required. The type of YouTube asset in the association. + # Required. The type of YouTube asset being associated with the resource. # @param [Fixnum] linked_entity_line_item_id - # The unique ID of the line item linked. + # The ID of a line item. # @param [String] order_by - # Optional. Field by which to sort the list. The only acceptable values are: ` - # linkedYoutubeAsset.locationAssetFilter.assetSetId`, `linkedYoutubeAsset. - # affiliateLocationAssetFilter.assetSetId`, `linkedYoutubeAsset.sitelinkAsset. + # Optional. Field by which to sort the list. The only acceptable values are: * ` + # linkedYoutubeAsset.locationAssetFilter.assetSetId`, * `linkedYoutubeAsset. + # affiliateLocationAssetFilter.assetSetId`, * `linkedYoutubeAsset.sitelinkAsset. # assetId` The default sorting order is ascending. To specify descending order # for a field, a suffix " desc" should be added to the field name. Example: ` # linkedYoutubeAsset.sitelinkAsset.assetId desc`. # @param [Fixnum] page_size # Optional. Requested page size. Must be between `1` and `10000`. If unspecified - # will default to `100`. + # will default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid + # value is specified. # @param [String] page_token # Optional. A token identifying a page of results the server should return. + # Typically, this is the value of next_page_token returned from the previous + # call to `ListYoutubeAssetAssociations` method. If not specified, the first + # page of results will be returned. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3553,17 +3567,18 @@ def list_advertiser_line_item_targeting_type_assigned_targeting_options(advertis execute_or_queue_command(command, &block) end - # Creates a new association between an entity (line item or ad group) and a - # YouTube asset. Returns the newly created association if successful. + # Creates a new association between the identified resource and a YouTube asset. + # Returns the newly-created association. *Warning:* This method is only + # available to an informed subset of users. # @param [Fixnum] advertiser_id - # Required. The ID of the advertiser this request is for. + # Required. The ID of the advertiser that the linked entity belongs to. # @param [Fixnum] line_item_id - # The unique ID of the line item linked. + # The ID of a line item. # @param [String] youtube_asset_type - # Required. The type of the linked YouTube asset in the association. + # Required. The type of YouTube asset associated with the resource. # @param [Google::Apis::DisplayvideoV4::YoutubeAssetAssociation] youtube_asset_association_object # @param [Fixnum] linked_entity_ad_group_id - # The unique ID of the ad group linked. + # The ID of an ad group. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3596,23 +3611,23 @@ def create_advertiser_line_item_youtube_asset_type_youtube_asset_association(adv execute_or_queue_command(command, &block) end - # Deletes an existing association between an entity (line item or ad group) and - # a YouTube asset. + # Deletes an existing association between the identified resource and a YouTube + # asset. *Warning:* This method is only available to an informed subset of users. # @param [Fixnum] advertiser_id - # Required. The ID of the advertiser this request is for. + # Required. The ID of the advertiser that the linked entity belongs to. # @param [Fixnum] line_item_id - # The unique ID of the line item linked. + # The ID of a line item. # @param [String] youtube_asset_type - # Required. The YouTube asset type this request is for. + # Required. The type of YouTube asset associated with the resource. # @param [Fixnum] youtube_asset_association_id - # Required. The ID of the YouTube asset in the association. For location + # Required. The ID of the YouTube asset in the association. For ` + # YOUTUBE_ASSET_TYPE_LOCATION` and `YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION` # associations: This should be the ID of the asset set linked, or 0 if the - # association stands for location asset is disabled. For affiliate location - # associations: This should be the ID of the asset set linked, or 0 if the - # association stands for affiliate location asset is disabled. For sitelink - # associations: This should be the ID of the sitelink asset linked. + # location_asset_filter or affiliate_location_asset_filter is `DISABLED`. For ` + # YOUTUBE_ASSET_TYPE_SITELINK` associations: This should be the ID of the + # sitelink asset linked. # @param [Fixnum] linked_entity_ad_group_id - # The unique ID of the ad group linked. + # The ID of an ad group. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3644,27 +3659,31 @@ def delete_advertiser_line_item_youtube_asset_type_youtube_asset_association(adv execute_or_queue_command(command, &block) end - # Lists the YouTube asset associations for given resource. + # Lists the YouTube asset associations linked to the given resource. # @param [Fixnum] advertiser_id - # Required. The ID of the advertiser this request is for. + # Required. The ID of the advertiser that the linked entity belongs to. # @param [Fixnum] line_item_id - # The unique ID of the line item linked. + # The ID of a line item. # @param [String] youtube_asset_type - # Required. The type of YouTube asset in the association. + # Required. The type of YouTube asset being associated with the resource. # @param [Fixnum] linked_entity_ad_group_id - # The unique ID of the ad group linked. + # The ID of an ad group. # @param [String] order_by - # Optional. Field by which to sort the list. The only acceptable values are: ` - # linkedYoutubeAsset.locationAssetFilter.assetSetId`, `linkedYoutubeAsset. - # affiliateLocationAssetFilter.assetSetId`, `linkedYoutubeAsset.sitelinkAsset. + # Optional. Field by which to sort the list. The only acceptable values are: * ` + # linkedYoutubeAsset.locationAssetFilter.assetSetId`, * `linkedYoutubeAsset. + # affiliateLocationAssetFilter.assetSetId`, * `linkedYoutubeAsset.sitelinkAsset. # assetId` The default sorting order is ascending. To specify descending order # for a field, a suffix " desc" should be added to the field name. Example: ` # linkedYoutubeAsset.sitelinkAsset.assetId desc`. # @param [Fixnum] page_size # Optional. Requested page size. Must be between `1` and `10000`. If unspecified - # will default to `100`. + # will default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid + # value is specified. # @param [String] page_token # Optional. A token identifying a page of results the server should return. + # Typically, this is the value of next_page_token returned from the previous + # call to `ListYoutubeAssetAssociations` method. If not specified, the first + # page of results will be returned. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user