@maxim_mazurok/gapi.client.displayvideo-v4 0.2.20251023 → 0.2.20251027

package/index.d.ts

@@ -9,7 +9,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://displayvideo.googleapis.com/$discovery/rest?version=v4
-// Revision: 20251023
+// Revision: 20251027
 
 /// <reference types="gapi.client" />
 
@@ -37,7 +37,7 @@ declare namespace gapi.client {
       minimumVolume?: string;
     }
     interface AdAsset {
-      /** 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. */
       adAssetId?: string;
       /** Required. The type of the ad asset. */
       adAssetType?: string;
@@ -45,7 +45,7 @@ declare namespace gapi.client {
       entityStatus?: string;
       /** Identifier. The resource name of the ad asset. */
       name?: string;
-      /** The youtube video asset of the ad asset. */
+      /** Youtube video asset data. */
       youtubeVideoAsset?: YoutubeVideoAsset;
     }
     interface AdGroup {
@@ -73,7 +73,7 @@ declare namespace gapi.client {
     interface AdGroupAd {
       /** The unique ID of the ad. Assigned by the system. */
       adGroupAdId?: string;
-      /** 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. */
       adGroupId?: string;
       /** The policy approval status of the ad. */
       adPolicy?: AdPolicy;
@@ -145,23 +145,23 @@ declare namespace gapi.client {
       videoIabViewability?: string;
     }
     interface AdPolicy {
-      /** The policy approval status of an ad. Indicating the ad policy approval decision. */
+      /** The policy approval status of an ad, indicating the approval decision. */
       adPolicyApprovalStatus?: string;
-      /** 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. */
       adPolicyReviewStatus?: string;
-      /** 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. */
       adPolicyTopicEntry?: AdPolicyTopicEntry[];
     }
     interface AdPolicyCriterionRestriction {
-      /** Only used today to represent a country criterion id. */
+      /** The country criterion id. */
       countryCriterionId?: string;
-      /** Localized name for the country. Could be empty. */
+      /** Localized name for the country. May be empty. */
       countryLabel?: string;
     }
     interface AdPolicyTopicAppealInfo {
-      /** Only available when appeal_type is APPEAL_FORM. */
+      /** Only available when appeal_type is `APPEAL_FORM`. */
       appealFormLink?: string;
-      /** 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. */
       appealType?: string;
     }
     interface AdPolicyTopicConstraint {
@@ -175,7 +175,7 @@ declare namespace gapi.client {
       globalCertificateDomainMismatch?: any;
       /** Certificate is required to serve in any country. */
       globalCertificateMissing?: any;
-      /** Link to the form to request a certificate for the policy topic constraint. */
+      /** Link to the form to request a certificate for the constraint. */
       requestCertificateFormLink?: string;
       /** Reseller constraint. */
       resellerConstraint?: any;
@@ -188,7 +188,7 @@ declare namespace gapi.client {
     interface AdPolicyTopicConstraintAdPolicyGlobalCertificateMissingConstraint {}
     interface AdPolicyTopicConstraintAdPolicyResellerConstraint {}
     interface AdPolicyTopicEntry {
-      /** Ad policy appeal related information for the policy topic. */
+      /** Information on how to appeal the policy decision. */
       appealInfo?: AdPolicyTopicAppealInfo;
       /** Ad policy help center link for the policy topic. */
       helpCenterLink?: string;
@@ -196,31 +196,31 @@ declare namespace gapi.client {
       policyDecisionType?: string;
       /** The policy enforcement means used in the policy review. */
       policyEnforcementMeans?: string;
-      /** Localized label text for policy. (Trademarks in text, Contains Alcohol, etc.) */
+      /** Localized label text for policy. Examples include "Trademarks in text", "Contains Alcohol", etc. */
       policyLabel?: string;
-      /** The policy topic of an ad policy topic entry. (TRADEMARKS, ALCOHOL, etc.) */
+      /** The policy topic. Examples include "TRADEMARKS", "ALCOHOL", etc. */
       policyTopic?: string;
-      /** The policy topic constraints. */
+      /** The serving constraints relevant to the policy decision. */
       policyTopicConstraints?: AdPolicyTopicConstraint[];
-      /** Short summary description of the policy topic. */
+      /** A short summary description of the policy topic. */
       policyTopicDescription?: string;
-      /** The policy topic evidences. */
+      /** The evidence used in the policy decision. */
       policyTopicEvidences?: AdPolicyTopicEvidence[];
-      /** The policy topic entry type. */
+      /** How ad serving will be affected due to the relation to the ad policy topic. */
       policyTopicType?: string;
     }
     interface AdPolicyTopicEvidence {
       /** Counterfeit enforcement that caused a policy violation. */
       counterfeit?: AdPolicyTopicEvidenceCounterfeit;
-      /** Mismatch between the ad destinations URLs. */
+      /** A mismatch between the ad destination URLs. */
       destinationMismatch?: AdPolicyTopicEvidenceDestinationMismatch;
-      /** Destination not working because of HTTP error or DNS error. */
+      /** Information on HTTP or DNS errors related to the ad destination. */
       destinationNotWorking?: AdPolicyTopicEvidenceDestinationNotWorking;
       /** The text in the destination of the ad that is causing a policy violation. */
       destinationTextList?: AdPolicyTopicEvidenceDestinationTextList;
       /** HTTP code returned when the final URL was crawled. */
       httpCode?: number;
-      /** 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". */
       languageCode?: string;
       /** Legal related regulation enforcement that caused a policy violation. */
       legalRemoval?: AdPolicyTopicEvidenceLegalRemoval;
@@ -234,15 +234,15 @@ declare namespace gapi.client {
       websiteList?: AdPolicyTopicEvidenceWebsiteList;
     }
     interface AdPolicyTopicEvidenceCounterfeit {
-      /** The content or product owners that make the complainants. */
+      /** The content or product owners that made a complaint. */
       owners?: string[];
     }
     interface AdPolicyTopicEvidenceDestinationMismatch {
-      /** 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. */
       uriTypes?: string[];
     }
     interface AdPolicyTopicEvidenceDestinationNotWorking {
-      /** The device platform of the not working url. */
+      /** The device where visiting the URL resulted in the error. */
       device?: string;
       /** The type of DNS error. */
       dnsErrorType?: string;
@@ -250,7 +250,7 @@ declare namespace gapi.client {
       expandedUri?: string;
       /** The HTTP error code. */
       httpErrorCode?: string;
-      /** The last checked time of the not working url. */
+      /** The last time the error was seen when navigating to URL. */
       lastCheckedTime?: string;
     }
     interface AdPolicyTopicEvidenceDestinationTextList {
@@ -258,19 +258,19 @@ declare namespace gapi.client {
       destinationTexts?: string[];
     }
     interface AdPolicyTopicEvidenceLegalRemoval {
-      /** The legal removal complaint type. */
+      /** The type of complaint causing the legal removal. */
       complaintType?: string;
-      /** The restricted countries due to the legal removal. */
+      /** The countries restricted due to the legal removal. */
       countryRestrictions?: AdPolicyCriterionRestriction[];
-      /** Whether the restriction is from DMCA regulation. */
+      /** Details on the DMCA regulation legal removal. */
       dmca?: AdPolicyTopicEvidenceLegalRemovalDmca;
-      /** Whether the restriction is from local legal regulation. */
+      /** Details on the local legal regulation legal removal. */
       localLegal?: AdPolicyTopicEvidenceLegalRemovalLocalLegal;
-      /** The urls that are restricted due to the legal removal. */
+      /** The urls restricted due to the legal removal. */
       restrictedUris?: string[];
     }
     interface AdPolicyTopicEvidenceLegalRemovalDmca {
-      /** The entity who makes the legal complaint. */
+      /** The entity who made the legal complaint. */
       complainant?: string;
     }
     interface AdPolicyTopicEvidenceLegalRemovalLocalLegal {
@@ -282,9 +282,9 @@ declare namespace gapi.client {
       regionalRequirementsEntries?: AdPolicyTopicEvidenceRegionalRequirementsRegionalRequirementsEntry[];
     }
     interface AdPolicyTopicEvidenceRegionalRequirementsRegionalRequirementsEntry {
-      /** The restricted countries due to the legal policy. */
+      /** The countries restricted due to the legal policy. */
       countryRestrictions?: AdPolicyCriterionRestriction[];
-      /** The legal policy that is violated. */
+      /** The legal policy that is being violated. */
       legalPolicy?: string;
     }
     interface AdPolicyTopicEvidenceTextList {
@@ -292,7 +292,7 @@ declare namespace gapi.client {
       texts?: string[];
     }
     interface AdPolicyTopicEvidenceTrademark {
-      /** Criteria that are geo restrictions. */
+      /** Countries where the policy violation is relevant. */
       countryRestrictions?: AdPolicyCriterionRestriction[];
       /** The trademark content owner. */
       owner?: string;
@@ -752,11 +752,11 @@ declare namespace gapi.client {
       totalAmountMicros?: string;
     }
     interface BulkCreateAdAssetsRequest {
-      /** 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`. */
       adAssets?: AdAsset[];
     }
     interface BulkCreateAdAssetsResponse {
-      /** The uploaded video ad assets, if successful. */
+      /** The created ad assets. */
       adAssets?: AdAsset[];
     }
     interface BulkEditAdvertiserAssignedTargetingOptionsRequest {
@@ -1190,7 +1190,7 @@ declare namespace gapi.client {
       reportingName?: string;
     }
     interface CreateAdAssetRequest {
-      /** Required. Ad assets to create. Only supports youtube video assets for now. */
+      /** Required. The ad asset to create. Only supports assets of AdAssetType `AD_ASSET_TYPE_YOUTUBE_VIDEO`. */
       adAsset?: AdAsset;
     }
     interface CreateAssetRequest {
@@ -2227,7 +2227,7 @@ declare namespace gapi.client {
       flightDateType?: string;
     }
     interface ListAdAssetsResponse {
-      /** 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. */
       adAssets?: AdAsset[];
       /** A token to retrieve the next page of results. Pass this value in the page_token field in the subsequent call to `ListAdAssets` method to retrieve the next page of results. */
       nextPageToken?: string;
@@ -2443,9 +2443,9 @@ declare namespace gapi.client {
       users?: User[];
     }
     interface ListYoutubeAssetAssociationsResponse {
-      /** 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. */
       nextPageToken?: string;
-      /** The list of associations. This list will be absent if empty. */
+      /** The list of asset associations. This list will be absent if empty. */
       youtubeAssetAssociations?: YoutubeAssetAssociation[];
     }
     interface LocationList {
@@ -3107,13 +3107,13 @@ declare namespace gapi.client {
       registry?: string;
     }
     interface UploadAdAssetRequest {
-      /** 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. */
       adAssetType?: string;
       /** Required. The filename of the ad asset, including the file extension. The filename must be UTF-8 encoded with a maximum size of 240 bytes. */
       filename?: string;
     }
     interface UploadAdAssetResponse {
-      /** The uploaded ad asset, if successful. */
+      /** The created ad asset. */
       adAsset?: AdAsset;
     }
     interface UrlAssignedTargetingOptionDetails {
@@ -3267,15 +3267,15 @@ declare namespace gapi.client {
       viewFrequencyCap?: FrequencyCap;
     }
     interface YoutubeAssetAssociation {
-      /** Required. The linked YouTube asset in the association. */
+      /** Required. The YouTube asset associated with the resource. */
       linkedYoutubeAsset?: YoutubeAssetAssociationLinkedYouTubeAsset;
-      /** 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 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. */
+      /** 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 pattern is `advertisers/{advertiser_id}/adGroups/{ad_group_id}/youtubeAssetTypes/{youtube_asset_type}/youtubeAssetAssociations/{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. */
       name?: string;
-      /** Required. The type of the linked YouTube asset in the association. */
+      /** Required. The type of YouTube asset associated with the resource. */
       youtubeAssetType?: string;
     }
     interface YoutubeAssetAssociationAffiliateLocationAssetFilter {
-      /** Optional. The matching function that contains details about how the affiliate location asset filter matches affiliate location assets. When creating associations with affiliate location asset filters: This field is required only for affiliate location asset filters of AffiliateLocationMatchingType#SELECTED_CHAINS. */
+      /** Optional. The matching function that determines how the affiliate location asset filter matches affiliate location assets. This field is required and can only be set for if affiliate_location_matching_type is `SELECTED_CHAINS`. */
       affiliateLocationMatchingFunction?: YoutubeAssetAssociationAffiliateLocationAssetFilterAffiliateLocationMatchingFunction;
       /** Required. The matching type of this affiliate location asset filter. */
       affiliateLocationMatchingType?: string;
@@ -3287,31 +3287,31 @@ declare namespace gapi.client {
       chainId?: string;
     }
     interface YoutubeAssetAssociationAffiliateLocationAssetFilterAffiliateLocationMatchingFunction {
-      /** 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`. */
       chains?: YoutubeAssetAssociationAffiliateLocationAssetFilterAffiliateLocationChain[];
     }
     interface YoutubeAssetAssociationLinkedYouTubeAsset {
-      /** The linked affiliate location asset filter. */
+      /** An affiliate location asset filter. This can be set only when youtube_asset_type is `YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION`. */
       affiliateLocationAssetFilter?: YoutubeAssetAssociationAffiliateLocationAssetFilter;
-      /** The linked location asset filter. */
+      /** A location asset filter. This can be set only when youtube_asset_type is `YOUTUBE_ASSET_TYPE_LOCATION`. */
       locationAssetFilter?: YoutubeAssetAssociationLocationAssetFilter;
-      /** The linked sitelink asset. */
+      /** A sitelink asset. This can be set only when youtube_asset_type is `YOUTUBE_ASSET_TYPE_SITELINK`. */
       sitelinkAsset?: YoutubeAssetAssociationSitelinkAsset;
     }
     interface YoutubeAssetAssociationLocationAssetFilter {
       /** Output only. The ID of the asset set that matches the location assets eligible for serving. */
       assetSetId?: string;
-      /** Optional. The matching function that contains details about how the location asset filter matches location assets. This field should only be set for location asset filters of LocationMatchingType#FILTER or LocationMatchingType#SELECTED_ASSETS. When creating associations with location asset filters: This field is required only for location asset filters of LocationMatchingType#FILTER or LocationMatchingType#SELECTED_ASSETS. */
+      /** Optional. The matching function that determines how the location asset filter matches location assets. This field is required and can only be set for if location_matching_type is `FILTER` or `SELECTED_ASSETS`. */
       locationMatchingFunction?: YoutubeAssetAssociationLocationAssetFilterLocationMatchingFunction;
       /** Required. The matching type of this location asset filter. */
       locationMatchingType?: string;
     }
     interface YoutubeAssetAssociationLocationAssetFilterLocationMatchingFunction {
-      /** 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`. */
       business?: string;
-      /** 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`. */
       labels?: string[];
-      /** 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`. */
       locationAssetIds?: string[];
     }
     interface YoutubeAssetAssociationSitelinkAsset {
@@ -3325,7 +3325,7 @@ declare namespace gapi.client {
       negative?: boolean;
     }
     interface YoutubeVideoAsset {
-      /** 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. */
       youtubeVideoId?: string;
     }
     interface YoutubeVideoAssignedTargetingOptionDetails {
@@ -3341,13 +3341,13 @@ declare namespace gapi.client {
       unavailableReason?: string;
     }
     interface AdAssetsResource {
-      /** 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`. */
       bulkCreate(request: {
         /** V1 error format. */
         '$.xgafv'?: string;
         /** OAuth access token. */
         access_token?: string;
-        /** Required. The ID of the advertiser this ad asset belongs to. */
+        /** Required. The ID of the advertiser these ad assets belong to. */
         advertiserId: string;
         /** Data format for response. */
         alt?: string;
@@ -3376,7 +3376,7 @@ declare namespace gapi.client {
           '$.xgafv'?: string;
           /** OAuth access token. */
           access_token?: string;
-          /** Required. The ID of the advertiser this ad asset belongs to. */
+          /** Required. The ID of the advertiser these ad assets belong to. */
           advertiserId: string;
           /** Data format for response. */
           alt?: string;
@@ -3399,7 +3399,7 @@ declare namespace gapi.client {
         },
         body: BulkCreateAdAssetsRequest,
       ): Request<BulkCreateAdAssetsResponse>;
-      /** 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`. */
       create(request: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -3457,13 +3457,13 @@ declare namespace gapi.client {
         },
         body: CreateAdAssetRequest,
       ): Request<AdAsset>;
-      /** 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`. */
       get(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
         /** OAuth access token. */
         access_token?: string;
-        /** 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` */
         adAssetId: string;
         /** Required. The ID of the advertiser this ad asset belongs to. */
         advertiserId: string;
@@ -3486,13 +3486,13 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<AdAsset>;
-      /** 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`. */
       list(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
         /** OAuth access token. */
         access_token?: string;
-        /** Required. The ID of the advertiser to list assets for. */
+        /** Required. The ID of the advertiser the ad assets belong to. */
         advertiserId: string;
         /** Data format for response. */
         alt?: string;
@@ -3500,17 +3500,17 @@ declare namespace gapi.client {
         callback?: string;
         /** Selector specifying which fields to include in a partial response. */
         fields?: string;
-        /** 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` */
         filter?: string;
         /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
         key?: string;
         /** OAuth 2.0 token for the current user. */
         oauth_token?: string;
-        /** 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`. */
+        /** 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: `adAssetId desc`. */
         orderBy?: string;
         /** Optional. Requested page size. Must be between `1` and `5000`. If unspecified will default to `5000`. Returns error code `INVALID_ARGUMENT` if an invalid value is specified. */
         pageSize?: number;
-        /** 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. */
+        /** 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 `ListAdAssets` method. If not specified, the first page of results will be returned. */
         pageToken?: string;
         /** Returns response with indentations and line breaks. */
         prettyPrint?: boolean;
@@ -3521,7 +3521,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<ListAdAssetsResponse>;
-      /** 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`. */
       upload(request: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -3724,15 +3724,15 @@ declare namespace gapi.client {
       assignedTargetingOptions: AssignedTargetingOptionsResource;
     }
     interface YoutubeAssetAssociationsResource {
-      /** 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. */
       create(request: {
         /** V1 error format. */
         '$.xgafv'?: string;
         /** OAuth access token. */
         access_token?: string;
-        /** The unique ID of the ad group linked. */
+        /** The ID of an ad group. */
         adGroupId: string;
-        /** Required. The ID of the advertiser this request is for. */
+        /** Required. The ID of the advertiser that the linked entity belongs to. */
         advertiserId: string;
         /** Data format for response. */
         alt?: string;
@@ -3742,7 +3742,7 @@ declare namespace gapi.client {
         fields?: string;
         /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
         key?: string;
-        /** The unique ID of the line item linked. */
+        /** The ID of a line item. */
         'linkedEntity.lineItemId'?: string;
         /** OAuth 2.0 token for the current user. */
         oauth_token?: string;
@@ -3754,7 +3754,7 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Required. The type of the linked YouTube asset in the association. */
+        /** Required. The type of YouTube asset associated with the resource. */
         youtubeAssetType: string;
         /** Request body */
         resource: YoutubeAssetAssociation;
@@ -3765,9 +3765,9 @@ declare namespace gapi.client {
           '$.xgafv'?: string;
           /** OAuth access token. */
           access_token?: string;
-          /** The unique ID of the ad group linked. */
+          /** The ID of an ad group. */
           adGroupId: string;
-          /** Required. The ID of the advertiser this request is for. */
+          /** Required. The ID of the advertiser that the linked entity belongs to. */
           advertiserId: string;
           /** Data format for response. */
           alt?: string;
@@ -3777,7 +3777,7 @@ declare namespace gapi.client {
           fields?: string;
           /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
           key?: string;
-          /** The unique ID of the line item linked. */
+          /** The ID of a line item. */
           'linkedEntity.lineItemId'?: string;
           /** OAuth 2.0 token for the current user. */
           oauth_token?: string;
@@ -3789,20 +3789,20 @@ declare namespace gapi.client {
           upload_protocol?: string;
           /** Legacy upload protocol for media (e.g. "media", "multipart"). */
           uploadType?: string;
-          /** Required. The type of the linked YouTube asset in the association. */
+          /** Required. The type of YouTube asset associated with the resource. */
           youtubeAssetType: string;
         },
         body: YoutubeAssetAssociation,
       ): Request<YoutubeAssetAssociation>;
-      /** 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. */
       delete(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
         /** OAuth access token. */
         access_token?: string;
-        /** The unique ID of the ad group linked. */
+        /** The ID of an ad group. */
         adGroupId: string;
-        /** Required. The ID of the advertiser this request is for. */
+        /** Required. The ID of the advertiser that the linked entity belongs to. */
         advertiserId: string;
         /** Data format for response. */
         alt?: string;
@@ -3812,7 +3812,7 @@ declare namespace gapi.client {
         fields?: string;
         /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
         key?: string;
-        /** The unique ID of the line item linked. */
+        /** The ID of a line item. */
         'linkedEntity.lineItemId'?: string;
         /** OAuth 2.0 token for the current user. */
         oauth_token?: string;
@@ -3824,20 +3824,20 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Required. The ID of the YouTube asset in the association. For 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. */
+        /** 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 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. */
         youtubeAssetAssociationId: string;
-        /** Required. The YouTube asset type this request is for. */
+        /** Required. The type of YouTube asset associated with the resource. */
         youtubeAssetType: string;
       }): Request<{}>;
-      /** Lists the YouTube asset associations for given resource. */
+      /** Lists the YouTube asset associations linked to the given resource. */
       list(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
         /** OAuth access token. */
         access_token?: string;
-        /** The unique ID of the ad group linked. */
+        /** The ID of an ad group. */
         adGroupId: string;
-        /** Required. The ID of the advertiser this request is for. */
+        /** Required. The ID of the advertiser that the linked entity belongs to. */
         advertiserId: string;
         /** Data format for response. */
         alt?: string;
@@ -3847,15 +3847,15 @@ declare namespace gapi.client {
         fields?: string;
         /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
         key?: string;
-        /** The unique ID of the line item linked. */
+        /** The ID of a line item. */
         'linkedEntity.lineItemId'?: string;
         /** OAuth 2.0 token for the current user. */
         oauth_token?: string;
-        /** 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`. */
+        /** 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`. */
         orderBy?: string;
-        /** Optional. Requested page size. Must be between `1` and `10000`. If unspecified will default to `100`. */
+        /** Optional. Requested page size. Must be between `1` and `10000`. If unspecified will default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is specified. */
         pageSize?: number;
-        /** Optional. A token identifying a page of results the server should return. */
+        /** 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. */
         pageToken?: string;
         /** Returns response with indentations and line breaks. */
         prettyPrint?: boolean;
@@ -3865,7 +3865,7 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Required. The type of YouTube asset in the association. */
+        /** Required. The type of YouTube asset being associated with the resource. */
         youtubeAssetType: string;
       }): Request<ListYoutubeAssetAssociationsResponse>;
     }
@@ -5733,13 +5733,13 @@ declare namespace gapi.client {
       assignedTargetingOptions: AssignedTargetingOptionsResource;
     }
     interface YoutubeAssetAssociationsResource {
-      /** 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. */
       create(request: {
         /** V1 error format. */
         '$.xgafv'?: string;
         /** OAuth access token. */
         access_token?: string;
-        /** Required. The ID of the advertiser this request is for. */
+        /** Required. The ID of the advertiser that the linked entity belongs to. */
         advertiserId: string;
         /** Data format for response. */
         alt?: string;
@@ -5749,9 +5749,9 @@ declare namespace gapi.client {
         fields?: string;
         /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
         key?: string;
-        /** The unique ID of the line item linked. */
+        /** The ID of a line item. */
         lineItemId: string;
-        /** The unique ID of the ad group linked. */
+        /** The ID of an ad group. */
         'linkedEntity.adGroupId'?: string;
         /** OAuth 2.0 token for the current user. */
         oauth_token?: string;
@@ -5763,7 +5763,7 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Required. The type of the linked YouTube asset in the association. */
+        /** Required. The type of YouTube asset associated with the resource. */
         youtubeAssetType: string;
         /** Request body */
         resource: YoutubeAssetAssociation;
@@ -5774,7 +5774,7 @@ declare namespace gapi.client {
           '$.xgafv'?: string;
           /** OAuth access token. */
           access_token?: string;
-          /** Required. The ID of the advertiser this request is for. */
+          /** Required. The ID of the advertiser that the linked entity belongs to. */
           advertiserId: string;
           /** Data format for response. */
           alt?: string;
@@ -5784,9 +5784,9 @@ declare namespace gapi.client {
           fields?: string;
           /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
           key?: string;
-          /** The unique ID of the line item linked. */
+          /** The ID of a line item. */
           lineItemId: string;
-          /** The unique ID of the ad group linked. */
+          /** The ID of an ad group. */
           'linkedEntity.adGroupId'?: string;
           /** OAuth 2.0 token for the current user. */
           oauth_token?: string;
@@ -5798,18 +5798,18 @@ declare namespace gapi.client {
           upload_protocol?: string;
           /** Legacy upload protocol for media (e.g. "media", "multipart"). */
           uploadType?: string;
-          /** Required. The type of the linked YouTube asset in the association. */
+          /** Required. The type of YouTube asset associated with the resource. */
           youtubeAssetType: string;
         },
         body: YoutubeAssetAssociation,
       ): Request<YoutubeAssetAssociation>;
-      /** 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. */
       delete(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
         /** OAuth access token. */
         access_token?: string;
-        /** Required. The ID of the advertiser this request is for. */
+        /** Required. The ID of the advertiser that the linked entity belongs to. */
         advertiserId: string;
         /** Data format for response. */
         alt?: string;
@@ -5819,9 +5819,9 @@ declare namespace gapi.client {
         fields?: string;
         /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
         key?: string;
-        /** The unique ID of the line item linked. */
+        /** The ID of a line item. */
         lineItemId: string;
-        /** The unique ID of the ad group linked. */
+        /** The ID of an ad group. */
         'linkedEntity.adGroupId'?: string;
         /** OAuth 2.0 token for the current user. */
         oauth_token?: string;
@@ -5833,18 +5833,18 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Required. The ID of the YouTube asset in the association. For 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. */
+        /** 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 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. */
         youtubeAssetAssociationId: string;
-        /** Required. The YouTube asset type this request is for. */
+        /** Required. The type of YouTube asset associated with the resource. */
         youtubeAssetType: string;
       }): Request<{}>;
-      /** Lists the YouTube asset associations for given resource. */
+      /** Lists the YouTube asset associations linked to the given resource. */
       list(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
         /** OAuth access token. */
         access_token?: string;
-        /** Required. The ID of the advertiser this request is for. */
+        /** Required. The ID of the advertiser that the linked entity belongs to. */
         advertiserId: string;
         /** Data format for response. */
         alt?: string;
@@ -5854,17 +5854,17 @@ declare namespace gapi.client {
         fields?: string;
         /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
         key?: string;
-        /** The unique ID of the line item linked. */
+        /** The ID of a line item. */
         lineItemId: string;
-        /** The unique ID of the ad group linked. */
+        /** The ID of an ad group. */
         'linkedEntity.adGroupId'?: string;
         /** OAuth 2.0 token for the current user. */
         oauth_token?: string;
-        /** 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`. */
+        /** 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`. */
         orderBy?: string;
-        /** Optional. Requested page size. Must be between `1` and `10000`. If unspecified will default to `100`. */
+        /** Optional. Requested page size. Must be between `1` and `10000`. If unspecified will default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is specified. */
         pageSize?: number;
-        /** Optional. A token identifying a page of results the server should return. */
+        /** 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. */
         pageToken?: string;
         /** Returns response with indentations and line breaks. */
         prettyPrint?: boolean;
@@ -5874,7 +5874,7 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Required. The type of YouTube asset in the association. */
+        /** Required. The type of YouTube asset being associated with the resource. */
         youtubeAssetType: string;
       }): Request<ListYoutubeAssetAssociationsResponse>;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxim_mazurok/gapi.client.displayvideo-v4",
-  "version": "0.2.20251023",
+  "version": "0.2.20251027",
   "description": "TypeScript typings for Display & Video 360 API v4",
   "repository": {
     "type": "git",