--- title: "POST /v23/customers/{+customerId}/searchAds360:mutate" method: POST path: "/v23/customers/{+customerId}/searchAds360:mutate" tags: ["customers"] --- # POST /v23/customers/{+customerId}/searchAds360:mutate `POST /v23/customers/{+customerId}/searchAds360:mutate` This method is essentially a wrapper around a series of mutate methods. The only features it offers over calling those methods directly are: - Atomic transactions - Temp resource names (described below) - Somewhat reduced latency over making a series of mutate calls Note: Only resources that support atomic transactions are included, so this method can't replace all calls to individual services. ## Atomic Transaction Benefits Atomicity makes error handling much easier. If you're making a series of changes and one fails, it can leave your account in an inconsistent state. With atomicity, you either reach the chosen state directly, or the request fails and you can retry. ## Temp Resource Names Temp resource names are a special type of resource name used to create a resource and reference that resource in the same request. For example, if a is created with `resource_name` equal to ``, that resource name can be reused in the `` field in the same request. That way, the two resources are created and linked atomically. To create a temp resource name, put a negative number in the part of the name that the server would normally allocate. Note: - Resources must be created with a temp name before the name can be reused. For example, the previous example would fail if the mutate order was reversed. - Temp names are not remembered across requests. - There's no limit to the number of temp names in a request. - Each temp name must use a unique negative number, even if the resource types differ. ## Latency It's important to group mutates by resource type or the request may time out and fail. Latency is roughly equal to a series of calls to individual mutate methods, where each change in resource type is a new call. For example, mutating is like 2 calls, while mutating is like 4 calls. List of thrown errors: [AdCustomizerError]() [AdError]() [AdGroupAdError]() [AdGroupCriterionError]() [AdGroupError]() [AssetError]() [AuthenticationError]() [AuthorizationError]() [BiddingError]() [CampaignBudgetError]() [CampaignCriterionError]() [CampaignError]() [CampaignExperimentError]() [CampaignSharedSetError]() [CollectionSizeError]() [ContextError]() [ConversionActionError]() [CriterionError]() [CustomerFeedError]() [DatabaseError]() [DateError]() [DateRangeError]() [DistinctError]() [ExtensionFeedItemError]() [ExtensionSettingError]() [FeedAttributeReferenceError]() [FeedError]() [FeedItemError]() [FeedItemSetError]() [FieldError]() [FieldMaskError]() [FunctionParsingError]() [HeaderError]() [ImageError]() [InternalError]() [KeywordPlanAdGroupKeywordError]() [KeywordPlanCampaignError]() [KeywordPlanError]() [LabelError]() [ListOperationError]() [MediaUploadError]() [MutateError]() [NewResourceCreationError]() [NullError]() [OperationAccessDeniedError]() [PolicyFindingError]() [PolicyViolationError]() [QuotaError]() [RangeError]() [RequestError]() [ResourceCountLimitExceededError]() [SettingError]() [SharedSetError]() [SizeLimitError]() [StringFormatError]() [StringLengthError]() [UrlFieldError]() [UserListError]() [YoutubeVideoRegistrationError]() ## Path parameters - `customerId` string, required ## Request body - GoogleAdsSearchads360V23ServicesMutateSearchAds360Request — Request message for Service.Mutate. - `mutateOperations` GoogleAdsSearchads360V23ServicesMutateOperation[] — Required. The list of operations to perform on individual resources. - `biddingDataExclusionOperation` GoogleAdsSearchads360V23ServicesBiddingDataExclusionOperation — A single operation (create, remove, update) on a data exclusion. - `create` GoogleAdsSearchads360V23ResourcesBiddingDataExclusion — Represents a bidding data exclusion. Bidding data exclusions can be set in client accounts only, and cannot be used in manager accounts. See "About data exclusions" at https://support.google.com/google-ads/answer/10370710. Note: A customer account can have a maximum of 500 active bidding data exclusions. - `scope` 'UNSPECIFIED' | 'UNKNOWN' | 'CUSTOMER' | 'CAMPAIGN' | 'CHANNEL' — The scope of the data exclusion. - `name` string — The name of the data exclusion. The name can be at most 255 characters. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — Output only. The status of the data exclusion. - `startDateTime` string — Required. The inclusive start time of the data exclusion in yyyy-MM-dd HH:mm:ss format. A data exclusion is backward looking and should be used for events that start in the past and end either in the past or future. - `dataExclusionId` string, int64 — Output only. The ID of the data exclusion. - `endDateTime` string — Required. The exclusive end time of the data exclusion in yyyy-MM-dd HH:mm:ss format. The length of [start_date_time, end_date_time) interval must be within (0, 14 days]. - `resourceName` string — Immutable. The resource name of the data exclusion. Data exclusion resource names have the form: `customers/{customer_id}/biddingDataExclusions/{data_exclusion_id}` - `description` string — The description of the data exclusion. The description can be at most 2048 characters. - `devices` string[] — If not specified, all devices will be included in this exclusion. Otherwise, only the specified targeted devices will be included in this exclusion. - `campaigns` string[] — The data exclusion will apply to the campaigns listed when the scope of this exclusion is CAMPAIGN. The maximum number of campaigns per event is 2000. Note: a data exclusion with both advertising_channel_types and campaign_ids is not supported. - `advertisingChannelTypes` string[] — The data_exclusion will apply to all the campaigns under the listed channels retroactively as well as going forward when the scope of this exclusion is CHANNEL. The supported advertising channel types are DISPLAY, SEARCH and SHOPPING. Note: a data exclusion with both advertising_channel_types and campaign_ids is not supported. - `update` GoogleAdsSearchads360V23ResourcesBiddingDataExclusion — Represents a bidding data exclusion. Bidding data exclusions can be set in client accounts only, and cannot be used in manager accounts. See "About data exclusions" at https://support.google.com/google-ads/answer/10370710. Note: A customer account can have a maximum of 500 active bidding data exclusions. - `scope` 'UNSPECIFIED' | 'UNKNOWN' | 'CUSTOMER' | 'CAMPAIGN' | 'CHANNEL' — The scope of the data exclusion. - `name` string — The name of the data exclusion. The name can be at most 255 characters. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — Output only. The status of the data exclusion. - `startDateTime` string — Required. The inclusive start time of the data exclusion in yyyy-MM-dd HH:mm:ss format. A data exclusion is backward looking and should be used for events that start in the past and end either in the past or future. - `dataExclusionId` string, int64 — Output only. The ID of the data exclusion. - `endDateTime` string — Required. The exclusive end time of the data exclusion in yyyy-MM-dd HH:mm:ss format. The length of [start_date_time, end_date_time) interval must be within (0, 14 days]. - `resourceName` string — Immutable. The resource name of the data exclusion. Data exclusion resource names have the form: `customers/{customer_id}/biddingDataExclusions/{data_exclusion_id}` - `description` string — The description of the data exclusion. The description can be at most 2048 characters. - `devices` string[] — If not specified, all devices will be included in this exclusion. Otherwise, only the specified targeted devices will be included in this exclusion. - `campaigns` string[] — The data exclusion will apply to the campaigns listed when the scope of this exclusion is CAMPAIGN. The maximum number of campaigns per event is 2000. Note: a data exclusion with both advertising_channel_types and campaign_ids is not supported. - `advertisingChannelTypes` string[] — The data_exclusion will apply to all the campaigns under the listed channels retroactively as well as going forward when the scope of this exclusion is CHANNEL. The supported advertising channel types are DISPLAY, SEARCH and SHOPPING. Note: a data exclusion with both advertising_channel_types and campaign_ids is not supported. - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `remove` string — Remove operation: A resource name for the removed data exclusion is expected, in this format: `customers/{customer_id}/biddingDataExclusions/{data_exclusion_id}` - `customizerAttributeOperation` GoogleAdsSearchads360V23ServicesCustomizerAttributeOperation — A single operation (create, remove) on a customizer attribute. - `create` GoogleAdsSearchads360V23ResourcesCustomizerAttribute — A customizer attribute. Use CustomerCustomizer, CampaignCustomizer, AdGroupCustomizer, or AdGroupCriterionCustomizer to associate a customizer attribute and set its value at the customer, campaign, ad group, or ad group criterion level, respectively. - `id` string, int64 — Output only. The ID of the customizer attribute. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'TEXT' | 'NUMBER' | 'PRICE' | 'PERCENT' — Immutable. The type of the customizer attribute. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — Output only. The status of the customizer attribute. - `name` string — Required. Immutable. Name of the customizer attribute. Required. It must have a minimum length of 1 and maximum length of 40. Name of an enabled customizer attribute must be unique (case insensitive). - `resourceName` string — Immutable. The resource name of the customizer attribute. Customizer Attribute resource names have the form: `customers/{customer_id}/customizerAttributes/{customizer_attribute_id}` - `remove` string — Remove operation: A resource name for the removed customizer attribute is expected, in this format: `customers/{customer_id}/customizerAttributes/{customizer_attribute_id}` - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `campaignLabelOperation` GoogleAdsSearchads360V23ServicesCampaignLabelOperation — A single operation (create, remove) on a campaign-label relationship. - `create` GoogleAdsSearchads360V23ResourcesCampaignLabel — Represents a relationship between a campaign and a label. - `resourceName` string — Immutable. Name of the resource. Campaign label resource names have the form: `customers/{owner_customer_id}/campaignLabels/{campaign_id}~{label_id}` - `campaign` string — Immutable. The campaign to which the label is attached. - `label` string — Immutable. The label assigned to the campaign. - `ownerCustomerId` string, int64 — Output only. The ID of the Customer which owns the label. - `remove` string — Remove operation: A resource name for the campaign-label relationship being removed, in this format: `customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}` - `adGroupAdOperation` GoogleAdsSearchads360V23ServicesAdGroupAdOperation — A single operation (create, update, remove) on an ad group ad. - `policyValidationParameter` GoogleAdsSearchads360V23CommonPolicyValidationParameter — Parameter for controlling how policy exemption is done. - `ignorablePolicyTopics` string[] — 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. - `exemptPolicyViolationKeys` GoogleAdsSearchads360V23CommonPolicyViolationKey[] — 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. - `policyName` string — Unique ID of the violated policy. - `violatingText` string — 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. - `remove` string — Remove operation: A resource name for the removed ad is expected, in this format: `customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}` - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `create` GoogleAdsSearchads360V23ResourcesAdGroupAd — An ad group ad. - `primaryStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'ELIGIBLE' | 'PAUSED' | 'REMOVED' | 'PENDING' | 'LIMITED' | 'NOT_ELIGIBLE' — Output only. Provides aggregated view into why an ad group ad is not serving or not serving optimally. - `policySummary` GoogleAdsSearchads360V23ResourcesAdGroupAdPolicySummary — Contains policy information for an ad. - `policyTopicEntries` GoogleAdsSearchads360V23CommonPolicyTopicEntry[] — Output only. The list of policy findings for this ad. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'PROHIBITED' | 'LIMITED' | 'FULLY_LIMITED' | 'DESCRIPTIVE' | 'BROADENING' | 'AREA_OF_INTEREST_ONLY' — Describes the negative or positive effect this policy will have on serving. - `evidences` GoogleAdsSearchads360V23CommonPolicyTopicEvidence[] — Additional information that explains policy finding (for example, the brand name for a trademark finding). - … - `topic` string — Policy topic this finding refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. - `constraints` GoogleAdsSearchads360V23CommonPolicyTopicConstraint[] — Indicates how serving of this resource may be affected (for example, not serving in a country). - … - `reviewStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'REVIEW_IN_PROGRESS' | 'REVIEWED' | 'UNDER_APPEAL' | 'ELIGIBLE_MAY_SERVE' — Output only. Where in the review process this ad is. - `approvalStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'DISAPPROVED' | 'APPROVED_LIMITED' | 'APPROVED' | 'AREA_OF_INTEREST_ONLY' — Output only. The overall approval status of this ad, calculated based on the status of its individual policy topic entries. - `engineStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'AD_GROUP_AD_ELIGIBLE' | 'AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN' | 'AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW' | 'AD_GROUP_AD_PARTIALLY_INVALID' | 'AD_GROUP_AD_TO_BE_ACTIVATED' | 'AD_GROUP_AD_NOT_REVIEWED' | 'AD_GROUP_AD_ON_HOLD' | 'AD_GROUP_AD_PAUSED' | 'AD_GROUP_AD_REMOVED' | 'AD_GROUP_AD_PENDING_REVIEW' | 'AD_GROUP_AD_UNDER_REVIEW' | 'AD_GROUP_AD_APPROVED' | 'AD_GROUP_AD_DISAPPROVED' | 'AD_GROUP_AD_SERVING' | 'AD_GROUP_AD_ACCOUNT_PAUSED' | 'AD_GROUP_AD_CAMPAIGN_PAUSED' | 'AD_GROUP_AD_AD_GROUP_PAUSED' — Output only. Additional status of the ad in the external engine account. Possible statuses (depending on the type of external account) include active, eligible, pending review, etc. - `lastModifiedTime` string — Output only. The datetime when this ad group ad was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format. - `primaryStatusReasons` string[] — Output only. Provides reasons for why an ad group ad is not serving or not serving optimally. - `engineId` string — Output only. ID of the ad in the external engine account. This field is for Search Ads 360 account only, for example, Yahoo Japan, Microsoft, Baidu etc. For non-Search Ads 360 entity, use "ad_group_ad.ad.id" instead. - `adStrength` 'UNSPECIFIED' | 'UNKNOWN' | 'PENDING' | 'NO_ADS' | 'POOR' | 'AVERAGE' | 'GOOD' | 'EXCELLENT' — Output only. Overall ad strength for this ad group ad. - `adGroupAdAssetAutomationSettings` GoogleAdsSearchads360V23ResourcesAdGroupAdAssetAutomationSetting[] — Settings that control the types of asset automation. See the AssetAutomationTypeEnum documentation for the default opt in/out behavior of each type. - `assetAutomationStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'OPTED_IN' | 'OPTED_OUT' — The opt-in/out status for the specified asset automation type. - `assetAutomationType` 'UNSPECIFIED' | 'UNKNOWN' | 'TEXT_ASSET_AUTOMATION' | 'GENERATE_VERTICAL_YOUTUBE_VIDEOS' | 'GENERATE_SHORTER_YOUTUBE_VIDEOS' | 'GENERATE_LANDING_PAGE_PREVIEW' | 'GENERATE_ENHANCED_YOUTUBE_VIDEOS' | 'GENERATE_IMAGE_ENHANCEMENT' | 'GENERATE_IMAGE_EXTRACTION' | 'GENERATE_DESIGN_VERSIONS_FOR_IMAGES' | 'FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION' | 'GENERATE_VIDEOS_FROM_OTHER_ASSETS' — The asset automation type that this setting configures. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'PAUSED' | 'REMOVED' — The status of the ad. - `adGroup` string — Immutable. The ad group to which the ad belongs. - `resourceName` string — Immutable. The resource name of the ad. Ad group ad resource names have the form: `customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}` - `effectiveLabels` string[] — Output only. The resource names of effective labels attached to this ad. An effective label is a label inherited or directly assigned to this ad. - `ad` GoogleAdsSearchads360V23ResourcesAd — An ad. - `shoppingComparisonListingAd` GoogleAdsSearchads360V23CommonShoppingComparisonListingAdInfo — A Shopping Comparison Listing ad. - `headline` string — Headline of the ad. This field is required. Allowed length is between 25 and 45 characters. - `travelAd` GoogleAdsSearchads360V23CommonTravelAdInfo — A travel ad. - `urlCollections` GoogleAdsSearchads360V23CommonUrlCollection[] — Additional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad. - `urlCollectionId` string — Unique identifier for this UrlCollection instance. - `finalUrls` string[] — A list of possible final URLs. - `finalMobileUrls` string[] — A list of possible final mobile URLs. - `trackingUrlTemplate` string — URL template for constructing a tracking URL. - `imageAd` GoogleAdsSearchads360V23CommonImageAdInfo — An image ad. - `previewPixelHeight` string, int64 — Height in pixels of the preview size image. - `previewImageUrl` string — URL of the preview size image. - `imageAsset` GoogleAdsSearchads360V23CommonAdImageAsset — An image asset used inside an ad. - … - `pixelHeight` string, int64 — Height in pixels of the full size image. - `previewPixelWidth` string, int64 — Width in pixels of the preview size image. - `mimeType` 'UNSPECIFIED' | 'UNKNOWN' | 'IMAGE_JPEG' | 'IMAGE_GIF' | 'IMAGE_PNG' | 'FLASH' | 'TEXT_HTML' | 'PDF' | 'MSWORD' | 'MSEXCEL' | 'RTF' | 'AUDIO_WAV' | 'AUDIO_MP3' | 'HTML5_AD_ZIP' — The mime type of the image. - `data` string, byte — Raw image data as bytes. - `imageUrl` string — URL of the full size image. - `adIdToCopyImageFrom` string, int64 — An ad ID to copy the image from. - `pixelWidth` string, int64 — Width in pixels of the full size image. - `name` string — The name of the image. If the image was created from a MediaFile, this is the MediaFile's name. If the image was created from bytes, this is empty. - `systemManagedResourceSource` 'UNSPECIFIED' | 'UNKNOWN' | 'AD_VARIATIONS' — Output only. If this ad is system managed, then this field will indicate the source. This field is read-only. - `resourceName` string — Immutable. The resource name of the ad. Ad resource names have the form: `customers/{customer_id}/ads/{ad_id}` - `searchAds360ExpandedTextAd` GoogleAdsSearchads360V23CommonSearchAds360ExpandedTextAdInfo — A Search Ads 360 expanded text ad. - `headline2` string — The second headline of the ad. - `description2` string — The second line of the ad's description. - `path2` string — Text appended to path1 with a delimiter. - `adTrackingId` string, int64 — The tracking id of the ad. - `headline` string — The headline of the ad. - `headline3` string — The third headline of the ad. - `description1` string — The first line of the ad's description. - `path1` string — Text appended to the auto-generated visible URL with a delimiter. - `responsiveSearchAd` GoogleAdsSearchads360V23CommonResponsiveSearchAdInfo — A responsive search ad. Responsive search ads let you create an ad that adapts to show more text, and more relevant messages, to your customers. Enter multiple headlines and descriptions when creating a responsive search ad, and over time, Google Ads will automatically test different combinations and learn which combinations perform best. By adapting your ad's content to more closely match potential customers' search terms, responsive search ads may improve your campaign's performance. More information at https://support.google.com/google-ads/answer/7684791 - `path1` string — First part of text that can be appended to the URL in the ad. - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for headlines. When the ad serves the headlines will be selected from this list. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. - … - `path2` string — Second part of text that can be appended to the URL in the ad. This field can only be set when `path1` is also set. - `shoppingProductAd` GoogleAdsSearchads360V23CommonShoppingProductAdInfo — A standard Shopping ad. - `demandGenProductAd` GoogleAdsSearchads360V23CommonDemandGenProductAdInfo — A Demand Gen product ad. - `description` GoogleAdsSearchads360V23CommonAdTextAsset — A text asset used inside an ad. - … - `businessName` GoogleAdsSearchads360V23CommonAdTextAsset — A text asset used inside an ad. - … - `callToAction` GoogleAdsSearchads360V23CommonAdCallToActionAsset — A call to action asset used inside an ad. - … - `headline` GoogleAdsSearchads360V23CommonAdTextAsset — A text asset used inside an ad. - … - `breadcrumb2` string — Second part of text that appears in the ad with the displayed URL. - `logoImage` GoogleAdsSearchads360V23CommonAdImageAsset — An image asset used inside an ad. - … - `breadcrumb1` string — First part of text that appears in the ad with the displayed URL. - `trackingUrlTemplate` string — The URL template for constructing a tracking URL. - `addedByGoogleAds` boolean — Output only. Indicates if this ad was automatically added by Google Ads and not by a user. For example, this could happen when ads are automatically created as suggestions for new ads based on knowledge of how existing ads are performing. - `id` string, int64 — Output only. The ID of the ad. - `expandedTextAd` GoogleAdsSearchads360V23CommonExpandedTextAdInfo — An expanded text ad. - `headlinePart1` string — The first part of the ad's headline. - `headlinePart2` string — The second part of the ad's headline. - `path1` string — The text that can appear alongside the ad's displayed URL. - `description2` string — The second description of the ad. - `path2` string — Additional text that can appear alongside the ad's displayed URL. - `headlinePart3` string — The third part of the ad's headline. - `description` string — The description of the ad. - `hotelAd` GoogleAdsSearchads360V23CommonHotelAdInfo — A hotel ad. - `demandGenVideoResponsiveAd` GoogleAdsSearchads360V23CommonDemandGenVideoResponsiveAdInfo — A Demand Gen video responsive ad. - `breadcrumb2` string — Second part of text that appears in the ad with the displayed URL. - `logoImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Logo image to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). - … - `companionBanners` GoogleAdsSearchads360V23CommonAdImageAsset[] — List of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported. - … - `callToActions` GoogleAdsSearchads360V23CommonAdCallToActionAsset[] — Assets of type CallToActionAsset used for the "Call To Action" button. - … - `breadcrumb1` string — First part of text that appears in the ad with the displayed URL. - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets used for the short headline. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets used for the description. - … - `longHeadlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets used for the long headline. - … - `videos` GoogleAdsSearchads360V23CommonAdVideoAsset[] — List of YouTube video assets used for the ad. - … - `businessName` GoogleAdsSearchads360V23CommonAdTextAsset — A text asset used inside an ad. - … - `shoppingSmartAd` GoogleAdsSearchads360V23CommonShoppingSmartAdInfo — A Smart Shopping ad. - `displayUploadAd` GoogleAdsSearchads360V23CommonDisplayUploadAdInfo — 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. - `displayUploadProductType` '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' — The product type of this ad. See comments on the enum for details. - `mediaBundle` GoogleAdsSearchads360V23CommonAdMediaBundleAsset — A media bundle asset used inside an ad. - … - `productAd` GoogleAdsSearchads360V23CommonSearchAds360ProductAdInfo — A Search Ads 360 product ad. - `appPreRegistrationAd` GoogleAdsSearchads360V23CommonAppPreRegistrationAdInfo — 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. - `images` GoogleAdsSearchads360V23CommonAdImageAsset[] — List of image asset IDs whose images may be displayed with the ad. - … - `youtubeVideos` GoogleAdsSearchads360V23CommonAdVideoAsset[] — List of YouTube video asset IDs whose videos may be displayed with the ad. - … - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for headlines. When the ad serves the headlines will be selected from this list. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. - … - `demandGenMultiAssetAd` GoogleAdsSearchads360V23CommonDemandGenMultiAssetAdInfo — A Demand Gen multi asset ad. - `marketingImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). Required if square_marketing_images is not present. - … - `tallPortraitMarketingImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Tall portrait marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x1067 and the aspect ratio must be 9:16 (+-1%). Combined with `marketing_images`, `square_marketing_images`, and `portrait_marketing_images`, the maximum is 20. - … - `logoImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Logo image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). At least 1 and max 5 logo images can be specified. - … - `portraitMarketingImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Portrait marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 480x600 and the aspect ratio must be 4:5 (+-1%). - … - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — Headline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — The descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified. - … - `callToActionText` string — Call to action text. - `businessName` string — The Advertiser/brand name. Maximum display width is 25. Required. - `squareMarketingImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Square marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). Required if marketing_images is not present. - … - `searchAds360TextAd` GoogleAdsSearchads360V23CommonSearchAds360TextAdInfo — A Search Ads 360 text ad. - `displayMobileUrl` string — The displayed mobile URL of the ad. - `description2` string — The second line of the ad's description. - `adTrackingId` string, int64 — The tracking id of the ad. - `headline` string — The headline of the ad. - `description1` string — The first line of the ad's description. - `displayUrl` string — The displayed URL of the ad. - `displayUrl` string — The URL that appears in the ad description for some ad formats. - `expandedDynamicSearchAd` GoogleAdsSearchads360V23CommonExpandedDynamicSearchAdInfo — An expanded dynamic search ad. - `description2` string — The second description of the ad. - `description` string — The description of the ad. - `legacyAppInstallAd` GoogleAdsSearchads360V23CommonLegacyAppInstallAdInfo — A legacy app install ad that only can be used by a few select customers. - `appStore` 'UNSPECIFIED' | 'UNKNOWN' | 'APPLE_APP_STORE' | 'GOOGLE_PLAY' | 'WINDOWS_STORE' | 'WINDOWS_PHONE_STORE' | 'CN_APP_STORE' — The app store the mobile app is available in. - `appId` string — The ID of the mobile app. - `description2` string — The second description line of the ad. - `headline` string — The headline of the ad. - `description1` string — The first description line of the ad. - `name` string — Immutable. The name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad. - `legacyResponsiveDisplayAd` GoogleAdsSearchads360V23CommonLegacyResponsiveDisplayAdInfo — A legacy responsive display ad. Ads of this type are labeled 'Responsive ads' in the Google Ads UI. - `shortHeadline` string — The short version of the ad's headline. - `squareMarketingImage` string — The MediaFile resource name of the square marketing image used in the ad. - `mainColor` string — 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. - `promoText` string — Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. - `allowFlexibleColor` boolean — 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. - `longHeadline` string — The long version of the ad's headline. - `pricePrefix` string — Prefix before price. For example, 'as low as'. - `logoImage` string — The MediaFile resource name of the logo image used in the ad. - `callToActionText` string — The call-to-action text for the ad. - `accentColor` string — 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. - `businessName` string — The business name in the ad. - `description` string — The description of the ad. - `formatSetting` 'UNSPECIFIED' | 'UNKNOWN' | 'ALL_FORMATS' | 'NON_NATIVE' | 'NATIVE' — Specifies which format the ad will be served in. Default is ALL_FORMATS. - `marketingImage` string — The MediaFile resource name of the marketing image used in the ad. - `squareLogoImage` string — The MediaFile resource name of the square logo image used in the ad. - `smartCampaignAd` GoogleAdsSearchads360V23CommonSmartCampaignAdInfo — A Smart campaign ad. - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets, each of which corresponds to a headline when the ad serves. This list consists of a minimum of 3 and up to 15 text assets. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets, each of which corresponds to a description when the ad serves. This list consists of a minimum of 2 and up to 4 text assets. - … - `demandGenCarouselAd` GoogleAdsSearchads360V23CommonDemandGenCarouselAdInfo — A Demand Gen carousel ad. - `logoImage` GoogleAdsSearchads360V23CommonAdImageAsset — An image asset used inside an ad. - … - `carouselCards` GoogleAdsSearchads360V23CommonAdDemandGenCarouselCardAsset[] — Required. Carousel cards that will display with the ad. Min 2 max 10. - … - `businessName` string — Required. The Advertiser/brand name. - `description` GoogleAdsSearchads360V23CommonAdTextAsset — A text asset used inside an ad. - … - `callToActionText` string — Call to action text. - `headline` GoogleAdsSearchads360V23CommonAdTextAsset — A text asset used inside an ad. - … - `finalMobileUrls` string[] — The list of possible final mobile URLs after all cross-domain redirects for the ad. - `devicePreference` 'UNSPECIFIED' | 'UNKNOWN' | 'MOBILE' | 'TABLET' | 'DESKTOP' | 'CONNECTED_TV' | 'OTHER' — The device preference for the ad. You can only specify a preference for mobile devices. When this preference is set the ad will be preferred over other ads when being displayed on a mobile device. The ad can still be displayed on other device types, for example, if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types. - `responsiveDisplayAd` GoogleAdsSearchads360V23CommonResponsiveDisplayAdInfo — A responsive display ad. - `squareLogoImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Square logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). Combined with `logo_images`, the maximum is 5. - … - `formatSetting` 'UNSPECIFIED' | 'UNKNOWN' | 'ALL_FORMATS' | 'NON_NATIVE' | 'NATIVE' — Specifies which format the ad will be served in. Default is ALL_FORMATS. - `logoImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 512x128 and the aspect ratio must be 4:1 (+-1%). Combined with `square_logo_images`, the maximum is 5. - … - `businessName` string — The advertiser/brand name. Maximum display width is 25. - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — Short format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — Descriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified. - … - `callToActionText` string — The call-to-action text for the ad. Maximum display width is 30. - `accentColor` string — 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. - `controlSpec` GoogleAdsSearchads360V23CommonResponsiveDisplayAdControlSpec — Specification for various creative controls for a responsive display ad. - … - `squareMarketingImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Square marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). At least one square `marketing_image` is required. Combined with `marketing_images`, the maximum is 15. - … - `marketingImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). At least one `marketing_image` is required. Combined with `square_marketing_images`, the maximum is 15. - … - `allowFlexibleColor` boolean — 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. - `longHeadline` GoogleAdsSearchads360V23CommonAdTextAsset — A text asset used inside an ad. - … - `pricePrefix` string — Prefix before price. For example, 'as low as'. - `promoText` string — Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. - `youtubeVideos` GoogleAdsSearchads360V23CommonAdVideoAsset[] — Optional YouTube videos for the ad. A maximum of 5 videos can be specified. - … - `mainColor` string — 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. - `appAd` GoogleAdsSearchads360V23CommonAppAdInfo — An app ad. - `images` GoogleAdsSearchads360V23CommonAdImageAsset[] — List of image assets that may be displayed with the ad. - … - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for headlines. When the ad serves the headlines will be selected from this list. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. - … - `html5MediaBundles` GoogleAdsSearchads360V23CommonAdMediaBundleAsset[] — List of media bundle assets that may be used with the ad. - … - `youtubeVideos` GoogleAdsSearchads360V23CommonAdVideoAsset[] — List of YouTube video assets that may be displayed with the ad. - … - `appDeepLink` GoogleAdsSearchads360V23CommonAdAppDeepLinkAsset — An app deep link used inside an ad. - … - `mandatoryAdText` GoogleAdsSearchads360V23CommonAdTextAsset — A text asset used inside an ad. - … - `finalUrlSuffix` string — The suffix to use when constructing a final URL. - `localAd` GoogleAdsSearchads360V23CommonLocalAdInfo — A local ad. - `callToActions` GoogleAdsSearchads360V23CommonAdTextAsset[] — 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. - … - `marketingImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — 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. - … - `videos` GoogleAdsSearchads360V23CommonAdVideoAsset[] — List of YouTube video assets that may be displayed with the ad. At least 1 and at most 20 video assets must be specified. - … - `logoImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — 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. - … - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — 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. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — 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. - … - `path2` string — 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. - `path1` string — First part of optional text that can be appended to the URL in the ad. - `textAd` GoogleAdsSearchads360V23CommonTextAdInfo — A text ad. - `headline` string — The headline of the ad. - `description1` string — The first line of the ad's description. - `description2` string — The second line of the ad's description. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'TEXT_AD' | 'EXPANDED_TEXT_AD' | 'EXPANDED_DYNAMIC_SEARCH_AD' | 'HOTEL_AD' | 'SHOPPING_SMART_AD' | 'SHOPPING_PRODUCT_AD' | 'VIDEO_AD' | 'IMAGE_AD' | 'RESPONSIVE_SEARCH_AD' | 'LEGACY_RESPONSIVE_DISPLAY_AD' | 'APP_AD' | 'LEGACY_APP_INSTALL_AD' | 'RESPONSIVE_DISPLAY_AD' | 'LOCAL_AD' | 'HTML5_UPLOAD_AD' | 'DYNAMIC_HTML5_AD' | 'APP_ENGAGEMENT_AD' | 'SHOPPING_COMPARISON_LISTING_AD' | 'VIDEO_BUMPER_AD' | 'VIDEO_NON_SKIPPABLE_IN_STREAM_AD' | 'VIDEO_TRUEVIEW_IN_STREAM_AD' | 'VIDEO_RESPONSIVE_AD' | 'SMART_CAMPAIGN_AD' | 'CALL_AD' | 'APP_PRE_REGISTRATION_AD' | 'DEMAND_GEN_MULTI_ASSET_AD' | 'DEMAND_GEN_CAROUSEL_AD' | 'TRAVEL_AD' | 'DEMAND_GEN_VIDEO_RESPONSIVE_AD' | 'DEMAND_GEN_PRODUCT_AD' | 'MULTIMEDIA_AD' — Output only. The type of ad. - `urlCustomParameters` GoogleAdsSearchads360V23CommonCustomParameter[] — The list of mappings that can be used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`. For mutates, use url custom parameter operations. - `key` string — The key matching the parameter tag name. - `value` string — The value to be substituted. - `appEngagementAd` GoogleAdsSearchads360V23CommonAppEngagementAdInfo — App engagement ads allow you to write text encouraging a specific action in the app, like checking in, making a purchase, or booking a flight. They allow you to send users to a specific part of your app where they can find what they're looking for easier and faster. - `videos` GoogleAdsSearchads360V23CommonAdVideoAsset[] — List of video assets that may be displayed with the ad. - … - `images` GoogleAdsSearchads360V23CommonAdImageAsset[] — List of image assets that may be displayed with the ad. - … - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for headlines. When the ad serves the headlines will be selected from this list. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. - … - `searchAds360ResponsiveSearchAd` GoogleAdsSearchads360V23CommonSearchAds360ResponsiveSearchAdInfo — A Search Ads 360 responsive search ad. - `path1` string — Text appended to the auto-generated visible URL with a delimiter. - `path2` string — Text appended to path1 with a delimiter. - `adTrackingId` string, int64 — The tracking id of the ad. - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for headlines. When the ad serves the headlines will be selected from this list. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. - … - `finalUrls` string[] — The list of possible final URLs after all cross-domain redirects for the ad. - `finalAppUrls` GoogleAdsSearchads360V23CommonFinalAppUrl[] — A list of final app URLs that will be used on mobile if the user has the specific app installed. - `osType` 'UNSPECIFIED' | 'UNKNOWN' | 'IOS' | 'ANDROID' — The operating system targeted by this URL. Required. - `url` string — The app deep link URL. Deep links specify a location in an app that corresponds to the content you'd like to show, and should be of the form {scheme}://{host_path} The scheme identifies which app to open. For your app, you can use a custom scheme that starts with the app's name. The host and path specify the unique location in the app where your content exists. Example: "exampleapp://productid_1234". Required. - `searchAds360ExpandedDynamicSearchAd` GoogleAdsSearchads360V23CommonSearchAds360ExpandedDynamicSearchAdInfo — An expanded dynamic search ad. - `description1` string — The first line of the ad's description. - `description2` string — The second line of the ad's description. - `adTrackingId` string, int64 — The tracking id of the ad. - `creationTime` string — Output only. The timestamp when this ad_group_ad was created. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format. - `labels` string[] — Output only. The resource names of labels attached to this ad group ad. - `actionItems` string[] — Output only. A list of recommendations to improve the ad strength. For example, a recommendation could be "Try adding a few more unique headlines or unpinning some assets.". - `update` GoogleAdsSearchads360V23ResourcesAdGroupAd — An ad group ad. - `primaryStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'ELIGIBLE' | 'PAUSED' | 'REMOVED' | 'PENDING' | 'LIMITED' | 'NOT_ELIGIBLE' — Output only. Provides aggregated view into why an ad group ad is not serving or not serving optimally. - `policySummary` GoogleAdsSearchads360V23ResourcesAdGroupAdPolicySummary — Contains policy information for an ad. - `policyTopicEntries` GoogleAdsSearchads360V23CommonPolicyTopicEntry[] — Output only. The list of policy findings for this ad. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'PROHIBITED' | 'LIMITED' | 'FULLY_LIMITED' | 'DESCRIPTIVE' | 'BROADENING' | 'AREA_OF_INTEREST_ONLY' — Describes the negative or positive effect this policy will have on serving. - `evidences` GoogleAdsSearchads360V23CommonPolicyTopicEvidence[] — Additional information that explains policy finding (for example, the brand name for a trademark finding). - … - `topic` string — Policy topic this finding refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. - `constraints` GoogleAdsSearchads360V23CommonPolicyTopicConstraint[] — Indicates how serving of this resource may be affected (for example, not serving in a country). - … - `reviewStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'REVIEW_IN_PROGRESS' | 'REVIEWED' | 'UNDER_APPEAL' | 'ELIGIBLE_MAY_SERVE' — Output only. Where in the review process this ad is. - `approvalStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'DISAPPROVED' | 'APPROVED_LIMITED' | 'APPROVED' | 'AREA_OF_INTEREST_ONLY' — Output only. The overall approval status of this ad, calculated based on the status of its individual policy topic entries. - `engineStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'AD_GROUP_AD_ELIGIBLE' | 'AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN' | 'AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW' | 'AD_GROUP_AD_PARTIALLY_INVALID' | 'AD_GROUP_AD_TO_BE_ACTIVATED' | 'AD_GROUP_AD_NOT_REVIEWED' | 'AD_GROUP_AD_ON_HOLD' | 'AD_GROUP_AD_PAUSED' | 'AD_GROUP_AD_REMOVED' | 'AD_GROUP_AD_PENDING_REVIEW' | 'AD_GROUP_AD_UNDER_REVIEW' | 'AD_GROUP_AD_APPROVED' | 'AD_GROUP_AD_DISAPPROVED' | 'AD_GROUP_AD_SERVING' | 'AD_GROUP_AD_ACCOUNT_PAUSED' | 'AD_GROUP_AD_CAMPAIGN_PAUSED' | 'AD_GROUP_AD_AD_GROUP_PAUSED' — Output only. Additional status of the ad in the external engine account. Possible statuses (depending on the type of external account) include active, eligible, pending review, etc. - `lastModifiedTime` string — Output only. The datetime when this ad group ad was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format. - `primaryStatusReasons` string[] — Output only. Provides reasons for why an ad group ad is not serving or not serving optimally. - `engineId` string — Output only. ID of the ad in the external engine account. This field is for Search Ads 360 account only, for example, Yahoo Japan, Microsoft, Baidu etc. For non-Search Ads 360 entity, use "ad_group_ad.ad.id" instead. - `adStrength` 'UNSPECIFIED' | 'UNKNOWN' | 'PENDING' | 'NO_ADS' | 'POOR' | 'AVERAGE' | 'GOOD' | 'EXCELLENT' — Output only. Overall ad strength for this ad group ad. - `adGroupAdAssetAutomationSettings` GoogleAdsSearchads360V23ResourcesAdGroupAdAssetAutomationSetting[] — Settings that control the types of asset automation. See the AssetAutomationTypeEnum documentation for the default opt in/out behavior of each type. - `assetAutomationStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'OPTED_IN' | 'OPTED_OUT' — The opt-in/out status for the specified asset automation type. - `assetAutomationType` 'UNSPECIFIED' | 'UNKNOWN' | 'TEXT_ASSET_AUTOMATION' | 'GENERATE_VERTICAL_YOUTUBE_VIDEOS' | 'GENERATE_SHORTER_YOUTUBE_VIDEOS' | 'GENERATE_LANDING_PAGE_PREVIEW' | 'GENERATE_ENHANCED_YOUTUBE_VIDEOS' | 'GENERATE_IMAGE_ENHANCEMENT' | 'GENERATE_IMAGE_EXTRACTION' | 'GENERATE_DESIGN_VERSIONS_FOR_IMAGES' | 'FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION' | 'GENERATE_VIDEOS_FROM_OTHER_ASSETS' — The asset automation type that this setting configures. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'PAUSED' | 'REMOVED' — The status of the ad. - `adGroup` string — Immutable. The ad group to which the ad belongs. - `resourceName` string — Immutable. The resource name of the ad. Ad group ad resource names have the form: `customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}` - `effectiveLabels` string[] — Output only. The resource names of effective labels attached to this ad. An effective label is a label inherited or directly assigned to this ad. - `ad` GoogleAdsSearchads360V23ResourcesAd — An ad. - `shoppingComparisonListingAd` GoogleAdsSearchads360V23CommonShoppingComparisonListingAdInfo — A Shopping Comparison Listing ad. - `headline` string — Headline of the ad. This field is required. Allowed length is between 25 and 45 characters. - `travelAd` GoogleAdsSearchads360V23CommonTravelAdInfo — A travel ad. - `urlCollections` GoogleAdsSearchads360V23CommonUrlCollection[] — Additional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad. - `urlCollectionId` string — Unique identifier for this UrlCollection instance. - `finalUrls` string[] — A list of possible final URLs. - `finalMobileUrls` string[] — A list of possible final mobile URLs. - `trackingUrlTemplate` string — URL template for constructing a tracking URL. - `imageAd` GoogleAdsSearchads360V23CommonImageAdInfo — An image ad. - `previewPixelHeight` string, int64 — Height in pixels of the preview size image. - `previewImageUrl` string — URL of the preview size image. - `imageAsset` GoogleAdsSearchads360V23CommonAdImageAsset — An image asset used inside an ad. - … - `pixelHeight` string, int64 — Height in pixels of the full size image. - `previewPixelWidth` string, int64 — Width in pixels of the preview size image. - `mimeType` 'UNSPECIFIED' | 'UNKNOWN' | 'IMAGE_JPEG' | 'IMAGE_GIF' | 'IMAGE_PNG' | 'FLASH' | 'TEXT_HTML' | 'PDF' | 'MSWORD' | 'MSEXCEL' | 'RTF' | 'AUDIO_WAV' | 'AUDIO_MP3' | 'HTML5_AD_ZIP' — The mime type of the image. - `data` string, byte — Raw image data as bytes. - `imageUrl` string — URL of the full size image. - `adIdToCopyImageFrom` string, int64 — An ad ID to copy the image from. - `pixelWidth` string, int64 — Width in pixels of the full size image. - `name` string — The name of the image. If the image was created from a MediaFile, this is the MediaFile's name. If the image was created from bytes, this is empty. - `systemManagedResourceSource` 'UNSPECIFIED' | 'UNKNOWN' | 'AD_VARIATIONS' — Output only. If this ad is system managed, then this field will indicate the source. This field is read-only. - `resourceName` string — Immutable. The resource name of the ad. Ad resource names have the form: `customers/{customer_id}/ads/{ad_id}` - `searchAds360ExpandedTextAd` GoogleAdsSearchads360V23CommonSearchAds360ExpandedTextAdInfo — A Search Ads 360 expanded text ad. - `headline2` string — The second headline of the ad. - `description2` string — The second line of the ad's description. - `path2` string — Text appended to path1 with a delimiter. - `adTrackingId` string, int64 — The tracking id of the ad. - `headline` string — The headline of the ad. - `headline3` string — The third headline of the ad. - `description1` string — The first line of the ad's description. - `path1` string — Text appended to the auto-generated visible URL with a delimiter. - `responsiveSearchAd` GoogleAdsSearchads360V23CommonResponsiveSearchAdInfo — A responsive search ad. Responsive search ads let you create an ad that adapts to show more text, and more relevant messages, to your customers. Enter multiple headlines and descriptions when creating a responsive search ad, and over time, Google Ads will automatically test different combinations and learn which combinations perform best. By adapting your ad's content to more closely match potential customers' search terms, responsive search ads may improve your campaign's performance. More information at https://support.google.com/google-ads/answer/7684791 - `path1` string — First part of text that can be appended to the URL in the ad. - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for headlines. When the ad serves the headlines will be selected from this list. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. - … - `path2` string — Second part of text that can be appended to the URL in the ad. This field can only be set when `path1` is also set. - `shoppingProductAd` GoogleAdsSearchads360V23CommonShoppingProductAdInfo — A standard Shopping ad. - `demandGenProductAd` GoogleAdsSearchads360V23CommonDemandGenProductAdInfo — A Demand Gen product ad. - `description` GoogleAdsSearchads360V23CommonAdTextAsset — A text asset used inside an ad. - … - `businessName` GoogleAdsSearchads360V23CommonAdTextAsset — A text asset used inside an ad. - … - `callToAction` GoogleAdsSearchads360V23CommonAdCallToActionAsset — A call to action asset used inside an ad. - … - `headline` GoogleAdsSearchads360V23CommonAdTextAsset — A text asset used inside an ad. - … - `breadcrumb2` string — Second part of text that appears in the ad with the displayed URL. - `logoImage` GoogleAdsSearchads360V23CommonAdImageAsset — An image asset used inside an ad. - … - `breadcrumb1` string — First part of text that appears in the ad with the displayed URL. - `trackingUrlTemplate` string — The URL template for constructing a tracking URL. - `addedByGoogleAds` boolean — Output only. Indicates if this ad was automatically added by Google Ads and not by a user. For example, this could happen when ads are automatically created as suggestions for new ads based on knowledge of how existing ads are performing. - `id` string, int64 — Output only. The ID of the ad. - `expandedTextAd` GoogleAdsSearchads360V23CommonExpandedTextAdInfo — An expanded text ad. - `headlinePart1` string — The first part of the ad's headline. - `headlinePart2` string — The second part of the ad's headline. - `path1` string — The text that can appear alongside the ad's displayed URL. - `description2` string — The second description of the ad. - `path2` string — Additional text that can appear alongside the ad's displayed URL. - `headlinePart3` string — The third part of the ad's headline. - `description` string — The description of the ad. - `hotelAd` GoogleAdsSearchads360V23CommonHotelAdInfo — A hotel ad. - `demandGenVideoResponsiveAd` GoogleAdsSearchads360V23CommonDemandGenVideoResponsiveAdInfo — A Demand Gen video responsive ad. - `breadcrumb2` string — Second part of text that appears in the ad with the displayed URL. - `logoImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Logo image to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). - … - `companionBanners` GoogleAdsSearchads360V23CommonAdImageAsset[] — List of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported. - … - `callToActions` GoogleAdsSearchads360V23CommonAdCallToActionAsset[] — Assets of type CallToActionAsset used for the "Call To Action" button. - … - `breadcrumb1` string — First part of text that appears in the ad with the displayed URL. - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets used for the short headline. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets used for the description. - … - `longHeadlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets used for the long headline. - … - `videos` GoogleAdsSearchads360V23CommonAdVideoAsset[] — List of YouTube video assets used for the ad. - … - `businessName` GoogleAdsSearchads360V23CommonAdTextAsset — A text asset used inside an ad. - … - `shoppingSmartAd` GoogleAdsSearchads360V23CommonShoppingSmartAdInfo — A Smart Shopping ad. - `displayUploadAd` GoogleAdsSearchads360V23CommonDisplayUploadAdInfo — 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. - `displayUploadProductType` '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' — The product type of this ad. See comments on the enum for details. - `mediaBundle` GoogleAdsSearchads360V23CommonAdMediaBundleAsset — A media bundle asset used inside an ad. - … - `productAd` GoogleAdsSearchads360V23CommonSearchAds360ProductAdInfo — A Search Ads 360 product ad. - `appPreRegistrationAd` GoogleAdsSearchads360V23CommonAppPreRegistrationAdInfo — 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. - `images` GoogleAdsSearchads360V23CommonAdImageAsset[] — List of image asset IDs whose images may be displayed with the ad. - … - `youtubeVideos` GoogleAdsSearchads360V23CommonAdVideoAsset[] — List of YouTube video asset IDs whose videos may be displayed with the ad. - … - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for headlines. When the ad serves the headlines will be selected from this list. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. - … - `demandGenMultiAssetAd` GoogleAdsSearchads360V23CommonDemandGenMultiAssetAdInfo — A Demand Gen multi asset ad. - `marketingImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). Required if square_marketing_images is not present. - … - `tallPortraitMarketingImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Tall portrait marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x1067 and the aspect ratio must be 9:16 (+-1%). Combined with `marketing_images`, `square_marketing_images`, and `portrait_marketing_images`, the maximum is 20. - … - `logoImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Logo image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). At least 1 and max 5 logo images can be specified. - … - `portraitMarketingImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Portrait marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 480x600 and the aspect ratio must be 4:5 (+-1%). - … - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — Headline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — The descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified. - … - `callToActionText` string — Call to action text. - `businessName` string — The Advertiser/brand name. Maximum display width is 25. Required. - `squareMarketingImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Square marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). Required if marketing_images is not present. - … - `searchAds360TextAd` GoogleAdsSearchads360V23CommonSearchAds360TextAdInfo — A Search Ads 360 text ad. - `displayMobileUrl` string — The displayed mobile URL of the ad. - `description2` string — The second line of the ad's description. - `adTrackingId` string, int64 — The tracking id of the ad. - `headline` string — The headline of the ad. - `description1` string — The first line of the ad's description. - `displayUrl` string — The displayed URL of the ad. - `displayUrl` string — The URL that appears in the ad description for some ad formats. - `expandedDynamicSearchAd` GoogleAdsSearchads360V23CommonExpandedDynamicSearchAdInfo — An expanded dynamic search ad. - `description2` string — The second description of the ad. - `description` string — The description of the ad. - `legacyAppInstallAd` GoogleAdsSearchads360V23CommonLegacyAppInstallAdInfo — A legacy app install ad that only can be used by a few select customers. - `appStore` 'UNSPECIFIED' | 'UNKNOWN' | 'APPLE_APP_STORE' | 'GOOGLE_PLAY' | 'WINDOWS_STORE' | 'WINDOWS_PHONE_STORE' | 'CN_APP_STORE' — The app store the mobile app is available in. - `appId` string — The ID of the mobile app. - `description2` string — The second description line of the ad. - `headline` string — The headline of the ad. - `description1` string — The first description line of the ad. - `name` string — Immutable. The name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad. - `legacyResponsiveDisplayAd` GoogleAdsSearchads360V23CommonLegacyResponsiveDisplayAdInfo — A legacy responsive display ad. Ads of this type are labeled 'Responsive ads' in the Google Ads UI. - `shortHeadline` string — The short version of the ad's headline. - `squareMarketingImage` string — The MediaFile resource name of the square marketing image used in the ad. - `mainColor` string — 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. - `promoText` string — Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. - `allowFlexibleColor` boolean — 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. - `longHeadline` string — The long version of the ad's headline. - `pricePrefix` string — Prefix before price. For example, 'as low as'. - `logoImage` string — The MediaFile resource name of the logo image used in the ad. - `callToActionText` string — The call-to-action text for the ad. - `accentColor` string — 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. - `businessName` string — The business name in the ad. - `description` string — The description of the ad. - `formatSetting` 'UNSPECIFIED' | 'UNKNOWN' | 'ALL_FORMATS' | 'NON_NATIVE' | 'NATIVE' — Specifies which format the ad will be served in. Default is ALL_FORMATS. - `marketingImage` string — The MediaFile resource name of the marketing image used in the ad. - `squareLogoImage` string — The MediaFile resource name of the square logo image used in the ad. - `smartCampaignAd` GoogleAdsSearchads360V23CommonSmartCampaignAdInfo — A Smart campaign ad. - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets, each of which corresponds to a headline when the ad serves. This list consists of a minimum of 3 and up to 15 text assets. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets, each of which corresponds to a description when the ad serves. This list consists of a minimum of 2 and up to 4 text assets. - … - `demandGenCarouselAd` GoogleAdsSearchads360V23CommonDemandGenCarouselAdInfo — A Demand Gen carousel ad. - `logoImage` GoogleAdsSearchads360V23CommonAdImageAsset — An image asset used inside an ad. - … - `carouselCards` GoogleAdsSearchads360V23CommonAdDemandGenCarouselCardAsset[] — Required. Carousel cards that will display with the ad. Min 2 max 10. - … - `businessName` string — Required. The Advertiser/brand name. - `description` GoogleAdsSearchads360V23CommonAdTextAsset — A text asset used inside an ad. - … - `callToActionText` string — Call to action text. - `headline` GoogleAdsSearchads360V23CommonAdTextAsset — A text asset used inside an ad. - … - `finalMobileUrls` string[] — The list of possible final mobile URLs after all cross-domain redirects for the ad. - `devicePreference` 'UNSPECIFIED' | 'UNKNOWN' | 'MOBILE' | 'TABLET' | 'DESKTOP' | 'CONNECTED_TV' | 'OTHER' — The device preference for the ad. You can only specify a preference for mobile devices. When this preference is set the ad will be preferred over other ads when being displayed on a mobile device. The ad can still be displayed on other device types, for example, if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types. - `responsiveDisplayAd` GoogleAdsSearchads360V23CommonResponsiveDisplayAdInfo — A responsive display ad. - `squareLogoImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Square logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). Combined with `logo_images`, the maximum is 5. - … - `formatSetting` 'UNSPECIFIED' | 'UNKNOWN' | 'ALL_FORMATS' | 'NON_NATIVE' | 'NATIVE' — Specifies which format the ad will be served in. Default is ALL_FORMATS. - `logoImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 512x128 and the aspect ratio must be 4:1 (+-1%). Combined with `square_logo_images`, the maximum is 5. - … - `businessName` string — The advertiser/brand name. Maximum display width is 25. - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — Short format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — Descriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified. - … - `callToActionText` string — The call-to-action text for the ad. Maximum display width is 30. - `accentColor` string — 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. - `controlSpec` GoogleAdsSearchads360V23CommonResponsiveDisplayAdControlSpec — Specification for various creative controls for a responsive display ad. - … - `squareMarketingImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Square marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). At least one square `marketing_image` is required. Combined with `marketing_images`, the maximum is 15. - … - `marketingImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — Marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). At least one `marketing_image` is required. Combined with `square_marketing_images`, the maximum is 15. - … - `allowFlexibleColor` boolean — 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. - `longHeadline` GoogleAdsSearchads360V23CommonAdTextAsset — A text asset used inside an ad. - … - `pricePrefix` string — Prefix before price. For example, 'as low as'. - `promoText` string — Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. - `youtubeVideos` GoogleAdsSearchads360V23CommonAdVideoAsset[] — Optional YouTube videos for the ad. A maximum of 5 videos can be specified. - … - `mainColor` string — 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. - `appAd` GoogleAdsSearchads360V23CommonAppAdInfo — An app ad. - `images` GoogleAdsSearchads360V23CommonAdImageAsset[] — List of image assets that may be displayed with the ad. - … - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for headlines. When the ad serves the headlines will be selected from this list. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. - … - `html5MediaBundles` GoogleAdsSearchads360V23CommonAdMediaBundleAsset[] — List of media bundle assets that may be used with the ad. - … - `youtubeVideos` GoogleAdsSearchads360V23CommonAdVideoAsset[] — List of YouTube video assets that may be displayed with the ad. - … - `appDeepLink` GoogleAdsSearchads360V23CommonAdAppDeepLinkAsset — An app deep link used inside an ad. - … - `mandatoryAdText` GoogleAdsSearchads360V23CommonAdTextAsset — A text asset used inside an ad. - … - `finalUrlSuffix` string — The suffix to use when constructing a final URL. - `localAd` GoogleAdsSearchads360V23CommonLocalAdInfo — A local ad. - `callToActions` GoogleAdsSearchads360V23CommonAdTextAsset[] — 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. - … - `marketingImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — 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. - … - `videos` GoogleAdsSearchads360V23CommonAdVideoAsset[] — List of YouTube video assets that may be displayed with the ad. At least 1 and at most 20 video assets must be specified. - … - `logoImages` GoogleAdsSearchads360V23CommonAdImageAsset[] — 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. - … - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — 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. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — 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. - … - `path2` string — 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. - `path1` string — First part of optional text that can be appended to the URL in the ad. - `textAd` GoogleAdsSearchads360V23CommonTextAdInfo — A text ad. - `headline` string — The headline of the ad. - `description1` string — The first line of the ad's description. - `description2` string — The second line of the ad's description. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'TEXT_AD' | 'EXPANDED_TEXT_AD' | 'EXPANDED_DYNAMIC_SEARCH_AD' | 'HOTEL_AD' | 'SHOPPING_SMART_AD' | 'SHOPPING_PRODUCT_AD' | 'VIDEO_AD' | 'IMAGE_AD' | 'RESPONSIVE_SEARCH_AD' | 'LEGACY_RESPONSIVE_DISPLAY_AD' | 'APP_AD' | 'LEGACY_APP_INSTALL_AD' | 'RESPONSIVE_DISPLAY_AD' | 'LOCAL_AD' | 'HTML5_UPLOAD_AD' | 'DYNAMIC_HTML5_AD' | 'APP_ENGAGEMENT_AD' | 'SHOPPING_COMPARISON_LISTING_AD' | 'VIDEO_BUMPER_AD' | 'VIDEO_NON_SKIPPABLE_IN_STREAM_AD' | 'VIDEO_TRUEVIEW_IN_STREAM_AD' | 'VIDEO_RESPONSIVE_AD' | 'SMART_CAMPAIGN_AD' | 'CALL_AD' | 'APP_PRE_REGISTRATION_AD' | 'DEMAND_GEN_MULTI_ASSET_AD' | 'DEMAND_GEN_CAROUSEL_AD' | 'TRAVEL_AD' | 'DEMAND_GEN_VIDEO_RESPONSIVE_AD' | 'DEMAND_GEN_PRODUCT_AD' | 'MULTIMEDIA_AD' — Output only. The type of ad. - `urlCustomParameters` GoogleAdsSearchads360V23CommonCustomParameter[] — The list of mappings that can be used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`. For mutates, use url custom parameter operations. - `key` string — The key matching the parameter tag name. - `value` string — The value to be substituted. - `appEngagementAd` GoogleAdsSearchads360V23CommonAppEngagementAdInfo — App engagement ads allow you to write text encouraging a specific action in the app, like checking in, making a purchase, or booking a flight. They allow you to send users to a specific part of your app where they can find what they're looking for easier and faster. - `videos` GoogleAdsSearchads360V23CommonAdVideoAsset[] — List of video assets that may be displayed with the ad. - … - `images` GoogleAdsSearchads360V23CommonAdImageAsset[] — List of image assets that may be displayed with the ad. - … - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for headlines. When the ad serves the headlines will be selected from this list. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. - … - `searchAds360ResponsiveSearchAd` GoogleAdsSearchads360V23CommonSearchAds360ResponsiveSearchAdInfo — A Search Ads 360 responsive search ad. - `path1` string — Text appended to the auto-generated visible URL with a delimiter. - `path2` string — Text appended to path1 with a delimiter. - `adTrackingId` string, int64 — The tracking id of the ad. - `headlines` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for headlines. When the ad serves the headlines will be selected from this list. - … - `descriptions` GoogleAdsSearchads360V23CommonAdTextAsset[] — List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. - … - `finalUrls` string[] — The list of possible final URLs after all cross-domain redirects for the ad. - `finalAppUrls` GoogleAdsSearchads360V23CommonFinalAppUrl[] — A list of final app URLs that will be used on mobile if the user has the specific app installed. - `osType` 'UNSPECIFIED' | 'UNKNOWN' | 'IOS' | 'ANDROID' — The operating system targeted by this URL. Required. - `url` string — The app deep link URL. Deep links specify a location in an app that corresponds to the content you'd like to show, and should be of the form {scheme}://{host_path} The scheme identifies which app to open. For your app, you can use a custom scheme that starts with the app's name. The host and path specify the unique location in the app where your content exists. Example: "exampleapp://productid_1234". Required. - `searchAds360ExpandedDynamicSearchAd` GoogleAdsSearchads360V23CommonSearchAds360ExpandedDynamicSearchAdInfo — An expanded dynamic search ad. - `description1` string — The first line of the ad's description. - `description2` string — The second line of the ad's description. - `adTrackingId` string, int64 — The tracking id of the ad. - `creationTime` string — Output only. The timestamp when this ad_group_ad was created. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format. - `labels` string[] — Output only. The resource names of labels attached to this ad group ad. - `actionItems` string[] — Output only. A list of recommendations to improve the ad strength. For example, a recommendation could be "Try adding a few more unique headlines or unpinning some assets.". - `adGroupBidModifierOperation` GoogleAdsSearchads360V23ServicesAdGroupBidModifierOperation — A single operation (create, remove, update) on an ad group bid modifier. - `remove` string — Remove operation: A resource name for the removed ad group bid modifier is expected, in this format: `customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}` - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `create` GoogleAdsSearchads360V23ResourcesAdGroupBidModifier — Represents an ad group bid modifier. - `hotelCheckInDateRange` GoogleAdsSearchads360V23CommonHotelCheckInDateRangeInfo — Criterion for a check-in date range. - `startDate` string — Start date in the YYYY-MM-DD format. - `endDate` string — End date in the YYYY-MM-DD format. - `criterionId` string, int64 — Output only. The ID of the criterion to bid modify. This field is ignored for mutates. - `hotelAdvanceBookingWindow` GoogleAdsSearchads360V23CommonHotelAdvanceBookingWindowInfo — Criterion for number of days prior to the stay the booking is being made. - `minDays` string, int64 — Low end of the number of days prior to the stay. - `maxDays` string, int64 — High end of the number of days prior to the stay. - `device` GoogleAdsSearchads360V23CommonDeviceInfo — A device criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MOBILE' | 'TABLET' | 'DESKTOP' | 'CONNECTED_TV' | 'OTHER' — Type of the device. - `baseAdGroup` string — Output only. The base ad group from which this draft/trial adgroup bid modifier was created. If ad_group is a base ad group then this field will be equal to ad_group. If the ad group was created in the draft or trial and has no corresponding base ad group, then this field will be null. This field is readonly. - `bidModifierSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN' | 'AD_GROUP' — Output only. Bid modifier source. - `hotelLengthOfStay` GoogleAdsSearchads360V23CommonHotelLengthOfStayInfo — Criterion for length of hotel stay in nights. - `minNights` string, int64 — Low end of the number of nights in the stay. - `maxNights` string, int64 — High end of the number of nights in the stay. - `resourceName` string — Immutable. The resource name of the ad group bid modifier. Ad group bid modifier resource names have the form: `customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}` - `hotelDateSelectionType` GoogleAdsSearchads360V23CommonHotelDateSelectionTypeInfo — Criterion for hotel date selection (default dates versus user selected). - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'DEFAULT_SELECTION' | 'USER_SELECTED' — Type of the hotel date selection - `hotelCheckInDay` GoogleAdsSearchads360V23CommonHotelCheckInDayInfo — Criterion for day of the week the booking is for. - `dayOfWeek` 'UNSPECIFIED' | 'UNKNOWN' | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY' — The day of the week. - `adGroup` string — Immutable. The ad group to which this criterion belongs. - `bidModifier` number, double — The modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Use 0 to opt out of a Device type. - `update` GoogleAdsSearchads360V23ResourcesAdGroupBidModifier — Represents an ad group bid modifier. - `hotelCheckInDateRange` GoogleAdsSearchads360V23CommonHotelCheckInDateRangeInfo — Criterion for a check-in date range. - `startDate` string — Start date in the YYYY-MM-DD format. - `endDate` string — End date in the YYYY-MM-DD format. - `criterionId` string, int64 — Output only. The ID of the criterion to bid modify. This field is ignored for mutates. - `hotelAdvanceBookingWindow` GoogleAdsSearchads360V23CommonHotelAdvanceBookingWindowInfo — Criterion for number of days prior to the stay the booking is being made. - `minDays` string, int64 — Low end of the number of days prior to the stay. - `maxDays` string, int64 — High end of the number of days prior to the stay. - `device` GoogleAdsSearchads360V23CommonDeviceInfo — A device criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MOBILE' | 'TABLET' | 'DESKTOP' | 'CONNECTED_TV' | 'OTHER' — Type of the device. - `baseAdGroup` string — Output only. The base ad group from which this draft/trial adgroup bid modifier was created. If ad_group is a base ad group then this field will be equal to ad_group. If the ad group was created in the draft or trial and has no corresponding base ad group, then this field will be null. This field is readonly. - `bidModifierSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN' | 'AD_GROUP' — Output only. Bid modifier source. - `hotelLengthOfStay` GoogleAdsSearchads360V23CommonHotelLengthOfStayInfo — Criterion for length of hotel stay in nights. - `minNights` string, int64 — Low end of the number of nights in the stay. - `maxNights` string, int64 — High end of the number of nights in the stay. - `resourceName` string — Immutable. The resource name of the ad group bid modifier. Ad group bid modifier resource names have the form: `customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}` - `hotelDateSelectionType` GoogleAdsSearchads360V23CommonHotelDateSelectionTypeInfo — Criterion for hotel date selection (default dates versus user selected). - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'DEFAULT_SELECTION' | 'USER_SELECTED' — Type of the hotel date selection - `hotelCheckInDay` GoogleAdsSearchads360V23CommonHotelCheckInDayInfo — Criterion for day of the week the booking is for. - `dayOfWeek` 'UNSPECIFIED' | 'UNKNOWN' | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY' — The day of the week. - `adGroup` string — Immutable. The ad group to which this criterion belongs. - `bidModifier` number, double — The modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Use 0 to opt out of a Device type. - `adGroupCriterionOperation` GoogleAdsSearchads360V23ServicesAdGroupCriterionOperation — A single operation (create, remove, update) on an ad group criterion. - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `create` GoogleAdsSearchads360V23ResourcesAdGroupCriterion — An ad group criterion. The ad_group_criterion report only returns criteria that were explicitly added to the ad group. - `verticalAdsItemGroupRuleList` GoogleAdsSearchads360V23CommonVerticalAdsItemGroupRuleListInfo — A criterion for targeting a shared set of rules for item groups in Vertical Ads (e.g., for hotel ads). - `sharedSet` string — The shared set resource name of the vertical ads item group rule list. - `finalMobileUrls` string[] — The list of possible final mobile URLs after all cross-domain redirects. - `youtubeVideo` GoogleAdsSearchads360V23CommonYouTubeVideoInfo — A YouTube Video criterion. - `videoId` string — YouTube video id as it appears on the YouTube watch page. - `cpcBidMicros` string, int64 — The CPC (cost-per-click) bid. - `effectiveCpmBidMicros` string, int64 — Output only. The effective CPM (cost-per-thousand viewable impressions) bid. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'KEYWORD' | 'PLACEMENT' | 'MOBILE_APP_CATEGORY' | 'MOBILE_APPLICATION' | 'DEVICE' | 'LOCATION' | 'LISTING_GROUP' | 'AD_SCHEDULE' | 'AGE_RANGE' | 'GENDER' | 'INCOME_RANGE' | 'PARENTAL_STATUS' | 'YOUTUBE_VIDEO' | 'YOUTUBE_CHANNEL' | 'USER_LIST' | 'PROXIMITY' | 'TOPIC' | 'LISTING_SCOPE' | 'LANGUAGE' | 'IP_BLOCK' | 'CONTENT_LABEL' | 'CARRIER' | 'USER_INTEREST' | 'WEBPAGE' | 'OPERATING_SYSTEM_VERSION' | 'APP_PAYMENT_MODEL' | 'MOBILE_DEVICE' | 'CUSTOM_AFFINITY' | 'CUSTOM_INTENT' | 'LOCATION_GROUP' | 'CUSTOM_AUDIENCE' | 'COMBINED_AUDIENCE' | 'KEYWORD_THEME' | 'AUDIENCE' | 'NEGATIVE_KEYWORD_LIST' | 'LOCAL_SERVICE_ID' | 'SEARCH_THEME' | 'BRAND' | 'BRAND_LIST' | 'LIFE_EVENT' | 'WEBPAGE_LIST' | 'VIDEO_LINEUP' | 'PLACEMENT_LIST' | 'VERTICAL_ADS_ITEM_GROUP_RULE_LIST' | 'VERTICAL_ADS_ITEM_GROUP_RULE' — Output only. The type of the criterion. - `appPaymentModel` GoogleAdsSearchads360V23CommonAppPaymentModelInfo — An app payment model criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'PAID' — Type of the app payment model. - `webpage` GoogleAdsSearchads360V23CommonWebpageInfo — Represents a criterion for targeting webpages of an advertiser's website. - `criterionName` string — The name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters. This field is required for CREATE operations and is prohibited on UPDATE operations. - `coveragePercentage` number, double — Website criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage. This field is read-only. - `sample` GoogleAdsSearchads360V23CommonWebpageSampleInfo — List of sample urls that match the website target - `sampleUrls` string[] — Webpage sample urls - `conditions` GoogleAdsSearchads360V23CommonWebpageConditionInfo[] — Conditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations. - `operator` 'UNSPECIFIED' | 'UNKNOWN' | 'EQUALS' | 'CONTAINS' — Operator of webpage targeting condition. - `argument` string — Argument of webpage targeting condition. - `operand` 'UNSPECIFIED' | 'UNKNOWN' | 'URL' | 'CATEGORY' | 'PAGE_TITLE' | 'PAGE_CONTENT' | 'CUSTOM_LABEL' — Operand of webpage targeting condition. - `language` GoogleAdsSearchads360V23CommonLanguageInfo — A language criterion. - `languageConstant` string — The language constant resource name. - `effectiveCpvBidSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective CPV bid. - `engineId` string — Output only. ID of the ad group criterion in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "ad_group_criterion.criterion_id" instead. - `placement` GoogleAdsSearchads360V23CommonPlacementInfo — A placement criterion. This can be used to modify bids for sites when targeting the content network. - `url` string — URL of the placement. For example, "http://www.domain.com". - `customAudience` GoogleAdsSearchads360V23CommonCustomAudienceInfo — A custom audience criterion. - `customAudience` string — The CustomAudience resource name. - `finalUrls` string[] — The list of possible final URLs after all cross-domain redirects for the ad. - `qualityInfo` GoogleAdsSearchads360V23ResourcesAdGroupCriterionQualityInfo — A container for ad group criterion quality information. - `creativeQualityScore` 'UNSPECIFIED' | 'UNKNOWN' | 'BELOW_AVERAGE' | 'AVERAGE' | 'ABOVE_AVERAGE' — Output only. The performance of the ad compared to other advertisers. - `qualityScore` integer — Output only. The quality score. This field may not be populated if Google does not have enough information to determine a value. - `postClickQualityScore` 'UNSPECIFIED' | 'UNKNOWN' | 'BELOW_AVERAGE' | 'AVERAGE' | 'ABOVE_AVERAGE' — Output only. The quality score of the landing page. - `searchPredictedCtr` 'UNSPECIFIED' | 'UNKNOWN' | 'BELOW_AVERAGE' | 'AVERAGE' | 'ABOVE_AVERAGE' — Output only. The click-through rate compared to that of other advertisers. - `keyword` GoogleAdsSearchads360V23CommonKeywordInfo — A keyword criterion. - `text` string — The text of the keyword (at most 80 characters and 10 words). - `matchType` 'UNSPECIFIED' | 'UNKNOWN' | 'EXACT' | 'PHRASE' | 'BROAD' — The match type of the keyword. - `audience` GoogleAdsSearchads360V23CommonAudienceInfo — An audience criterion. - `audience` string — The Audience resource name. - `disapprovalReasons` string[] — Output only. List of disapproval reasons of the criterion. The different reasons for disapproving a criterion can be found here: https://support.google.com/adspolicy/answer/6008942 This field is read-only. - `effectiveCpcBidSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective CPC bid. - `displayName` string — Output only. The display name of the criterion. - `effectiveLabels` string[] — Output only. The resource names of effective labels attached to this ad group criterion. An effective label is a label inherited or directly assigned to this ad group criterion. - `extendedDemographic` GoogleAdsSearchads360V23CommonExtendedDemographicInfo — Represents an extended demographic criterion. - `extendedDemographicId` string, int64 — Taxonomy id of the extended demographic group. - `positionEstimates` GoogleAdsSearchads360V23ResourcesAdGroupCriterionPositionEstimates — Estimates for criterion bids at various positions. - `estimatedAddClicksAtFirstPositionCpc` string, int64 — Output only. Estimate of how many clicks per week you might get by changing your keyword bid to the value in first_position_cpc_micros. - `firstPageCpcMicros` string, int64 — Output only. The estimate of the CPC bid required for ad to be shown on first page of search results. - `topOfPageCpcMicros` string, int64 — Output only. The estimate of the CPC bid required for ad to be displayed at the top of the first page of search results. - `firstPositionCpcMicros` string, int64 — Output only. The estimate of the CPC bid required for ad to be displayed in first position, at the top of the first page of search results. - `estimatedAddCostAtFirstPositionCpc` string, int64 — Output only. Estimate of how your cost per week might change when changing your keyword bid to the value in first_position_cpc_micros. - `adGroup` string — Immutable. The ad group to which the criterion belongs. - `mobileApplication` GoogleAdsSearchads360V23CommonMobileApplicationInfo — A mobile application criterion. - `appId` string — A string that uniquely identifies a mobile application to Google Ads API. The format of this string is "{platform}-{platform_native_id}", where platform is "1" for iOS apps and "2" for Android apps, and where platform_native_id is the mobile application identifier native to the corresponding platform. For iOS, this native identifier is the 9 digit string that appears at the end of an App Store URL (for example, "476943146" for "Flood-It! 2" whose App Store link is "http://itunes.apple.com/us/app/flood-it!-2/id476943146"). For Android, this native identifier is the application's package name (for example, "com.labpixies.colordrips" for "Color Drips" given Google Play link "https://play.google.com/store/apps/details?id=com.labpixies.colordrips"). A well formed app id for Google Ads API would thus be "1-476943146" for iOS and "2-com.labpixies.colordrips" for Android. This field is required and must be set in CREATE operations. - `name` string — Name of this mobile application. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'PAUSED' | 'REMOVED' — The status of the criterion. This is the status of the ad group criterion entity, set by the client. Note: UI reports may incorporate additional information that affects whether a criterion is eligible to run. In some cases a criterion that's REMOVED in the API can still show as enabled in the UI. For example, campaigns by default show to users of all age ranges unless excluded. The UI will show each age range as "enabled", since they're eligible to see the ads; but AdGroupCriterion.status will show "removed", since no positive criterion was added. - `trackingUrlTemplate` string — The URL template for constructing a tracking URL. - `approvalStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'APPROVED' | 'DISAPPROVED' | 'PENDING_REVIEW' | 'UNDER_REVIEW' — Output only. Approval status of the criterion. - `engineStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'AD_GROUP_CRITERION_ELIGIBLE' | 'AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN' | 'AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH' | 'AD_GROUP_CRITERION_INVALID_PC_SEARCH' | 'AD_GROUP_CRITERION_INVALID_SEARCH' | 'AD_GROUP_CRITERION_LOW_SEARCH_VOLUME' | 'AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW' | 'AD_GROUP_CRITERION_PARTIALLY_INVALID' | 'AD_GROUP_CRITERION_TO_BE_ACTIVATED' | 'AD_GROUP_CRITERION_UNDER_REVIEW' | 'AD_GROUP_CRITERION_NOT_REVIEWED' | 'AD_GROUP_CRITERION_ON_HOLD' | 'AD_GROUP_CRITERION_PENDING_REVIEW' | 'AD_GROUP_CRITERION_PAUSED' | 'AD_GROUP_CRITERION_REMOVED' | 'AD_GROUP_CRITERION_APPROVED' | 'AD_GROUP_CRITERION_DISAPPROVED' | 'AD_GROUP_CRITERION_SERVING' | 'AD_GROUP_CRITERION_ACCOUNT_PAUSED' — Output only. The Engine Status for ad group criterion. - `primaryStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'ELIGIBLE' | 'PAUSED' | 'REMOVED' | 'PENDING' | 'NOT_ELIGIBLE' — Output only. The primary status for the ad group criterion. - `ageRange` GoogleAdsSearchads360V23CommonAgeRangeInfo — An age range criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'AGE_RANGE_18_24' | 'AGE_RANGE_25_34' | 'AGE_RANGE_35_44' | 'AGE_RANGE_45_54' | 'AGE_RANGE_55_64' | 'AGE_RANGE_65_UP' | 'AGE_RANGE_UNDETERMINED' — Type of the age range. - `criterionId` string, int64 — Output only. The ID of the criterion. - `parentalStatus` GoogleAdsSearchads360V23CommonParentalStatusInfo — A parental status criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'PARENT' | 'NOT_A_PARENT' | 'UNDETERMINED' — Type of the parental status. - `userInterest` GoogleAdsSearchads360V23CommonUserInterestInfo — Represents a particular interest-based topic to be targeted. - `userInterestCategory` string — The UserInterest resource name. - `effectivePercentCpcBidMicros` string, int64 — Output only. The effective Percent CPC bid amount. - `mobileAppCategory` GoogleAdsSearchads360V23CommonMobileAppCategoryInfo — A mobile app category criterion. - `mobileAppCategoryConstant` string — The mobile app category constant resource name. - `userList` GoogleAdsSearchads360V23CommonUserListInfo — A User List criterion. Represents a user list that is defined by the advertiser to be targeted. - `userList` string — The User List resource name. - `youtubeChannel` GoogleAdsSearchads360V23CommonYouTubeChannelInfo — A YouTube Channel criterion. - `channelId` string — The YouTube uploader channel id or the channel code of a YouTube channel. - `cpmBidMicros` string, int64 — The CPM (cost-per-thousand viewable impressions) bid. - `location` GoogleAdsSearchads360V23CommonLocationInfo — A location criterion. - `geoTargetConstant` string — The geo target constant resource name. - `effectiveCpmBidSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective CPM bid. - `systemServingStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'ELIGIBLE' | 'RARELY_SERVED' — Output only. Serving status of the criterion. - `lifeEvent` GoogleAdsSearchads360V23CommonLifeEventInfo — Represents a life event criterion. - `lifeEventId` string, int64 — Taxonomy id of the life event. - `finalUrlSuffix` string — URL template for appending params to final URL. - `listingGroup` GoogleAdsSearchads360V23CommonListingGroupInfo — A listing group criterion. - `parentAdGroupCriterion` string — Resource name of ad group criterion which is the parent listing group subdivision. Null for the root group. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'SUBDIVISION' | 'UNIT' — Type of the listing group. - `path` GoogleAdsSearchads360V23CommonListingDimensionPath — The path of dimensions defining a listing group. - `dimensions` GoogleAdsSearchads360V23CommonListingDimensionInfo[] — The complete path of dimensions through the listing group hierarchy, from the root (excluding the root itself) to this listing group. - … - `caseValue` GoogleAdsSearchads360V23CommonListingDimensionInfo — Listing dimensions for listing group criterion. - `productGrouping` GoogleAdsSearchads360V23CommonProductGroupingInfo — Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. - … - `activityId` GoogleAdsSearchads360V23CommonActivityIdInfo — Advertiser-specific activity ID. - … - `productCategory` GoogleAdsSearchads360V23CommonProductCategoryInfo — Category of a product offer. - … - `activityState` GoogleAdsSearchads360V23CommonActivityStateInfo — The state where the travel activity is available. - … - `hotelClass` GoogleAdsSearchads360V23CommonHotelClassInfo — Class of the hotel as a number of stars 1 to 5. - … - `productLegacyCondition` GoogleAdsSearchads360V23CommonProductLegacyConditionInfo — Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. - … - `hotelId` GoogleAdsSearchads360V23CommonHotelIdInfo — Advertiser-specific hotel ID. - … - `hotelCity` GoogleAdsSearchads360V23CommonHotelCityInfo — City the hotel is located in. - … - `productCustomAttribute` GoogleAdsSearchads360V23CommonProductCustomAttributeInfo — Custom attribute of a product offer. - … - `unknownListingDimension` GoogleAdsSearchads360V23CommonUnknownListingDimensionInfo — Unknown listing dimension. - `productChannelExclusivity` GoogleAdsSearchads360V23CommonProductChannelExclusivityInfo — Availability of a product offer. - … - `productItemId` GoogleAdsSearchads360V23CommonProductItemIdInfo — Item id of a product offer. - … - `hotelCountryRegion` GoogleAdsSearchads360V23CommonHotelCountryRegionInfo — Country or Region the hotel is located in. - … - `productLabels` GoogleAdsSearchads360V23CommonProductLabelsInfo — Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. - … - `productTypeFull` GoogleAdsSearchads360V23CommonProductTypeFullInfo — Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. - … - `activityCity` GoogleAdsSearchads360V23CommonActivityCityInfo — The city where the travel activity is available. - … - `productChannel` GoogleAdsSearchads360V23CommonProductChannelInfo — Locality of a product offer. - … - `activityCountry` GoogleAdsSearchads360V23CommonActivityCountryInfo — The country where the travel activity is available. - … - `productType` GoogleAdsSearchads360V23CommonProductTypeInfo — Type of a product offer. - … - `activityRating` GoogleAdsSearchads360V23CommonActivityRatingInfo — Rating of the activity as a number 1 to 5, where 5 is the best. - … - `productCondition` GoogleAdsSearchads360V23CommonProductConditionInfo — Condition of a product offer. - … - `hotelState` GoogleAdsSearchads360V23CommonHotelStateInfo — State the hotel is located in. - … - `productBrand` GoogleAdsSearchads360V23CommonProductBrandInfo — Brand of the product. - … - `effectiveCpvBidMicros` string, int64 — Output only. The effective CPV (cost-per-view) bid. - `brandList` GoogleAdsSearchads360V23CommonBrandListInfo — A Brand List Criterion is used to specify a list of brands. The list is represented as a SharedSet id type BRAND_HINT. A criterion of this type can be either targeted or excluded. - `sharedSet` string — Shared set resource name of the brand list. - `urlCustomParameters` GoogleAdsSearchads360V23CommonCustomParameter[] — The list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`. - `key` string — The key matching the parameter tag name. - `value` string — The value to be substituted. - `negative` boolean — Immutable. Whether to target (`false`) or exclude (`true`) the criterion. This field is immutable. To switch a criterion from positive to negative, remove then re-add it. - `labels` string[] — Output only. The resource names of labels attached to this ad group criterion. - `effectiveCpcBidMicros` string, int64 — Output only. The effective CPC (cost-per-click) bid. - `creationTime` string — Output only. The timestamp when this ad group criterion was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. - `effectivePercentCpcBidSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective Percent CPC bid. - `combinedAudience` GoogleAdsSearchads360V23CommonCombinedAudienceInfo — A combined audience criterion. - `combinedAudience` string — The CombinedAudience resource name. - `resourceName` string — Immutable. The resource name of the ad group criterion. Ad group criterion resource names have the form: `customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}` - `customIntent` GoogleAdsSearchads360V23CommonCustomIntentInfo — A custom intent criterion. A criterion of this type is only targetable. - `customIntent` string — The CustomInterest resource name. - `gender` GoogleAdsSearchads360V23CommonGenderInfo — A gender criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MALE' | 'FEMALE' | 'UNDETERMINED' — Type of the gender. - `cpvBidMicros` string, int64 — The CPV (cost-per-view) bid. - `videoLineup` GoogleAdsSearchads360V23CommonVideoLineupInfo — A Video lineup criterion. - `videoLineupId` string, int64 — ID for a Video lineup. Contact your Google business development representative for details. - `customAffinity` GoogleAdsSearchads360V23CommonCustomAffinityInfo — A custom affinity criterion. A criterion of this type is only targetable. - `customAffinity` string — The CustomInterest resource name. - `topic` GoogleAdsSearchads360V23CommonTopicInfo — A topic criterion. Use topics to target or exclude placements in the Google Display Network based on the category into which the placement falls (for example, "Pets & Animals/Pets/Dogs"). - `topicConstant` string — The Topic Constant resource name. - `path` string[] — The category to target or exclude. Each subsequent element in the array describes a more specific sub-category. For example, "Pets & Animals", "Pets", "Dogs" represents the "Pets & Animals/Pets/Dogs" category. - `lastModifiedTime` string — Output only. The datetime when this ad group criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format. - `primaryStatusReasons` string[] — Output only. The primary status reasons for the ad group criterion. - `incomeRange` GoogleAdsSearchads360V23CommonIncomeRangeInfo — An income range criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'INCOME_RANGE_0_50' | 'INCOME_RANGE_50_60' | 'INCOME_RANGE_60_70' | 'INCOME_RANGE_70_80' | 'INCOME_RANGE_80_90' | 'INCOME_RANGE_90_UP' | 'INCOME_RANGE_UNDETERMINED' — Type of the income range. - `percentCpcBidMicros` string, int64 — The CPC bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0,1) and the value stored here is 1,000,000 * [fraction]. - `bidModifier` number, double — The modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. - `update` GoogleAdsSearchads360V23ResourcesAdGroupCriterion — An ad group criterion. The ad_group_criterion report only returns criteria that were explicitly added to the ad group. - `verticalAdsItemGroupRuleList` GoogleAdsSearchads360V23CommonVerticalAdsItemGroupRuleListInfo — A criterion for targeting a shared set of rules for item groups in Vertical Ads (e.g., for hotel ads). - `sharedSet` string — The shared set resource name of the vertical ads item group rule list. - `finalMobileUrls` string[] — The list of possible final mobile URLs after all cross-domain redirects. - `youtubeVideo` GoogleAdsSearchads360V23CommonYouTubeVideoInfo — A YouTube Video criterion. - `videoId` string — YouTube video id as it appears on the YouTube watch page. - `cpcBidMicros` string, int64 — The CPC (cost-per-click) bid. - `effectiveCpmBidMicros` string, int64 — Output only. The effective CPM (cost-per-thousand viewable impressions) bid. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'KEYWORD' | 'PLACEMENT' | 'MOBILE_APP_CATEGORY' | 'MOBILE_APPLICATION' | 'DEVICE' | 'LOCATION' | 'LISTING_GROUP' | 'AD_SCHEDULE' | 'AGE_RANGE' | 'GENDER' | 'INCOME_RANGE' | 'PARENTAL_STATUS' | 'YOUTUBE_VIDEO' | 'YOUTUBE_CHANNEL' | 'USER_LIST' | 'PROXIMITY' | 'TOPIC' | 'LISTING_SCOPE' | 'LANGUAGE' | 'IP_BLOCK' | 'CONTENT_LABEL' | 'CARRIER' | 'USER_INTEREST' | 'WEBPAGE' | 'OPERATING_SYSTEM_VERSION' | 'APP_PAYMENT_MODEL' | 'MOBILE_DEVICE' | 'CUSTOM_AFFINITY' | 'CUSTOM_INTENT' | 'LOCATION_GROUP' | 'CUSTOM_AUDIENCE' | 'COMBINED_AUDIENCE' | 'KEYWORD_THEME' | 'AUDIENCE' | 'NEGATIVE_KEYWORD_LIST' | 'LOCAL_SERVICE_ID' | 'SEARCH_THEME' | 'BRAND' | 'BRAND_LIST' | 'LIFE_EVENT' | 'WEBPAGE_LIST' | 'VIDEO_LINEUP' | 'PLACEMENT_LIST' | 'VERTICAL_ADS_ITEM_GROUP_RULE_LIST' | 'VERTICAL_ADS_ITEM_GROUP_RULE' — Output only. The type of the criterion. - `appPaymentModel` GoogleAdsSearchads360V23CommonAppPaymentModelInfo — An app payment model criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'PAID' — Type of the app payment model. - `webpage` GoogleAdsSearchads360V23CommonWebpageInfo — Represents a criterion for targeting webpages of an advertiser's website. - `criterionName` string — The name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters. This field is required for CREATE operations and is prohibited on UPDATE operations. - `coveragePercentage` number, double — Website criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage. This field is read-only. - `sample` GoogleAdsSearchads360V23CommonWebpageSampleInfo — List of sample urls that match the website target - `sampleUrls` string[] — Webpage sample urls - `conditions` GoogleAdsSearchads360V23CommonWebpageConditionInfo[] — Conditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations. - `operator` 'UNSPECIFIED' | 'UNKNOWN' | 'EQUALS' | 'CONTAINS' — Operator of webpage targeting condition. - `argument` string — Argument of webpage targeting condition. - `operand` 'UNSPECIFIED' | 'UNKNOWN' | 'URL' | 'CATEGORY' | 'PAGE_TITLE' | 'PAGE_CONTENT' | 'CUSTOM_LABEL' — Operand of webpage targeting condition. - `language` GoogleAdsSearchads360V23CommonLanguageInfo — A language criterion. - `languageConstant` string — The language constant resource name. - `effectiveCpvBidSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective CPV bid. - `engineId` string — Output only. ID of the ad group criterion in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "ad_group_criterion.criterion_id" instead. - `placement` GoogleAdsSearchads360V23CommonPlacementInfo — A placement criterion. This can be used to modify bids for sites when targeting the content network. - `url` string — URL of the placement. For example, "http://www.domain.com". - `customAudience` GoogleAdsSearchads360V23CommonCustomAudienceInfo — A custom audience criterion. - `customAudience` string — The CustomAudience resource name. - `finalUrls` string[] — The list of possible final URLs after all cross-domain redirects for the ad. - `qualityInfo` GoogleAdsSearchads360V23ResourcesAdGroupCriterionQualityInfo — A container for ad group criterion quality information. - `creativeQualityScore` 'UNSPECIFIED' | 'UNKNOWN' | 'BELOW_AVERAGE' | 'AVERAGE' | 'ABOVE_AVERAGE' — Output only. The performance of the ad compared to other advertisers. - `qualityScore` integer — Output only. The quality score. This field may not be populated if Google does not have enough information to determine a value. - `postClickQualityScore` 'UNSPECIFIED' | 'UNKNOWN' | 'BELOW_AVERAGE' | 'AVERAGE' | 'ABOVE_AVERAGE' — Output only. The quality score of the landing page. - `searchPredictedCtr` 'UNSPECIFIED' | 'UNKNOWN' | 'BELOW_AVERAGE' | 'AVERAGE' | 'ABOVE_AVERAGE' — Output only. The click-through rate compared to that of other advertisers. - `keyword` GoogleAdsSearchads360V23CommonKeywordInfo — A keyword criterion. - `text` string — The text of the keyword (at most 80 characters and 10 words). - `matchType` 'UNSPECIFIED' | 'UNKNOWN' | 'EXACT' | 'PHRASE' | 'BROAD' — The match type of the keyword. - `audience` GoogleAdsSearchads360V23CommonAudienceInfo — An audience criterion. - `audience` string — The Audience resource name. - `disapprovalReasons` string[] — Output only. List of disapproval reasons of the criterion. The different reasons for disapproving a criterion can be found here: https://support.google.com/adspolicy/answer/6008942 This field is read-only. - `effectiveCpcBidSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective CPC bid. - `displayName` string — Output only. The display name of the criterion. - `effectiveLabels` string[] — Output only. The resource names of effective labels attached to this ad group criterion. An effective label is a label inherited or directly assigned to this ad group criterion. - `extendedDemographic` GoogleAdsSearchads360V23CommonExtendedDemographicInfo — Represents an extended demographic criterion. - `extendedDemographicId` string, int64 — Taxonomy id of the extended demographic group. - `positionEstimates` GoogleAdsSearchads360V23ResourcesAdGroupCriterionPositionEstimates — Estimates for criterion bids at various positions. - `estimatedAddClicksAtFirstPositionCpc` string, int64 — Output only. Estimate of how many clicks per week you might get by changing your keyword bid to the value in first_position_cpc_micros. - `firstPageCpcMicros` string, int64 — Output only. The estimate of the CPC bid required for ad to be shown on first page of search results. - `topOfPageCpcMicros` string, int64 — Output only. The estimate of the CPC bid required for ad to be displayed at the top of the first page of search results. - `firstPositionCpcMicros` string, int64 — Output only. The estimate of the CPC bid required for ad to be displayed in first position, at the top of the first page of search results. - `estimatedAddCostAtFirstPositionCpc` string, int64 — Output only. Estimate of how your cost per week might change when changing your keyword bid to the value in first_position_cpc_micros. - `adGroup` string — Immutable. The ad group to which the criterion belongs. - `mobileApplication` GoogleAdsSearchads360V23CommonMobileApplicationInfo — A mobile application criterion. - `appId` string — A string that uniquely identifies a mobile application to Google Ads API. The format of this string is "{platform}-{platform_native_id}", where platform is "1" for iOS apps and "2" for Android apps, and where platform_native_id is the mobile application identifier native to the corresponding platform. For iOS, this native identifier is the 9 digit string that appears at the end of an App Store URL (for example, "476943146" for "Flood-It! 2" whose App Store link is "http://itunes.apple.com/us/app/flood-it!-2/id476943146"). For Android, this native identifier is the application's package name (for example, "com.labpixies.colordrips" for "Color Drips" given Google Play link "https://play.google.com/store/apps/details?id=com.labpixies.colordrips"). A well formed app id for Google Ads API would thus be "1-476943146" for iOS and "2-com.labpixies.colordrips" for Android. This field is required and must be set in CREATE operations. - `name` string — Name of this mobile application. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'PAUSED' | 'REMOVED' — The status of the criterion. This is the status of the ad group criterion entity, set by the client. Note: UI reports may incorporate additional information that affects whether a criterion is eligible to run. In some cases a criterion that's REMOVED in the API can still show as enabled in the UI. For example, campaigns by default show to users of all age ranges unless excluded. The UI will show each age range as "enabled", since they're eligible to see the ads; but AdGroupCriterion.status will show "removed", since no positive criterion was added. - `trackingUrlTemplate` string — The URL template for constructing a tracking URL. - `approvalStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'APPROVED' | 'DISAPPROVED' | 'PENDING_REVIEW' | 'UNDER_REVIEW' — Output only. Approval status of the criterion. - `engineStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'AD_GROUP_CRITERION_ELIGIBLE' | 'AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN' | 'AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH' | 'AD_GROUP_CRITERION_INVALID_PC_SEARCH' | 'AD_GROUP_CRITERION_INVALID_SEARCH' | 'AD_GROUP_CRITERION_LOW_SEARCH_VOLUME' | 'AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW' | 'AD_GROUP_CRITERION_PARTIALLY_INVALID' | 'AD_GROUP_CRITERION_TO_BE_ACTIVATED' | 'AD_GROUP_CRITERION_UNDER_REVIEW' | 'AD_GROUP_CRITERION_NOT_REVIEWED' | 'AD_GROUP_CRITERION_ON_HOLD' | 'AD_GROUP_CRITERION_PENDING_REVIEW' | 'AD_GROUP_CRITERION_PAUSED' | 'AD_GROUP_CRITERION_REMOVED' | 'AD_GROUP_CRITERION_APPROVED' | 'AD_GROUP_CRITERION_DISAPPROVED' | 'AD_GROUP_CRITERION_SERVING' | 'AD_GROUP_CRITERION_ACCOUNT_PAUSED' — Output only. The Engine Status for ad group criterion. - `primaryStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'ELIGIBLE' | 'PAUSED' | 'REMOVED' | 'PENDING' | 'NOT_ELIGIBLE' — Output only. The primary status for the ad group criterion. - `ageRange` GoogleAdsSearchads360V23CommonAgeRangeInfo — An age range criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'AGE_RANGE_18_24' | 'AGE_RANGE_25_34' | 'AGE_RANGE_35_44' | 'AGE_RANGE_45_54' | 'AGE_RANGE_55_64' | 'AGE_RANGE_65_UP' | 'AGE_RANGE_UNDETERMINED' — Type of the age range. - `criterionId` string, int64 — Output only. The ID of the criterion. - `parentalStatus` GoogleAdsSearchads360V23CommonParentalStatusInfo — A parental status criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'PARENT' | 'NOT_A_PARENT' | 'UNDETERMINED' — Type of the parental status. - `userInterest` GoogleAdsSearchads360V23CommonUserInterestInfo — Represents a particular interest-based topic to be targeted. - `userInterestCategory` string — The UserInterest resource name. - `effectivePercentCpcBidMicros` string, int64 — Output only. The effective Percent CPC bid amount. - `mobileAppCategory` GoogleAdsSearchads360V23CommonMobileAppCategoryInfo — A mobile app category criterion. - `mobileAppCategoryConstant` string — The mobile app category constant resource name. - `userList` GoogleAdsSearchads360V23CommonUserListInfo — A User List criterion. Represents a user list that is defined by the advertiser to be targeted. - `userList` string — The User List resource name. - `youtubeChannel` GoogleAdsSearchads360V23CommonYouTubeChannelInfo — A YouTube Channel criterion. - `channelId` string — The YouTube uploader channel id or the channel code of a YouTube channel. - `cpmBidMicros` string, int64 — The CPM (cost-per-thousand viewable impressions) bid. - `location` GoogleAdsSearchads360V23CommonLocationInfo — A location criterion. - `geoTargetConstant` string — The geo target constant resource name. - `effectiveCpmBidSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective CPM bid. - `systemServingStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'ELIGIBLE' | 'RARELY_SERVED' — Output only. Serving status of the criterion. - `lifeEvent` GoogleAdsSearchads360V23CommonLifeEventInfo — Represents a life event criterion. - `lifeEventId` string, int64 — Taxonomy id of the life event. - `finalUrlSuffix` string — URL template for appending params to final URL. - `listingGroup` GoogleAdsSearchads360V23CommonListingGroupInfo — A listing group criterion. - `parentAdGroupCriterion` string — Resource name of ad group criterion which is the parent listing group subdivision. Null for the root group. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'SUBDIVISION' | 'UNIT' — Type of the listing group. - `path` GoogleAdsSearchads360V23CommonListingDimensionPath — The path of dimensions defining a listing group. - `dimensions` GoogleAdsSearchads360V23CommonListingDimensionInfo[] — The complete path of dimensions through the listing group hierarchy, from the root (excluding the root itself) to this listing group. - … - `caseValue` GoogleAdsSearchads360V23CommonListingDimensionInfo — Listing dimensions for listing group criterion. - `productGrouping` GoogleAdsSearchads360V23CommonProductGroupingInfo — Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. - … - `activityId` GoogleAdsSearchads360V23CommonActivityIdInfo — Advertiser-specific activity ID. - … - `productCategory` GoogleAdsSearchads360V23CommonProductCategoryInfo — Category of a product offer. - … - `activityState` GoogleAdsSearchads360V23CommonActivityStateInfo — The state where the travel activity is available. - … - `hotelClass` GoogleAdsSearchads360V23CommonHotelClassInfo — Class of the hotel as a number of stars 1 to 5. - … - `productLegacyCondition` GoogleAdsSearchads360V23CommonProductLegacyConditionInfo — Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. - … - `hotelId` GoogleAdsSearchads360V23CommonHotelIdInfo — Advertiser-specific hotel ID. - … - `hotelCity` GoogleAdsSearchads360V23CommonHotelCityInfo — City the hotel is located in. - … - `productCustomAttribute` GoogleAdsSearchads360V23CommonProductCustomAttributeInfo — Custom attribute of a product offer. - … - `unknownListingDimension` GoogleAdsSearchads360V23CommonUnknownListingDimensionInfo — Unknown listing dimension. - `productChannelExclusivity` GoogleAdsSearchads360V23CommonProductChannelExclusivityInfo — Availability of a product offer. - … - `productItemId` GoogleAdsSearchads360V23CommonProductItemIdInfo — Item id of a product offer. - … - `hotelCountryRegion` GoogleAdsSearchads360V23CommonHotelCountryRegionInfo — Country or Region the hotel is located in. - … - `productLabels` GoogleAdsSearchads360V23CommonProductLabelsInfo — Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. - … - `productTypeFull` GoogleAdsSearchads360V23CommonProductTypeFullInfo — Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. - … - `activityCity` GoogleAdsSearchads360V23CommonActivityCityInfo — The city where the travel activity is available. - … - `productChannel` GoogleAdsSearchads360V23CommonProductChannelInfo — Locality of a product offer. - … - `activityCountry` GoogleAdsSearchads360V23CommonActivityCountryInfo — The country where the travel activity is available. - … - `productType` GoogleAdsSearchads360V23CommonProductTypeInfo — Type of a product offer. - … - `activityRating` GoogleAdsSearchads360V23CommonActivityRatingInfo — Rating of the activity as a number 1 to 5, where 5 is the best. - … - `productCondition` GoogleAdsSearchads360V23CommonProductConditionInfo — Condition of a product offer. - … - `hotelState` GoogleAdsSearchads360V23CommonHotelStateInfo — State the hotel is located in. - … - `productBrand` GoogleAdsSearchads360V23CommonProductBrandInfo — Brand of the product. - … - `effectiveCpvBidMicros` string, int64 — Output only. The effective CPV (cost-per-view) bid. - `brandList` GoogleAdsSearchads360V23CommonBrandListInfo — A Brand List Criterion is used to specify a list of brands. The list is represented as a SharedSet id type BRAND_HINT. A criterion of this type can be either targeted or excluded. - `sharedSet` string — Shared set resource name of the brand list. - `urlCustomParameters` GoogleAdsSearchads360V23CommonCustomParameter[] — The list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`. - `key` string — The key matching the parameter tag name. - `value` string — The value to be substituted. - `negative` boolean — Immutable. Whether to target (`false`) or exclude (`true`) the criterion. This field is immutable. To switch a criterion from positive to negative, remove then re-add it. - `labels` string[] — Output only. The resource names of labels attached to this ad group criterion. - `effectiveCpcBidMicros` string, int64 — Output only. The effective CPC (cost-per-click) bid. - `creationTime` string — Output only. The timestamp when this ad group criterion was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. - `effectivePercentCpcBidSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective Percent CPC bid. - `combinedAudience` GoogleAdsSearchads360V23CommonCombinedAudienceInfo — A combined audience criterion. - `combinedAudience` string — The CombinedAudience resource name. - `resourceName` string — Immutable. The resource name of the ad group criterion. Ad group criterion resource names have the form: `customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}` - `customIntent` GoogleAdsSearchads360V23CommonCustomIntentInfo — A custom intent criterion. A criterion of this type is only targetable. - `customIntent` string — The CustomInterest resource name. - `gender` GoogleAdsSearchads360V23CommonGenderInfo — A gender criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MALE' | 'FEMALE' | 'UNDETERMINED' — Type of the gender. - `cpvBidMicros` string, int64 — The CPV (cost-per-view) bid. - `videoLineup` GoogleAdsSearchads360V23CommonVideoLineupInfo — A Video lineup criterion. - `videoLineupId` string, int64 — ID for a Video lineup. Contact your Google business development representative for details. - `customAffinity` GoogleAdsSearchads360V23CommonCustomAffinityInfo — A custom affinity criterion. A criterion of this type is only targetable. - `customAffinity` string — The CustomInterest resource name. - `topic` GoogleAdsSearchads360V23CommonTopicInfo — A topic criterion. Use topics to target or exclude placements in the Google Display Network based on the category into which the placement falls (for example, "Pets & Animals/Pets/Dogs"). - `topicConstant` string — The Topic Constant resource name. - `path` string[] — The category to target or exclude. Each subsequent element in the array describes a more specific sub-category. For example, "Pets & Animals", "Pets", "Dogs" represents the "Pets & Animals/Pets/Dogs" category. - `lastModifiedTime` string — Output only. The datetime when this ad group criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format. - `primaryStatusReasons` string[] — Output only. The primary status reasons for the ad group criterion. - `incomeRange` GoogleAdsSearchads360V23CommonIncomeRangeInfo — An income range criterion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'INCOME_RANGE_0_50' | 'INCOME_RANGE_50_60' | 'INCOME_RANGE_60_70' | 'INCOME_RANGE_70_80' | 'INCOME_RANGE_80_90' | 'INCOME_RANGE_90_UP' | 'INCOME_RANGE_UNDETERMINED' — Type of the income range. - `percentCpcBidMicros` string, int64 — The CPC bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0,1) and the value stored here is 1,000,000 * [fraction]. - `bidModifier` number, double — The modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. - `exemptPolicyViolationKeys` GoogleAdsSearchads360V23CommonPolicyViolationKey[] — 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. Resources violating these polices 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. - `policyName` string — Unique ID of the violated policy. - `violatingText` string — 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. - `remove` string — Remove operation: A resource name for the removed criterion is expected, in this format: `customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}` - `adParameterOperation` GoogleAdsSearchads360V23ServicesAdParameterOperation — A single operation (create, update, remove) on ad parameter. - `remove` string — Remove operation: A resource name for the ad parameter to remove is expected in this format: `customers/{customer_id}/adParameters/{ad_group_id}~{criterion_id}~{parameter_index}` - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `create` GoogleAdsSearchads360V23ResourcesAdParameter — An ad parameter that is used to update numeric values (such as prices or inventory levels) in any text line of an ad (including URLs). There can be a maximum of two AdParameters per ad group criterion. (One with parameter_index = 1 and one with parameter_index = 2.) In the ad the parameters are referenced by a placeholder of the form "{param#:value}". For example, "{param1:$17}" - `adGroupCriterion` string — Immutable. The ad group criterion that this ad parameter belongs to. - `insertionText` string — Numeric value to insert into the ad text. The following restrictions apply: - Can use comma or period as a separator, with an optional period or comma (respectively) for fractional values. For example, 1,000,000.00 and 2.000.000,10 are valid. - Can be prepended or appended with a currency symbol. For example, $99.99 is valid. - Can be prepended or appended with a currency code. For example, 99.99USD and EUR200 are valid. - Can use '%'. For example, 1.0% and 1,0% are valid. - Can use plus or minus. For example, -10.99 and 25+ are valid. - Can use '/' between two numbers. For example 4/1 and 0.95/0.45 are valid. - `resourceName` string — Immutable. The resource name of the ad parameter. Ad parameter resource names have the form: `customers/{customer_id}/adParameters/{ad_group_id}~{criterion_id}~{parameter_index}` - `parameterIndex` string, int64 — Immutable. The unique index of this ad parameter. Must be either 1 or 2. - `update` GoogleAdsSearchads360V23ResourcesAdParameter — An ad parameter that is used to update numeric values (such as prices or inventory levels) in any text line of an ad (including URLs). There can be a maximum of two AdParameters per ad group criterion. (One with parameter_index = 1 and one with parameter_index = 2.) In the ad the parameters are referenced by a placeholder of the form "{param#:value}". For example, "{param1:$17}" - `adGroupCriterion` string — Immutable. The ad group criterion that this ad parameter belongs to. - `insertionText` string — Numeric value to insert into the ad text. The following restrictions apply: - Can use comma or period as a separator, with an optional period or comma (respectively) for fractional values. For example, 1,000,000.00 and 2.000.000,10 are valid. - Can be prepended or appended with a currency symbol. For example, $99.99 is valid. - Can be prepended or appended with a currency code. For example, 99.99USD and EUR200 are valid. - Can use '%'. For example, 1.0% and 1,0% are valid. - Can use plus or minus. For example, -10.99 and 25+ are valid. - Can use '/' between two numbers. For example 4/1 and 0.95/0.45 are valid. - `resourceName` string — Immutable. The resource name of the ad parameter. Ad parameter resource names have the form: `customers/{customer_id}/adParameters/{ad_group_id}~{criterion_id}~{parameter_index}` - `parameterIndex` string, int64 — Immutable. The unique index of this ad parameter. Must be either 1 or 2. - `conversionValueRuleOperation` GoogleAdsSearchads360V23ServicesConversionValueRuleOperation — A single operation (create, update, remove) on a conversion value rule. - `remove` string — Remove operation: A resource name for the removed conversion value rule is expected, in this format: `customers/{customer_id}/conversionValueRules/{conversion_value_rule_id}` - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `create` GoogleAdsSearchads360V23ResourcesConversionValueRule — A conversion value rule - `action` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleAction — Action applied when rule is applied. - `value` number, double — Specifies applied value. - `operation` 'UNSPECIFIED' | 'UNKNOWN' | 'ADD' | 'MULTIPLY' | 'SET' — Specifies applied operation. - `ownerCustomer` string — Output only. The resource name of the conversion value rule's owner customer. When the value rule is inherited from a manager customer, owner_customer will be the resource name of the manager whereas the customer in the resource_name will be of the requesting serving customer. ** Read-only ** - `deviceCondition` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleDeviceCondition — Condition on Device dimension. - `deviceTypes` string[] — Value for device type condition. - `resourceName` string — Immutable. The resource name of the conversion value rule. Conversion value rule resource names have the form: `customers/{customer_id}/conversionValueRules/{conversion_value_rule_id}` - `id` string, int64 — Output only. The ID of the conversion value rule. - `audienceCondition` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleAudienceCondition — Condition on Audience dimension. - `userLists` string[] — User Lists. - `userInterests` string[] — User Interests. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' | 'PAUSED' — The status of the conversion value rule. - `geoLocationCondition` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleGeoLocationCondition — Condition on Geo dimension. - `excludedGeoTargetConstants` string[] — Geo locations that advertisers want to exclude. - `excludedGeoMatchType` 'UNSPECIFIED' | 'UNKNOWN' | 'ANY' | 'LOCATION_OF_PRESENCE' — Excluded Geo location match type. - `geoMatchType` 'UNSPECIFIED' | 'UNKNOWN' | 'ANY' | 'LOCATION_OF_PRESENCE' — Included Geo location match type. - `geoTargetConstants` string[] — Geo locations that advertisers want to include. - `itineraryCondition` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleItineraryCondition — Condition on Itinerary dimension. - `advanceBookingWindow` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleItineraryAdvanceBookingWindow — Range for the number of days between the date of the booking and the start of the itinerary. - `minDays` integer — Minimum number of days between the date of the booking the start date. - `maxDays` integer — Maximum number of days between the date of the booking the start date. - `travelStartDay` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleItineraryTravelStartDay — The days of the week on which an itinerary's travel can start. - `monday` boolean — The travel can start on Monday. - `tuesday` boolean — The travel can start on Tuesday. - `friday` boolean — The travel can start on Friday. - `wednesday` boolean — The travel can start on Wednesday. - `sunday` boolean — The travel can start on Sunday. - `thursday` boolean — The travel can start on Thursday. - `saturday` boolean — The travel can start on Saturday. - `travelLength` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleItineraryTravelLength — Range for the itinerary length in number of nights. - `minNights` integer — Minimum number of nights between the start date and the end date. - `maxNights` integer — Maximum number of days between the start date and the end date. - `update` GoogleAdsSearchads360V23ResourcesConversionValueRule — A conversion value rule - `action` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleAction — Action applied when rule is applied. - `value` number, double — Specifies applied value. - `operation` 'UNSPECIFIED' | 'UNKNOWN' | 'ADD' | 'MULTIPLY' | 'SET' — Specifies applied operation. - `ownerCustomer` string — Output only. The resource name of the conversion value rule's owner customer. When the value rule is inherited from a manager customer, owner_customer will be the resource name of the manager whereas the customer in the resource_name will be of the requesting serving customer. ** Read-only ** - `deviceCondition` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleDeviceCondition — Condition on Device dimension. - `deviceTypes` string[] — Value for device type condition. - `resourceName` string — Immutable. The resource name of the conversion value rule. Conversion value rule resource names have the form: `customers/{customer_id}/conversionValueRules/{conversion_value_rule_id}` - `id` string, int64 — Output only. The ID of the conversion value rule. - `audienceCondition` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleAudienceCondition — Condition on Audience dimension. - `userLists` string[] — User Lists. - `userInterests` string[] — User Interests. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' | 'PAUSED' — The status of the conversion value rule. - `geoLocationCondition` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleGeoLocationCondition — Condition on Geo dimension. - `excludedGeoTargetConstants` string[] — Geo locations that advertisers want to exclude. - `excludedGeoMatchType` 'UNSPECIFIED' | 'UNKNOWN' | 'ANY' | 'LOCATION_OF_PRESENCE' — Excluded Geo location match type. - `geoMatchType` 'UNSPECIFIED' | 'UNKNOWN' | 'ANY' | 'LOCATION_OF_PRESENCE' — Included Geo location match type. - `geoTargetConstants` string[] — Geo locations that advertisers want to include. - `itineraryCondition` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleItineraryCondition — Condition on Itinerary dimension. - `advanceBookingWindow` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleItineraryAdvanceBookingWindow — Range for the number of days between the date of the booking and the start of the itinerary. - `minDays` integer — Minimum number of days between the date of the booking the start date. - `maxDays` integer — Maximum number of days between the date of the booking the start date. - `travelStartDay` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleItineraryTravelStartDay — The days of the week on which an itinerary's travel can start. - `monday` boolean — The travel can start on Monday. - `tuesday` boolean — The travel can start on Tuesday. - `friday` boolean — The travel can start on Friday. - `wednesday` boolean — The travel can start on Wednesday. - `sunday` boolean — The travel can start on Sunday. - `thursday` boolean — The travel can start on Thursday. - `saturday` boolean — The travel can start on Saturday. - `travelLength` GoogleAdsSearchads360V23ResourcesConversionValueRuleValueRuleItineraryTravelLength — Range for the itinerary length in number of nights. - `minNights` integer — Minimum number of nights between the start date and the end date. - `maxNights` integer — Maximum number of days between the start date and the end date. - `conversionActionOperation` GoogleAdsSearchads360V23ServicesConversionActionOperation — A single operation (create, update, remove) on a conversion action. - `create` GoogleAdsSearchads360V23ResourcesConversionAction — A conversion action. - `name` string — The name of the conversion action. This field is required and should not be empty when creating new conversion actions. - `viewThroughLookbackWindowDays` string, int64 — The maximum number of days which may elapse between an impression and a conversion without an interaction. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'AD_CALL' | 'CLICK_TO_CALL' | 'GOOGLE_PLAY_DOWNLOAD' | 'GOOGLE_PLAY_IN_APP_PURCHASE' | 'UPLOAD_CALLS' | 'UPLOAD_CLICKS' | 'WEBPAGE' | 'WEBSITE_CALL' | 'STORE_SALES_DIRECT_UPLOAD' | 'STORE_SALES' | 'FIREBASE_ANDROID_FIRST_OPEN' | 'FIREBASE_ANDROID_IN_APP_PURCHASE' | 'FIREBASE_ANDROID_CUSTOM' | 'FIREBASE_IOS_FIRST_OPEN' | 'FIREBASE_IOS_IN_APP_PURCHASE' | 'FIREBASE_IOS_CUSTOM' | 'THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN' | 'THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE' | 'THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM' | 'THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN' | 'THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE' | 'THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM' | 'ANDROID_APP_PRE_REGISTRATION' | 'ANDROID_INSTALLS_ALL_OTHER_APPS' | 'FLOODLIGHT_ACTION' | 'FLOODLIGHT_TRANSACTION' | 'GOOGLE_HOSTED' | 'LEAD_FORM_SUBMIT' | 'SALESFORCE' | 'SEARCH_ADS_360' | 'SMART_CAMPAIGN_AD_CLICKS_TO_CALL' | 'SMART_CAMPAIGN_MAP_CLICKS_TO_CALL' | 'SMART_CAMPAIGN_MAP_DIRECTIONS' | 'SMART_CAMPAIGN_TRACKED_CALLS' | 'STORE_VISITS' | 'WEBPAGE_CODELESS' | 'UNIVERSAL_ANALYTICS_GOAL' | 'UNIVERSAL_ANALYTICS_TRANSACTION' | 'GOOGLE_ANALYTICS_4_CUSTOM' | 'GOOGLE_ANALYTICS_4_PURCHASE' — Immutable. The type of this conversion action. - `clickThroughLookbackWindowDays` string, int64 — The maximum number of days that may elapse between an interaction (for example, a click) and a conversion event. - `phoneCallDurationSeconds` string, int64 — The phone call duration in seconds after which a conversion should be reported for this conversion action. The value must be between 0 and 10000, inclusive. - `valueSettings` GoogleAdsSearchads360V23ResourcesConversionActionValueSettings — Settings related to the value for conversion events associated with this conversion action. - `defaultValue` number, double — The value to use when conversion events for this conversion action are sent with an invalid, disallowed or missing value, or when this conversion action is configured to always use the default value. - `alwaysUseDefaultValue` boolean — Controls whether the default value and default currency code are used in place of the value and currency code specified in conversion events for this conversion action. - `defaultCurrencyCode` string — The currency code to use when conversion events for this conversion action are sent with an invalid or missing currency code, or when this conversion action is configured to always use the default value. - `category` 'UNSPECIFIED' | 'UNKNOWN' | 'DEFAULT' | 'PAGE_VIEW' | 'PURCHASE' | 'SIGNUP' | 'DOWNLOAD' | 'ADD_TO_CART' | 'BEGIN_CHECKOUT' | 'SUBSCRIBE_PAID' | 'PHONE_CALL_LEAD' | 'IMPORTED_LEAD' | 'SUBMIT_LEAD_FORM' | 'BOOK_APPOINTMENT' | 'REQUEST_QUOTE' | 'GET_DIRECTIONS' | 'OUTBOUND_CLICK' | 'CONTACT' | 'ENGAGEMENT' | 'STORE_VISIT' | 'STORE_SALE' | 'QUALIFIED_LEAD' | 'CONVERTED_LEAD' — The category of conversions reported for this conversion action. - `includeInClientAccountConversionsMetric` boolean — Whether this conversion action should be included in the "client_account_conversions" metric. - `firebaseSettings` GoogleAdsSearchads360V23ResourcesConversionActionFirebaseSettings — Settings related to a Firebase conversion action. - `eventName` string — Output only. The event name of a Firebase conversion. - `propertyId` string, int64 — Output only. The GA property ID of the conversion. - `projectId` string — Output only. The Firebase project ID of the conversion. - `propertyName` string — Output only. The GA property name of the conversion. - `floodlightSettings` GoogleAdsSearchads360V23ResourcesConversionActionFloodlightSettings — Settings related to a Floodlight conversion action. - `activityGroupTag` string — Output only. String used to identify a Floodlight activity group when reporting conversions. - `activityTag` string — Output only. String used to identify a Floodlight activity when reporting conversions. - `activityId` string, int64 — Output only. ID of the Floodlight activity in DoubleClick Campaign Manager (DCM). - `creationTime` string — Output only. Timestamp of the Floodlight activity's creation, formatted in ISO 8601. - `includeInConversionsMetric` boolean — Output only. Whether this conversion action should be included in the "conversions" metric. - `resourceName` string — Immutable. The resource name of the conversion action. Conversion action resource names have the form: `customers/{customer_id}/conversionActions/{conversion_action_id}` - `ownerCustomer` string — Output only. The resource name of the conversion action owner customer, or null if this is a system-defined conversion action. - `countingType` 'UNSPECIFIED' | 'UNKNOWN' | 'ONE_PER_CLICK' | 'MANY_PER_CLICK' — How to count conversion events for the conversion action. - `mobileAppVendor` 'UNSPECIFIED' | 'UNKNOWN' | 'APPLE_APP_STORE' | 'GOOGLE_APP_STORE' — Output only. Mobile app vendor for an app conversion action. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' | 'HIDDEN' — The status of this conversion action for conversion event accrual. - `primaryForGoal` boolean — If a conversion action's primary_for_goal bit is false, the conversion action is non-biddable for all campaigns regardless of their customer conversion goal or campaign conversion goal. However, custom conversion goals do not respect primary_for_goal, so if a campaign has a custom conversion goal configured with a primary_for_goal = false conversion action, that conversion action is still biddable. By default, primary_for_goal will be true if not set. In V9, primary_for_goal can only be set to false after creation through an 'update' operation because it's not declared as optional. - `tagSnippets` GoogleAdsSearchads360V23CommonTagSnippet[] — Output only. The snippets used for tracking conversions. - `pageFormat` 'UNSPECIFIED' | 'UNKNOWN' | 'HTML' | 'AMP' — The format of the web page where the tracking tag and snippet will be installed, for example, HTML. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'WEBPAGE' | 'WEBPAGE_ONCLICK' | 'CLICK_TO_CALL' | 'WEBSITE_CALL' — The type of the generated tag snippets for tracking conversions. - `globalSiteTag` string — The site tag that adds visitors to your basic remarketing lists and sets new cookies on your domain. - `eventSnippet` string — The event snippet that works with the site tag to track actions that should be counted as conversions. - `thirdPartyAppAnalyticsSettings` GoogleAdsSearchads360V23ResourcesConversionActionThirdPartyAppAnalyticsSettings — Settings related to a third party app analytics conversion action. - `eventName` string — Output only. The event name of a third-party app analytics conversion. - `providerName` string — Output only. Name of the third-party app analytics provider. - `attributionModelSettings` GoogleAdsSearchads360V23ResourcesConversionActionAttributionModelSettings — Settings related to this conversion action's attribution model. - `dataDrivenModelStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'AVAILABLE' | 'STALE' | 'EXPIRED' | 'NEVER_GENERATED' — Output only. The status of the data-driven attribution model for the conversion action. - `attributionModel` 'UNSPECIFIED' | 'UNKNOWN' | 'EXTERNAL' | 'GOOGLE_ADS_LAST_CLICK' | 'GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK' | 'GOOGLE_SEARCH_ATTRIBUTION_LINEAR' | 'GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY' | 'GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED' | 'GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN' — The attribution model type of this conversion action. - `id` string, int64 — Output only. The ID of the conversion action. - `origin` 'UNSPECIFIED' | 'UNKNOWN' | 'WEBSITE' | 'GOOGLE_HOSTED' | 'APP' | 'CALL_FROM_ADS' | 'STORE' | 'YOUTUBE_HOSTED' | 'FLOODLIGHT' — Output only. The conversion origin of this conversion action. - `appId` string — App ID for an app conversion action. - `googleAnalytics4Settings` GoogleAdsSearchads360V23ResourcesConversionActionGoogleAnalytics4Settings — Settings related to a Google Analytics 4 conversion action. - `eventName` string — Output only. The name of the GA 4 event. - `propertyId` string, int64 — Output only. The ID of the GA 4 property. - `propertyName` string — Output only. The name of the GA 4 property. - `update` GoogleAdsSearchads360V23ResourcesConversionAction — A conversion action. - `name` string — The name of the conversion action. This field is required and should not be empty when creating new conversion actions. - `viewThroughLookbackWindowDays` string, int64 — The maximum number of days which may elapse between an impression and a conversion without an interaction. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'AD_CALL' | 'CLICK_TO_CALL' | 'GOOGLE_PLAY_DOWNLOAD' | 'GOOGLE_PLAY_IN_APP_PURCHASE' | 'UPLOAD_CALLS' | 'UPLOAD_CLICKS' | 'WEBPAGE' | 'WEBSITE_CALL' | 'STORE_SALES_DIRECT_UPLOAD' | 'STORE_SALES' | 'FIREBASE_ANDROID_FIRST_OPEN' | 'FIREBASE_ANDROID_IN_APP_PURCHASE' | 'FIREBASE_ANDROID_CUSTOM' | 'FIREBASE_IOS_FIRST_OPEN' | 'FIREBASE_IOS_IN_APP_PURCHASE' | 'FIREBASE_IOS_CUSTOM' | 'THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN' | 'THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE' | 'THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM' | 'THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN' | 'THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE' | 'THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM' | 'ANDROID_APP_PRE_REGISTRATION' | 'ANDROID_INSTALLS_ALL_OTHER_APPS' | 'FLOODLIGHT_ACTION' | 'FLOODLIGHT_TRANSACTION' | 'GOOGLE_HOSTED' | 'LEAD_FORM_SUBMIT' | 'SALESFORCE' | 'SEARCH_ADS_360' | 'SMART_CAMPAIGN_AD_CLICKS_TO_CALL' | 'SMART_CAMPAIGN_MAP_CLICKS_TO_CALL' | 'SMART_CAMPAIGN_MAP_DIRECTIONS' | 'SMART_CAMPAIGN_TRACKED_CALLS' | 'STORE_VISITS' | 'WEBPAGE_CODELESS' | 'UNIVERSAL_ANALYTICS_GOAL' | 'UNIVERSAL_ANALYTICS_TRANSACTION' | 'GOOGLE_ANALYTICS_4_CUSTOM' | 'GOOGLE_ANALYTICS_4_PURCHASE' — Immutable. The type of this conversion action. - `clickThroughLookbackWindowDays` string, int64 — The maximum number of days that may elapse between an interaction (for example, a click) and a conversion event. - `phoneCallDurationSeconds` string, int64 — The phone call duration in seconds after which a conversion should be reported for this conversion action. The value must be between 0 and 10000, inclusive. - `valueSettings` GoogleAdsSearchads360V23ResourcesConversionActionValueSettings — Settings related to the value for conversion events associated with this conversion action. - `defaultValue` number, double — The value to use when conversion events for this conversion action are sent with an invalid, disallowed or missing value, or when this conversion action is configured to always use the default value. - `alwaysUseDefaultValue` boolean — Controls whether the default value and default currency code are used in place of the value and currency code specified in conversion events for this conversion action. - `defaultCurrencyCode` string — The currency code to use when conversion events for this conversion action are sent with an invalid or missing currency code, or when this conversion action is configured to always use the default value. - `category` 'UNSPECIFIED' | 'UNKNOWN' | 'DEFAULT' | 'PAGE_VIEW' | 'PURCHASE' | 'SIGNUP' | 'DOWNLOAD' | 'ADD_TO_CART' | 'BEGIN_CHECKOUT' | 'SUBSCRIBE_PAID' | 'PHONE_CALL_LEAD' | 'IMPORTED_LEAD' | 'SUBMIT_LEAD_FORM' | 'BOOK_APPOINTMENT' | 'REQUEST_QUOTE' | 'GET_DIRECTIONS' | 'OUTBOUND_CLICK' | 'CONTACT' | 'ENGAGEMENT' | 'STORE_VISIT' | 'STORE_SALE' | 'QUALIFIED_LEAD' | 'CONVERTED_LEAD' — The category of conversions reported for this conversion action. - `includeInClientAccountConversionsMetric` boolean — Whether this conversion action should be included in the "client_account_conversions" metric. - `firebaseSettings` GoogleAdsSearchads360V23ResourcesConversionActionFirebaseSettings — Settings related to a Firebase conversion action. - `eventName` string — Output only. The event name of a Firebase conversion. - `propertyId` string, int64 — Output only. The GA property ID of the conversion. - `projectId` string — Output only. The Firebase project ID of the conversion. - `propertyName` string — Output only. The GA property name of the conversion. - `floodlightSettings` GoogleAdsSearchads360V23ResourcesConversionActionFloodlightSettings — Settings related to a Floodlight conversion action. - `activityGroupTag` string — Output only. String used to identify a Floodlight activity group when reporting conversions. - `activityTag` string — Output only. String used to identify a Floodlight activity when reporting conversions. - `activityId` string, int64 — Output only. ID of the Floodlight activity in DoubleClick Campaign Manager (DCM). - `creationTime` string — Output only. Timestamp of the Floodlight activity's creation, formatted in ISO 8601. - `includeInConversionsMetric` boolean — Output only. Whether this conversion action should be included in the "conversions" metric. - `resourceName` string — Immutable. The resource name of the conversion action. Conversion action resource names have the form: `customers/{customer_id}/conversionActions/{conversion_action_id}` - `ownerCustomer` string — Output only. The resource name of the conversion action owner customer, or null if this is a system-defined conversion action. - `countingType` 'UNSPECIFIED' | 'UNKNOWN' | 'ONE_PER_CLICK' | 'MANY_PER_CLICK' — How to count conversion events for the conversion action. - `mobileAppVendor` 'UNSPECIFIED' | 'UNKNOWN' | 'APPLE_APP_STORE' | 'GOOGLE_APP_STORE' — Output only. Mobile app vendor for an app conversion action. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' | 'HIDDEN' — The status of this conversion action for conversion event accrual. - `primaryForGoal` boolean — If a conversion action's primary_for_goal bit is false, the conversion action is non-biddable for all campaigns regardless of their customer conversion goal or campaign conversion goal. However, custom conversion goals do not respect primary_for_goal, so if a campaign has a custom conversion goal configured with a primary_for_goal = false conversion action, that conversion action is still biddable. By default, primary_for_goal will be true if not set. In V9, primary_for_goal can only be set to false after creation through an 'update' operation because it's not declared as optional. - `tagSnippets` GoogleAdsSearchads360V23CommonTagSnippet[] — Output only. The snippets used for tracking conversions. - `pageFormat` 'UNSPECIFIED' | 'UNKNOWN' | 'HTML' | 'AMP' — The format of the web page where the tracking tag and snippet will be installed, for example, HTML. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'WEBPAGE' | 'WEBPAGE_ONCLICK' | 'CLICK_TO_CALL' | 'WEBSITE_CALL' — The type of the generated tag snippets for tracking conversions. - `globalSiteTag` string — The site tag that adds visitors to your basic remarketing lists and sets new cookies on your domain. - `eventSnippet` string — The event snippet that works with the site tag to track actions that should be counted as conversions. - `thirdPartyAppAnalyticsSettings` GoogleAdsSearchads360V23ResourcesConversionActionThirdPartyAppAnalyticsSettings — Settings related to a third party app analytics conversion action. - `eventName` string — Output only. The event name of a third-party app analytics conversion. - `providerName` string — Output only. Name of the third-party app analytics provider. - `attributionModelSettings` GoogleAdsSearchads360V23ResourcesConversionActionAttributionModelSettings — Settings related to this conversion action's attribution model. - `dataDrivenModelStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'AVAILABLE' | 'STALE' | 'EXPIRED' | 'NEVER_GENERATED' — Output only. The status of the data-driven attribution model for the conversion action. - `attributionModel` 'UNSPECIFIED' | 'UNKNOWN' | 'EXTERNAL' | 'GOOGLE_ADS_LAST_CLICK' | 'GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK' | 'GOOGLE_SEARCH_ATTRIBUTION_LINEAR' | 'GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY' | 'GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED' | 'GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN' — The attribution model type of this conversion action. - `id` string, int64 — Output only. The ID of the conversion action. - `origin` 'UNSPECIFIED' | 'UNKNOWN' | 'WEBSITE' | 'GOOGLE_HOSTED' | 'APP' | 'CALL_FROM_ADS' | 'STORE' | 'YOUTUBE_HOSTED' | 'FLOODLIGHT' — Output only. The conversion origin of this conversion action. - `appId` string — App ID for an app conversion action. - `googleAnalytics4Settings` GoogleAdsSearchads360V23ResourcesConversionActionGoogleAnalytics4Settings — Settings related to a Google Analytics 4 conversion action. - `eventName` string — Output only. The name of the GA 4 event. - `propertyId` string, int64 — Output only. The ID of the GA 4 property. - `propertyName` string — Output only. The name of the GA 4 property. - `remove` string — Remove operation: A resource name for the removed conversion action is expected, in this format: `customers/{customer_id}/conversionActions/{conversion_action_id}` - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `assetSetOperation` GoogleAdsSearchads360V23ServicesAssetSetOperation — A single operation (create, remove) on an asset set. - `create` GoogleAdsSearchads360V23ResourcesAssetSet — An asset set representing a collection of assets. Use AssetSetAsset to link an asset to the asset set. - `merchantCenterFeed` GoogleAdsSearchads360V23ResourcesAssetSetMerchantCenterFeed — Merchant ID and Feed Label from Google Merchant Center. - `merchantId` string, int64 — Required. Merchant ID from Google Merchant Center - `feedLabel` string — Optional. Feed Label from Google Merchant Center. - `hotelPropertyData` GoogleAdsSearchads360V23ResourcesAssetSetHotelPropertyData — For Performance Max for travel goals campaigns with a Hotel Center account link. Read-only. - `hotelCenterId` string, int64 — Output only. The hotel center ID of the partner. - `partnerName` string — Output only. Name of the hotel partner. - `id` string, int64 — Output only. The ID of the asset set. - `locationSet` GoogleAdsSearchads360V23CommonLocationSet — Data related to location set. One of the Google Business Profile (previously known as Google My Business) data, Chain data, and map location data need to be specified. - `businessProfileLocationSet` GoogleAdsSearchads360V23CommonBusinessProfileLocationSet — Data used to configure a location set populated from Google Business Profile locations. Different types of filters are AND'ed together, if they are specified. - `labelFilters` string[] — Used to filter Google Business Profile listings by labels. If entries exist in labelFilters, only listings that have any of the labels set are candidates to be synchronized into Assets. If no entries exist in labelFilters, then all listings are candidates for syncing. Label filters are OR'ed together. - `businessAccountId` string — Immutable. The account ID of the managed business whose locations are to be used. If this field is not set, then all businesses accessible by the user (specified by the emailAddress) are used. - `httpAuthorizationToken` string — Required. Immutable. The HTTP authorization token used to obtain authorization. - `listingIdFilters` string[] — Used to filter Google Business Profile listings by listing id. If entries exist in listingIdFilters, only listings specified by the filters are candidates to be synchronized into Assets. If no entries exist in listingIdFilters, then all listings are candidates for syncing. Listing ID filters are OR'ed together. - `businessNameFilter` string — Used to filter Google Business Profile listings by business name. If businessNameFilter is set, only listings with a matching business name are candidates to be sync'd into Assets. - `emailAddress` string — Required. Immutable. Email address of a Google Business Profile account or email address of a manager of the Google Business Profile account. - `locationOwnershipType` 'UNSPECIFIED' | 'UNKNOWN' | 'BUSINESS_OWNER' | 'AFFILIATE' — Required. Immutable. Location Ownership Type (owned location or affiliate location). - `chainLocationSet` GoogleAdsSearchads360V23CommonChainSet — Data used to configure a location set populated with the specified chains. - `chains` GoogleAdsSearchads360V23CommonChainFilter[] — Required. A list of chain level filters, all filters are OR'ed together. - … - `relationshipType` 'UNSPECIFIED' | 'UNKNOWN' | 'AUTO_DEALERS' | 'GENERAL_RETAILERS' — Required. Immutable. Relationship type the specified chains have with this advertiser. - `mapsLocationSet` GoogleAdsSearchads360V23CommonMapsLocationSet — Wrapper for multiple maps location sync data - `mapsLocations` GoogleAdsSearchads360V23CommonMapsLocationInfo[] — Required. A list of maps location info that user manually synced in. - … - `resourceName` string — Immutable. The resource name of the asset set. Asset set resource names have the form: `customers/{customer_id}/assetSets/{asset_set_id}` - `chainLocationGroup` GoogleAdsSearchads360V23CommonChainLocationGroup — Represents information about a Chain dynamic location group. Only applicable if the sync level AssetSet's type is LOCATION_SYNC and sync source is chain. - `dynamicChainLocationGroupFilters` GoogleAdsSearchads360V23CommonChainFilter[] — Used to filter chain locations by chain ids. Only Locations that belong to the specified chain(s) will be in the asset set. - `chainId` string, int64 — Required. Used to filter chain locations by chain id. Only chain locations that belong to the specified chain will be in the asset set. - `locationAttributes` string[] — Used to filter chain locations by location attributes. Only chain locations that belong to all of the specified attribute(s) will be in the asset set. If this field is empty, it means no filtering on this field. - `locationGroupParentAssetSetId` string, int64 — Immutable. Parent asset set ID for the asset set where the elements of this asset set come from. For example: the sync level location AssetSet id where the elements in LocationGroup AssetSet come from. This field is required and only applicable for Location Group typed AssetSet. - `businessProfileLocationGroup` GoogleAdsSearchads360V23CommonBusinessProfileLocationGroup — Information about a Business Profile dynamic location group. Only applicable if the sync level AssetSet's type is LOCATION_SYNC and sync source is Business Profile. - `dynamicBusinessProfileLocationGroupFilter` GoogleAdsSearchads360V23CommonDynamicBusinessProfileLocationGroupFilter — Represents a filter on Business Profile locations in an asset set. If multiple filters are provided, they are AND'ed together. - `listingIdFilters` string[] — Used to filter Business Profile locations by listing ids. - `labelFilters` string[] — Used to filter Business Profile locations by label. Only locations that have any of the listed labels will be in the asset set. Label filters are OR'ed together. - `businessNameFilter` GoogleAdsSearchads360V23CommonBusinessProfileBusinessNameFilter — Business Profile location group business name filter. - … - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'PAGE_FEED' | 'DYNAMIC_EDUCATION' | 'MERCHANT_CENTER_FEED' | 'DYNAMIC_REAL_ESTATE' | 'DYNAMIC_CUSTOM' | 'DYNAMIC_HOTELS_AND_RENTALS' | 'DYNAMIC_FLIGHTS' | 'DYNAMIC_TRAVEL' | 'DYNAMIC_LOCAL' | 'DYNAMIC_JOBS' | 'LOCATION_SYNC' | 'BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP' | 'CHAIN_DYNAMIC_LOCATION_GROUP' | 'STATIC_LOCATION_GROUP' | 'HOTEL_PROPERTY' | 'TRAVEL_FEED' — Required. Immutable. The type of the asset set. Required. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — Output only. The status of the asset set. Read-only. - `name` string — Required. Name of the asset set. Required. It must have a minimum length of 1 and maximum length of 128. - `update` GoogleAdsSearchads360V23ResourcesAssetSet — An asset set representing a collection of assets. Use AssetSetAsset to link an asset to the asset set. - `merchantCenterFeed` GoogleAdsSearchads360V23ResourcesAssetSetMerchantCenterFeed — Merchant ID and Feed Label from Google Merchant Center. - `merchantId` string, int64 — Required. Merchant ID from Google Merchant Center - `feedLabel` string — Optional. Feed Label from Google Merchant Center. - `hotelPropertyData` GoogleAdsSearchads360V23ResourcesAssetSetHotelPropertyData — For Performance Max for travel goals campaigns with a Hotel Center account link. Read-only. - `hotelCenterId` string, int64 — Output only. The hotel center ID of the partner. - `partnerName` string — Output only. Name of the hotel partner. - `id` string, int64 — Output only. The ID of the asset set. - `locationSet` GoogleAdsSearchads360V23CommonLocationSet — Data related to location set. One of the Google Business Profile (previously known as Google My Business) data, Chain data, and map location data need to be specified. - `businessProfileLocationSet` GoogleAdsSearchads360V23CommonBusinessProfileLocationSet — Data used to configure a location set populated from Google Business Profile locations. Different types of filters are AND'ed together, if they are specified. - `labelFilters` string[] — Used to filter Google Business Profile listings by labels. If entries exist in labelFilters, only listings that have any of the labels set are candidates to be synchronized into Assets. If no entries exist in labelFilters, then all listings are candidates for syncing. Label filters are OR'ed together. - `businessAccountId` string — Immutable. The account ID of the managed business whose locations are to be used. If this field is not set, then all businesses accessible by the user (specified by the emailAddress) are used. - `httpAuthorizationToken` string — Required. Immutable. The HTTP authorization token used to obtain authorization. - `listingIdFilters` string[] — Used to filter Google Business Profile listings by listing id. If entries exist in listingIdFilters, only listings specified by the filters are candidates to be synchronized into Assets. If no entries exist in listingIdFilters, then all listings are candidates for syncing. Listing ID filters are OR'ed together. - `businessNameFilter` string — Used to filter Google Business Profile listings by business name. If businessNameFilter is set, only listings with a matching business name are candidates to be sync'd into Assets. - `emailAddress` string — Required. Immutable. Email address of a Google Business Profile account or email address of a manager of the Google Business Profile account. - `locationOwnershipType` 'UNSPECIFIED' | 'UNKNOWN' | 'BUSINESS_OWNER' | 'AFFILIATE' — Required. Immutable. Location Ownership Type (owned location or affiliate location). - `chainLocationSet` GoogleAdsSearchads360V23CommonChainSet — Data used to configure a location set populated with the specified chains. - `chains` GoogleAdsSearchads360V23CommonChainFilter[] — Required. A list of chain level filters, all filters are OR'ed together. - … - `relationshipType` 'UNSPECIFIED' | 'UNKNOWN' | 'AUTO_DEALERS' | 'GENERAL_RETAILERS' — Required. Immutable. Relationship type the specified chains have with this advertiser. - `mapsLocationSet` GoogleAdsSearchads360V23CommonMapsLocationSet — Wrapper for multiple maps location sync data - `mapsLocations` GoogleAdsSearchads360V23CommonMapsLocationInfo[] — Required. A list of maps location info that user manually synced in. - … - `resourceName` string — Immutable. The resource name of the asset set. Asset set resource names have the form: `customers/{customer_id}/assetSets/{asset_set_id}` - `chainLocationGroup` GoogleAdsSearchads360V23CommonChainLocationGroup — Represents information about a Chain dynamic location group. Only applicable if the sync level AssetSet's type is LOCATION_SYNC and sync source is chain. - `dynamicChainLocationGroupFilters` GoogleAdsSearchads360V23CommonChainFilter[] — Used to filter chain locations by chain ids. Only Locations that belong to the specified chain(s) will be in the asset set. - `chainId` string, int64 — Required. Used to filter chain locations by chain id. Only chain locations that belong to the specified chain will be in the asset set. - `locationAttributes` string[] — Used to filter chain locations by location attributes. Only chain locations that belong to all of the specified attribute(s) will be in the asset set. If this field is empty, it means no filtering on this field. - `locationGroupParentAssetSetId` string, int64 — Immutable. Parent asset set ID for the asset set where the elements of this asset set come from. For example: the sync level location AssetSet id where the elements in LocationGroup AssetSet come from. This field is required and only applicable for Location Group typed AssetSet. - `businessProfileLocationGroup` GoogleAdsSearchads360V23CommonBusinessProfileLocationGroup — Information about a Business Profile dynamic location group. Only applicable if the sync level AssetSet's type is LOCATION_SYNC and sync source is Business Profile. - `dynamicBusinessProfileLocationGroupFilter` GoogleAdsSearchads360V23CommonDynamicBusinessProfileLocationGroupFilter — Represents a filter on Business Profile locations in an asset set. If multiple filters are provided, they are AND'ed together. - `listingIdFilters` string[] — Used to filter Business Profile locations by listing ids. - `labelFilters` string[] — Used to filter Business Profile locations by label. Only locations that have any of the listed labels will be in the asset set. Label filters are OR'ed together. - `businessNameFilter` GoogleAdsSearchads360V23CommonBusinessProfileBusinessNameFilter — Business Profile location group business name filter. - … - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'PAGE_FEED' | 'DYNAMIC_EDUCATION' | 'MERCHANT_CENTER_FEED' | 'DYNAMIC_REAL_ESTATE' | 'DYNAMIC_CUSTOM' | 'DYNAMIC_HOTELS_AND_RENTALS' | 'DYNAMIC_FLIGHTS' | 'DYNAMIC_TRAVEL' | 'DYNAMIC_LOCAL' | 'DYNAMIC_JOBS' | 'LOCATION_SYNC' | 'BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP' | 'CHAIN_DYNAMIC_LOCATION_GROUP' | 'STATIC_LOCATION_GROUP' | 'HOTEL_PROPERTY' | 'TRAVEL_FEED' — Required. Immutable. The type of the asset set. Required. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — Output only. The status of the asset set. Read-only. - `name` string — Required. Name of the asset set. Required. It must have a minimum length of 1 and maximum length of 128. - `remove` string — Remove operation: A resource name for the removed asset set is expected, in this format: `customers/{customer_id}/assetSets/{asset_set_id}` - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `smartCampaignSettingOperation` GoogleAdsSearchads360V23ServicesSmartCampaignSettingOperation — A single operation to update Smart campaign settings for a campaign. - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `update` GoogleAdsSearchads360V23ResourcesSmartCampaignSetting — Settings for configuring Smart campaigns. - `campaign` string — Output only. The campaign to which these settings apply. - `businessName` string — The name of the business. - `finalUrl` string — The user-provided landing page URL for this Campaign. - `businessProfileLocation` string — The resource name of a Business Profile location. Business Profile location resource names can be fetched through the Business Profile API and adhere to the following format: `locations/{locationId}`. See the [Business Profile API] (https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations) for additional details. - `resourceName` string — Immutable. The resource name of the Smart campaign setting. Smart campaign setting resource names have the form: `customers/{customer_id}/smartCampaignSettings/{campaign_id}` - `phoneNumber` GoogleAdsSearchads360V23ResourcesSmartCampaignSettingPhoneNumber — Phone number and country code in smart campaign settings. - `phoneNumber` string — Phone number of the smart campaign. - `countryCode` string — Upper-case, two-letter country code as defined by ISO-3166. - `advertisingLanguageCode` string — The language code to advertise in from the set of [supported language codes] (https://developers.google.com/google-ads/api/reference/data/codes-formats#languages). - `adOptimizedBusinessProfileSetting` GoogleAdsSearchads360V23ResourcesSmartCampaignSettingAdOptimizedBusinessProfileSetting — Settings for configuring a business profile optimized for ads as this campaign's landing page. - `includeLeadForm` boolean — Enabling a lead form on your business profile enables prospective customers to contact your business by filling out a simple form, and you'll receive their information through email. - `audienceOperation` GoogleAdsSearchads360V23ServicesAudienceOperation — A single operation (create, update) on an audience. - `create` GoogleAdsSearchads360V23ResourcesAudience — Audience is an effective targeting option that lets you intersect different segment attributes, such as detailed demographics and affinities, to create audiences that represent sections of your target segments. - `resourceName` string — Immutable. The resource name of the audience. Audience names have the form: `customers/{customer_id}/audiences/{audience_id}` - `id` string, int64 — Output only. ID of the audience. - `description` string — Description of this audience. - `exclusionDimension` GoogleAdsSearchads360V23CommonAudienceExclusionDimension — Negative dimension specifying users to exclude from the audience. - `exclusions` GoogleAdsSearchads360V23CommonExclusionSegment[] — Audience segment to be excluded. - `userList` GoogleAdsSearchads360V23CommonUserListSegment — User list segment. - … - `name` string — Name of the audience. It should be unique across all audiences within the account. It must have a minimum length of 1 and maximum length of 255. Required when scope is not set or is set to CUSTOMER. Cannot be set or updated when scope is ASSET_GROUP. - `scope` 'UNSPECIFIED' | 'UNKNOWN' | 'CUSTOMER' | 'ASSET_GROUP' — Defines the scope this audience can be used in. By default, the scope is CUSTOMER. Audiences can be created with a scope of ASSET_GROUP for exclusive use by a single asset_group. Scope may change from ASSET_GROUP to CUSTOMER but not from CUSTOMER to ASSET_GROUP. - `assetGroup` string — Immutable. The asset group that this audience is scoped under. Must be set if and only if scope is ASSET_GROUP. Immutable after creation. If an audience with ASSET_GROUP scope is upgraded to CUSTOMER scope, this field will automatically be cleared. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — Output only. Status of this audience. Indicates whether the audience is enabled or removed. - `dimensions` GoogleAdsSearchads360V23CommonAudienceDimension[] — Positive dimensions specifying the audience composition. - `gender` GoogleAdsSearchads360V23CommonGenderDimension — Dimension specifying users by their gender. - `genders` string[] — Included gender demographic segments. - `includeUndetermined` boolean — Include users whose gender is not determined. - `audienceSegments` GoogleAdsSearchads360V23CommonAudienceSegmentDimension — Dimension specifying users by their membership in other audience segments. - `segments` GoogleAdsSearchads360V23CommonAudienceSegment[] — Included audience segments. Users are included if they belong to at least one segment. - … - `householdIncome` GoogleAdsSearchads360V23CommonHouseholdIncomeDimension — Dimension specifying users by their household income. - `includeUndetermined` boolean — Include users whose household income is not determined. - `incomeRanges` string[] — Included household income demographic segments. - `age` GoogleAdsSearchads360V23CommonAgeDimension — Dimension specifying users by their age. - `includeUndetermined` boolean — Include users whose age is not determined. - `ageRanges` GoogleAdsSearchads360V23CommonAgeSegment[] — Contiguous age range to be included in the dimension. - … - `parentalStatus` GoogleAdsSearchads360V23CommonParentalStatusDimension — Dimension specifying users by their parental status. - `parentalStatuses` string[] — Included parental status demographic segments. - `includeUndetermined` boolean — Include users whose parental status is undetermined. - `update` GoogleAdsSearchads360V23ResourcesAudience — Audience is an effective targeting option that lets you intersect different segment attributes, such as detailed demographics and affinities, to create audiences that represent sections of your target segments. - `resourceName` string — Immutable. The resource name of the audience. Audience names have the form: `customers/{customer_id}/audiences/{audience_id}` - `id` string, int64 — Output only. ID of the audience. - `description` string — Description of this audience. - `exclusionDimension` GoogleAdsSearchads360V23CommonAudienceExclusionDimension — Negative dimension specifying users to exclude from the audience. - `exclusions` GoogleAdsSearchads360V23CommonExclusionSegment[] — Audience segment to be excluded. - `userList` GoogleAdsSearchads360V23CommonUserListSegment — User list segment. - … - `name` string — Name of the audience. It should be unique across all audiences within the account. It must have a minimum length of 1 and maximum length of 255. Required when scope is not set or is set to CUSTOMER. Cannot be set or updated when scope is ASSET_GROUP. - `scope` 'UNSPECIFIED' | 'UNKNOWN' | 'CUSTOMER' | 'ASSET_GROUP' — Defines the scope this audience can be used in. By default, the scope is CUSTOMER. Audiences can be created with a scope of ASSET_GROUP for exclusive use by a single asset_group. Scope may change from ASSET_GROUP to CUSTOMER but not from CUSTOMER to ASSET_GROUP. - `assetGroup` string — Immutable. The asset group that this audience is scoped under. Must be set if and only if scope is ASSET_GROUP. Immutable after creation. If an audience with ASSET_GROUP scope is upgraded to CUSTOMER scope, this field will automatically be cleared. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — Output only. Status of this audience. Indicates whether the audience is enabled or removed. - `dimensions` GoogleAdsSearchads360V23CommonAudienceDimension[] — Positive dimensions specifying the audience composition. - `gender` GoogleAdsSearchads360V23CommonGenderDimension — Dimension specifying users by their gender. - `genders` string[] — Included gender demographic segments. - `includeUndetermined` boolean — Include users whose gender is not determined. - `audienceSegments` GoogleAdsSearchads360V23CommonAudienceSegmentDimension — Dimension specifying users by their membership in other audience segments. - `segments` GoogleAdsSearchads360V23CommonAudienceSegment[] — Included audience segments. Users are included if they belong to at least one segment. - … - `householdIncome` GoogleAdsSearchads360V23CommonHouseholdIncomeDimension — Dimension specifying users by their household income. - `includeUndetermined` boolean — Include users whose household income is not determined. - `incomeRanges` string[] — Included household income demographic segments. - `age` GoogleAdsSearchads360V23CommonAgeDimension — Dimension specifying users by their age. - `includeUndetermined` boolean — Include users whose age is not determined. - `ageRanges` GoogleAdsSearchads360V23CommonAgeSegment[] — Contiguous age range to be included in the dimension. - … - `parentalStatus` GoogleAdsSearchads360V23CommonParentalStatusDimension — Dimension specifying users by their parental status. - `parentalStatuses` string[] — Included parental status demographic segments. - `includeUndetermined` boolean — Include users whose parental status is undetermined. - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `customerCustomizerOperation` GoogleAdsSearchads360V23ServicesCustomerCustomizerOperation — A single operation (create, remove) on a customizer attribute. - `create` GoogleAdsSearchads360V23ResourcesCustomerCustomizer — A customizer value for the associated CustomizerAttribute at the Customer level. - `resourceName` string — Immutable. The resource name of the customer customizer. Customer customizer resource names have the form: `customers/{customer_id}/customerCustomizers/{customizer_attribute_id}` - `customizerAttribute` string — Required. Immutable. The customizer attribute which is linked to the customer. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — Output only. The status of the customer customizer attribute. - `value` GoogleAdsSearchads360V23CommonCustomizerValue — A customizer value that is referenced in customizer linkage entities like CustomerCustomizer, CampaignCustomizer, etc. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'TEXT' | 'NUMBER' | 'PRICE' | 'PERCENT' — Required. The data type for the customizer value. It must match the attribute type. The string_value content must match the constraints associated with the type. - `stringValue` string — Required. Value to insert in creative text. Customizer values of all types are stored as string to make formatting unambiguous. - `remove` string — Remove operation: A resource name for the removed customer customizer is expected, in this format: `customers/{customer_id}/customerCustomizers/{customizer_attribute_id}` - `campaignDraftOperation` GoogleAdsSearchads360V23ServicesCampaignDraftOperation — A single operation (create, update, remove) on a campaign draft. - `create` GoogleAdsSearchads360V23ResourcesCampaignDraft — A campaign draft. - `baseCampaign` string — Immutable. The base campaign to which the draft belongs. - `hasExperimentRunning` boolean — Output only. Whether there is an experiment based on this draft currently serving. - `longRunningOperation` string — Output only. The resource name of the long-running operation that can be used to poll for completion of draft promotion. This is only set if the draft promotion is in progress or finished. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'PROPOSED' | 'REMOVED' | 'PROMOTING' | 'PROMOTED' | 'PROMOTE_FAILED' — Output only. The status of the campaign draft. This field is read-only. When a new campaign draft is added, the status defaults to PROPOSED. - `resourceName` string — Immutable. The resource name of the campaign draft. Campaign draft resource names have the form: `customers/{customer_id}/campaignDrafts/{base_campaign_id}~{draft_id}` - `draftId` string, int64 — Output only. The ID of the draft. This field is read-only. - `draftCampaign` string — Output only. Resource name of the Campaign that results from overlaying the draft changes onto the base campaign. This field is read-only. - `name` string — The name of the campaign draft. This field is required and should not be empty when creating new campaign drafts. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. - `update` GoogleAdsSearchads360V23ResourcesCampaignDraft — A campaign draft. - `baseCampaign` string — Immutable. The base campaign to which the draft belongs. - `hasExperimentRunning` boolean — Output only. Whether there is an experiment based on this draft currently serving. - `longRunningOperation` string — Output only. The resource name of the long-running operation that can be used to poll for completion of draft promotion. This is only set if the draft promotion is in progress or finished. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'PROPOSED' | 'REMOVED' | 'PROMOTING' | 'PROMOTED' | 'PROMOTE_FAILED' — Output only. The status of the campaign draft. This field is read-only. When a new campaign draft is added, the status defaults to PROPOSED. - `resourceName` string — Immutable. The resource name of the campaign draft. Campaign draft resource names have the form: `customers/{customer_id}/campaignDrafts/{base_campaign_id}~{draft_id}` - `draftId` string, int64 — Output only. The ID of the draft. This field is read-only. - `draftCampaign` string — Output only. Resource name of the Campaign that results from overlaying the draft changes onto the base campaign. This field is read-only. - `name` string — The name of the campaign draft. This field is required and should not be empty when creating new campaign drafts. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `remove` string — Remove operation: The campaign draft is expected to have a valid resource name, in this format: `customers/{customer_id}/campaignDrafts/{base_campaign_id}~{draft_id}` - `campaignGroupOperation` GoogleAdsSearchads360V23ServicesCampaignGroupOperation — A single operation (create, update, remove) on a campaign group. - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `remove` string — Remove operation: A resource name for the removed campaign group is expected, in this format: `customers/{customer_id}/campaignGroups/{campaign_group_id}` - `create` GoogleAdsSearchads360V23ResourcesCampaignGroup — A campaign group. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — The status of the campaign group. When a new campaign group is added, the status defaults to ENABLED. - `id` string, int64 — Output only. The ID of the campaign group. - `name` string — The name of the campaign group. This field is required and should not be empty when creating new campaign groups. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. - `resourceName` string — Immutable. The resource name of the campaign group. Campaign group resource names have the form: `customers/{customer_id}/campaignGroups/{campaign_group_id}` - `update` GoogleAdsSearchads360V23ResourcesCampaignGroup — A campaign group. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — The status of the campaign group. When a new campaign group is added, the status defaults to ENABLED. - `id` string, int64 — Output only. The ID of the campaign group. - `name` string — The name of the campaign group. This field is required and should not be empty when creating new campaign groups. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. - `resourceName` string — Immutable. The resource name of the campaign group. Campaign group resource names have the form: `customers/{customer_id}/campaignGroups/{campaign_group_id}` - `conversionValueRuleSetOperation` GoogleAdsSearchads360V23ServicesConversionValueRuleSetOperation — A single operation (create, update, remove) on a conversion value rule set. - `create` GoogleAdsSearchads360V23ResourcesConversionValueRuleSet — A conversion value rule set is a collection of conversion value rules that lets you adjust conversion values based on the dimensions specified in the `dimensions` field. - `ownerCustomer` string — Output only. The resource name of the conversion value rule set's owner customer. When the value rule set is inherited from a manager customer, owner_customer will be the resource name of the manager whereas the customer in the resource_name will be of the requesting serving customer. ** Read-only ** - `resourceName` string — Immutable. The resource name of the conversion value rule set. Conversion value rule set resource names have the form: `customers/{customer_id}/conversionValueRuleSets/{conversion_value_rule_set_id}` - `conversionActionCategories` string[] — Immutable. The conversion action categories of the conversion value rule set. - `id` string, int64 — Output only. The ID of the conversion value rule set. - `conversionValueRules` string[] — Resource names of rules within the rule set. - `campaign` string — The resource name of the campaign when the conversion value rule set is attached to a campaign. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' | 'PAUSED' — Output only. The status of the conversion value rule set. ** Read-only ** - `attachmentType` 'UNSPECIFIED' | 'UNKNOWN' | 'CUSTOMER' | 'CAMPAIGN' — Immutable. Defines the scope where the conversion value rule set is attached. - `dimensions` string[] — Defines dimensions for Value Rule conditions. The condition types of value rules within this value rule set must be of these dimensions. The first entry in this list is the primary dimension of the included value rules. When using value rule primary dimension segmentation, conversion values will be segmented into the values adjusted by value rules and the original values, if some value rules apply. - `update` GoogleAdsSearchads360V23ResourcesConversionValueRuleSet — A conversion value rule set is a collection of conversion value rules that lets you adjust conversion values based on the dimensions specified in the `dimensions` field. - `ownerCustomer` string — Output only. The resource name of the conversion value rule set's owner customer. When the value rule set is inherited from a manager customer, owner_customer will be the resource name of the manager whereas the customer in the resource_name will be of the requesting serving customer. ** Read-only ** - `resourceName` string — Immutable. The resource name of the conversion value rule set. Conversion value rule set resource names have the form: `customers/{customer_id}/conversionValueRuleSets/{conversion_value_rule_set_id}` - `conversionActionCategories` string[] — Immutable. The conversion action categories of the conversion value rule set. - `id` string, int64 — Output only. The ID of the conversion value rule set. - `conversionValueRules` string[] — Resource names of rules within the rule set. - `campaign` string — The resource name of the campaign when the conversion value rule set is attached to a campaign. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' | 'PAUSED' — Output only. The status of the conversion value rule set. ** Read-only ** - `attachmentType` 'UNSPECIFIED' | 'UNKNOWN' | 'CUSTOMER' | 'CAMPAIGN' — Immutable. Defines the scope where the conversion value rule set is attached. - `dimensions` string[] — Defines dimensions for Value Rule conditions. The condition types of value rules within this value rule set must be of these dimensions. The first entry in this list is the primary dimension of the included value rules. When using value rule primary dimension segmentation, conversion values will be segmented into the values adjusted by value rules and the original values, if some value rules apply. - `remove` string — Remove operation: A resource name for the removed conversion value rule set is expected, in this format: `customers/{customer_id}/conversionValueRuleSets/{conversion_value_rule_set_id}` - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `biddingStrategyOperation` GoogleAdsSearchads360V23ServicesBiddingStrategyOperation — A single operation (create, update, remove) on a bidding strategy. - `create` GoogleAdsSearchads360V23ResourcesBiddingStrategy — A bidding strategy. - `alignedCampaignBudgetId` string, int64 — ID of the campaign budget that this portfolio bidding strategy is aligned with. When a portfolio and a campaign budget are aligned, that means that they are attached to the same set of campaigns. After a bidding strategy is aligned with a campaign budget, campaigns that are added to the bidding strategy must also use the aligned campaign budget. - `id` string, int64 — Output only. The ID of the bidding strategy. - `campaignCount` string, int64 — Output only. The number of campaigns attached to this bidding strategy. This field is read-only. - `enhancedCpc` GoogleAdsSearchads360V23CommonEnhancedCpc — An automated bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely. This bidding strategy is deprecated and cannot be created anymore. Use ManualCpc with enhanced_cpc_enabled set to true for equivalent functionality. - `targetRoas` GoogleAdsSearchads360V23CommonTargetRoas — An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS). - `cpcBidCeilingMicros` string, int64 — Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. - `targetRoas` number, double — Required. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive. - `cpcBidFloorMicros` string, int64 — Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. - `targetRoasTolerancePercentMillis` string, int64 — The percent of ROAS(return on advertising spend) degradation tolerance allowed to increase traffic diversity and conversion volume, specified in millis (for example, 10,000 = 10%). A value of 10,000 means that the advertiser can expect ROAS degradation of up to 10% of the specified target ROAS. This field is only mutable for portfolio bidding strategies. - `currencyCode` string — Immutable. The currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this currency can be set on creation and defaults to the manager customer's currency. For serving customers, this field cannot be set; all strategies in a serving customer implicitly use the serving customer's currency. In all cases the effective_currency_code field returns the currency used by the strategy. - `targetCpa` GoogleAdsSearchads360V23CommonTargetCpa — An automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set. - `targetCpaMicros` string, int64 — Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account. - `cpcBidCeilingMicros` string, int64 — Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. - `cpcBidFloorMicros` string, int64 — Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. - `targetSpend` GoogleAdsSearchads360V23CommonTargetSpend — An automated bid strategy that sets your bids to help get as many clicks as possible within your budget. - `cpcBidCeilingMicros` string, int64 — Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. - `targetSpendMicros` string, int64 — Deprecated: The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — Output only. The status of the bidding strategy. This field is read-only. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'COMMISSION' | 'ENHANCED_CPC' | 'INVALID' | 'MANUAL_CPA' | 'MANUAL_CPC' | 'MANUAL_CPM' | 'MANUAL_CPV' | 'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE' | 'PAGE_ONE_PROMOTED' | 'PERCENT_CPC' | 'TARGET_CPA' | 'TARGET_CPC' | 'TARGET_CPM' | 'TARGET_IMPRESSION_SHARE' | 'TARGET_OUTRANK_SHARE' | 'TARGET_ROAS' | 'TARGET_SPEND' — Output only. The type of the bidding strategy. Create a bidding strategy by setting the bidding scheme. This field is read-only. - `resourceName` string — Immutable. The resource name of the bidding strategy. Bidding strategy resource names have the form: `customers/{customer_id}/biddingStrategies/{bidding_strategy_id}` - `effectiveCurrencyCode` string — Output only. The currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this is the currency set by the advertiser when creating the strategy. For serving customers, this is the customer's currency_code. Bidding strategy metrics are reported in this currency. This field is read-only. - `maximizeConversions` GoogleAdsSearchads360V23CommonMaximizeConversions — An automated bidding strategy to help get the most conversions for your campaigns while spending your budget. - `targetCpaMicros` string, int64 — The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. - `cpcBidCeilingMicros` string, int64 — Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only. - `cpcBidFloorMicros` string, int64 — Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only. - `maximizeConversionValue` GoogleAdsSearchads360V23CommonMaximizeConversionValue — An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget. - `targetRoasTolerancePercentMillis` string, int64 — The percent of ROAS(return on advertising spend) degradation tolerance allowed to increase traffic diversity and conversion volume, specified in millis (for example, 10,000 = 10%). A value of 10,000 means that the advertiser can expect ROAS degradation of up to 10% of the specified target ROAS. - `cpcBidCeilingMicros` string, int64 — Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only. - `targetRoas` number, double — The target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget. - `cpcBidFloorMicros` string, int64 — Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only. - `name` string — The name of the bidding strategy. All bidding strategies within an account must be named distinctly. The length of this string should be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed). - `nonRemovedCampaignCount` string, int64 — Output only. The number of non-removed campaigns attached to this bidding strategy. This field is read-only. - `targetImpressionShare` GoogleAdsSearchads360V23CommonTargetImpressionShare — An automated bidding strategy that sets bids so that a certain percentage of search ads are shown at the top of the first page (or other targeted location). - `locationFractionMicros` string, int64 — The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000. - `location` 'UNSPECIFIED' | 'UNKNOWN' | 'ANYWHERE_ON_PAGE' | 'TOP_OF_PAGE' | 'ABSOLUTE_TOP_OF_PAGE' — The targeted location on the search results page. - `cpcBidCeilingMicros` string, int64 — The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. - `update` GoogleAdsSearchads360V23ResourcesBiddingStrategy — A bidding strategy. - `alignedCampaignBudgetId` string, int64 — ID of the campaign budget that this portfolio bidding strategy is aligned with. When a portfolio and a campaign budget are aligned, that means that they are attached to the same set of campaigns. After a bidding strategy is aligned with a campaign budget, campaigns that are added to the bidding strategy must also use the aligned campaign budget. - `id` string, int64 — Output only. The ID of the bidding strategy. - `campaignCount` string, int64 — Output only. The number of campaigns attached to this bidding strategy. This field is read-only. - `enhancedCpc` GoogleAdsSearchads360V23CommonEnhancedCpc — An automated bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely. This bidding strategy is deprecated and cannot be created anymore. Use ManualCpc with enhanced_cpc_enabled set to true for equivalent functionality. - `targetRoas` GoogleAdsSearchads360V23CommonTargetRoas — An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS). - `cpcBidCeilingMicros` string, int64 — Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. - `targetRoas` number, double — Required. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive. - `cpcBidFloorMicros` string, int64 — Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. - `targetRoasTolerancePercentMillis` string, int64 — The percent of ROAS(return on advertising spend) degradation tolerance allowed to increase traffic diversity and conversion volume, specified in millis (for example, 10,000 = 10%). A value of 10,000 means that the advertiser can expect ROAS degradation of up to 10% of the specified target ROAS. This field is only mutable for portfolio bidding strategies. - `currencyCode` string — Immutable. The currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this currency can be set on creation and defaults to the manager customer's currency. For serving customers, this field cannot be set; all strategies in a serving customer implicitly use the serving customer's currency. In all cases the effective_currency_code field returns the currency used by the strategy. - `targetCpa` GoogleAdsSearchads360V23CommonTargetCpa — An automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set. - `targetCpaMicros` string, int64 — Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account. - `cpcBidCeilingMicros` string, int64 — Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. - `cpcBidFloorMicros` string, int64 — Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. - `targetSpend` GoogleAdsSearchads360V23CommonTargetSpend — An automated bid strategy that sets your bids to help get as many clicks as possible within your budget. - `cpcBidCeilingMicros` string, int64 — Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. - `targetSpendMicros` string, int64 — Deprecated: The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — Output only. The status of the bidding strategy. This field is read-only. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'COMMISSION' | 'ENHANCED_CPC' | 'INVALID' | 'MANUAL_CPA' | 'MANUAL_CPC' | 'MANUAL_CPM' | 'MANUAL_CPV' | 'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE' | 'PAGE_ONE_PROMOTED' | 'PERCENT_CPC' | 'TARGET_CPA' | 'TARGET_CPC' | 'TARGET_CPM' | 'TARGET_IMPRESSION_SHARE' | 'TARGET_OUTRANK_SHARE' | 'TARGET_ROAS' | 'TARGET_SPEND' — Output only. The type of the bidding strategy. Create a bidding strategy by setting the bidding scheme. This field is read-only. - `resourceName` string — Immutable. The resource name of the bidding strategy. Bidding strategy resource names have the form: `customers/{customer_id}/biddingStrategies/{bidding_strategy_id}` - `effectiveCurrencyCode` string — Output only. The currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this is the currency set by the advertiser when creating the strategy. For serving customers, this is the customer's currency_code. Bidding strategy metrics are reported in this currency. This field is read-only. - `maximizeConversions` GoogleAdsSearchads360V23CommonMaximizeConversions — An automated bidding strategy to help get the most conversions for your campaigns while spending your budget. - `targetCpaMicros` string, int64 — The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. - `cpcBidCeilingMicros` string, int64 — Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only. - `cpcBidFloorMicros` string, int64 — Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only. - `maximizeConversionValue` GoogleAdsSearchads360V23CommonMaximizeConversionValue — An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget. - `targetRoasTolerancePercentMillis` string, int64 — The percent of ROAS(return on advertising spend) degradation tolerance allowed to increase traffic diversity and conversion volume, specified in millis (for example, 10,000 = 10%). A value of 10,000 means that the advertiser can expect ROAS degradation of up to 10% of the specified target ROAS. - `cpcBidCeilingMicros` string, int64 — Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only. - `targetRoas` number, double — The target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget. - `cpcBidFloorMicros` string, int64 — Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only. - `name` string — The name of the bidding strategy. All bidding strategies within an account must be named distinctly. The length of this string should be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed). - `nonRemovedCampaignCount` string, int64 — Output only. The number of non-removed campaigns attached to this bidding strategy. This field is read-only. - `targetImpressionShare` GoogleAdsSearchads360V23CommonTargetImpressionShare — An automated bidding strategy that sets bids so that a certain percentage of search ads are shown at the top of the first page (or other targeted location). - `locationFractionMicros` string, int64 — The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000. - `location` 'UNSPECIFIED' | 'UNKNOWN' | 'ANYWHERE_ON_PAGE' | 'TOP_OF_PAGE' | 'ABSOLUTE_TOP_OF_PAGE' — The targeted location on the search results page. - `cpcBidCeilingMicros` string, int64 — The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `remove` string — Remove operation: A resource name for the removed bidding strategy is expected, in this format: `customers/{customer_id}/biddingStrategies/{bidding_strategy_id}` - `biddingSeasonalityAdjustmentOperation` GoogleAdsSearchads360V23ServicesBiddingSeasonalityAdjustmentOperation — A single operation (create, remove, update) on a seasonality adjustment. - `create` GoogleAdsSearchads360V23ResourcesBiddingSeasonalityAdjustment — Represents a bidding seasonality adjustment. Cannot be used in manager accounts. See "About seasonality adjustments" at https://support.google.com/google-ads/answer/10369906. - `resourceName` string — Immutable. The resource name of the seasonality adjustment. Seasonality adjustment resource names have the form: `customers/{customer_id}/biddingSeasonalityAdjustments/{seasonality_adjustment_id}` - `devices` string[] — If not specified, all devices will be included in this adjustment. Otherwise, only the specified targeted devices will be included in this adjustment. - `campaigns` string[] — The seasonality adjustment will apply to the campaigns listed when the scope of this adjustment is CAMPAIGN. The maximum number of campaigns per event is 2000. Note: a seasonality adjustment with both advertising_channel_types and campaign_ids is not supported. - `advertisingChannelTypes` string[] — The seasonality adjustment will apply to all the campaigns under the listed channels retroactively as well as going forward when the scope of this adjustment is CHANNEL. The supported advertising channel types are DISPLAY, SEARCH and SHOPPING. Note: a seasonality adjustment with both advertising_channel_types and campaign_ids is not supported. - `seasonalityAdjustmentId` string, int64 — Output only. The ID of the seasonality adjustment. - `description` string — The description of the seasonality adjustment. The description can be at most 2048 characters. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — Output only. The status of the seasonality adjustment. - `startDateTime` string — Required. The inclusive start time of the seasonality adjustment in yyyy-MM-dd HH:mm:ss format. A seasonality adjustment is forward looking and should be used for events that start and end in the future. - `scope` 'UNSPECIFIED' | 'UNKNOWN' | 'CUSTOMER' | 'CAMPAIGN' | 'CHANNEL' — The scope of the seasonality adjustment. - `name` string — The name of the seasonality adjustment. The name can be at most 255 characters. - `conversionRateModifier` number, double — Conversion rate modifier estimated based on expected conversion rate changes. When this field is unset or set to 1.0 no adjustment will be applied to traffic. The allowed range is 0.1 to 10.0. - `endDateTime` string — Required. The exclusive end time of the seasonality adjustment in yyyy-MM-dd HH:mm:ss format. The length of [start_date_time, end_date_time) interval must be within (0, 14 days]. - `update` GoogleAdsSearchads360V23ResourcesBiddingSeasonalityAdjustment — Represents a bidding seasonality adjustment. Cannot be used in manager accounts. See "About seasonality adjustments" at https://support.google.com/google-ads/answer/10369906. - `resourceName` string — Immutable. The resource name of the seasonality adjustment. Seasonality adjustment resource names have the form: `customers/{customer_id}/biddingSeasonalityAdjustments/{seasonality_adjustment_id}` - `devices` string[] — If not specified, all devices will be included in this adjustment. Otherwise, only the specified targeted devices will be included in this adjustment. - `campaigns` string[] — The seasonality adjustment will apply to the campaigns listed when the scope of this adjustment is CAMPAIGN. The maximum number of campaigns per event is 2000. Note: a seasonality adjustment with both advertising_channel_types and campaign_ids is not supported. - `advertisingChannelTypes` string[] — The seasonality adjustment will apply to all the campaigns under the listed channels retroactively as well as going forward when the scope of this adjustment is CHANNEL. The supported advertising channel types are DISPLAY, SEARCH and SHOPPING. Note: a seasonality adjustment with both advertising_channel_types and campaign_ids is not supported. - `seasonalityAdjustmentId` string, int64 — Output only. The ID of the seasonality adjustment. - `description` string — The description of the seasonality adjustment. The description can be at most 2048 characters. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — Output only. The status of the seasonality adjustment. - `startDateTime` string — Required. The inclusive start time of the seasonality adjustment in yyyy-MM-dd HH:mm:ss format. A seasonality adjustment is forward looking and should be used for events that start and end in the future. - `scope` 'UNSPECIFIED' | 'UNKNOWN' | 'CUSTOMER' | 'CAMPAIGN' | 'CHANNEL' — The scope of the seasonality adjustment. - `name` string — The name of the seasonality adjustment. The name can be at most 255 characters. - `conversionRateModifier` number, double — Conversion rate modifier estimated based on expected conversion rate changes. When this field is unset or set to 1.0 no adjustment will be applied to traffic. The allowed range is 0.1 to 10.0. - `endDateTime` string — Required. The exclusive end time of the seasonality adjustment in yyyy-MM-dd HH:mm:ss format. The length of [start_date_time, end_date_time) interval must be within (0, 14 days]. - `remove` string — Remove operation: A resource name for the removed seasonality adjustment is expected, in this format: `customers/{customer_id}/biddingSeasonalityAdjustments/{seasonality_adjustment_id}` - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `userListOperation` GoogleAdsSearchads360V23ServicesUserListOperation — A single operation (create, update) on a user list. - `create` GoogleAdsSearchads360V23ResourcesUserList — A user list. This is a list of users a customer may target. The unique key of a user list consists of the following fields: `id`. Note that the `name` must also be unique for user lists owned by a given customer, except in some cases where `access_reason` is set to `SHARED`. Violating the unique name constraint produces error: `UserListError.INVALID_NAME`. - `name` string — Name of this user list. Unique per user list, except in some cases where a user list of the same name has `access_reason` set to `SHARED`. - `sizeForSearch` string, int64 — Output only. Estimated number of users in this user list in the google.com domain. These are the users available for targeting in Search campaigns. This value is null if the number of users has not yet been determined. This field is read-only. - `sizeForDisplay` string, int64 — Output only. Estimated number of users in this user list, on the Google Display Network. This value is if the number of users has not yet been determined. This field is -only. - `accountUserListStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'DISABLED' — Indicates if this share is still enabled. When a UserList is shared with the user this field is set to ENABLED. Later the userList owner can decide to revoke the share and make it DISABLED. The default value of this field is set to ENABLED. - `closingReason` 'UNSPECIFIED' | 'UNKNOWN' | 'UNUSED' — Indicating the reason why this user list membership status is closed. It is only populated on lists that were automatically closed due to inactivity, and will be cleared once the list membership status becomes open. - `membershipLifeSpan` string, int64 — Number of days a user's cookie stays on your list since its most recent addition to the list. This field must be between 0 and 540 inclusive. However, for CRM based userlists, this field can be set to 10000 which means no expiration. Beginning on April 7, 2025, using a value of 10000 to indicate no expiration will no longer be supported. This field is ignored for logical_user_list and rule_based_user_list types. Membership to lists of these types depends on the rules defined by the lists. - `sizeRangeForDisplay` 'UNSPECIFIED' | 'UNKNOWN' | 'LESS_THAN_FIVE_HUNDRED' | 'LESS_THAN_ONE_THOUSAND' | 'ONE_THOUSAND_TO_TEN_THOUSAND' | 'TEN_THOUSAND_TO_FIFTY_THOUSAND' | 'FIFTY_THOUSAND_TO_ONE_HUNDRED_THOUSAND' | 'ONE_HUNDRED_THOUSAND_TO_THREE_HUNDRED_THOUSAND' | 'THREE_HUNDRED_THOUSAND_TO_FIVE_HUNDRED_THOUSAND' | 'FIVE_HUNDRED_THOUSAND_TO_ONE_MILLION' | 'ONE_MILLION_TO_TWO_MILLION' | 'TWO_MILLION_TO_THREE_MILLION' | 'THREE_MILLION_TO_FIVE_MILLION' | 'FIVE_MILLION_TO_TEN_MILLION' | 'TEN_MILLION_TO_TWENTY_MILLION' | 'TWENTY_MILLION_TO_THIRTY_MILLION' | 'THIRTY_MILLION_TO_FIFTY_MILLION' | 'OVER_FIFTY_MILLION' — Output only. Size range in terms of number of users of the UserList, on the Google Display Network. This field is read-only. - `sizeRangeForSearch` 'UNSPECIFIED' | 'UNKNOWN' | 'LESS_THAN_FIVE_HUNDRED' | 'LESS_THAN_ONE_THOUSAND' | 'ONE_THOUSAND_TO_TEN_THOUSAND' | 'TEN_THOUSAND_TO_FIFTY_THOUSAND' | 'FIFTY_THOUSAND_TO_ONE_HUNDRED_THOUSAND' | 'ONE_HUNDRED_THOUSAND_TO_THREE_HUNDRED_THOUSAND' | 'THREE_HUNDRED_THOUSAND_TO_FIVE_HUNDRED_THOUSAND' | 'FIVE_HUNDRED_THOUSAND_TO_ONE_MILLION' | 'ONE_MILLION_TO_TWO_MILLION' | 'TWO_MILLION_TO_THREE_MILLION' | 'THREE_MILLION_TO_FIVE_MILLION' | 'FIVE_MILLION_TO_TEN_MILLION' | 'TEN_MILLION_TO_TWENTY_MILLION' | 'TWENTY_MILLION_TO_THIRTY_MILLION' | 'THIRTY_MILLION_TO_FIFTY_MILLION' | 'OVER_FIFTY_MILLION' — Output only. Size range in terms of number of users of the UserList, for Search ads. This field is read-only. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'REMARKETING' | 'LOGICAL' | 'EXTERNAL_REMARKETING' | 'RULE_BASED' | 'SIMILAR' | 'CRM_BASED' | 'LOOKALIKE' — Output only. Type of this list. This field is read-only. - `membershipStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'OPEN' | 'CLOSED' — Membership status of this user list. Indicates whether a user list is open or active. Only open user lists can accumulate more users and can be targeted to. - `basicUserList` GoogleAdsSearchads360V23CommonBasicUserListInfo - `actions` GoogleAdsSearchads360V23CommonUserListActionInfo[] — Actions associated with this user list. - `conversionAction` string — A conversion action that's not generated from remarketing. - `remarketingAction` string — A remarketing action. - `lookalikeUserList` GoogleAdsSearchads360V23CommonLookalikeUserListInfo — LookalikeUserlist, composed of users similar to those of a configurable seed (set of UserLists) - `expansionLevel` 'UNSPECIFIED' | 'UNKNOWN' | 'NARROW' | 'BALANCED' | 'BROAD' — Expansion level, reflecting the size of the lookalike audience - `seedUserListIds` string[] — Seed UserList ID from which this list is derived, provided by user. - `countryCodes` string[] — Countries targeted by the Lookalike. Two-letter country code as defined by ISO-3166 - `ruleBasedUserList` GoogleAdsSearchads360V23CommonRuleBasedUserListInfo — Representation of a userlist that is generated by a rule. - `flexibleRuleUserList` GoogleAdsSearchads360V23CommonFlexibleRuleUserListInfo — Flexible rule representation of visitors with one or multiple actions. The flexible user list is defined by two lists of operands – inclusive_operands and exclusive_operands; each operand represents a set of users based on actions they took in a given timeframe. These lists of operands are combined with the AND_NOT operator, so that users represented by the inclusive operands are included in the user list, minus the users represented by the exclusive operands. - `exclusiveOperands` GoogleAdsSearchads360V23CommonFlexibleRuleOperandInfo[] — Rules representing users that should be excluded from the user list. These are located on the right side of the AND_NOT operator, and joined together by OR. - … - `inclusiveOperands` GoogleAdsSearchads360V23CommonFlexibleRuleOperandInfo[] — Rules representing users that should be included in the user list. These are located on the left side of the AND_NOT operator, and joined together by either AND/OR as specified by the inclusive_rule_operator. - … - `inclusiveRuleOperator` 'UNSPECIFIED' | 'UNKNOWN' | 'AND' | 'OR' — Operator that defines how the inclusive operands are combined. - `prepopulationStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'REQUESTED' | 'FINISHED' | 'FAILED' — The status of pre-population. The field is default to NONE if not set which means the previous users will not be considered. If set to REQUESTED, past site visitors or app users who match the list definition will be included in the list (works on the Display Network only). This will only add past users from within the last 30 days, depending on the list's membership duration and the date when the remarketing tag is added. The status will be updated to FINISHED once request is processed, or FAILED if the request fails. - `readOnly` boolean — Output only. An option that indicates if a user may edit a list. Depends on the list ownership and list type. For example, external remarketing user lists are not editable. This field is -only. - `matchRatePercentage` integer — Output only. Indicates match rate for Customer Match lists. The range of this field is [0-100]. This will be null for other list types or when it's not possible to calculate the match rate. This field is read-only. - `integrationCode` string — An ID from external system. It is used by user list sellers to correlate IDs on their systems. - `resourceName` string — Immutable. The resource name of the user list. User list resource names have the form: `customers/{customer_id}/userLists/{user_list_id}` - `accessReason` 'UNSPECIFIED' | 'UNKNOWN' | 'OWNED' | 'SHARED' | 'LICENSED' | 'SUBSCRIBED' | 'AFFILIATED' — Output only. Indicates the reason this account has been granted access to the list. The reason can be SHARED, OWNED, LICENSED or SUBSCRIBED. This field is read-only. - `description` string — Description of this user list. - `crmBasedUserList` GoogleAdsSearchads360V23CommonCrmBasedUserListInfo — UserList of CRM users provided by the advertiser. - `appId` string — A string that uniquely identifies a mobile application from which the data was collected. For iOS, the ID string is the 9 digit string that appears at the end of an App Store URL (for example, "476943146" for "Flood-It! 2" whose App Store link is http://itunes.apple.com/us/app/flood-it!-2/id476943146). For Android, the ID string is the application's package name (for example, "com.labpixies.colordrips" for "Color Drips" given Google Play link https://play.google.com/store/apps/details?id=com.labpixies.colordrips). Required when creating CrmBasedUserList for uploading mobile advertising IDs. - `dataSourceType` 'UNSPECIFIED' | 'UNKNOWN' | 'FIRST_PARTY' | 'THIRD_PARTY_CREDIT_BUREAU' | 'THIRD_PARTY_VOTER_FILE' | 'THIRD_PARTY_PARTNER_DATA' — Data source of the list. Default value is FIRST_PARTY. Only customers on the allow-list can create third-party sourced CRM lists. - `uploadKeyType` 'UNSPECIFIED' | 'UNKNOWN' | 'CONTACT_INFO' | 'CRM_ID' | 'MOBILE_ADVERTISING_ID' — Matching key type of the list. Mixed data types are not allowed on the same list. This field is required for an ADD operation. - `logicalUserList` GoogleAdsSearchads360V23CommonLogicalUserListInfo — Represents a user list that is a custom combination of user lists. - `rules` GoogleAdsSearchads360V23CommonUserListLogicalRuleInfo[] — Logical list rules that define this user list. The rules are defined as a logical operator (ALL/ANY/NONE) and a list of user lists. All the rules are ANDed when they are evaluated. Required for creating a logical user list. - `operator` 'UNSPECIFIED' | 'UNKNOWN' | 'ALL' | 'ANY' | 'NONE' — The logical operator of the rule. - `ruleOperands` GoogleAdsSearchads360V23CommonLogicalUserListOperandInfo[] — The list of operands of the rule. - … - `eligibleForDisplay` boolean — Output only. Indicates this user list is eligible for Google Display Network. This field is read-only. - `id` string, int64 — Output only. Id of the user list. - `eligibleForSearch` boolean — Indicates if this user list is eligible for Google Search Network. - `similarUserList` GoogleAdsSearchads360V23CommonSimilarUserListInfo — SimilarUserList is a list of users which are similar to users from another UserList. These lists are read-only and automatically created by Google. - `seedUserList` string — Seed UserList from which this list is derived. - `update` GoogleAdsSearchads360V23ResourcesUserList — A user list. This is a list of users a customer may target. The unique key of a user list consists of the following fields: `id`. Note that the `name` must also be unique for user lists owned by a given customer, except in some cases where `access_reason` is set to `SHARED`. Violating the unique name constraint produces error: `UserListError.INVALID_NAME`. - `name` string — Name of this user list. Unique per user list, except in some cases where a user list of the same name has `access_reason` set to `SHARED`. - `sizeForSearch` string, int64 — Output only. Estimated number of users in this user list in the google.com domain. These are the users available for targeting in Search campaigns. This value is null if the number of users has not yet been determined. This field is read-only. - `sizeForDisplay` string, int64 — Output only. Estimated number of users in this user list, on the Google Display Network. This value is if the number of users has not yet been determined. This field is -only. - `accountUserListStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'DISABLED' — Indicates if this share is still enabled. When a UserList is shared with the user this field is set to ENABLED. Later the userList owner can decide to revoke the share and make it DISABLED. The default value of this field is set to ENABLED. - `closingReason` 'UNSPECIFIED' | 'UNKNOWN' | 'UNUSED' — Indicating the reason why this user list membership status is closed. It is only populated on lists that were automatically closed due to inactivity, and will be cleared once the list membership status becomes open. - `membershipLifeSpan` string, int64 — Number of days a user's cookie stays on your list since its most recent addition to the list. This field must be between 0 and 540 inclusive. However, for CRM based userlists, this field can be set to 10000 which means no expiration. Beginning on April 7, 2025, using a value of 10000 to indicate no expiration will no longer be supported. This field is ignored for logical_user_list and rule_based_user_list types. Membership to lists of these types depends on the rules defined by the lists. - `sizeRangeForDisplay` 'UNSPECIFIED' | 'UNKNOWN' | 'LESS_THAN_FIVE_HUNDRED' | 'LESS_THAN_ONE_THOUSAND' | 'ONE_THOUSAND_TO_TEN_THOUSAND' | 'TEN_THOUSAND_TO_FIFTY_THOUSAND' | 'FIFTY_THOUSAND_TO_ONE_HUNDRED_THOUSAND' | 'ONE_HUNDRED_THOUSAND_TO_THREE_HUNDRED_THOUSAND' | 'THREE_HUNDRED_THOUSAND_TO_FIVE_HUNDRED_THOUSAND' | 'FIVE_HUNDRED_THOUSAND_TO_ONE_MILLION' | 'ONE_MILLION_TO_TWO_MILLION' | 'TWO_MILLION_TO_THREE_MILLION' | 'THREE_MILLION_TO_FIVE_MILLION' | 'FIVE_MILLION_TO_TEN_MILLION' | 'TEN_MILLION_TO_TWENTY_MILLION' | 'TWENTY_MILLION_TO_THIRTY_MILLION' | 'THIRTY_MILLION_TO_FIFTY_MILLION' | 'OVER_FIFTY_MILLION' — Output only. Size range in terms of number of users of the UserList, on the Google Display Network. This field is read-only. - `sizeRangeForSearch` 'UNSPECIFIED' | 'UNKNOWN' | 'LESS_THAN_FIVE_HUNDRED' | 'LESS_THAN_ONE_THOUSAND' | 'ONE_THOUSAND_TO_TEN_THOUSAND' | 'TEN_THOUSAND_TO_FIFTY_THOUSAND' | 'FIFTY_THOUSAND_TO_ONE_HUNDRED_THOUSAND' | 'ONE_HUNDRED_THOUSAND_TO_THREE_HUNDRED_THOUSAND' | 'THREE_HUNDRED_THOUSAND_TO_FIVE_HUNDRED_THOUSAND' | 'FIVE_HUNDRED_THOUSAND_TO_ONE_MILLION' | 'ONE_MILLION_TO_TWO_MILLION' | 'TWO_MILLION_TO_THREE_MILLION' | 'THREE_MILLION_TO_FIVE_MILLION' | 'FIVE_MILLION_TO_TEN_MILLION' | 'TEN_MILLION_TO_TWENTY_MILLION' | 'TWENTY_MILLION_TO_THIRTY_MILLION' | 'THIRTY_MILLION_TO_FIFTY_MILLION' | 'OVER_FIFTY_MILLION' — Output only. Size range in terms of number of users of the UserList, for Search ads. This field is read-only. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'REMARKETING' | 'LOGICAL' | 'EXTERNAL_REMARKETING' | 'RULE_BASED' | 'SIMILAR' | 'CRM_BASED' | 'LOOKALIKE' — Output only. Type of this list. This field is read-only. - `membershipStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'OPEN' | 'CLOSED' — Membership status of this user list. Indicates whether a user list is open or active. Only open user lists can accumulate more users and can be targeted to. - `basicUserList` GoogleAdsSearchads360V23CommonBasicUserListInfo - `actions` GoogleAdsSearchads360V23CommonUserListActionInfo[] — Actions associated with this user list. - `conversionAction` string — A conversion action that's not generated from remarketing. - `remarketingAction` string — A remarketing action. - `lookalikeUserList` GoogleAdsSearchads360V23CommonLookalikeUserListInfo — LookalikeUserlist, composed of users similar to those of a configurable seed (set of UserLists) - `expansionLevel` 'UNSPECIFIED' | 'UNKNOWN' | 'NARROW' | 'BALANCED' | 'BROAD' — Expansion level, reflecting the size of the lookalike audience - `seedUserListIds` string[] — Seed UserList ID from which this list is derived, provided by user. - `countryCodes` string[] — Countries targeted by the Lookalike. Two-letter country code as defined by ISO-3166 - `ruleBasedUserList` GoogleAdsSearchads360V23CommonRuleBasedUserListInfo — Representation of a userlist that is generated by a rule. - `flexibleRuleUserList` GoogleAdsSearchads360V23CommonFlexibleRuleUserListInfo — Flexible rule representation of visitors with one or multiple actions. The flexible user list is defined by two lists of operands – inclusive_operands and exclusive_operands; each operand represents a set of users based on actions they took in a given timeframe. These lists of operands are combined with the AND_NOT operator, so that users represented by the inclusive operands are included in the user list, minus the users represented by the exclusive operands. - `exclusiveOperands` GoogleAdsSearchads360V23CommonFlexibleRuleOperandInfo[] — Rules representing users that should be excluded from the user list. These are located on the right side of the AND_NOT operator, and joined together by OR. - … - `inclusiveOperands` GoogleAdsSearchads360V23CommonFlexibleRuleOperandInfo[] — Rules representing users that should be included in the user list. These are located on the left side of the AND_NOT operator, and joined together by either AND/OR as specified by the inclusive_rule_operator. - … - `inclusiveRuleOperator` 'UNSPECIFIED' | 'UNKNOWN' | 'AND' | 'OR' — Operator that defines how the inclusive operands are combined. - `prepopulationStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'REQUESTED' | 'FINISHED' | 'FAILED' — The status of pre-population. The field is default to NONE if not set which means the previous users will not be considered. If set to REQUESTED, past site visitors or app users who match the list definition will be included in the list (works on the Display Network only). This will only add past users from within the last 30 days, depending on the list's membership duration and the date when the remarketing tag is added. The status will be updated to FINISHED once request is processed, or FAILED if the request fails. - `readOnly` boolean — Output only. An option that indicates if a user may edit a list. Depends on the list ownership and list type. For example, external remarketing user lists are not editable. This field is -only. - `matchRatePercentage` integer — Output only. Indicates match rate for Customer Match lists. The range of this field is [0-100]. This will be null for other list types or when it's not possible to calculate the match rate. This field is read-only. - `integrationCode` string — An ID from external system. It is used by user list sellers to correlate IDs on their systems. - `resourceName` string — Immutable. The resource name of the user list. User list resource names have the form: `customers/{customer_id}/userLists/{user_list_id}` - `accessReason` 'UNSPECIFIED' | 'UNKNOWN' | 'OWNED' | 'SHARED' | 'LICENSED' | 'SUBSCRIBED' | 'AFFILIATED' — Output only. Indicates the reason this account has been granted access to the list. The reason can be SHARED, OWNED, LICENSED or SUBSCRIBED. This field is read-only. - `description` string — Description of this user list. - `crmBasedUserList` GoogleAdsSearchads360V23CommonCrmBasedUserListInfo — UserList of CRM users provided by the advertiser. - `appId` string — A string that uniquely identifies a mobile application from which the data was collected. For iOS, the ID string is the 9 digit string that appears at the end of an App Store URL (for example, "476943146" for "Flood-It! 2" whose App Store link is http://itunes.apple.com/us/app/flood-it!-2/id476943146). For Android, the ID string is the application's package name (for example, "com.labpixies.colordrips" for "Color Drips" given Google Play link https://play.google.com/store/apps/details?id=com.labpixies.colordrips). Required when creating CrmBasedUserList for uploading mobile advertising IDs. - `dataSourceType` 'UNSPECIFIED' | 'UNKNOWN' | 'FIRST_PARTY' | 'THIRD_PARTY_CREDIT_BUREAU' | 'THIRD_PARTY_VOTER_FILE' | 'THIRD_PARTY_PARTNER_DATA' — Data source of the list. Default value is FIRST_PARTY. Only customers on the allow-list can create third-party sourced CRM lists. - `uploadKeyType` 'UNSPECIFIED' | 'UNKNOWN' | 'CONTACT_INFO' | 'CRM_ID' | 'MOBILE_ADVERTISING_ID' — Matching key type of the list. Mixed data types are not allowed on the same list. This field is required for an ADD operation. - `logicalUserList` GoogleAdsSearchads360V23CommonLogicalUserListInfo — Represents a user list that is a custom combination of user lists. - `rules` GoogleAdsSearchads360V23CommonUserListLogicalRuleInfo[] — Logical list rules that define this user list. The rules are defined as a logical operator (ALL/ANY/NONE) and a list of user lists. All the rules are ANDed when they are evaluated. Required for creating a logical user list. - `operator` 'UNSPECIFIED' | 'UNKNOWN' | 'ALL' | 'ANY' | 'NONE' — The logical operator of the rule. - `ruleOperands` GoogleAdsSearchads360V23CommonLogicalUserListOperandInfo[] — The list of operands of the rule. - … - `eligibleForDisplay` boolean — Output only. Indicates this user list is eligible for Google Display Network. This field is read-only. - `id` string, int64 — Output only. Id of the user list. - `eligibleForSearch` boolean — Indicates if this user list is eligible for Google Search Network. - `similarUserList` GoogleAdsSearchads360V23CommonSimilarUserListInfo — SimilarUserList is a list of users which are similar to users from another UserList. These lists are read-only and automatically created by Google. - `seedUserList` string — Seed UserList from which this list is derived. - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `remove` string — Remove operation: A resource name for the removed user list is expected, in this format: `customers/{customer_id}/userLists/{user_list_id}` - `adGroupCustomizerOperation` GoogleAdsSearchads360V23ServicesAdGroupCustomizerOperation — A single operation (create, remove) on a customizer attribute. - `create` GoogleAdsSearchads360V23ResourcesAdGroupCustomizer — A customizer value for the associated CustomizerAttribute at the AdGroup level. - `resourceName` string — Immutable. The resource name of the ad group customizer. Ad group customizer resource names have the form: `customers/{customer_id}/adGroupCustomizers/{ad_group_id}~{customizer_attribute_id}` - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' — Output only. The status of the ad group customizer. - `adGroup` string — Immutable. The ad group to which the customizer attribute is linked. - `customizerAttribute` string — Required. Immutable. The customizer attribute which is linked to the ad group. - `value` GoogleAdsSearchads360V23CommonCustomizerValue — A customizer value that is referenced in customizer linkage entities like CustomerCustomizer, CampaignCustomizer, etc. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'TEXT' | 'NUMBER' | 'PRICE' | 'PERCENT' — Required. The data type for the customizer value. It must match the attribute type. The string_value content must match the constraints associated with the type. - `stringValue` string — Required. Value to insert in creative text. Customizer values of all types are stored as string to make formatting unambiguous. - `remove` string — Remove operation: A resource name for the removed ad group customizer is expected, in this format: `customers/{customer_id}/adGroupCustomizers/{ad_group_id}~{customizer_attribute_id}` - `customerNegativeCriterionOperation` GoogleAdsSearchads360V23ServicesCustomerNegativeCriterionOperation — A single operation (create or remove) on a customer level negative criterion. - `create` GoogleAdsSearchads360V23ResourcesCustomerNegativeCriterion — A negative criterion for exclusions at the customer level. - `ipBlock` GoogleAdsSearchads360V23CommonIpBlockInfo — An IpBlock criterion used for excluding IP addresses. We support excluding individual IP addresses or CIDR blocks. Create one IpBlockInfo criterion for each individual IP address or CIDR block you want to exclude. You can exclude up to 500 IP addresses per campaign. For more details, see [Exclude IP addresses](//support.google.com/google-ads/answer/2456098). IPv4 examples: * Individual address: 192.168.0.1 * Individual address as CIDR block: 192.168.0.1/32 * CIDR block: 192.168.0.0/24 IPv6 examples: * Individual address: 2001:db8:a0b:12f0::1 * Individual address as CIDR block: 2001:db8:a0b:12f0::1/128 * CIDR block: 2001:db8::/48 - `ipAddress` string — The IP address or the CIDR block to be excluded. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'KEYWORD' | 'PLACEMENT' | 'MOBILE_APP_CATEGORY' | 'MOBILE_APPLICATION' | 'DEVICE' | 'LOCATION' | 'LISTING_GROUP' | 'AD_SCHEDULE' | 'AGE_RANGE' | 'GENDER' | 'INCOME_RANGE' | 'PARENTAL_STATUS' | 'YOUTUBE_VIDEO' | 'YOUTUBE_CHANNEL' | 'USER_LIST' | 'PROXIMITY' | 'TOPIC' | 'LISTING_SCOPE' | 'LANGUAGE' | 'IP_BLOCK' | 'CONTENT_LABEL' | 'CARRIER' | 'USER_INTEREST' | 'WEBPAGE' | 'OPERATING_SYSTEM_VERSION' | 'APP_PAYMENT_MODEL' | 'MOBILE_DEVICE' | 'CUSTOM_AFFINITY' | 'CUSTOM_INTENT' | 'LOCATION_GROUP' | 'CUSTOM_AUDIENCE' | 'COMBINED_AUDIENCE' | 'KEYWORD_THEME' | 'AUDIENCE' | 'NEGATIVE_KEYWORD_LIST' | 'LOCAL_SERVICE_ID' | 'SEARCH_THEME' | 'BRAND' | 'BRAND_LIST' | 'LIFE_EVENT' | 'WEBPAGE_LIST' | 'VIDEO_LINEUP' | 'PLACEMENT_LIST' | 'VERTICAL_ADS_ITEM_GROUP_RULE_LIST' | 'VERTICAL_ADS_ITEM_GROUP_RULE' — Output only. The type of the criterion. - `mobileAppCategory` GoogleAdsSearchads360V23CommonMobileAppCategoryInfo — A mobile app category criterion. - `mobileAppCategoryConstant` string — The mobile app category constant resource name. - `resourceName` string — Immutable. The resource name of the customer negative criterion. Customer negative criterion resource names have the form: `customers/{customer_id}/customerNegativeCriteria/{criterion_id}` - `negativeKeywordList` GoogleAdsSearchads360V23CommonNegativeKeywordListInfo — A Negative Keyword List criterion. Represents a shared set of negative keywords that can be excluded at the account-level. Only one negative keyword list criterion can be attached per account. - `sharedSet` string — The NegativeKeywordListInfo shared set resource name. - `contentLabel` GoogleAdsSearchads360V23CommonContentLabelInfo — Content Label for category exclusion. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'SEXUALLY_SUGGESTIVE' | 'BELOW_THE_FOLD' | 'PARKED_DOMAIN' | 'JUVENILE' | 'PROFANITY' | 'TRAGEDY' | 'VIDEO' | 'VIDEO_RATING_DV_G' | 'VIDEO_RATING_DV_PG' | 'VIDEO_RATING_DV_T' | 'VIDEO_RATING_DV_MA' | 'VIDEO_NOT_YET_RATED' | 'EMBEDDED_VIDEO' | 'LIVE_STREAMING_VIDEO' | 'SOCIAL_ISSUES' | 'BRAND_SUITABILITY_CONTENT_FOR_FAMILIES' | 'BRAND_SUITABILITY_GAMES_FIGHTING' | 'BRAND_SUITABILITY_GAMES_MATURE' | 'BRAND_SUITABILITY_HEALTH_SENSITIVE' | 'BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED' | 'BRAND_SUITABILITY_NEWS_RECENT' | 'BRAND_SUITABILITY_NEWS_SENSITIVE' | 'BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED' | 'BRAND_SUITABILITY_POLITICS' | 'BRAND_SUITABILITY_RELIGION' — Content label type, required for CREATE operations. - `placement` GoogleAdsSearchads360V23CommonPlacementInfo — A placement criterion. This can be used to modify bids for sites when targeting the content network. - `url` string — URL of the placement. For example, "http://www.domain.com". - `youtubeChannel` GoogleAdsSearchads360V23CommonYouTubeChannelInfo — A YouTube Channel criterion. - `channelId` string — The YouTube uploader channel id or the channel code of a YouTube channel. - `youtubeVideo` GoogleAdsSearchads360V23CommonYouTubeVideoInfo — A YouTube Video criterion. - `videoId` string — YouTube video id as it appears on the YouTube watch page. - `mobileApplication` GoogleAdsSearchads360V23CommonMobileApplicationInfo — A mobile application criterion. - `appId` string — A string that uniquely identifies a mobile application to Google Ads API. The format of this string is "{platform}-{platform_native_id}", where platform is "1" for iOS apps and "2" for Android apps, and where platform_native_id is the mobile application identifier native to the corresponding platform. For iOS, this native identifier is the 9 digit string that appears at the end of an App Store URL (for example, "476943146" for "Flood-It! 2" whose App Store link is "http://itunes.apple.com/us/app/flood-it!-2/id476943146"). For Android, this native identifier is the application's package name (for example, "com.labpixies.colordrips" for "Color Drips" given Google Play link "https://play.google.com/store/apps/details?id=com.labpixies.colordrips"). A well formed app id for Google Ads API would thus be "1-476943146" for iOS and "2-com.labpixies.colordrips" for Android. This field is required and must be set in CREATE operations. - `name` string — Name of this mobile application. - `placementList` GoogleAdsSearchads360V23CommonPlacementListInfo — A Placement List criterion. Represents a shared set of placements that can be excluded at the account-level. - `sharedSet` string — The PlacementListInfo shared set resource name. - `id` string, int64 — Output only. The ID of the criterion. - `remove` string — Remove operation: A resource name for the removed criterion is expected, in this format: `customers/{customer_id}/customerNegativeCriteria/{criterion_id}` - `campaignAssetOperation` GoogleAdsSearchads360V23ServicesCampaignAssetOperation — A single operation (create, remove) on a campaign asset. - `remove` string — Remove operation: A resource name for the removed campaign asset is expected, in this format: `customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}` - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `create` GoogleAdsSearchads360V23ResourcesCampaignAsset — A link between a Campaign and an Asset. - `fieldType` 'UNSPECIFIED' | 'UNKNOWN' | 'HEADLINE' | 'DESCRIPTION' | 'MANDATORY_AD_TEXT' | 'MARKETING_IMAGE' | 'MEDIA_BUNDLE' | 'YOUTUBE_VIDEO' | 'BOOK_ON_GOOGLE' | 'LEAD_FORM' | 'PROMOTION' | 'CALLOUT' | 'STRUCTURED_SNIPPET' | 'SITELINK' | 'MOBILE_APP' | 'HOTEL_CALLOUT' | 'CALL' | 'PRICE' | 'LONG_HEADLINE' | 'BUSINESS_NAME' | 'SQUARE_MARKETING_IMAGE' | 'PORTRAIT_MARKETING_IMAGE' | 'LOGO' | 'LANDSCAPE_LOGO' | 'VIDEO' | 'CALL_TO_ACTION_SELECTION' | 'AD_IMAGE' | 'BUSINESS_LOGO' | 'HOTEL_PROPERTY' | 'DEMAND_GEN_CAROUSEL_CARD' | 'BUSINESS_MESSAGE' | 'TALL_PORTRAIT_MARKETING_IMAGE' | 'LANDING_PAGE_PREVIEW' | 'LONG_DESCRIPTION' | 'CALL_TO_ACTION' — Immutable. Role that the asset takes under the linked campaign. Required. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' | 'PAUSED' — Status of the campaign asset. - `campaign` string — Immutable. The campaign to which the asset is linked. - `primaryStatusDetails` GoogleAdsSearchads360V23CommonAssetLinkPrimaryStatusDetails[] — Output only. Provides the details of the primary status and its associated reasons. - `reason` 'UNSPECIFIED' | 'UNKNOWN' | 'ASSET_LINK_PAUSED' | 'ASSET_LINK_REMOVED' | 'ASSET_DISAPPROVED' | 'ASSET_UNDER_REVIEW' | 'ASSET_APPROVED_LABELED' — Provides the reason of this PrimaryStatus. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ELIGIBLE' | 'PAUSED' | 'REMOVED' | 'PENDING' | 'LIMITED' | 'NOT_ELIGIBLE' — Provides the PrimaryStatus of this status detail. - `assetDisapproved` GoogleAdsSearchads360V23CommonAssetDisapproved — Details related to AssetLinkPrimaryStatusReasonPB.ASSET_DISAPPROVED - `offlineEvaluationErrorReasons` string[] — Provides the quality evaluation disapproval reason of an asset. - `primaryStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'ELIGIBLE' | 'PAUSED' | 'REMOVED' | 'PENDING' | 'LIMITED' | 'NOT_ELIGIBLE' — Output only. Provides the PrimaryStatus of this asset link. Primary status is meant essentially to differentiate between the plain "status" field, which has advertiser set values of enabled, paused, or removed. The primary status takes into account other signals (for assets its mainly policy and quality approvals) to come up with a more comprehensive status to indicate its serving state. - `resourceName` string — Immutable. The resource name of the campaign asset. CampaignAsset resource names have the form: `customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}` - `primaryStatusReasons` string[] — Output only. Provides a list of reasons for why an asset is not serving or not serving at full capacity. - `source` 'UNSPECIFIED' | 'UNKNOWN' | 'ADVERTISER' | 'AUTOMATICALLY_CREATED' — Output only. Source of the campaign asset link. - `asset` string — Immutable. The asset which is linked to the campaign. - `update` GoogleAdsSearchads360V23ResourcesCampaignAsset — A link between a Campaign and an Asset. - `fieldType` 'UNSPECIFIED' | 'UNKNOWN' | 'HEADLINE' | 'DESCRIPTION' | 'MANDATORY_AD_TEXT' | 'MARKETING_IMAGE' | 'MEDIA_BUNDLE' | 'YOUTUBE_VIDEO' | 'BOOK_ON_GOOGLE' | 'LEAD_FORM' | 'PROMOTION' | 'CALLOUT' | 'STRUCTURED_SNIPPET' | 'SITELINK' | 'MOBILE_APP' | 'HOTEL_CALLOUT' | 'CALL' | 'PRICE' | 'LONG_HEADLINE' | 'BUSINESS_NAME' | 'SQUARE_MARKETING_IMAGE' | 'PORTRAIT_MARKETING_IMAGE' | 'LOGO' | 'LANDSCAPE_LOGO' | 'VIDEO' | 'CALL_TO_ACTION_SELECTION' | 'AD_IMAGE' | 'BUSINESS_LOGO' | 'HOTEL_PROPERTY' | 'DEMAND_GEN_CAROUSEL_CARD' | 'BUSINESS_MESSAGE' | 'TALL_PORTRAIT_MARKETING_IMAGE' | 'LANDING_PAGE_PREVIEW' | 'LONG_DESCRIPTION' | 'CALL_TO_ACTION' — Immutable. Role that the asset takes under the linked campaign. Required. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' | 'PAUSED' — Status of the campaign asset. - `campaign` string — Immutable. The campaign to which the asset is linked. - `primaryStatusDetails` GoogleAdsSearchads360V23CommonAssetLinkPrimaryStatusDetails[] — Output only. Provides the details of the primary status and its associated reasons. - `reason` 'UNSPECIFIED' | 'UNKNOWN' | 'ASSET_LINK_PAUSED' | 'ASSET_LINK_REMOVED' | 'ASSET_DISAPPROVED' | 'ASSET_UNDER_REVIEW' | 'ASSET_APPROVED_LABELED' — Provides the reason of this PrimaryStatus. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ELIGIBLE' | 'PAUSED' | 'REMOVED' | 'PENDING' | 'LIMITED' | 'NOT_ELIGIBLE' — Provides the PrimaryStatus of this status detail. - `assetDisapproved` GoogleAdsSearchads360V23CommonAssetDisapproved — Details related to AssetLinkPrimaryStatusReasonPB.ASSET_DISAPPROVED - `offlineEvaluationErrorReasons` string[] — Provides the quality evaluation disapproval reason of an asset. - `primaryStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'ELIGIBLE' | 'PAUSED' | 'REMOVED' | 'PENDING' | 'LIMITED' | 'NOT_ELIGIBLE' — Output only. Provides the PrimaryStatus of this asset link. Primary status is meant essentially to differentiate between the plain "status" field, which has advertiser set values of enabled, paused, or removed. The primary status takes into account other signals (for assets its mainly policy and quality approvals) to come up with a more comprehensive status to indicate its serving state. - `resourceName` string — Immutable. The resource name of the campaign asset. CampaignAsset resource names have the form: `customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}` - `primaryStatusReasons` string[] — Output only. Provides a list of reasons for why an asset is not serving or not serving at full capacity. - `source` 'UNSPECIFIED' | 'UNKNOWN' | 'ADVERTISER' | 'AUTOMATICALLY_CREATED' — Output only. Source of the campaign asset link. - `asset` string — Immutable. The asset which is linked to the campaign. - `adGroupOperation` GoogleAdsSearchads360V23ServicesAdGroupOperation — A single operation (create, update, remove) on an ad group. - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `remove` string — Remove operation: A resource name for the removed ad group is expected, in this format: `customers/{customer_id}/adGroups/{ad_group_id}` - `create` GoogleAdsSearchads360V23ResourcesAdGroup — An ad group. - `effectiveTargetCpcSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective target CPC. This field is read-only. - `engineId` string — Output only. ID of the ad group in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "ad_group.id" instead. - `effectiveTargetCpaSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective target CPA. This field is read-only. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'SEARCH_STANDARD' | 'DISPLAY_STANDARD' | 'SHOPPING_PRODUCT_ADS' | 'HOTEL_ADS' | 'SHOPPING_SMART_ADS' | 'VIDEO_BUMPER' | 'VIDEO_TRUE_VIEW_IN_STREAM' | 'VIDEO_TRUE_VIEW_IN_DISPLAY' | 'VIDEO_NON_SKIPPABLE_IN_STREAM' | 'SEARCH_DYNAMIC_ADS' | 'SHOPPING_COMPARISON_LISTING_ADS' | 'PROMOTED_HOTEL_ADS' | 'VIDEO_RESPONSIVE' | 'VIDEO_EFFICIENT_REACH' | 'SMART_CAMPAIGN_ADS' | 'TRAVEL_ADS' — Immutable. The type of the ad group. - `targetCpvMicros` string, int64 — Average amount in micros that the advertiser is willing to pay for every ad view. - `baseAdGroup` string — Output only. For draft or experiment ad groups, this field is the resource name of the base ad group from which this ad group was created. If a draft or experiment ad group does not have a base ad group, then this field is null. For base ad groups, this field equals the ad group resource name. This field is read-only. - `startDate` string — Output only. Date when this ad group starts serving ads. By default, the ad group starts now or the ad group's start date, whichever is later. If this field is set, then the ad group starts at the beginning of the specified date in the customer's time zone. This field is only available for Microsoft Advertising and Facebook gateway accounts. Format: YYYY-MM-DD Example: 2019-03-14 - `targetCpcMicros` string, int64 — Average amount in micros that the advertiser is willing to pay for every ad click. Overrides the target CPC configured at the campaign level. - `targetingSetting` GoogleAdsSearchads360V23CommonTargetingSetting — Settings for the targeting-related features, at the campaign and ad group levels. For more details about the targeting setting, visit https://support.google.com/google-ads/answer/7365594 - `targetRestrictions` GoogleAdsSearchads360V23CommonTargetRestriction[] — The per-targeting-dimension setting to restrict the reach of your campaign or ad group. - `bidOnly` boolean — Indicates whether to restrict your ads to show only for the criteria you have selected for this targeting_dimension, or to target all values for this targeting_dimension and show ads based on your targeting in other TargetingDimensions. A value of `true` means that these criteria will only apply bid modifiers, and not affect targeting. A value of `false` means that these criteria will restrict targeting as well as applying bid modifiers. - `targetingDimension` 'UNSPECIFIED' | 'UNKNOWN' | 'KEYWORD' | 'AUDIENCE' | 'TOPIC' | 'GENDER' | 'AGE_RANGE' | 'PLACEMENT' | 'PARENTAL_STATUS' | 'INCOME_RANGE' — The targeting dimension that these settings apply to. - `targetRestrictionOperations` GoogleAdsSearchads360V23CommonTargetRestrictionOperation[] — The list of operations changing the target restrictions. Adding a target restriction with a targeting dimension that already exists causes the existing target restriction to be replaced with the new value. - `operator` 'UNSPECIFIED' | 'UNKNOWN' | 'ADD' | 'REMOVE' — Type of list operation to perform. - `value` GoogleAdsSearchads360V23CommonTargetRestriction — The list of per-targeting-dimension targeting settings. - … - `effectiveTargetCpaMicros` string, int64 — Output only. The effective target CPA (cost-per-acquisition). This field is read-only. - `cpcBidMicros` string, int64 — The maximum CPC (cost-per-click) bid. This field is used when the ad group's effective bidding strategy is Manual CPC. This field is not applicable and will be ignored if the ad group's campaign is using a portfolio bidding strategy. - `demandGenAdGroupSettings` GoogleAdsSearchads360V23ResourcesAdGroupDemandGenAdGroupSettings — Settings for Demand Gen ad groups. - `channelControls` GoogleAdsSearchads360V23ResourcesAdGroupDemandGenAdGroupSettingsDemandGenChannelControls — Channel controls for Demand Gen ad groups. - `channelConfig` 'UNSPECIFIED' | 'UNKNOWN' | 'CHANNEL_STRATEGY' | 'SELECTED_CHANNELS' — Output only. Channel configuration reflecting which field in the oneof is populated. - `channelStrategy` 'UNSPECIFIED' | 'UNKNOWN' | 'ALL_CHANNELS' | 'ALL_OWNED_AND_OPERATED_CHANNELS' — High level channel strategy. - `selectedChannels` GoogleAdsSearchads360V23ResourcesAdGroupDemandGenAdGroupSettingsDemandGenChannelControlsDemandGenSelectedChannels — Explicitly selected channels for channel controls in Demand Gen ad groups. - … - `name` string — The name of the ad group. This field is required and should not be empty when creating new ad groups. It must contain fewer than 255 UTF-8 full-width characters. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. - `effectiveTargetRoasSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective target ROAS. This field is read-only. - `effectiveTargetCpc` string, int64 — Output only. The effective target CPC (cost-per-click). This field is read-only. - `primaryStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'ELIGIBLE' | 'PAUSED' | 'REMOVED' | 'PENDING' | 'NOT_ELIGIBLE' | 'LIMITED' — Output only. Provides aggregated view into why an ad group is not serving or not serving optimally. - `engineStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'AD_GROUP_ELIGIBLE' | 'AD_GROUP_EXPIRED' | 'AD_GROUP_REMOVED' | 'AD_GROUP_DRAFT' | 'AD_GROUP_PAUSED' | 'AD_GROUP_SERVING' | 'AD_GROUP_SUBMITTED' | 'CAMPAIGN_PAUSED' | 'ACCOUNT_PAUSED' — Output only. The Engine Status for ad group. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'PAUSED' | 'REMOVED' — The status of the ad group. - `trackingUrlTemplate` string — The URL template for constructing a tracking URL. - `effectiveTargetRoas` number, double — Output only. The effective target ROAS (return-on-ad-spend). This field is read-only. - `excludedParentAssetFieldTypes` string[] — The asset field types that should be excluded from this ad group. Asset links with these field types will not be inherited by this ad group from the upper levels. - `excludeDemographicExpansion` boolean — When this value is true, demographics will be excluded from the types of targeting which are expanded when optimized_targeting_enabled is true. When optimized_targeting_enabled is false, this field is ignored. Default is false. - `effectiveLabels` string[] — Output only. The resource names of effective labels attached to this ad group. An effective label is a label inherited or directly assigned to this ad group. - `audienceSetting` GoogleAdsSearchads360V23ResourcesAdGroupAudienceSetting — Settings for the audience targeting. - `useAudienceGrouped` boolean — Immutable. If true, this ad group uses an Audience resource for audience targeting. If false, this ad group may use audience segment criteria instead. - `targetCpaMicros` string, int64 — The target CPA (cost-per-acquisition). If the ad group's campaign bidding strategy is TargetCpa or MaximizeConversions (with its target_cpa field set), then this field overrides the target CPA specified in the campaign's bidding strategy. Otherwise, this value is ignored. - `fixedCpmMicros` string, int64 — The fixed amount in micros that the advertiser pays for every thousand impressions of the ad. - `optimizedTargetingEnabled` boolean — True if optimized targeting is enabled. Optimized Targeting is the replacement for Audience Expansion. - `targetRoas` number, double — The target ROAS (return-on-ad-spend) for this ad group. This field lets you override the target ROAS specified in the campaign's bidding strategy, but only if the campaign is using a standard (not portfolio) `TargetRoas` strategy or a standard `MaximizeConversionValue` strategy with its `target_roas` field set. If the campaign is using a portfolio bidding strategy, this field cannot be set and attempting to do so will result in an error. For any other bidding strategies, this value is ignored. To see the actual target ROAS being used by the ad group, considering potential overrides, query the `effective_target_roas` and `effective_target_roas_source` fields. - `aiMaxAdGroupSetting` GoogleAdsSearchads360V23ResourcesAdGroupAiMaxAdGroupSetting — Settings for AI Max feature in standard search adgroups. - `disableSearchTermMatching` boolean — Disable search term matching for this adgroup when AI Max is enabled. Search term matching uses broad match, asset-based, and landing page-based technology to improve reach. - `excludedParentAssetSetTypes` string[] — The asset set types that should be excluded from this ad group. Asset set links with these types will not be inherited by this ad group from the upper levels. Location group types (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, and STATIC_LOCATION_GROUP) are child types of LOCATION_SYNC. Therefore, if LOCATION_SYNC is set for this field, all location group asset sets are not allowed to be linked to this ad group, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this ad group. Only LOCATION_SYNC is currently supported. - `urlCustomParameters` GoogleAdsSearchads360V23CommonCustomParameter[] — The list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`. - `key` string — The key matching the parameter tag name. - `value` string — The value to be substituted. - `languageCode` string — Output only. The language of the ads and keywords in an ad group. This field is only available for Microsoft Advertising accounts. More details: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage - `finalUrlSuffix` string — URL template for appending params to Final URL. - `cpmBidMicros` string, int64 — The maximum CPM (cost-per-thousand viewable impressions) bid. - `verticalAdsFormatSetting` GoogleAdsSearchads360V23ResourcesAdGroupVerticalAdsFormatSetting — Vertical ads setting feature to enable/disable ad group format controls in search campaigns. - `enableVerticalPromotionAds` boolean — If true, vertical promotion ads will be enabled for this ad group. - `disableTextAds` boolean — If true, text ads will be disabled for this ad group. - `enableBookingLinks` boolean — If true, booking links will be enabled for this ad group. - `lastModifiedTime` string — Output only. The datetime when this ad group was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format. - `primaryStatusReasons` string[] — Output only. Provides reasons for why an ad group is not serving or not serving optimally. - `id` string, int64 — Output only. The ID of the ad group. - `percentCpcBidMicros` string, int64 — The percent cpc bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0,1) and the value stored here is 1,000,000 * [fraction]. - `endDate` string — Output only. Date when the ad group ends serving ads. By default, the ad group ends on the ad group's end date. If this field is set, then the ad group ends at the end of the specified date in the customer's time zone. This field is only available for Microsoft Advertising and Facebook gateway accounts. Format: YYYY-MM-DD Example: 2019-03-14 - `targetCpmMicros` string, int64 — Average amount in micros that the advertiser is willing to pay for every thousand times the ad is shown. - `resourceName` string — Immutable. The resource name of the ad group. Ad group resource names have the form: `customers/{customer_id}/adGroups/{ad_group_id}` - `cpvBidMicros` string, int64 — The CPV (cost-per-view) bid. - `campaign` string — Immutable. The campaign to which the ad group belongs. - `displayCustomBidDimension` 'UNSPECIFIED' | 'UNKNOWN' | 'KEYWORD' | 'AUDIENCE' | 'TOPIC' | 'GENDER' | 'AGE_RANGE' | 'PLACEMENT' | 'PARENTAL_STATUS' | 'INCOME_RANGE' — Lets advertisers specify a targeting dimension on which to place absolute bids. This is only applicable for campaigns that target only the display network and not search. - `labels` string[] — Output only. The resource names of labels attached to this ad group. - `effectiveCpcBidMicros` string, int64 — Output only. Value will be same as that of the CPC (cost-per-click) bid value when the bidding strategy is one of manual cpc, enhanced cpc, page one promoted or target outrank share, otherwise the value will be null. - `creationTime` string — Output only. The timestamp when this ad_group was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. - `adRotationMode` 'UNSPECIFIED' | 'UNKNOWN' | 'OPTIMIZE' | 'ROTATE_FOREVER' — The ad rotation mode of the ad group. - `update` GoogleAdsSearchads360V23ResourcesAdGroup — An ad group. - `effectiveTargetCpcSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective target CPC. This field is read-only. - `engineId` string — Output only. ID of the ad group in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "ad_group.id" instead. - `effectiveTargetCpaSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective target CPA. This field is read-only. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'SEARCH_STANDARD' | 'DISPLAY_STANDARD' | 'SHOPPING_PRODUCT_ADS' | 'HOTEL_ADS' | 'SHOPPING_SMART_ADS' | 'VIDEO_BUMPER' | 'VIDEO_TRUE_VIEW_IN_STREAM' | 'VIDEO_TRUE_VIEW_IN_DISPLAY' | 'VIDEO_NON_SKIPPABLE_IN_STREAM' | 'SEARCH_DYNAMIC_ADS' | 'SHOPPING_COMPARISON_LISTING_ADS' | 'PROMOTED_HOTEL_ADS' | 'VIDEO_RESPONSIVE' | 'VIDEO_EFFICIENT_REACH' | 'SMART_CAMPAIGN_ADS' | 'TRAVEL_ADS' — Immutable. The type of the ad group. - `targetCpvMicros` string, int64 — Average amount in micros that the advertiser is willing to pay for every ad view. - `baseAdGroup` string — Output only. For draft or experiment ad groups, this field is the resource name of the base ad group from which this ad group was created. If a draft or experiment ad group does not have a base ad group, then this field is null. For base ad groups, this field equals the ad group resource name. This field is read-only. - `startDate` string — Output only. Date when this ad group starts serving ads. By default, the ad group starts now or the ad group's start date, whichever is later. If this field is set, then the ad group starts at the beginning of the specified date in the customer's time zone. This field is only available for Microsoft Advertising and Facebook gateway accounts. Format: YYYY-MM-DD Example: 2019-03-14 - `targetCpcMicros` string, int64 — Average amount in micros that the advertiser is willing to pay for every ad click. Overrides the target CPC configured at the campaign level. - `targetingSetting` GoogleAdsSearchads360V23CommonTargetingSetting — Settings for the targeting-related features, at the campaign and ad group levels. For more details about the targeting setting, visit https://support.google.com/google-ads/answer/7365594 - `targetRestrictions` GoogleAdsSearchads360V23CommonTargetRestriction[] — The per-targeting-dimension setting to restrict the reach of your campaign or ad group. - `bidOnly` boolean — Indicates whether to restrict your ads to show only for the criteria you have selected for this targeting_dimension, or to target all values for this targeting_dimension and show ads based on your targeting in other TargetingDimensions. A value of `true` means that these criteria will only apply bid modifiers, and not affect targeting. A value of `false` means that these criteria will restrict targeting as well as applying bid modifiers. - `targetingDimension` 'UNSPECIFIED' | 'UNKNOWN' | 'KEYWORD' | 'AUDIENCE' | 'TOPIC' | 'GENDER' | 'AGE_RANGE' | 'PLACEMENT' | 'PARENTAL_STATUS' | 'INCOME_RANGE' — The targeting dimension that these settings apply to. - `targetRestrictionOperations` GoogleAdsSearchads360V23CommonTargetRestrictionOperation[] — The list of operations changing the target restrictions. Adding a target restriction with a targeting dimension that already exists causes the existing target restriction to be replaced with the new value. - `operator` 'UNSPECIFIED' | 'UNKNOWN' | 'ADD' | 'REMOVE' — Type of list operation to perform. - `value` GoogleAdsSearchads360V23CommonTargetRestriction — The list of per-targeting-dimension targeting settings. - … - `effectiveTargetCpaMicros` string, int64 — Output only. The effective target CPA (cost-per-acquisition). This field is read-only. - `cpcBidMicros` string, int64 — The maximum CPC (cost-per-click) bid. This field is used when the ad group's effective bidding strategy is Manual CPC. This field is not applicable and will be ignored if the ad group's campaign is using a portfolio bidding strategy. - `demandGenAdGroupSettings` GoogleAdsSearchads360V23ResourcesAdGroupDemandGenAdGroupSettings — Settings for Demand Gen ad groups. - `channelControls` GoogleAdsSearchads360V23ResourcesAdGroupDemandGenAdGroupSettingsDemandGenChannelControls — Channel controls for Demand Gen ad groups. - `channelConfig` 'UNSPECIFIED' | 'UNKNOWN' | 'CHANNEL_STRATEGY' | 'SELECTED_CHANNELS' — Output only. Channel configuration reflecting which field in the oneof is populated. - `channelStrategy` 'UNSPECIFIED' | 'UNKNOWN' | 'ALL_CHANNELS' | 'ALL_OWNED_AND_OPERATED_CHANNELS' — High level channel strategy. - `selectedChannels` GoogleAdsSearchads360V23ResourcesAdGroupDemandGenAdGroupSettingsDemandGenChannelControlsDemandGenSelectedChannels — Explicitly selected channels for channel controls in Demand Gen ad groups. - … - `name` string — The name of the ad group. This field is required and should not be empty when creating new ad groups. It must contain fewer than 255 UTF-8 full-width characters. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. - `effectiveTargetRoasSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective target ROAS. This field is read-only. - `effectiveTargetCpc` string, int64 — Output only. The effective target CPC (cost-per-click). This field is read-only. - `primaryStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'ELIGIBLE' | 'PAUSED' | 'REMOVED' | 'PENDING' | 'NOT_ELIGIBLE' | 'LIMITED' — Output only. Provides aggregated view into why an ad group is not serving or not serving optimally. - `engineStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'AD_GROUP_ELIGIBLE' | 'AD_GROUP_EXPIRED' | 'AD_GROUP_REMOVED' | 'AD_GROUP_DRAFT' | 'AD_GROUP_PAUSED' | 'AD_GROUP_SERVING' | 'AD_GROUP_SUBMITTED' | 'CAMPAIGN_PAUSED' | 'ACCOUNT_PAUSED' — Output only. The Engine Status for ad group. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'PAUSED' | 'REMOVED' — The status of the ad group. - `trackingUrlTemplate` string — The URL template for constructing a tracking URL. - `effectiveTargetRoas` number, double — Output only. The effective target ROAS (return-on-ad-spend). This field is read-only. - `excludedParentAssetFieldTypes` string[] — The asset field types that should be excluded from this ad group. Asset links with these field types will not be inherited by this ad group from the upper levels. - `excludeDemographicExpansion` boolean — When this value is true, demographics will be excluded from the types of targeting which are expanded when optimized_targeting_enabled is true. When optimized_targeting_enabled is false, this field is ignored. Default is false. - `effectiveLabels` string[] — Output only. The resource names of effective labels attached to this ad group. An effective label is a label inherited or directly assigned to this ad group. - `audienceSetting` GoogleAdsSearchads360V23ResourcesAdGroupAudienceSetting — Settings for the audience targeting. - `useAudienceGrouped` boolean — Immutable. If true, this ad group uses an Audience resource for audience targeting. If false, this ad group may use audience segment criteria instead. - `targetCpaMicros` string, int64 — The target CPA (cost-per-acquisition). If the ad group's campaign bidding strategy is TargetCpa or MaximizeConversions (with its target_cpa field set), then this field overrides the target CPA specified in the campaign's bidding strategy. Otherwise, this value is ignored. - `fixedCpmMicros` string, int64 — The fixed amount in micros that the advertiser pays for every thousand impressions of the ad. - `optimizedTargetingEnabled` boolean — True if optimized targeting is enabled. Optimized Targeting is the replacement for Audience Expansion. - `targetRoas` number, double — The target ROAS (return-on-ad-spend) for this ad group. This field lets you override the target ROAS specified in the campaign's bidding strategy, but only if the campaign is using a standard (not portfolio) `TargetRoas` strategy or a standard `MaximizeConversionValue` strategy with its `target_roas` field set. If the campaign is using a portfolio bidding strategy, this field cannot be set and attempting to do so will result in an error. For any other bidding strategies, this value is ignored. To see the actual target ROAS being used by the ad group, considering potential overrides, query the `effective_target_roas` and `effective_target_roas_source` fields. - `aiMaxAdGroupSetting` GoogleAdsSearchads360V23ResourcesAdGroupAiMaxAdGroupSetting — Settings for AI Max feature in standard search adgroups. - `disableSearchTermMatching` boolean — Disable search term matching for this adgroup when AI Max is enabled. Search term matching uses broad match, asset-based, and landing page-based technology to improve reach. - … truncated; see the full OpenAPI document linked below ## Response `200` Successful response --- [API](https://skmtc.net/google/apis/searchads360.md) · [All operations](https://skmtc.net/google/apis/searchads360/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/searchads360/revisions/40d087435afd/schema)