Google Ads Customers.ads API

openapi: 3.2.0
info:
  title: Google Ads Customers.ads API
  description: Manage your Google Ads accounts, campaigns, and reports with this API.
  version: v25
  x-discovery-revision: '20260721'
  contact:
    name: Google
    url: https://developers.google.com/google-ads/api/
  termsOfService: https://developers.google.com/terms
servers:
- url: https://googleads.googleapis.com
  description: Google Ads API production server
security:
- oauth2:
  - https://www.googleapis.com/auth/adwords
tags:
- name: customers.ads
paths:
  /v25/customers/{customersId}/ads:mutate:
    parameters:
    - name: upload_protocol
      in: query
      required: false
      schema:
        type: string
      description: Upload protocol for media (e.g. "raw", "multipart").
    - name: quotaUser
      in: query
      required: false
      schema:
        type: string
      description: Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
    - name: fields
      in: query
      required: false
      schema:
        type: string
      description: Selector specifying which fields to include in a partial response.
    - name: $.xgafv
      in: query
      required: false
      schema:
        type: string
        enum:
        - '1'
        - '2'
        x-enumDescriptions:
        - v1 error format
        - v2 error format
      description: V1 error format.
    - name: callback
      in: query
      required: false
      schema:
        type: string
      description: JSONP
    - name: prettyPrint
      in: query
      required: false
      schema:
        type: boolean
        default: 'true'
      description: Returns response with indentations and line breaks.
    - name: access_token
      in: query
      required: false
      schema:
        type: string
      description: OAuth access token.
    - name: uploadType
      in: query
      required: false
      schema:
        type: string
      description: Legacy upload protocol for media (e.g. "media", "multipart").
    - name: key
      in: query
      required: false
      schema:
        type: string
      description: 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.
    - name: oauth_token
      in: query
      required: false
      schema:
        type: string
      description: OAuth 2.0 token for the current user.
    - name: alt
      in: query
      required: false
      schema:
        x-enumDescriptions:
        - Responses with Content-Type of application/json
        - Media download with context-dependent Content-Type
        - Responses with Content-Type of application/x-protobuf
        type: string
        default: json
        enum:
        - json
        - media
        - proto
      description: Data format for response.
    post:
      operationId: googleads_customers_ads_mutate
      summary: Updates ads
      tags:
      - customers.ads
      description: 'Updates ads. Operation statuses are returned. Updating ads is not supported for TextAd, ExpandedDynamicSearchAd, GmailAd and ImageAd. List of thrown errors: [AdCustomizerError]() [AdError]() [AdSharingError]() [AdxError]() [AssetError]() [AssetLinkError]() [AuthenticationError]() [AuthorizationError]() [CollectionSizeError]() [DatabaseError]() [DateError]() [DistinctError]() [FeedAttributeReferenceError]() [FieldError]() [FieldMaskError]() [FunctionError]() [FunctionParsingError]() [HeaderError]() [IdError]() [ImageError]() [InternalError]() [ListOperationError]() [MediaBundleError]() [MediaFileError]() [MutateError]() [NewResourceCreationError]() [NotEmptyError]() [NullError]() [OperatorError]() [PolicyFindingError]() [PolicyViolationError]() [QuotaError]() [RangeError]() [RequestError]() [SizeLimitError]() [StringFormatError]() [StringLengthError]() [UrlFieldError]()'
      parameters:
      - name: customerId
        in: path
        required: true
        schema:
          pattern: ^[^/]+$
          type: string
        description: Required. The ID of the customer whose ads are being modified.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GoogleAdsGoogleadsV25Services__MutateAdsRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleAdsGoogleadsV25Services__MutateAdsResponse'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/adwords
components:
  schemas:
    GoogleAdsGoogleadsV25Common_PolicyTopicEvidence_WebsiteList:
      description: A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here.
      type: object
      properties:
        websites:
          type: array
          description: Websites that caused the policy finding.
          items:
            type: string
    GoogleAdsGoogleadsV25Common__PolicyTopicConstraint:
      type: object
      properties:
        resellerConstraint:
          description: Reseller constraint.
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common_PolicyTopicConstraint_ResellerConstraint'
        certificateMissingInCountryList:
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common_PolicyTopicConstraint_CountryConstraintList'
          description: Countries where a certificate is required for serving.
        countryConstraintList:
          description: Countries where the resource cannot serve.
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common_PolicyTopicConstraint_CountryConstraintList'
        certificateDomainMismatchInCountryList:
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common_PolicyTopicConstraint_CountryConstraintList'
          description: Countries where the resource's domain is not covered by the certificates associated with it.
      description: Describes the effect on serving that a policy topic entry will have.
    GoogleAdsGoogleadsV25Common__AppAdInfo:
      type: object
      properties:
        mandatoryAdText:
          description: Mandatory ad text.
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdTextAsset'
        youtubeVideos:
          type: array
          description: List of YouTube video assets that may be displayed with the ad.
          items:
            $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdVideoAsset'
        descriptions:
          description: List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
          items:
            $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdTextAsset'
          type: array
        html5MediaBundles:
          type: array
          description: List of media bundle assets that may be used with the ad.
          items:
            $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdMediaBundleAsset'
        headlines:
          description: List of text assets for headlines. When the ad serves the headlines will be selected from this list.
          items:
            $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdTextAsset'
          type: array
        appDeepLink:
          description: An app deep link asset that may be used with the ad.
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdAppDeepLinkAsset'
        images:
          type: array
          description: List of image assets that may be displayed with the ad.
          items:
            $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdImageAsset'
      description: An app ad.
    GoogleAdsGoogleadsV25Common__ShoppingSmartAdInfo:
      type: object
      properties: {}
      description: A Smart Shopping ad.
    GoogleAdsGoogleadsV25Common__InFeedVideoAdInfo:
      type: object
      properties:
        headline:
          description: The headline of the ad.
          type: string
        description1:
          type: string
          description: First text line for the ad.
        description2:
          description: Second text line for the ad.
          type: string
        thumbnail:
          x-enumDescriptions:
          - The type has not been specified.
          - The received value is not known in this version. This is a response-only value.
          - The default thumbnail. Can be auto-generated or user-uploaded.
          - Thumbnail 1, generated from the video.
          - Thumbnail 2, generated from the video.
          - Thumbnail 3, generated from the video.
          enum:
          - UNSPECIFIED
          - UNKNOWN
          - DEFAULT_THUMBNAIL
          - THUMBNAIL_1
          - THUMBNAIL_2
          - THUMBNAIL_3
          type: string
          description: Video thumbnail image to use.
      description: Representation of In-feed video ad format.
    GoogleAdsGoogleadsV25Common__PolicyViolationKey:
      type: object
      properties:
        violatingText:
          description: The text that violates the policy if specified. Otherwise, refers to the policy in general (for example, when requesting to be exempt from the whole policy). If not specified for criterion exemptions, the whole policy is implied. Must be specified for ad exemptions.
          type: string
        policyName:
          description: Unique ID of the violated policy.
          type: string
      description: Key of the violation. The key is used for referring to a violation when filing an exemption request.
    GoogleAdsGoogleadsV25Common_PolicyTopicEvidence_TextList:
      type: object
      properties:
        texts:
          description: The fragments of text from the resource that caused the policy finding.
          items:
            type: string
          type: array
      description: A list of fragments of text that violated a policy.
    GoogleAdsGoogleadsV25Common_PolicyTopicEvidence_DestinationNotWorking:
      type: object
      properties:
        httpErrorCode:
          format: int64
          type: string
          description: The HTTP error code.
        expandedUrl:
          type: string
          description: The full URL that didn't work.
        device:
          x-enumDescriptions:
          - No value has been specified.
          - The received value is not known in this version. This is a response-only value.
          - Landing page doesn't work on desktop device.
          - Landing page doesn't work on Android device.
          - Landing page doesn't work on iOS device.
          enum:
          - UNSPECIFIED
          - UNKNOWN
          - DESKTOP
          - ANDROID
          - IOS
          type: string
          description: The type of device that failed to load the URL.
        dnsErrorType:
          description: The type of DNS error.
          type: string
          x-enumDescriptions:
          - No value has been specified.
          - The received value is not known in this version. This is a response-only value.
          - Host name not found in DNS when fetching landing page.
          - Google internal crawler issue when communicating with DNS. This error doesn't mean the landing page doesn't work. Google will recrawl the landing page.
          enum:
          - UNSPECIFIED
          - UNKNOWN
          - HOSTNAME_NOT_FOUND
          - GOOGLE_CRAWLER_DNS_ISSUE
        lastCheckedDateTime:
          description: 'The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"'
          type: string
      description: Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
    GoogleAdsGoogleadsV25Common__UrlCollection:
      description: Collection of urls that is tagged with a unique identifier.
      type: object
      properties:
        urlCollectionId:
          type: string
          description: Unique identifier for this UrlCollection instance.
        trackingUrlTemplate:
          type: string
          description: URL template for constructing a tracking URL.
        finalUrls:
          type: array
          description: A list of possible final URLs.
          items:
            type: string
        finalMobileUrls:
          description: A list of possible final mobile URLs.
          items:
            type: string
          type: array
    GoogleAdsGoogleadsV25Common__DisplayUploadAdInfo:
      type: object
      properties:
        displayUploadProductType:
          type: string
          description: The product type of this ad. See comments on the enum for details.
          x-enumDescriptions:
          - Not specified.
          - The value is unknown in this version.
          - HTML5 upload ad. This product type requires the upload_media_bundle field in DisplayUploadAdInfo to be set.
          - Dynamic HTML5 education ad. This product type requires the upload_media_bundle field in DisplayUploadAdInfo to be set. Can only be used in an education campaign.
          - Dynamic HTML5 flight ad. This product type requires the upload_media_bundle field in DisplayUploadAdInfo to be set. Can only be used in a flight campaign.
          - Dynamic HTML5 hotel and rental ad. This product type requires the upload_media_bundle field in DisplayUploadAdInfo to be set. Can only be used in a hotel campaign.
          - Dynamic HTML5 job ad. This product type requires the upload_media_bundle field in DisplayUploadAdInfo to be set. Can only be used in a job campaign.
          - Dynamic HTML5 local ad. This product type requires the upload_media_bundle field in DisplayUploadAdInfo to be set. Can only be used in a local campaign.
          - Dynamic HTML5 real estate ad. This product type requires the upload_media_bundle field in DisplayUploadAdInfo to be set. Can only be used in a real estate campaign.
          - Dynamic HTML5 custom ad. This product type requires the upload_media_bundle field in DisplayUploadAdInfo to be set. Can only be used in a custom campaign.
          - Dynamic HTML5 travel ad. This product type requires the upload_media_bundle field in DisplayUploadAdInfo to be set. Can only be used in a travel campaign.
          - Dynamic HTML5 hotel ad. This product type requires the upload_media_bundle field in DisplayUploadAdInfo to be set. Can only be used in a hotel campaign.
          enum:
          - UNSPECIFIED
          - UNKNOWN
          - HTML5_UPLOAD_AD
          - DYNAMIC_HTML5_EDUCATION_AD
          - DYNAMIC_HTML5_FLIGHT_AD
          - DYNAMIC_HTML5_HOTEL_RENTAL_AD
          - DYNAMIC_HTML5_JOB_AD
          - DYNAMIC_HTML5_LOCAL_AD
          - DYNAMIC_HTML5_REAL_ESTATE_AD
          - DYNAMIC_HTML5_CUSTOM_AD
          - DYNAMIC_HTML5_TRAVEL_AD
          - DYNAMIC_HTML5_HOTEL_AD
        mediaBundle:
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdMediaBundleAsset'
          description: A media bundle asset to be used in the ad. For information about the media bundle for HTML5_UPLOAD_AD, see https://support.google.com/google-ads/answer/1722096 Media bundles that are part of dynamic product types use a special format that needs to be created through the Google Web Designer. See https://support.google.com/webdesigner/answer/7543898 for more information.
      description: A generic type of display ad. The exact ad format is controlled by the `display_upload_product_type` field, which determines what kinds of data need to be included with the ad.
    GoogleRpc__Status:
      description: 'The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).'
      type: object
      properties:
        message:
          description: A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
          type: string
        code:
          type: integer
          description: The status code, which should be an enum value of google.rpc.Code.
          format: int32
        details:
          type: array
          description: A list of messages that carry the error details. There is a common set of message types for APIs to use.
          items:
            type: object
            additionalProperties:
              description: Properties of the object. Contains field @type with type URL.
    GoogleAdsGoogleadsV25Common__YouTubeAudioAdInfo:
      type: object
      properties: {}
      description: Representation of YouTube Audio ad format.
    GoogleAdsGoogleadsV25Services__AdOperation:
      type: object
      properties:
        policyValidationParameter:
          description: Configuration for how policies are validated.
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__PolicyValidationParameter'
        update:
          description: 'Update operation: The ad is expected to have a valid resource name in this format: `customers/{customer_id}/ads/{ad_id}`'
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Resources__Ad'
        updateMask:
          description: FieldMask that determines which resource fields are modified in an update.
          type: string
          format: google-fieldmask
      description: A single update operation on an ad.
    GoogleAdsGoogleadsV25Common__PolicyTopicEvidence:
      description: Additional information that explains a policy finding.
      type: object
      properties:
        websiteList:
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common_PolicyTopicEvidence_WebsiteList'
          description: List of websites linked with this resource.
        languageCode:
          description: The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
          type: string
        destinationTextList:
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common_PolicyTopicEvidence_DestinationTextList'
          description: The text in the destination of the resource that is causing a policy finding.
        destinationMismatch:
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common_PolicyTopicEvidence_DestinationMismatch'
          description: Mismatch between the destinations of a resource's URLs.
        destinationNotWorking:
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common_PolicyTopicEvidence_DestinationNotWorking'
          description: Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
        textList:
          description: List of evidence found in the text of a resource.
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common_PolicyTopicEvidence_TextList'
    GoogleAdsGoogleadsV25Common__LegacyResponsiveDisplayAdInfo:
      description: A legacy responsive display ad. Ads of this type are labeled 'Responsive ads' in the Google Ads UI.
      type: object
      properties:
        allowFlexibleColor:
          description: Advertiser's consent to allow flexible color. When true, the ad may be served with different color if necessary. When false, the ad will be served with the specified colors or a neutral color. The default value is `true`. Must be true if `main_color` and `accent_color` are not set.
          type: boolean
        callToActionText:
          description: The call-to-action text for the ad.
          type: string
        squareLogoImage:
          type: string
          description: The MediaFile resource name of the square logo image used in the ad.
        accentColor:
          type: string
          description: 'The accent color of the ad in hexadecimal, for example, #ffffff for white. If one of `main_color` and `accent_color` is set, the other is required as well.'
        marketingImage:
          description: The MediaFile resource name of the marketing image used in the ad.
          type: string
        squareMarketingImage:
          description: The MediaFile resource name of the square marketing image used in the ad.
          type: string
        shortHeadline:
          type: string
          description: The short version of the ad's headline.
        description:
          description: The description of the ad.
          type: string
        longHeadline:
          type: string
          description: The long version of the ad's headline.
        businessName:
          type: string
          description: The business name in the ad.
        mainColor:
          description: 'The main color of the ad in hexadecimal, for example, #ffffff for white. If one of `main_color` and `accent_color` is set, the other is required as well.'
          type: string
        formatSetting:
          x-enumDescriptions:
          - Not specified.
          - The value is unknown in this version.
          - Text, image and native formats.
          - Text and image formats.
          - Native format, for example, the format rendering is controlled by the publisher and not by Google.
          enum:
          - UNSPECIFIED
          - UNKNOWN
          - ALL_FORMATS
          - NON_NATIVE
          - NATIVE
          type: string
          description: Specifies which format the ad will be served in. Default is ALL_FORMATS.
        pricePrefix:
          type: string
          description: Prefix before price. For example, 'as low as'.
        promoText:
          type: string
          description: Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
        logoImage:
          description: The MediaFile resource name of the logo image used in the ad.
          type: string
    GoogleAdsGoogleadsV25Common__ExpandedTextAdInfo:
      type: object
      properties:
        headlinePart2:
          description: The second part of the ad's headline.
          type: string
        description2:
          type: string
          description: The second description of the ad.
        headlinePart3:
          description: The third part of the ad's headline.
          type: string
        description:
          description: The description of the ad.
          type: string
        path1:
          type: string
          description: The text that can appear alongside the ad's displayed URL.
        headlinePart1:
          type: string
          description: The first part of the ad's headline.
        path2:
          description: Additional text that can appear alongside the ad's displayed URL.
          type: string
      description: An expanded text ad. Expanded text ads are deprecated.
    GoogleAdsGoogleadsV25Common__AdVideoAsset:
      description: A video asset used inside an ad.
      type: object
      properties:
        asset:
          type: string
          description: The Asset resource name of this video.
        adVideoAssetInfo:
          description: Contains info fields for this AdVideoAsset.
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdVideoAssetInfo'
    GoogleAdsGoogleadsV25Common__CustomParameter:
      type: object
      properties:
        key:
          description: The key matching the parameter tag name.
          type: string
        value:
          type: string
          description: The value to be substituted.
      description: A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
    GoogleAdsGoogleadsV25Common__AdDemandGenCarouselCardAsset:
      type: object
      properties:
        asset:
          description: The Asset resource name of this discovery carousel card.
          type: string
      description: A Demand Gen carousel card asset used inside an ad.
    GoogleAdsGoogleadsV25Common__SyntheticContentInfo:
      description: Container for synthetic content attestations from different sources, such as the advertiser and Google systems.
      type: object
      properties:
        systemAttestation:
          description: Output only. Information about synthetic content generated by Google's systems.
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__SyntheticContentAttestation'
        advertiserAttestation:
          description: Input provided by the advertiser.
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__SyntheticContentAttestation'
    GoogleAdsGoogleadsV25Common__DemandGenCarouselAdInfo:
      type: object
      properties:
        carouselCards:
          description: Required. Carousel cards that will display with the ad. Min 2 max 10.
          items:
            $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdDemandGenCarouselCardAsset'
          type: array
        callToActionText:
          description: Call to action text.
          type: string
        headline:
          description: Required. Headline of the ad.
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdTextAsset'
        businessName:
          type: string
          description: Required. The Advertiser/brand name.
        logoImage:
          description: Required. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%).
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdImageAsset'
        description:
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdTextAsset'
          description: Required. The descriptive text of the ad.
      description: A Demand Gen carousel ad.
    GoogleAdsGoogleadsV25Common__PolicyValidationParameter:
      description: Parameter for controlling how policy exemption is done.
      type: object
      properties:
        ignorablePolicyTopics:
          type: array
          description: The list of policy topics that should not cause a `PolicyFindingError` to be reported. This field is used for ad policy exemptions. It corresponds to the `PolicyTopicEntry.topic` field. If this field is populated, then `exempt_policy_violation_keys` must be empty. Resources that violate these policies will be saved, but will not be eligible to serve. They may begin serving at a later time due to a change in policies, re-review of the resource, or a change in advertiser certificates.
          items:
            type: string
        exemptPolicyViolationKeys:
          type: array
          description: The list of policy violation keys that should not cause a `PolicyViolationError` to be reported. Not all policy violations are exemptable. Refer to the `is_exemptible` field in the returned `PolicyViolationError`. This field is used for keyword policy exemptions. If this field is populated, then `ignorable_policy_topics` must be empty. Resources that violate these policies will be saved, but will not be eligible to serve. They may begin serving at a later time due to a change in policies, re-review of the resource, or a change in advertiser certificates.
          items:
            $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__PolicyViolationKey'
    GoogleAdsGoogleadsV25Common__LocalAdInfo:
      type: object
      properties:
        callToActions:
          type: array
          description: List of text assets for call-to-actions. When the ad serves the call-to-actions will be selected from this list. At least 1 and at most 5 call-to-actions must be specified.
          items:
            $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdTextAsset'
        path1:
          type: string
          description: First part of optional text that can be appended to the URL in the ad.
        path2:
          description: Second part of optional text that can be appended to the URL in the ad. This field can only be set when `path1` is also set.
          type: string
        descriptions:
          description: List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. At least 1 and at most 5 descriptions must be specified.
          items:
            $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdTextAsset'
          type: array
        logoImages:
          type: array
          description: List of logo image assets that may be displayed with the ad. The images must be 128x128 pixels and not larger than 120KB. At least 1 and at most 5 image assets must be specified.
          items:
            $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdImageAsset'
        headlines:
          type: array
          description: List of text assets for headlines. When the ad serves the headlines will be selected from this list. At least 1 and at most 5 headlines must be specified.
          items:
            $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdTextAsset'
        marketingImages:
          type: array
          description: List of marketing image assets that may be displayed with the ad. The images must be 314x600 pixels or 320x320 pixels. At least 1 and at most 20 image assets must be specified.
          items:
            $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdImageAsset'
        videos:
          description: List of YouTube video assets that may be displayed with the ad. At least 1 and at most 20 video assets must be specified.
          items:
            $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdVideoAsset'
          type: array
      description: A local ad.
    GoogleAdsGoogleadsV25Common__AppPreRegistrationAdInfo:
      type: object
      properties:
        headlines:
          description: List of text assets for headlines. When the ad serves the headlines will be selected from this list.
          items:
            $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdTextAsset'
          type: array
        youtubeVideos:
          description: List of YouTube video asset IDs whose videos may be displayed with the ad.
          items:
            $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdVideoAsset'
          type: array
        images:
          type: array
          description: List of image asset IDs whose images may be displayed with the ad.
          items:
            $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdImageAsset'
        descriptions:
          type: array
          description: List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
          items:
            $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdTextAsset'
      description: App pre-registration ads link to your app or game listing on Google Play, and can run on Google Play, on YouTube (in-stream only), and within other apps and mobile websites on the Display Network. It will help capture people's interest in your app or game and generate an early install base for your app or game before a launch.
    GoogleAdsGoogleadsV25Common__VideoTrueViewInStreamAdInfo:
      description: Representation of video TrueView in-stream ad format (ad shown during video playback, often at beginning, which displays a skip button a few seconds into the video).
      type: object
      properties:
        actionHeadline:
          description: Additional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button.
          type: string
        actionButtonLabel:
          description: Label on the CTA (call-to-action) button taking the user to the video ad's final URL. Required for TrueView for action campaigns, optional otherwise.
          type: string
        companionBanner:
          $ref: '#/components/schemas/GoogleAdsGoogleadsV25Common__AdImageAsset'
          description: The image assets of the companion banner used with the ad.
    GoogleAdsGoogleadsV25Common_PolicyTopicEvidence_DestinationMismatch:
      type: object
      properties:
        urlTypes:
          type: array
          description: The set of URLs that did not match each other.
          items:
            x-enumDescriptions:
            - No value has been specified.
            - The received value i

# --- truncated at 32 KB (90 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/google-ads/refs/heads/main/openapi/google-ads-customers-ads-api-openapi.yml