addOperations(resourceName, body=None, x__xgafv=None)

Add operations to the batch job. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [BatchJobError]() [HeaderError]() [InternalError]() [QuotaError]() [RequestError]() [ResourceCountLimitExceededError]()

Args:
resourceName: string, Required. The resource name of the batch job. (required)
body: object, The request body.
The object takes the form of:

{ # Request message for BatchJobService.AddBatchJobOperations.
"mutateOperations": [ # Required. The list of mutates being added. Operations can use negative integers as temp ids to signify dependencies between entities created in this batch job. For example, a customer with id = 1234 can create a campaign and an ad group in that same campaign by creating a campaign in the first operation with the resource name explicitly set to "customers/1234/campaigns/-1", and creating an ad group in the second operation with the campaign field also set to "customers/1234/campaigns/-1".
{ # A single operation (create, update, remove) on a resource.
"adGroupAdLabelOperation": { # A single operation (create, remove) on an ad group ad label. # An ad group ad label mutate operation.
"create": { # A relationship between an ad group ad and a label. # Create operation: No resource name is expected for the new ad group ad label.
"adGroupAd": "A String", # Immutable. The ad group ad to which the label is attached.
"label": "A String", # Immutable. The label assigned to the ad group ad.
"ownerCustomerId": "A String", # Output only. The ID of the Customer which owns the label.
"resourceName": "A String", # Immutable. The resource name of the ad group ad label. Ad group ad label resource names have the form: `customers/{owner_customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}`
},
"remove": "A String", # Remove operation: A resource name for the ad group ad label being removed, in this format: `customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}`
},
"adGroupAdOperation": { # A single operation (create, update, remove) on an ad group ad. # An ad group ad mutate operation.
"create": { # An ad group ad. # Create operation: No resource name is expected for the new ad.
"actionItems": [ # 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.".
"A String",
],
"ad": { # An ad. # Immutable. The ad.
"addedByGoogleAds": True or False, # 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.
"appAd": { # An app ad. # Details pertaining to an app ad.
"appDeepLink": { # An app deep link used inside an ad. # An app deep link asset that may be used with the ad.
"asset": "A String", # The Asset resource name of this app deep link asset.
},
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"html5MediaBundles": [ # List of media bundle assets that may be used with the ad.
{ # A media bundle asset used inside an ad.
"asset": "A String", # The Asset resource name of this media bundle.
},
],
"images": [ # List of image assets that may be displayed with the ad.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"mandatoryAdText": { # A text asset used inside an ad. # Mandatory ad text.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"youtubeVideos": [ # List of YouTube video assets that may be displayed with the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"appEngagementAd": { # 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. # Details pertaining to an app engagement ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"images": [ # List of image assets that may be displayed with the ad.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"videos": [ # List of video assets that may be displayed with the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"appPreRegistrationAd": { # 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. # Details pertaining to an app pre-registration ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"images": [ # List of image asset IDs whose images may be displayed with the ad.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"youtubeVideos": [ # List of YouTube video asset IDs whose videos may be displayed with the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"demandGenCarouselAd": { # A Demand Gen carousel ad. # Details pertaining to a Demand Gen carousel ad.
"businessName": "A String", # Required. The Advertiser/brand name.
"callToActionText": "A String", # Call to action text.
"carouselCards": [ # Required. Carousel cards that will display with the ad. Min 2 max 10.
{ # A Demand Gen carousel card asset used inside an ad.
"asset": "A String", # The Asset resource name of this discovery carousel card.
},
],
"description": { # A text asset used inside an ad. # Required. The descriptive text of the ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"headline": { # A text asset used inside an ad. # Required. Headline of the ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"logoImage": { # An image asset used inside an ad. # Required. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%).
"asset": "A String", # The Asset resource name of this image.
},
},
"demandGenMultiAssetAd": { # A Demand Gen multi asset ad. # Details pertaining to a Demand Gen multi asset ad.
"businessName": "A String", # The Advertiser/brand name. Maximum display width is 25. Required.
"callToActionText": "A String", # Call to action text.
"descriptions": [ # The descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # Headline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"marketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"portraitMarketingImages": [ # 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%).
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"squareMarketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"tallPortraitMarketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
},
"demandGenProductAd": { # A Demand Gen product ad. # Details pertaining to a Demand Gen product ad.
"breadcrumb1": "A String", # First part of text that appears in the ad with the displayed URL.
"breadcrumb2": "A String", # Second part of text that appears in the ad with the displayed URL.
"businessName": { # A text asset used inside an ad. # Required. The advertiser/brand name.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"callToAction": { # A call to action asset used inside an ad. # Asset of type CallToActionAsset used for the "Call To Action" button.
"asset": "A String", # The Asset resource name of this call to action asset.
},
"description": { # A text asset used inside an ad. # Required. Text asset used for the description.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"headline": { # A text asset used inside an ad. # Required. Text asset used for the short headline.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"logoImage": { # An image asset used inside an ad. # Required. 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%).
"asset": "A String", # The Asset resource name of this image.
},
},
"demandGenVideoResponsiveAd": { # A Demand Gen video responsive ad. # Details pertaining to a Demand Gen video responsive ad.
"breadcrumb1": "A String", # First part of text that appears in the ad with the displayed URL.
"breadcrumb2": "A String", # Second part of text that appears in the ad with the displayed URL.
"businessName": { # A text asset used inside an ad. # Required. The advertiser/brand name.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"callToActions": [ # Assets of type CallToActionAsset used for the "Call To Action" button.
{ # A call to action asset used inside an ad.
"asset": "A String", # The Asset resource name of this call to action asset.
},
],
"companionBanners": [ # List of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"descriptions": [ # List of text assets used for the description.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets used for the short headline.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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%).
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"longHeadlines": [ # List of text assets used for the long headline.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"videos": [ # List of YouTube video assets used for the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"devicePreference": "A String", # 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.
"displayUploadAd": { # 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. # Details pertaining to a display upload ad.
"displayUploadProductType": "A String", # The product type of this ad. See comments on the enum for details.
"mediaBundle": { # A media bundle asset used inside an ad. # A media bundle asset to be used in the ad. For information about the media bundle for HTML5_UPLOAD_AD, see https://support.google.com/google-ads/answer/1722096 Media bundles that are part of dynamic product types use a special format that needs to be created through the Google Web Designer. See https://support.google.com/webdesigner/answer/7543898 for more information.
"asset": "A String", # The Asset resource name of this media bundle.
},
},
"displayUrl": "A String", # The URL that appears in the ad description for some ad formats.
"expandedDynamicSearchAd": { # An expanded dynamic search ad. # Immutable. Details pertaining to an Expanded Dynamic Search Ad. This type of ad has its headline, final URLs, and display URL auto-generated at serving time according to domain name specific information provided by `dynamic_search_ads_setting` linked at the campaign level.
"description": "A String", # The description of the ad.
"description2": "A String", # The second description of the ad.
},
"expandedTextAd": { # An expanded text ad. # Details pertaining to an expanded text ad.
"description": "A String", # The description of the ad.
"description2": "A String", # The second description of the ad.
"headlinePart1": "A String", # The first part of the ad's headline.
"headlinePart2": "A String", # The second part of the ad's headline.
"headlinePart3": "A String", # The third part of the ad's headline.
"path1": "A String", # The text that can appear alongside the ad's displayed URL.
"path2": "A String", # Additional text that can appear alongside the ad's displayed URL.
},
"finalAppUrls": [ # A list of final app URLs that will be used on mobile if the user has the specific app installed.
{ # A URL for deep linking into an app for the given operating system.
"osType": "A String", # The operating system targeted by this URL. Required.
"url": "A 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.
},
],
"finalMobileUrls": [ # The list of possible final mobile URLs after all cross-domain redirects for the ad.
"A String",
],
"finalUrlSuffix": "A String", # The suffix to use when constructing a final URL.
"finalUrls": [ # The list of possible final URLs after all cross-domain redirects for the ad.
"A String",
],
"hotelAd": { # A hotel ad. # Details pertaining to a hotel ad.
},
"id": "A String", # Output only. The ID of the ad.
"imageAd": { # An image ad. # Immutable. Details pertaining to an Image ad.
"adIdToCopyImageFrom": "A String", # An ad ID to copy the image from.
"data": "A String", # Raw image data as bytes.
"imageAsset": { # An image asset used inside an ad. # The image assets used for the ad.
"asset": "A String", # The Asset resource name of this image.
},
"imageUrl": "A String", # URL of the full size image.
"mimeType": "A String", # The mime type of the image.
"name": "A 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.
"pixelHeight": "A String", # Height in pixels of the full size image.
"pixelWidth": "A String", # Width in pixels of the full size image.
"previewImageUrl": "A String", # URL of the preview size image.
"previewPixelHeight": "A String", # Height in pixels of the preview size image.
"previewPixelWidth": "A String", # Width in pixels of the preview size image.
},
"legacyAppInstallAd": { # A legacy app install ad that only can be used by a few select customers. # Immutable. Details pertaining to a legacy app install ad.
"appId": "A String", # The ID of the mobile app.
"appStore": "A String", # The app store the mobile app is available in.
"description1": "A String", # The first description line of the ad.
"description2": "A String", # The second description line of the ad.
"headline": "A String", # The headline of the ad.
},
"legacyResponsiveDisplayAd": { # A legacy responsive display ad. Ads of this type are labeled 'Responsive ads' in the Google Ads UI. # Details pertaining to a legacy responsive display ad.
"accentColor": "A 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.
"allowFlexibleColor": True or False, # 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.
"businessName": "A String", # The business name in the ad.
"callToActionText": "A String", # The call-to-action text for the ad.
"description": "A String", # The description of the ad.
"formatSetting": "A String", # Specifies which format the ad will be served in. Default is ALL_FORMATS.
"logoImage": "A String", # The MediaFile resource name of the logo image used in the ad.
"longHeadline": "A String", # The long version of the ad's headline.
"mainColor": "A 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.
"marketingImage": "A String", # The MediaFile resource name of the marketing image used in the ad.
"pricePrefix": "A String", # Prefix before price. For example, 'as low as'.
"promoText": "A String", # Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
"shortHeadline": "A String", # The short version of the ad's headline.
"squareLogoImage": "A String", # The MediaFile resource name of the square logo image used in the ad.
"squareMarketingImage": "A String", # The MediaFile resource name of the square marketing image used in the ad.
},
"localAd": { # A local ad. # Details pertaining to a local ad.
"callToActions": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"descriptions": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"marketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"path1": "A String", # First part of optional text that can be appended to the URL in the ad.
"path2": "A 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.
"videos": [ # List of YouTube video assets that may be displayed with the ad. At least 1 and at most 20 video assets must be specified.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"name": "A 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.
"productAd": { # A Search Ads 360 product ad. # Immutable. Details pertaining to a product ad.
},
"resourceName": "A String", # Immutable. The resource name of the ad. Ad resource names have the form: `customers/{customer_id}/ads/{ad_id}`
"responsiveDisplayAd": { # A responsive display ad. # Details pertaining to a responsive display ad.
"accentColor": "A 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.
"allowFlexibleColor": True or False, # 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.
"businessName": "A String", # The advertiser/brand name. Maximum display width is 25.
"callToActionText": "A String", # The call-to-action text for the ad. Maximum display width is 30.
"controlSpec": { # Specification for various creative controls for a responsive display ad. # Specification for various creative controls.
"enableAssetEnhancements": True or False, # Whether the advertiser has opted into the asset enhancements feature.
"enableAutogenVideo": True or False, # Whether the advertiser has opted into auto-gen video feature.
},
"descriptions": [ # Descriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"formatSetting": "A String", # Specifies which format the ad will be served in. Default is ALL_FORMATS.
"headlines": [ # Short format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"longHeadline": { # A text asset used inside an ad. # A required long format headline. The maximum length is 90 characters.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"mainColor": "A 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.
"marketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"pricePrefix": "A String", # Prefix before price. For example, 'as low as'.
"promoText": "A String", # Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
"squareLogoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"squareMarketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"youtubeVideos": [ # Optional YouTube videos for the ad. A maximum of 5 videos can be specified.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"responsiveSearchAd": { # 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 # Details pertaining to a responsive search ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"path1": "A String", # First part of text that can be appended to the URL in the ad.
"path2": "A 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.
},
"searchAds360ExpandedDynamicSearchAd": { # An expanded dynamic search ad. # Immutable. Details pertaining to an expanded dynamic search ad.
"adTrackingId": "A String", # The tracking id of the ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
},
"searchAds360ExpandedTextAd": { # A Search Ads 360 expanded text ad. # Immutable. Details pertaining to an expanded text ad.
"adTrackingId": "A String", # The tracking id of the ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
"headline": "A String", # The headline of the ad.
"headline2": "A String", # The second headline of the ad.
"headline3": "A String", # The third headline of the ad.
"path1": "A String", # Text appended to the auto-generated visible URL with a delimiter.
"path2": "A String", # Text appended to path1 with a delimiter.
},
"searchAds360ResponsiveSearchAd": { # A Search Ads 360 responsive search ad. # Immutable. Details pertaining to a responsive search ad.
"adTrackingId": "A String", # The tracking id of the ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"path1": "A String", # Text appended to the auto-generated visible URL with a delimiter.
"path2": "A String", # Text appended to path1 with a delimiter.
},
"searchAds360TextAd": { # A Search Ads 360 text ad. # Immutable. Details pertaining to a text ad.
"adTrackingId": "A String", # The tracking id of the ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
"displayMobileUrl": "A String", # The displayed mobile URL of the ad.
"displayUrl": "A String", # The displayed URL of the ad.
"headline": "A String", # The headline of the ad.
},
"shoppingComparisonListingAd": { # A Shopping Comparison Listing ad. # Details pertaining to a Shopping Comparison Listing ad.
"headline": "A String", # Headline of the ad. This field is required. Allowed length is between 25 and 45 characters.
},
"shoppingProductAd": { # A standard Shopping ad. # Details pertaining to a Shopping product ad.
},
"shoppingSmartAd": { # A Smart Shopping ad. # Details pertaining to a Smart Shopping ad.
},
"smartCampaignAd": { # A Smart campaign ad. # Details pertaining to a Smart campaign ad.
"descriptions": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
},
"systemManagedResourceSource": "A String", # Output only. If this ad is system managed, then this field will indicate the source. This field is read-only.
"textAd": { # A text ad. # Immutable. Details pertaining to a text ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
"headline": "A String", # The headline of the ad.
},
"trackingUrlTemplate": "A String", # The URL template for constructing a tracking URL.
"travelAd": { # A travel ad. # Details pertaining to a travel ad.
},
"type": "A String", # Output only. The type of ad.
"urlCollections": [ # Additional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad.
{ # Collection of urls that is tagged with a unique identifier.
"finalMobileUrls": [ # A list of possible final mobile URLs.
"A String",
],
"finalUrls": [ # A list of possible final URLs.
"A String",
],
"trackingUrlTemplate": "A String", # URL template for constructing a tracking URL.
"urlCollectionId": "A String", # Unique identifier for this UrlCollection instance.
},
],
"urlCustomParameters": [ # 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.
{ # A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
"key": "A String", # The key matching the parameter tag name.
"value": "A String", # The value to be substituted.
},
],
},
"adGroup": "A String", # Immutable. The ad group to which the ad belongs.
"adGroupAdAssetAutomationSettings": [ # Settings that control the types of asset automation. See the AssetAutomationTypeEnum documentation for the default opt in/out behavior of each type.
{ # Asset automation setting for an AdGroupAd.
"assetAutomationStatus": "A String", # The opt-in/out status for the specified asset automation type.
"assetAutomationType": "A String", # The asset automation type that this setting configures.
},
],
"adStrength": "A String", # Output only. Overall ad strength for this ad group ad.
"creationTime": "A 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.
"effectiveLabels": [ # 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.
"A String",
],
"engineId": "A 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.
"engineStatus": "A String", # 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.
"labels": [ # Output only. The resource names of labels attached to this ad group ad.
"A String",
],
"lastModifiedTime": "A 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.
"policySummary": { # Contains policy information for an ad. # Output only. Policy information for the ad.
"approvalStatus": "A String", # Output only. The overall approval status of this ad, calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # Output only. The list of policy findings for this ad.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Output only. Where in the review process this ad is.
},
"primaryStatus": "A String", # Output only. Provides aggregated view into why an ad group ad is not serving or not serving optimally.
"primaryStatusReasons": [ # Output only. Provides reasons for why an ad group ad is not serving or not serving optimally.
"A String",
],
"resourceName": "A 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}`
"status": "A String", # The status of the ad.
},
"policyValidationParameter": { # Parameter for controlling how policy exemption is done. # Configuration for how policies are validated.
"exemptPolicyViolationKeys": [ # 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.
{ # Key of the violation. The key is used for referring to a violation when filing an exemption request.
"policyName": "A String", # Unique ID of the violated policy.
"violatingText": "A 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.
},
],
"ignorablePolicyTopics": [ # 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.
"A String",
],
},
"remove": "A String", # Remove operation: A resource name for the removed ad is expected, in this format: `customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}`
"update": { # An ad group ad. # Update operation: The ad is expected to have a valid resource name.
"actionItems": [ # 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.".
"A String",
],
"ad": { # An ad. # Immutable. The ad.
"addedByGoogleAds": True or False, # 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.
"appAd": { # An app ad. # Details pertaining to an app ad.
"appDeepLink": { # An app deep link used inside an ad. # An app deep link asset that may be used with the ad.
"asset": "A String", # The Asset resource name of this app deep link asset.
},
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"html5MediaBundles": [ # List of media bundle assets that may be used with the ad.
{ # A media bundle asset used inside an ad.
"asset": "A String", # The Asset resource name of this media bundle.
},
],
"images": [ # List of image assets that may be displayed with the ad.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"mandatoryAdText": { # A text asset used inside an ad. # Mandatory ad text.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"youtubeVideos": [ # List of YouTube video assets that may be displayed with the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"appEngagementAd": { # 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. # Details pertaining to an app engagement ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"images": [ # List of image assets that may be displayed with the ad.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"videos": [ # List of video assets that may be displayed with the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"appPreRegistrationAd": { # 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. # Details pertaining to an app pre-registration ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"images": [ # List of image asset IDs whose images may be displayed with the ad.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"youtubeVideos": [ # List of YouTube video asset IDs whose videos may be displayed with the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"demandGenCarouselAd": { # A Demand Gen carousel ad. # Details pertaining to a Demand Gen carousel ad.
"businessName": "A String", # Required. The Advertiser/brand name.
"callToActionText": "A String", # Call to action text.
"carouselCards": [ # Required. Carousel cards that will display with the ad. Min 2 max 10.
{ # A Demand Gen carousel card asset used inside an ad.
"asset": "A String", # The Asset resource name of this discovery carousel card.
},
],
"description": { # A text asset used inside an ad. # Required. The descriptive text of the ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"headline": { # A text asset used inside an ad. # Required. Headline of the ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"logoImage": { # An image asset used inside an ad. # Required. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%).
"asset": "A String", # The Asset resource name of this image.
},
},
"demandGenMultiAssetAd": { # A Demand Gen multi asset ad. # Details pertaining to a Demand Gen multi asset ad.
"businessName": "A String", # The Advertiser/brand name. Maximum display width is 25. Required.
"callToActionText": "A String", # Call to action text.
"descriptions": [ # The descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # Headline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"marketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"portraitMarketingImages": [ # 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%).
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"squareMarketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"tallPortraitMarketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
},
"demandGenProductAd": { # A Demand Gen product ad. # Details pertaining to a Demand Gen product ad.
"breadcrumb1": "A String", # First part of text that appears in the ad with the displayed URL.
"breadcrumb2": "A String", # Second part of text that appears in the ad with the displayed URL.
"businessName": { # A text asset used inside an ad. # Required. The advertiser/brand name.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"callToAction": { # A call to action asset used inside an ad. # Asset of type CallToActionAsset used for the "Call To Action" button.
"asset": "A String", # The Asset resource name of this call to action asset.
},
"description": { # A text asset used inside an ad. # Required. Text asset used for the description.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"headline": { # A text asset used inside an ad. # Required. Text asset used for the short headline.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"logoImage": { # An image asset used inside an ad. # Required. 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%).
"asset": "A String", # The Asset resource name of this image.
},
},
"demandGenVideoResponsiveAd": { # A Demand Gen video responsive ad. # Details pertaining to a Demand Gen video responsive ad.
"breadcrumb1": "A String", # First part of text that appears in the ad with the displayed URL.
"breadcrumb2": "A String", # Second part of text that appears in the ad with the displayed URL.
"businessName": { # A text asset used inside an ad. # Required. The advertiser/brand name.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"callToActions": [ # Assets of type CallToActionAsset used for the "Call To Action" button.
{ # A call to action asset used inside an ad.
"asset": "A String", # The Asset resource name of this call to action asset.
},
],
"companionBanners": [ # List of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"descriptions": [ # List of text assets used for the description.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets used for the short headline.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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%).
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"longHeadlines": [ # List of text assets used for the long headline.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"videos": [ # List of YouTube video assets used for the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"devicePreference": "A String", # 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.
"displayUploadAd": { # 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. # Details pertaining to a display upload ad.
"displayUploadProductType": "A String", # The product type of this ad. See comments on the enum for details.
"mediaBundle": { # A media bundle asset used inside an ad. # A media bundle asset to be used in the ad. For information about the media bundle for HTML5_UPLOAD_AD, see https://support.google.com/google-ads/answer/1722096 Media bundles that are part of dynamic product types use a special format that needs to be created through the Google Web Designer. See https://support.google.com/webdesigner/answer/7543898 for more information.
"asset": "A String", # The Asset resource name of this media bundle.
},
},
"displayUrl": "A String", # The URL that appears in the ad description for some ad formats.
"expandedDynamicSearchAd": { # An expanded dynamic search ad. # Immutable. Details pertaining to an Expanded Dynamic Search Ad. This type of ad has its headline, final URLs, and display URL auto-generated at serving time according to domain name specific information provided by `dynamic_search_ads_setting` linked at the campaign level.
"description": "A String", # The description of the ad.
"description2": "A String", # The second description of the ad.
},
"expandedTextAd": { # An expanded text ad. # Details pertaining to an expanded text ad.
"description": "A String", # The description of the ad.
"description2": "A String", # The second description of the ad.
"headlinePart1": "A String", # The first part of the ad's headline.
"headlinePart2": "A String", # The second part of the ad's headline.
"headlinePart3": "A String", # The third part of the ad's headline.
"path1": "A String", # The text that can appear alongside the ad's displayed URL.
"path2": "A String", # Additional text that can appear alongside the ad's displayed URL.
},
"finalAppUrls": [ # A list of final app URLs that will be used on mobile if the user has the specific app installed.
{ # A URL for deep linking into an app for the given operating system.
"osType": "A String", # The operating system targeted by this URL. Required.
"url": "A 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.
},
],
"finalMobileUrls": [ # The list of possible final mobile URLs after all cross-domain redirects for the ad.
"A String",
],
"finalUrlSuffix": "A String", # The suffix to use when constructing a final URL.
"finalUrls": [ # The list of possible final URLs after all cross-domain redirects for the ad.
"A String",
],
"hotelAd": { # A hotel ad. # Details pertaining to a hotel ad.
},
"id": "A String", # Output only. The ID of the ad.
"imageAd": { # An image ad. # Immutable. Details pertaining to an Image ad.
"adIdToCopyImageFrom": "A String", # An ad ID to copy the image from.
"data": "A String", # Raw image data as bytes.
"imageAsset": { # An image asset used inside an ad. # The image assets used for the ad.
"asset": "A String", # The Asset resource name of this image.
},
"imageUrl": "A String", # URL of the full size image.
"mimeType": "A String", # The mime type of the image.
"name": "A 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.
"pixelHeight": "A String", # Height in pixels of the full size image.
"pixelWidth": "A String", # Width in pixels of the full size image.
"previewImageUrl": "A String", # URL of the preview size image.
"previewPixelHeight": "A String", # Height in pixels of the preview size image.
"previewPixelWidth": "A String", # Width in pixels of the preview size image.
},
"legacyAppInstallAd": { # A legacy app install ad that only can be used by a few select customers. # Immutable. Details pertaining to a legacy app install ad.
"appId": "A String", # The ID of the mobile app.
"appStore": "A String", # The app store the mobile app is available in.
"description1": "A String", # The first description line of the ad.
"description2": "A String", # The second description line of the ad.
"headline": "A String", # The headline of the ad.
},
"legacyResponsiveDisplayAd": { # A legacy responsive display ad. Ads of this type are labeled 'Responsive ads' in the Google Ads UI. # Details pertaining to a legacy responsive display ad.
"accentColor": "A 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.
"allowFlexibleColor": True or False, # 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.
"businessName": "A String", # The business name in the ad.
"callToActionText": "A String", # The call-to-action text for the ad.
"description": "A String", # The description of the ad.
"formatSetting": "A String", # Specifies which format the ad will be served in. Default is ALL_FORMATS.
"logoImage": "A String", # The MediaFile resource name of the logo image used in the ad.
"longHeadline": "A String", # The long version of the ad's headline.
"mainColor": "A 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.
"marketingImage": "A String", # The MediaFile resource name of the marketing image used in the ad.
"pricePrefix": "A String", # Prefix before price. For example, 'as low as'.
"promoText": "A String", # Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
"shortHeadline": "A String", # The short version of the ad's headline.
"squareLogoImage": "A String", # The MediaFile resource name of the square logo image used in the ad.
"squareMarketingImage": "A String", # The MediaFile resource name of the square marketing image used in the ad.
},
"localAd": { # A local ad. # Details pertaining to a local ad.
"callToActions": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"descriptions": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"marketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"path1": "A String", # First part of optional text that can be appended to the URL in the ad.
"path2": "A 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.
"videos": [ # List of YouTube video assets that may be displayed with the ad. At least 1 and at most 20 video assets must be specified.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"name": "A 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.
"productAd": { # A Search Ads 360 product ad. # Immutable. Details pertaining to a product ad.
},
"resourceName": "A String", # Immutable. The resource name of the ad. Ad resource names have the form: `customers/{customer_id}/ads/{ad_id}`
"responsiveDisplayAd": { # A responsive display ad. # Details pertaining to a responsive display ad.
"accentColor": "A 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.
"allowFlexibleColor": True or False, # 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.
"businessName": "A String", # The advertiser/brand name. Maximum display width is 25.
"callToActionText": "A String", # The call-to-action text for the ad. Maximum display width is 30.
"controlSpec": { # Specification for various creative controls for a responsive display ad. # Specification for various creative controls.
"enableAssetEnhancements": True or False, # Whether the advertiser has opted into the asset enhancements feature.
"enableAutogenVideo": True or False, # Whether the advertiser has opted into auto-gen video feature.
},
"descriptions": [ # Descriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"formatSetting": "A String", # Specifies which format the ad will be served in. Default is ALL_FORMATS.
"headlines": [ # Short format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"longHeadline": { # A text asset used inside an ad. # A required long format headline. The maximum length is 90 characters.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"mainColor": "A 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.
"marketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"pricePrefix": "A String", # Prefix before price. For example, 'as low as'.
"promoText": "A String", # Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
"squareLogoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"squareMarketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"youtubeVideos": [ # Optional YouTube videos for the ad. A maximum of 5 videos can be specified.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"responsiveSearchAd": { # 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 # Details pertaining to a responsive search ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"path1": "A String", # First part of text that can be appended to the URL in the ad.
"path2": "A 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.
},
"searchAds360ExpandedDynamicSearchAd": { # An expanded dynamic search ad. # Immutable. Details pertaining to an expanded dynamic search ad.
"adTrackingId": "A String", # The tracking id of the ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
},
"searchAds360ExpandedTextAd": { # A Search Ads 360 expanded text ad. # Immutable. Details pertaining to an expanded text ad.
"adTrackingId": "A String", # The tracking id of the ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
"headline": "A String", # The headline of the ad.
"headline2": "A String", # The second headline of the ad.
"headline3": "A String", # The third headline of the ad.
"path1": "A String", # Text appended to the auto-generated visible URL with a delimiter.
"path2": "A String", # Text appended to path1 with a delimiter.
},
"searchAds360ResponsiveSearchAd": { # A Search Ads 360 responsive search ad. # Immutable. Details pertaining to a responsive search ad.
"adTrackingId": "A String", # The tracking id of the ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"path1": "A String", # Text appended to the auto-generated visible URL with a delimiter.
"path2": "A String", # Text appended to path1 with a delimiter.
},
"searchAds360TextAd": { # A Search Ads 360 text ad. # Immutable. Details pertaining to a text ad.
"adTrackingId": "A String", # The tracking id of the ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
"displayMobileUrl": "A String", # The displayed mobile URL of the ad.
"displayUrl": "A String", # The displayed URL of the ad.
"headline": "A String", # The headline of the ad.
},
"shoppingComparisonListingAd": { # A Shopping Comparison Listing ad. # Details pertaining to a Shopping Comparison Listing ad.
"headline": "A String", # Headline of the ad. This field is required. Allowed length is between 25 and 45 characters.
},
"shoppingProductAd": { # A standard Shopping ad. # Details pertaining to a Shopping product ad.
},
"shoppingSmartAd": { # A Smart Shopping ad. # Details pertaining to a Smart Shopping ad.
},
"smartCampaignAd": { # A Smart campaign ad. # Details pertaining to a Smart campaign ad.
"descriptions": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
},
"systemManagedResourceSource": "A String", # Output only. If this ad is system managed, then this field will indicate the source. This field is read-only.
"textAd": { # A text ad. # Immutable. Details pertaining to a text ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
"headline": "A String", # The headline of the ad.
},
"trackingUrlTemplate": "A String", # The URL template for constructing a tracking URL.
"travelAd": { # A travel ad. # Details pertaining to a travel ad.
},
"type": "A String", # Output only. The type of ad.
"urlCollections": [ # Additional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad.
{ # Collection of urls that is tagged with a unique identifier.
"finalMobileUrls": [ # A list of possible final mobile URLs.
"A String",
],
"finalUrls": [ # A list of possible final URLs.
"A String",
],
"trackingUrlTemplate": "A String", # URL template for constructing a tracking URL.
"urlCollectionId": "A String", # Unique identifier for this UrlCollection instance.
},
],
"urlCustomParameters": [ # 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.
{ # A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
"key": "A String", # The key matching the parameter tag name.
"value": "A String", # The value to be substituted.
},
],
},
"adGroup": "A String", # Immutable. The ad group to which the ad belongs.
"adGroupAdAssetAutomationSettings": [ # Settings that control the types of asset automation. See the AssetAutomationTypeEnum documentation for the default opt in/out behavior of each type.
{ # Asset automation setting for an AdGroupAd.
"assetAutomationStatus": "A String", # The opt-in/out status for the specified asset automation type.
"assetAutomationType": "A String", # The asset automation type that this setting configures.
},
],
"adStrength": "A String", # Output only. Overall ad strength for this ad group ad.
"creationTime": "A 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.
"effectiveLabels": [ # 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.
"A String",
],
"engineId": "A 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.
"engineStatus": "A String", # 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.
"labels": [ # Output only. The resource names of labels attached to this ad group ad.
"A String",
],
"lastModifiedTime": "A 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.
"policySummary": { # Contains policy information for an ad. # Output only. Policy information for the ad.
"approvalStatus": "A String", # Output only. The overall approval status of this ad, calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # Output only. The list of policy findings for this ad.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Output only. Where in the review process this ad is.
},
"primaryStatus": "A String", # Output only. Provides aggregated view into why an ad group ad is not serving or not serving optimally.
"primaryStatusReasons": [ # Output only. Provides reasons for why an ad group ad is not serving or not serving optimally.
"A String",
],
"resourceName": "A 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}`
"status": "A String", # The status of the ad.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"adGroupAssetOperation": { # A single operation (create, update, remove) on an ad group asset. # An ad group asset mutate operation.
"create": { # A link between an ad group and an asset. # Create operation: No resource name is expected for the new ad group asset.
"adGroup": "A String", # Required. Immutable. The ad group to which the asset is linked.
"asset": "A String", # Required. Immutable. The asset which is linked to the ad group.
"fieldType": "A String", # Required. Immutable. Role that the asset takes under the linked ad group.
"primaryStatus": "A String", # 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.
"primaryStatusDetails": [ # Output only. Provides the details of the primary status and its associated reasons.
{ # Provides the detail of a PrimaryStatus. Each asset link has a PrimaryStatus value (e.g. NOT_ELIGIBLE, meaning not serving), and list of corroborating PrimaryStatusReasons (e.g. [ASSET_DISAPPROVED]). Each reason may have some additional details annotated with it. For instance, when the reason is ASSET_DISAPPROVED, the details field will contain additional information about the offline evaluation errors which led to the asset being disapproved.
"assetDisapproved": { # Details related to AssetLinkPrimaryStatusReasonPB.ASSET_DISAPPROVED # Provides the details for AssetLinkPrimaryStatusReason.ASSET_DISAPPROVED
"offlineEvaluationErrorReasons": [ # Provides the quality evaluation disapproval reason of an asset.
"A String",
],
},
"reason": "A String", # Provides the reason of this PrimaryStatus.
"status": "A String", # Provides the PrimaryStatus of this status detail.
},
],
"primaryStatusReasons": [ # Output only. Provides a list of reasons for why an asset is not serving or not serving at full capacity.
"A String",
],
"resourceName": "A String", # Immutable. The resource name of the ad group asset. AdGroupAsset resource names have the form: `customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}`
"source": "A String", # Output only. Source of the adgroup asset link.
"status": "A String", # Status of the ad group asset.
},
"remove": "A String", # Remove operation: A resource name for the removed ad group asset is expected, in this format: `customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}`
"update": { # A link between an ad group and an asset. # Update operation: The ad group asset is expected to have a valid resource name.
"adGroup": "A String", # Required. Immutable. The ad group to which the asset is linked.
"asset": "A String", # Required. Immutable. The asset which is linked to the ad group.
"fieldType": "A String", # Required. Immutable. Role that the asset takes under the linked ad group.
"primaryStatus": "A String", # 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.
"primaryStatusDetails": [ # Output only. Provides the details of the primary status and its associated reasons.
{ # Provides the detail of a PrimaryStatus. Each asset link has a PrimaryStatus value (e.g. NOT_ELIGIBLE, meaning not serving), and list of corroborating PrimaryStatusReasons (e.g. [ASSET_DISAPPROVED]). Each reason may have some additional details annotated with it. For instance, when the reason is ASSET_DISAPPROVED, the details field will contain additional information about the offline evaluation errors which led to the asset being disapproved.
"assetDisapproved": { # Details related to AssetLinkPrimaryStatusReasonPB.ASSET_DISAPPROVED # Provides the details for AssetLinkPrimaryStatusReason.ASSET_DISAPPROVED
"offlineEvaluationErrorReasons": [ # Provides the quality evaluation disapproval reason of an asset.
"A String",
],
},
"reason": "A String", # Provides the reason of this PrimaryStatus.
"status": "A String", # Provides the PrimaryStatus of this status detail.
},
],
"primaryStatusReasons": [ # Output only. Provides a list of reasons for why an asset is not serving or not serving at full capacity.
"A String",
],
"resourceName": "A String", # Immutable. The resource name of the ad group asset. AdGroupAsset resource names have the form: `customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}`
"source": "A String", # Output only. Source of the adgroup asset link.
"status": "A String", # Status of the ad group asset.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"adGroupBidModifierOperation": { # A single operation (create, remove, update) on an ad group bid modifier. # An ad group bid modifier mutate operation.
"create": { # Represents an ad group bid modifier. # Create operation: No resource name is expected for the new ad group bid modifier.
"adGroup": "A String", # Immutable. The ad group to which this criterion belongs.
"baseAdGroup": "A 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.
"bidModifier": 3.14, # 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.
"bidModifierSource": "A String", # Output only. Bid modifier source.
"criterionId": "A String", # Output only. The ID of the criterion to bid modify. This field is ignored for mutates.
"device": { # A device criterion. # Immutable. A device criterion.
"type": "A String", # Type of the device.
},
"hotelAdvanceBookingWindow": { # Criterion for number of days prior to the stay the booking is being made. # Immutable. Criterion for number of days prior to the stay the booking is being made.
"maxDays": "A String", # High end of the number of days prior to the stay.
"minDays": "A String", # Low end of the number of days prior to the stay.
},
"hotelCheckInDateRange": { # Criterion for a check-in date range. # Immutable. Criterion for a hotel check-in date range.
"endDate": "A String", # End date in the YYYY-MM-DD format.
"startDate": "A String", # Start date in the YYYY-MM-DD format.
},
"hotelCheckInDay": { # Criterion for day of the week the booking is for. # Immutable. Criterion for day of the week the booking is for.
"dayOfWeek": "A String", # The day of the week.
},
"hotelDateSelectionType": { # Criterion for hotel date selection (default dates versus user selected). # Immutable. Criterion for hotel date selection (default dates versus user selected).
"type": "A String", # Type of the hotel date selection
},
"hotelLengthOfStay": { # Criterion for length of hotel stay in nights. # Immutable. Criterion for length of hotel stay in nights.
"maxNights": "A String", # High end of the number of nights in the stay.
"minNights": "A String", # Low end of the number of nights in the stay.
},
"resourceName": "A 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}`
},
"remove": "A 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}`
"update": { # Represents an ad group bid modifier. # Update operation: The ad group bid modifier is expected to have a valid resource name.
"adGroup": "A String", # Immutable. The ad group to which this criterion belongs.
"baseAdGroup": "A 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.
"bidModifier": 3.14, # 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.
"bidModifierSource": "A String", # Output only. Bid modifier source.
"criterionId": "A String", # Output only. The ID of the criterion to bid modify. This field is ignored for mutates.
"device": { # A device criterion. # Immutable. A device criterion.
"type": "A String", # Type of the device.
},
"hotelAdvanceBookingWindow": { # Criterion for number of days prior to the stay the booking is being made. # Immutable. Criterion for number of days prior to the stay the booking is being made.
"maxDays": "A String", # High end of the number of days prior to the stay.
"minDays": "A String", # Low end of the number of days prior to the stay.
},
"hotelCheckInDateRange": { # Criterion for a check-in date range. # Immutable. Criterion for a hotel check-in date range.
"endDate": "A String", # End date in the YYYY-MM-DD format.
"startDate": "A String", # Start date in the YYYY-MM-DD format.
},
"hotelCheckInDay": { # Criterion for day of the week the booking is for. # Immutable. Criterion for day of the week the booking is for.
"dayOfWeek": "A String", # The day of the week.
},
"hotelDateSelectionType": { # Criterion for hotel date selection (default dates versus user selected). # Immutable. Criterion for hotel date selection (default dates versus user selected).
"type": "A String", # Type of the hotel date selection
},
"hotelLengthOfStay": { # Criterion for length of hotel stay in nights. # Immutable. Criterion for length of hotel stay in nights.
"maxNights": "A String", # High end of the number of nights in the stay.
"minNights": "A String", # Low end of the number of nights in the stay.
},
"resourceName": "A 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}`
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"adGroupCriterionCustomizerOperation": { # A single operation (create, remove) on a customizer attribute. # An ad group criterion customizer mutate operation.
"create": { # A customizer value for the associated CustomizerAttribute at the AdGroupCriterion level. # Create operation: No resource name is expected for the new ad group criterion customizer.
"adGroupCriterion": "A String", # Immutable. The ad group criterion to which the customizer attribute is linked. It must be a keyword criterion.
"customizerAttribute": "A String", # Required. Immutable. The customizer attribute which is linked to the ad group criterion.
"resourceName": "A String", # Immutable. The resource name of the ad group criterion customizer. Ad group criterion customizer resource names have the form: `customers/{customer_id}/adGroupCriterionCustomizers/{ad_group_id}~{criterion_id}~{customizer_attribute_id}`
"status": "A String", # Output only. The status of the ad group criterion customizer.
"value": { # A customizer value that is referenced in customizer linkage entities like CustomerCustomizer, CampaignCustomizer, etc. # Required. The value to associate with the customizer attribute at this level. The value must be of the type specified for the CustomizerAttribute.
"stringValue": "A String", # Required. Value to insert in creative text. Customizer values of all types are stored as string to make formatting unambiguous.
"type": "A String", # 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.
},
},
"remove": "A String", # Remove operation: A resource name for the removed ad group criterion customizer is expected, in this format: `customers/{customer_id}/adGroupCriterionCustomizers/{ad_group_id}~{criterion_id}~{customizer_attribute_id}`
},
"adGroupCriterionLabelOperation": { # A single operation (create, remove) on an ad group criterion label. # An ad group criterion label mutate operation.
"create": { # A relationship between an ad group criterion and a label. # Create operation: No resource name is expected for the new ad group label.
"adGroupCriterion": "A String", # Immutable. The ad group criterion to which the label is attached.
"label": "A String", # Immutable. The label assigned to the ad group criterion.
"ownerCustomerId": "A String", # Output only. The ID of the Customer which owns the label.
"resourceName": "A String", # Immutable. The resource name of the ad group criterion label. Ad group criterion label resource names have the form: `customers/{owner_customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}`
},
"remove": "A String", # Remove operation: A resource name for the ad group criterion label being removed, in this format: `customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}`
},
"adGroupCriterionOperation": { # A single operation (create, remove, update) on an ad group criterion. # An ad group criterion mutate operation.
"create": { # An ad group criterion. The ad_group_criterion report only returns criteria that were explicitly added to the ad group. # Create operation: No resource name is expected for the new criterion.
"adGroup": "A String", # Immutable. The ad group to which the criterion belongs.
"ageRange": { # An age range criterion. # Immutable. Age range.
"type": "A String", # Type of the age range.
},
"appPaymentModel": { # An app payment model criterion. # Immutable. App Payment Model.
"type": "A String", # Type of the app payment model.
},
"approvalStatus": "A String", # Output only. Approval status of the criterion.
"audience": { # An audience criterion. # Immutable. Audience.
"audience": "A String", # The Audience resource name.
},
"bidModifier": 3.14, # 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.
"brandList": { # 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. # Immutable. Brand list criterion.
"sharedSet": "A String", # Shared set resource name of the brand list.
},
"combinedAudience": { # A combined audience criterion. # Immutable. Combined Audience.
"combinedAudience": "A String", # The CombinedAudience resource name.
},
"cpcBidMicros": "A String", # The CPC (cost-per-click) bid.
"cpmBidMicros": "A String", # The CPM (cost-per-thousand viewable impressions) bid.
"cpvBidMicros": "A String", # The CPV (cost-per-view) bid.
"creationTime": "A 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.
"criterionId": "A String", # Output only. The ID of the criterion.
"customAffinity": { # A custom affinity criterion. A criterion of this type is only targetable. # Immutable. Custom Affinity.
"customAffinity": "A String", # The CustomInterest resource name.
},
"customAudience": { # A custom audience criterion. # Immutable. Custom Audience.
"customAudience": "A String", # The CustomAudience resource name.
},
"customIntent": { # A custom intent criterion. A criterion of this type is only targetable. # Immutable. Custom Intent.
"customIntent": "A String", # The CustomInterest resource name.
},
"disapprovalReasons": [ # 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.
"A String",
],
"displayName": "A String", # Output only. The display name of the criterion.
"effectiveCpcBidMicros": "A String", # Output only. The effective CPC (cost-per-click) bid.
"effectiveCpcBidSource": "A String", # Output only. Source of the effective CPC bid.
"effectiveCpmBidMicros": "A String", # Output only. The effective CPM (cost-per-thousand viewable impressions) bid.
"effectiveCpmBidSource": "A String", # Output only. Source of the effective CPM bid.
"effectiveCpvBidMicros": "A String", # Output only. The effective CPV (cost-per-view) bid.
"effectiveCpvBidSource": "A String", # Output only. Source of the effective CPV bid.
"effectiveLabels": [ # 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.
"A String",
],
"effectivePercentCpcBidMicros": "A String", # Output only. The effective Percent CPC bid amount.
"effectivePercentCpcBidSource": "A String", # Output only. Source of the effective Percent CPC bid.
"engineId": "A 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.
"engineStatus": "A String", # Output only. The Engine Status for ad group criterion.
"extendedDemographic": { # Represents an extended demographic criterion. # Immutable. Extended demographic criterion.
"extendedDemographicId": "A String", # Taxonomy id of the extended demographic group.
},
"finalMobileUrls": [ # The list of possible final mobile URLs after all cross-domain redirects.
"A String",
],
"finalUrlSuffix": "A String", # URL template for appending params to final URL.
"finalUrls": [ # The list of possible final URLs after all cross-domain redirects for the ad.
"A String",
],
"gender": { # A gender criterion. # Immutable. Gender.
"type": "A String", # Type of the gender.
},
"incomeRange": { # An income range criterion. # Immutable. Income range.
"type": "A String", # Type of the income range.
},
"keyword": { # A keyword criterion. # Immutable. Keyword.
"matchType": "A String", # The match type of the keyword.
"text": "A String", # The text of the keyword (at most 80 characters and 10 words).
},
"labels": [ # Output only. The resource names of labels attached to this ad group criterion.
"A String",
],
"language": { # A language criterion. # Immutable. Language.
"languageConstant": "A String", # The language constant resource name.
},
"lastModifiedTime": "A 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.
"lifeEvent": { # Represents a life event criterion. # Immutable. Life event campaign criterion.
"lifeEventId": "A String", # Taxonomy id of the life event.
},
"listingGroup": { # A listing group criterion. # Immutable. Listing group.
"caseValue": { # Listing dimensions for listing group criterion. # Dimension value with which this listing group is refining its parent. Undefined for the root group.
"activityCity": { # The city where the travel activity is available. # The city where the travel activity is available.
"value": "A String", # String value of the activity city. The Geo Target Constant resource name.
},
"activityCountry": { # The country where the travel activity is available. # The country where the travel activity is available.
"value": "A String", # String value of the activity country. The Geo Target Constant resource name.
},
"activityId": { # Advertiser-specific activity ID. # Advertiser-specific activity ID.
"value": "A String", # String value of the activity ID.
},
"activityRating": { # Rating of the activity as a number 1 to 5, where 5 is the best. # Rating of the activity as a number 1 to 5, where 5 is the best.
"value": "A String", # Long value of the activity rating.
},
"activityState": { # The state where the travel activity is available. # The state where the travel activity is available.
"value": "A String", # String value of the activity state. The Geo Target Constant resource name.
},
"hotelCity": { # City the hotel is located in. # City the hotel is located in.
"cityCriterion": "A String", # The Geo Target Constant resource name.
},
"hotelClass": { # Class of the hotel as a number of stars 1 to 5. # Class of the hotel as a number of stars 1 to 5.
"value": "A String", # Long value of the hotel class.
},
"hotelCountryRegion": { # Country or Region the hotel is located in. # Country or Region the hotel is located in.
"countryRegionCriterion": "A String", # The Geo Target Constant resource name.
},
"hotelId": { # Advertiser-specific hotel ID. # Advertiser-specific hotel ID.
"value": "A String", # String value of the hotel ID.
},
"hotelState": { # State the hotel is located in. # State the hotel is located in.
"stateCriterion": "A String", # The Geo Target Constant resource name.
},
"productBrand": { # Brand of the product. # Brand of a product offer.
"value": "A String", # String value of the product brand.
},
"productCategory": { # Category of a product offer. # Category of a product offer.
"categoryId": "A String", # ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
"level": "A String", # Level of the product category.
},
"productChannel": { # Locality of a product offer. # Locality of a product offer.
"channel": "A String", # Value of the locality.
},
"productChannelExclusivity": { # Availability of a product offer. # Availability of a product offer.
"channelExclusivity": "A String", # Value of the availability.
},
"productCondition": { # Condition of a product offer. # Condition of a product offer.
"condition": "A String", # Value of the condition.
},
"productCustomAttribute": { # Custom attribute of a product offer. # Custom attribute of a product offer.
"index": "A String", # Indicates the index of the custom attribute.
"value": "A String", # String value of the product custom attribute.
},
"productGrouping": { # Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product grouping.
},
"productItemId": { # Item id of a product offer. # Item id of a product offer.
"value": "A String", # Value of the id.
},
"productLabels": { # Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product labels.
},
"productLegacyCondition": { # Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product legacy condition.
},
"productType": { # Type of a product offer. # Type of a product offer.
"level": "A String", # Level of the type.
"value": "A String", # Value of the type.
},
"productTypeFull": { # Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product full type.
},
"unknownListingDimension": { # Unknown listing dimension. # Unknown dimension. Set when no other listing dimension is set.
},
},
"parentAdGroupCriterion": "A String", # Resource name of ad group criterion which is the parent listing group subdivision. Null for the root group.
"path": { # The path of dimensions defining a listing group. # The path of dimensions defining this listing group.
"dimensions": [ # The complete path of dimensions through the listing group hierarchy, from the root (excluding the root itself) to this listing group.
{ # Listing dimensions for listing group criterion.
"activityCity": { # The city where the travel activity is available. # The city where the travel activity is available.
"value": "A String", # String value of the activity city. The Geo Target Constant resource name.
},
"activityCountry": { # The country where the travel activity is available. # The country where the travel activity is available.
"value": "A String", # String value of the activity country. The Geo Target Constant resource name.
},
"activityId": { # Advertiser-specific activity ID. # Advertiser-specific activity ID.
"value": "A String", # String value of the activity ID.
},
"activityRating": { # Rating of the activity as a number 1 to 5, where 5 is the best. # Rating of the activity as a number 1 to 5, where 5 is the best.
"value": "A String", # Long value of the activity rating.
},
"activityState": { # The state where the travel activity is available. # The state where the travel activity is available.
"value": "A String", # String value of the activity state. The Geo Target Constant resource name.
},
"hotelCity": { # City the hotel is located in. # City the hotel is located in.
"cityCriterion": "A String", # The Geo Target Constant resource name.
},
"hotelClass": { # Class of the hotel as a number of stars 1 to 5. # Class of the hotel as a number of stars 1 to 5.
"value": "A String", # Long value of the hotel class.
},
"hotelCountryRegion": { # Country or Region the hotel is located in. # Country or Region the hotel is located in.
"countryRegionCriterion": "A String", # The Geo Target Constant resource name.
},
"hotelId": { # Advertiser-specific hotel ID. # Advertiser-specific hotel ID.
"value": "A String", # String value of the hotel ID.
},
"hotelState": { # State the hotel is located in. # State the hotel is located in.
"stateCriterion": "A String", # The Geo Target Constant resource name.
},
"productBrand": { # Brand of the product. # Brand of a product offer.
"value": "A String", # String value of the product brand.
},
"productCategory": { # Category of a product offer. # Category of a product offer.
"categoryId": "A String", # ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
"level": "A String", # Level of the product category.
},
"productChannel": { # Locality of a product offer. # Locality of a product offer.
"channel": "A String", # Value of the locality.
},
"productChannelExclusivity": { # Availability of a product offer. # Availability of a product offer.
"channelExclusivity": "A String", # Value of the availability.
},
"productCondition": { # Condition of a product offer. # Condition of a product offer.
"condition": "A String", # Value of the condition.
},
"productCustomAttribute": { # Custom attribute of a product offer. # Custom attribute of a product offer.
"index": "A String", # Indicates the index of the custom attribute.
"value": "A String", # String value of the product custom attribute.
},
"productGrouping": { # Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product grouping.
},
"productItemId": { # Item id of a product offer. # Item id of a product offer.
"value": "A String", # Value of the id.
},
"productLabels": { # Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product labels.
},
"productLegacyCondition": { # Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product legacy condition.
},
"productType": { # Type of a product offer. # Type of a product offer.
"level": "A String", # Level of the type.
"value": "A String", # Value of the type.
},
"productTypeFull": { # Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product full type.
},
"unknownListingDimension": { # Unknown listing dimension. # Unknown dimension. Set when no other listing dimension is set.
},
},
],
},
"type": "A String", # Type of the listing group.
},
"location": { # A location criterion. # Immutable. Location.
"geoTargetConstant": "A String", # The geo target constant resource name.
},
"mobileAppCategory": { # A mobile app category criterion. # Immutable. Mobile app category.
"mobileAppCategoryConstant": "A String", # The mobile app category constant resource name.
},
"mobileApplication": { # A mobile application criterion. # Immutable. Mobile application.
"appId": "A 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": "A String", # Name of this mobile application.
},
"negative": True or False, # 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.
"parentalStatus": { # A parental status criterion. # Immutable. Parental status.
"type": "A String", # Type of the parental status.
},
"percentCpcBidMicros": "A String", # 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].
"placement": { # A placement criterion. This can be used to modify bids for sites when targeting the content network. # Immutable. Placement.
"url": "A String", # URL of the placement. For example, "http://www.domain.com".
},
"positionEstimates": { # Estimates for criterion bids at various positions. # Output only. Estimates for criterion bids at various positions.
"estimatedAddClicksAtFirstPositionCpc": "A String", # 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.
"estimatedAddCostAtFirstPositionCpc": "A String", # Output only. Estimate of how your cost per week might change when changing your keyword bid to the value in first_position_cpc_micros.
"firstPageCpcMicros": "A String", # Output only. The estimate of the CPC bid required for ad to be shown on first page of search results.
"firstPositionCpcMicros": "A String", # 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.
"topOfPageCpcMicros": "A String", # Output only. The estimate of the CPC bid required for ad to be displayed at the top of the first page of search results.
},
"primaryStatus": "A String", # Output only. The primary status for the ad group criterion.
"primaryStatusReasons": [ # Output only. The primary status reasons for the ad group criterion.
"A String",
],
"qualityInfo": { # A container for ad group criterion quality information. # Output only. Information regarding the quality of the criterion.
"creativeQualityScore": "A String", # Output only. The performance of the ad compared to other advertisers.
"postClickQualityScore": "A String", # Output only. The quality score of the landing page.
"qualityScore": 42, # Output only. The quality score. This field may not be populated if Google does not have enough information to determine a value.
"searchPredictedCtr": "A String", # Output only. The click-through rate compared to that of other advertisers.
},
"resourceName": "A 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}`
"status": "A String", # 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.
"systemServingStatus": "A String", # Output only. Serving status of the criterion.
"topic": { # 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"). # Immutable. Topic.
"path": [ # 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.
"A String",
],
"topicConstant": "A String", # The Topic Constant resource name.
},
"trackingUrlTemplate": "A String", # The URL template for constructing a tracking URL.
"type": "A String", # Output only. The type of the criterion.
"urlCustomParameters": [ # The list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
{ # A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
"key": "A String", # The key matching the parameter tag name.
"value": "A String", # The value to be substituted.
},
],
"userInterest": { # Represents a particular interest-based topic to be targeted. # Immutable. User Interest.
"userInterestCategory": "A String", # The UserInterest resource name.
},
"userList": { # A User List criterion. Represents a user list that is defined by the advertiser to be targeted. # Immutable. User List.
"userList": "A String", # The User List resource name.
},
"verticalAdsItemGroupRuleList": { # A criterion for targeting a shared set of rules for item groups in Vertical Ads (e.g., for hotel ads). # Immutable. Vertical ads item group rule list criterion.
"sharedSet": "A String", # The shared set resource name of the vertical ads item group rule list.
},
"videoLineup": { # A Video lineup criterion. # Immutable. Video lineup criterion.
"videoLineupId": "A String", # ID for a Video lineup. Contact your Google business development representative for details.
},
"webpage": { # Represents a criterion for targeting webpages of an advertiser's website. # Immutable. Webpage
"conditions": [ # 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.
{ # Logical expression for targeting webpages of an advertiser's website.
"argument": "A String", # Argument of webpage targeting condition.
"operand": "A String", # Operand of webpage targeting condition.
"operator": "A String", # Operator of webpage targeting condition.
},
],
"coveragePercentage": 3.14, # 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.
"criterionName": "A 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.
"sample": { # List of sample urls that match the website target # List of sample urls that match the website target. This field is read-only.
"sampleUrls": [ # Webpage sample urls
"A String",
],
},
},
"youtubeChannel": { # A YouTube Channel criterion. # Immutable. YouTube Channel.
"channelId": "A String", # The YouTube uploader channel id or the channel code of a YouTube channel.
},
"youtubeVideo": { # A YouTube Video criterion. # Immutable. YouTube Video.
"videoId": "A String", # YouTube video id as it appears on the YouTube watch page.
},
},
"exemptPolicyViolationKeys": [ # 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.
{ # Key of the violation. The key is used for referring to a violation when filing an exemption request.
"policyName": "A String", # Unique ID of the violated policy.
"violatingText": "A 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": "A String", # Remove operation: A resource name for the removed criterion is expected, in this format: `customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}`
"update": { # An ad group criterion. The ad_group_criterion report only returns criteria that were explicitly added to the ad group. # Update operation: The criterion is expected to have a valid resource name.
"adGroup": "A String", # Immutable. The ad group to which the criterion belongs.
"ageRange": { # An age range criterion. # Immutable. Age range.
"type": "A String", # Type of the age range.
},
"appPaymentModel": { # An app payment model criterion. # Immutable. App Payment Model.
"type": "A String", # Type of the app payment model.
},
"approvalStatus": "A String", # Output only. Approval status of the criterion.
"audience": { # An audience criterion. # Immutable. Audience.
"audience": "A String", # The Audience resource name.
},
"bidModifier": 3.14, # 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.
"brandList": { # 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. # Immutable. Brand list criterion.
"sharedSet": "A String", # Shared set resource name of the brand list.
},
"combinedAudience": { # A combined audience criterion. # Immutable. Combined Audience.
"combinedAudience": "A String", # The CombinedAudience resource name.
},
"cpcBidMicros": "A String", # The CPC (cost-per-click) bid.
"cpmBidMicros": "A String", # The CPM (cost-per-thousand viewable impressions) bid.
"cpvBidMicros": "A String", # The CPV (cost-per-view) bid.
"creationTime": "A 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.
"criterionId": "A String", # Output only. The ID of the criterion.
"customAffinity": { # A custom affinity criterion. A criterion of this type is only targetable. # Immutable. Custom Affinity.
"customAffinity": "A String", # The CustomInterest resource name.
},
"customAudience": { # A custom audience criterion. # Immutable. Custom Audience.
"customAudience": "A String", # The CustomAudience resource name.
},
"customIntent": { # A custom intent criterion. A criterion of this type is only targetable. # Immutable. Custom Intent.
"customIntent": "A String", # The CustomInterest resource name.
},
"disapprovalReasons": [ # 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.
"A String",
],
"displayName": "A String", # Output only. The display name of the criterion.
"effectiveCpcBidMicros": "A String", # Output only. The effective CPC (cost-per-click) bid.
"effectiveCpcBidSource": "A String", # Output only. Source of the effective CPC bid.
"effectiveCpmBidMicros": "A String", # Output only. The effective CPM (cost-per-thousand viewable impressions) bid.
"effectiveCpmBidSource": "A String", # Output only. Source of the effective CPM bid.
"effectiveCpvBidMicros": "A String", # Output only. The effective CPV (cost-per-view) bid.
"effectiveCpvBidSource": "A String", # Output only. Source of the effective CPV bid.
"effectiveLabels": [ # 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.
"A String",
],
"effectivePercentCpcBidMicros": "A String", # Output only. The effective Percent CPC bid amount.
"effectivePercentCpcBidSource": "A String", # Output only. Source of the effective Percent CPC bid.
"engineId": "A 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.
"engineStatus": "A String", # Output only. The Engine Status for ad group criterion.
"extendedDemographic": { # Represents an extended demographic criterion. # Immutable. Extended demographic criterion.
"extendedDemographicId": "A String", # Taxonomy id of the extended demographic group.
},
"finalMobileUrls": [ # The list of possible final mobile URLs after all cross-domain redirects.
"A String",
],
"finalUrlSuffix": "A String", # URL template for appending params to final URL.
"finalUrls": [ # The list of possible final URLs after all cross-domain redirects for the ad.
"A String",
],
"gender": { # A gender criterion. # Immutable. Gender.
"type": "A String", # Type of the gender.
},
"incomeRange": { # An income range criterion. # Immutable. Income range.
"type": "A String", # Type of the income range.
},
"keyword": { # A keyword criterion. # Immutable. Keyword.
"matchType": "A String", # The match type of the keyword.
"text": "A String", # The text of the keyword (at most 80 characters and 10 words).
},
"labels": [ # Output only. The resource names of labels attached to this ad group criterion.
"A String",
],
"language": { # A language criterion. # Immutable. Language.
"languageConstant": "A String", # The language constant resource name.
},
"lastModifiedTime": "A 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.
"lifeEvent": { # Represents a life event criterion. # Immutable. Life event campaign criterion.
"lifeEventId": "A String", # Taxonomy id of the life event.
},
"listingGroup": { # A listing group criterion. # Immutable. Listing group.
"caseValue": { # Listing dimensions for listing group criterion. # Dimension value with which this listing group is refining its parent. Undefined for the root group.
"activityCity": { # The city where the travel activity is available. # The city where the travel activity is available.
"value": "A String", # String value of the activity city. The Geo Target Constant resource name.
},
"activityCountry": { # The country where the travel activity is available. # The country where the travel activity is available.
"value": "A String", # String value of the activity country. The Geo Target Constant resource name.
},
"activityId": { # Advertiser-specific activity ID. # Advertiser-specific activity ID.
"value": "A String", # String value of the activity ID.
},
"activityRating": { # Rating of the activity as a number 1 to 5, where 5 is the best. # Rating of the activity as a number 1 to 5, where 5 is the best.
"value": "A String", # Long value of the activity rating.
},
"activityState": { # The state where the travel activity is available. # The state where the travel activity is available.
"value": "A String", # String value of the activity state. The Geo Target Constant resource name.
},
"hotelCity": { # City the hotel is located in. # City the hotel is located in.
"cityCriterion": "A String", # The Geo Target Constant resource name.
},
"hotelClass": { # Class of the hotel as a number of stars 1 to 5. # Class of the hotel as a number of stars 1 to 5.
"value": "A String", # Long value of the hotel class.
},
"hotelCountryRegion": { # Country or Region the hotel is located in. # Country or Region the hotel is located in.
"countryRegionCriterion": "A String", # The Geo Target Constant resource name.
},
"hotelId": { # Advertiser-specific hotel ID. # Advertiser-specific hotel ID.
"value": "A String", # String value of the hotel ID.
},
"hotelState": { # State the hotel is located in. # State the hotel is located in.
"stateCriterion": "A String", # The Geo Target Constant resource name.
},
"productBrand": { # Brand of the product. # Brand of a product offer.
"value": "A String", # String value of the product brand.
},
"productCategory": { # Category of a product offer. # Category of a product offer.
"categoryId": "A String", # ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
"level": "A String", # Level of the product category.
},
"productChannel": { # Locality of a product offer. # Locality of a product offer.
"channel": "A String", # Value of the locality.
},
"productChannelExclusivity": { # Availability of a product offer. # Availability of a product offer.
"channelExclusivity": "A String", # Value of the availability.
},
"productCondition": { # Condition of a product offer. # Condition of a product offer.
"condition": "A String", # Value of the condition.
},
"productCustomAttribute": { # Custom attribute of a product offer. # Custom attribute of a product offer.
"index": "A String", # Indicates the index of the custom attribute.
"value": "A String", # String value of the product custom attribute.
},
"productGrouping": { # Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product grouping.
},
"productItemId": { # Item id of a product offer. # Item id of a product offer.
"value": "A String", # Value of the id.
},
"productLabels": { # Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product labels.
},
"productLegacyCondition": { # Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product legacy condition.
},
"productType": { # Type of a product offer. # Type of a product offer.
"level": "A String", # Level of the type.
"value": "A String", # Value of the type.
},
"productTypeFull": { # Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product full type.
},
"unknownListingDimension": { # Unknown listing dimension. # Unknown dimension. Set when no other listing dimension is set.
},
},
"parentAdGroupCriterion": "A String", # Resource name of ad group criterion which is the parent listing group subdivision. Null for the root group.
"path": { # The path of dimensions defining a listing group. # The path of dimensions defining this listing group.
"dimensions": [ # The complete path of dimensions through the listing group hierarchy, from the root (excluding the root itself) to this listing group.
{ # Listing dimensions for listing group criterion.
"activityCity": { # The city where the travel activity is available. # The city where the travel activity is available.
"value": "A String", # String value of the activity city. The Geo Target Constant resource name.
},
"activityCountry": { # The country where the travel activity is available. # The country where the travel activity is available.
"value": "A String", # String value of the activity country. The Geo Target Constant resource name.
},
"activityId": { # Advertiser-specific activity ID. # Advertiser-specific activity ID.
"value": "A String", # String value of the activity ID.
},
"activityRating": { # Rating of the activity as a number 1 to 5, where 5 is the best. # Rating of the activity as a number 1 to 5, where 5 is the best.
"value": "A String", # Long value of the activity rating.
},
"activityState": { # The state where the travel activity is available. # The state where the travel activity is available.
"value": "A String", # String value of the activity state. The Geo Target Constant resource name.
},
"hotelCity": { # City the hotel is located in. # City the hotel is located in.
"cityCriterion": "A String", # The Geo Target Constant resource name.
},
"hotelClass": { # Class of the hotel as a number of stars 1 to 5. # Class of the hotel as a number of stars 1 to 5.
"value": "A String", # Long value of the hotel class.
},
"hotelCountryRegion": { # Country or Region the hotel is located in. # Country or Region the hotel is located in.
"countryRegionCriterion": "A String", # The Geo Target Constant resource name.
},
"hotelId": { # Advertiser-specific hotel ID. # Advertiser-specific hotel ID.
"value": "A String", # String value of the hotel ID.
},
"hotelState": { # State the hotel is located in. # State the hotel is located in.
"stateCriterion": "A String", # The Geo Target Constant resource name.
},
"productBrand": { # Brand of the product. # Brand of a product offer.
"value": "A String", # String value of the product brand.
},
"productCategory": { # Category of a product offer. # Category of a product offer.
"categoryId": "A String", # ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
"level": "A String", # Level of the product category.
},
"productChannel": { # Locality of a product offer. # Locality of a product offer.
"channel": "A String", # Value of the locality.
},
"productChannelExclusivity": { # Availability of a product offer. # Availability of a product offer.
"channelExclusivity": "A String", # Value of the availability.
},
"productCondition": { # Condition of a product offer. # Condition of a product offer.
"condition": "A String", # Value of the condition.
},
"productCustomAttribute": { # Custom attribute of a product offer. # Custom attribute of a product offer.
"index": "A String", # Indicates the index of the custom attribute.
"value": "A String", # String value of the product custom attribute.
},
"productGrouping": { # Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product grouping.
},
"productItemId": { # Item id of a product offer. # Item id of a product offer.
"value": "A String", # Value of the id.
},
"productLabels": { # Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product labels.
},
"productLegacyCondition": { # Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product legacy condition.
},
"productType": { # Type of a product offer. # Type of a product offer.
"level": "A String", # Level of the type.
"value": "A String", # Value of the type.
},
"productTypeFull": { # Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product full type.
},
"unknownListingDimension": { # Unknown listing dimension. # Unknown dimension. Set when no other listing dimension is set.
},
},
],
},
"type": "A String", # Type of the listing group.
},
"location": { # A location criterion. # Immutable. Location.
"geoTargetConstant": "A String", # The geo target constant resource name.
},
"mobileAppCategory": { # A mobile app category criterion. # Immutable. Mobile app category.
"mobileAppCategoryConstant": "A String", # The mobile app category constant resource name.
},
"mobileApplication": { # A mobile application criterion. # Immutable. Mobile application.
"appId": "A 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": "A String", # Name of this mobile application.
},
"negative": True or False, # 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.
"parentalStatus": { # A parental status criterion. # Immutable. Parental status.
"type": "A String", # Type of the parental status.
},
"percentCpcBidMicros": "A String", # 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].
"placement": { # A placement criterion. This can be used to modify bids for sites when targeting the content network. # Immutable. Placement.
"url": "A String", # URL of the placement. For example, "http://www.domain.com".
},
"positionEstimates": { # Estimates for criterion bids at various positions. # Output only. Estimates for criterion bids at various positions.
"estimatedAddClicksAtFirstPositionCpc": "A String", # 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.
"estimatedAddCostAtFirstPositionCpc": "A String", # Output only. Estimate of how your cost per week might change when changing your keyword bid to the value in first_position_cpc_micros.
"firstPageCpcMicros": "A String", # Output only. The estimate of the CPC bid required for ad to be shown on first page of search results.
"firstPositionCpcMicros": "A String", # 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.
"topOfPageCpcMicros": "A String", # Output only. The estimate of the CPC bid required for ad to be displayed at the top of the first page of search results.
},
"primaryStatus": "A String", # Output only. The primary status for the ad group criterion.
"primaryStatusReasons": [ # Output only. The primary status reasons for the ad group criterion.
"A String",
],
"qualityInfo": { # A container for ad group criterion quality information. # Output only. Information regarding the quality of the criterion.
"creativeQualityScore": "A String", # Output only. The performance of the ad compared to other advertisers.
"postClickQualityScore": "A String", # Output only. The quality score of the landing page.
"qualityScore": 42, # Output only. The quality score. This field may not be populated if Google does not have enough information to determine a value.
"searchPredictedCtr": "A String", # Output only. The click-through rate compared to that of other advertisers.
},
"resourceName": "A 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}`
"status": "A String", # 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.
"systemServingStatus": "A String", # Output only. Serving status of the criterion.
"topic": { # 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"). # Immutable. Topic.
"path": [ # 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.
"A String",
],
"topicConstant": "A String", # The Topic Constant resource name.
},
"trackingUrlTemplate": "A String", # The URL template for constructing a tracking URL.
"type": "A String", # Output only. The type of the criterion.
"urlCustomParameters": [ # The list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
{ # A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
"key": "A String", # The key matching the parameter tag name.
"value": "A String", # The value to be substituted.
},
],
"userInterest": { # Represents a particular interest-based topic to be targeted. # Immutable. User Interest.
"userInterestCategory": "A String", # The UserInterest resource name.
},
"userList": { # A User List criterion. Represents a user list that is defined by the advertiser to be targeted. # Immutable. User List.
"userList": "A String", # The User List resource name.
},
"verticalAdsItemGroupRuleList": { # A criterion for targeting a shared set of rules for item groups in Vertical Ads (e.g., for hotel ads). # Immutable. Vertical ads item group rule list criterion.
"sharedSet": "A String", # The shared set resource name of the vertical ads item group rule list.
},
"videoLineup": { # A Video lineup criterion. # Immutable. Video lineup criterion.
"videoLineupId": "A String", # ID for a Video lineup. Contact your Google business development representative for details.
},
"webpage": { # Represents a criterion for targeting webpages of an advertiser's website. # Immutable. Webpage
"conditions": [ # 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.
{ # Logical expression for targeting webpages of an advertiser's website.
"argument": "A String", # Argument of webpage targeting condition.
"operand": "A String", # Operand of webpage targeting condition.
"operator": "A String", # Operator of webpage targeting condition.
},
],
"coveragePercentage": 3.14, # 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.
"criterionName": "A 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.
"sample": { # List of sample urls that match the website target # List of sample urls that match the website target. This field is read-only.
"sampleUrls": [ # Webpage sample urls
"A String",
],
},
},
"youtubeChannel": { # A YouTube Channel criterion. # Immutable. YouTube Channel.
"channelId": "A String", # The YouTube uploader channel id or the channel code of a YouTube channel.
},
"youtubeVideo": { # A YouTube Video criterion. # Immutable. YouTube Video.
"videoId": "A String", # YouTube video id as it appears on the YouTube watch page.
},
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"adGroupCustomizerOperation": { # A single operation (create, remove) on a customizer attribute. # An ad group customizer mutate operation.
"create": { # A customizer value for the associated CustomizerAttribute at the AdGroup level. # Create operation: No resource name is expected for the new ad group customizer
"adGroup": "A String", # Immutable. The ad group to which the customizer attribute is linked.
"customizerAttribute": "A String", # Required. Immutable. The customizer attribute which is linked to the ad group.
"resourceName": "A 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": "A String", # Output only. The status of the ad group customizer.
"value": { # A customizer value that is referenced in customizer linkage entities like CustomerCustomizer, CampaignCustomizer, etc. # Required. The value to associate with the customizer attribute at this level. The value must be of the type specified for the CustomizerAttribute.
"stringValue": "A String", # Required. Value to insert in creative text. Customizer values of all types are stored as string to make formatting unambiguous.
"type": "A String", # 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.
},
},
"remove": "A 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}`
},
"adGroupLabelOperation": { # A single operation (create, remove) on an ad group label. # An ad group label mutate operation.
"create": { # A relationship between an ad group and a label. # Create operation: No resource name is expected for the new ad group label.
"adGroup": "A String", # Immutable. The ad group to which the label is attached.
"label": "A String", # Immutable. The label assigned to the ad group.
"ownerCustomerId": "A String", # Output only. The ID of the Customer which owns the label.
"resourceName": "A String", # Immutable. The resource name of the ad group label. Ad group label resource names have the form: `customers/{owner_customer_id}/adGroupLabels/{ad_group_id}~{label_id}`
},
"remove": "A String", # Remove operation: A resource name for the ad group label being removed, in this format: `customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}`
},
"adGroupOperation": { # A single operation (create, update, remove) on an ad group. # An ad group mutate operation.
"create": { # An ad group. # Create operation: No resource name is expected for the new ad group.
"adRotationMode": "A String", # The ad rotation mode of the ad group.
"aiMaxAdGroupSetting": { # Settings for AI Max feature in standard search adgroups. # Settings for AI Max feature in standard search adgroups.
"disableSearchTermMatching": True or False, # 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.
},
"audienceSetting": { # Settings for the audience targeting. # Immutable. Setting for audience related features.
"useAudienceGrouped": True or False, # Immutable. If true, this ad group uses an Audience resource for audience targeting. If false, this ad group may use audience segment criteria instead.
},
"baseAdGroup": "A 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.
"campaign": "A String", # Immutable. The campaign to which the ad group belongs.
"cpcBidMicros": "A String", # 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.
"cpmBidMicros": "A String", # The maximum CPM (cost-per-thousand viewable impressions) bid.
"cpvBidMicros": "A String", # The CPV (cost-per-view) bid.
"creationTime": "A 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.
"demandGenAdGroupSettings": { # Settings for Demand Gen ad groups. # Settings for Demand Gen ad groups.
"channelControls": { # Channel controls for Demand Gen ad groups. # Channel controls for Demand Gen ad groups.
"channelConfig": "A String", # Output only. Channel configuration reflecting which field in the oneof is populated.
"channelStrategy": "A String", # High level channel strategy.
"selectedChannels": { # Explicitly selected channels for channel controls in Demand Gen ad groups. # Explicitly selected channels. This field should be set with at least one true value when present.
"discover": True or False, # Whether to enable ads on the Discover channel.
"display": True or False, # Whether to enable ads on the Display channel.
"gmail": True or False, # Whether to enable ads on the Gmail channel.
"youtubeInFeed": True or False, # Whether to enable ads on the YouTube In-Feed channel.
"youtubeInStream": True or False, # Whether to enable ads on the YouTube In-Stream channel.
"youtubeShorts": True or False, # Whether to enable ads on the YouTube Shorts channel.
},
},
},
"displayCustomBidDimension": "A String", # 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.
"effectiveCpcBidMicros": "A String", # 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.
"effectiveLabels": [ # 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.
"A String",
],
"effectiveTargetCpaMicros": "A String", # Output only. The effective target CPA (cost-per-acquisition). This field is read-only.
"effectiveTargetCpaSource": "A String", # Output only. Source of the effective target CPA. This field is read-only.
"effectiveTargetCpc": "A String", # Output only. The effective target CPC (cost-per-click). This field is read-only.
"effectiveTargetCpcSource": "A String", # Output only. Source of the effective target CPC. This field is read-only.
"effectiveTargetRoas": 3.14, # Output only. The effective target ROAS (return-on-ad-spend). This field is read-only.
"effectiveTargetRoasSource": "A String", # Output only. Source of the effective target ROAS. This field is read-only.
"endDate": "A 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
"engineId": "A 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.
"engineStatus": "A String", # Output only. The Engine Status for ad group.
"excludeDemographicExpansion": True or False, # 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.
"excludedParentAssetFieldTypes": [ # 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.
"A String",
],
"excludedParentAssetSetTypes": [ # 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.
"A String",
],
"finalUrlSuffix": "A String", # URL template for appending params to Final URL.
"fixedCpmMicros": "A String", # The fixed amount in micros that the advertiser pays for every thousand impressions of the ad.
"id": "A String", # Output only. The ID of the ad group.
"labels": [ # Output only. The resource names of labels attached to this ad group.
"A String",
],
"languageCode": "A 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
"lastModifiedTime": "A 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.
"name": "A 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.
"optimizedTargetingEnabled": True or False, # True if optimized targeting is enabled. Optimized Targeting is the replacement for Audience Expansion.
"percentCpcBidMicros": "A String", # 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].
"primaryStatus": "A String", # Output only. Provides aggregated view into why an ad group is not serving or not serving optimally.
"primaryStatusReasons": [ # Output only. Provides reasons for why an ad group is not serving or not serving optimally.
"A String",
],
"resourceName": "A String", # Immutable. The resource name of the ad group. Ad group resource names have the form: `customers/{customer_id}/adGroups/{ad_group_id}`
"startDate": "A 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
"status": "A String", # The status of the ad group.
"targetCpaMicros": "A String", # 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.
"targetCpcMicros": "A String", # Average amount in micros that the advertiser is willing to pay for every ad click. Overrides the target CPC configured at the campaign level.
"targetCpmMicros": "A String", # Average amount in micros that the advertiser is willing to pay for every thousand times the ad is shown.
"targetCpvMicros": "A String", # Average amount in micros that the advertiser is willing to pay for every ad view.
"targetRoas": 3.14, # 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.
"targetingSetting": { # 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 # Setting for targeting related features.
"targetRestrictionOperations": [ # 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.
{ # Operation to be performed on a target restriction list in a mutate.
"operator": "A String", # Type of list operation to perform.
"value": { # The list of per-targeting-dimension targeting settings. # The target restriction being added to or removed from the list.
"bidOnly": True or False, # 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": "A String", # The targeting dimension that these settings apply to.
},
},
],
"targetRestrictions": [ # The per-targeting-dimension setting to restrict the reach of your campaign or ad group.
{ # The list of per-targeting-dimension targeting settings.
"bidOnly": True or False, # 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": "A String", # The targeting dimension that these settings apply to.
},
],
},
"trackingUrlTemplate": "A String", # The URL template for constructing a tracking URL.
"type": "A String", # Immutable. The type of the ad group.
"urlCustomParameters": [ # The list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
{ # A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
"key": "A String", # The key matching the parameter tag name.
"value": "A String", # The value to be substituted.
},
],
"verticalAdsFormatSetting": { # Vertical ads setting feature to enable/disable ad group format controls in search campaigns. # Vertical ads setting feature to enable/disable ad group format controls in search campaigns. This setting requires AiMaxAdGroupSetting to be enabled and a travel feed to be attached to the campaign.
"disableTextAds": True or False, # If true, text ads will be disabled for this ad group.
"enableBookingLinks": True or False, # If true, booking links will be enabled for this ad group.
"enableVerticalPromotionAds": True or False, # If true, vertical promotion ads will be enabled for this ad group.
},
},
"remove": "A String", # Remove operation: A resource name for the removed ad group is expected, in this format: `customers/{customer_id}/adGroups/{ad_group_id}`
"update": { # An ad group. # Update operation: The ad group is expected to have a valid resource name.
"adRotationMode": "A String", # The ad rotation mode of the ad group.
"aiMaxAdGroupSetting": { # Settings for AI Max feature in standard search adgroups. # Settings for AI Max feature in standard search adgroups.
"disableSearchTermMatching": True or False, # 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.
},
"audienceSetting": { # Settings for the audience targeting. # Immutable. Setting for audience related features.
"useAudienceGrouped": True or False, # Immutable. If true, this ad group uses an Audience resource for audience targeting. If false, this ad group may use audience segment criteria instead.
},
"baseAdGroup": "A 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.
"campaign": "A String", # Immutable. The campaign to which the ad group belongs.
"cpcBidMicros": "A String", # 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.
"cpmBidMicros": "A String", # The maximum CPM (cost-per-thousand viewable impressions) bid.
"cpvBidMicros": "A String", # The CPV (cost-per-view) bid.
"creationTime": "A 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.
"demandGenAdGroupSettings": { # Settings for Demand Gen ad groups. # Settings for Demand Gen ad groups.
"channelControls": { # Channel controls for Demand Gen ad groups. # Channel controls for Demand Gen ad groups.
"channelConfig": "A String", # Output only. Channel configuration reflecting which field in the oneof is populated.
"channelStrategy": "A String", # High level channel strategy.
"selectedChannels": { # Explicitly selected channels for channel controls in Demand Gen ad groups. # Explicitly selected channels. This field should be set with at least one true value when present.
"discover": True or False, # Whether to enable ads on the Discover channel.
"display": True or False, # Whether to enable ads on the Display channel.
"gmail": True or False, # Whether to enable ads on the Gmail channel.
"youtubeInFeed": True or False, # Whether to enable ads on the YouTube In-Feed channel.
"youtubeInStream": True or False, # Whether to enable ads on the YouTube In-Stream channel.
"youtubeShorts": True or False, # Whether to enable ads on the YouTube Shorts channel.
},
},
},
"displayCustomBidDimension": "A String", # 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.
"effectiveCpcBidMicros": "A String", # 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.
"effectiveLabels": [ # 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.
"A String",
],
"effectiveTargetCpaMicros": "A String", # Output only. The effective target CPA (cost-per-acquisition). This field is read-only.
"effectiveTargetCpaSource": "A String", # Output only. Source of the effective target CPA. This field is read-only.
"effectiveTargetCpc": "A String", # Output only. The effective target CPC (cost-per-click). This field is read-only.
"effectiveTargetCpcSource": "A String", # Output only. Source of the effective target CPC. This field is read-only.
"effectiveTargetRoas": 3.14, # Output only. The effective target ROAS (return-on-ad-spend). This field is read-only.
"effectiveTargetRoasSource": "A String", # Output only. Source of the effective target ROAS. This field is read-only.
"endDate": "A 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
"engineId": "A 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.
"engineStatus": "A String", # Output only. The Engine Status for ad group.
"excludeDemographicExpansion": True or False, # 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.
"excludedParentAssetFieldTypes": [ # 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.
"A String",
],
"excludedParentAssetSetTypes": [ # 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.
"A String",
],
"finalUrlSuffix": "A String", # URL template for appending params to Final URL.
"fixedCpmMicros": "A String", # The fixed amount in micros that the advertiser pays for every thousand impressions of the ad.
"id": "A String", # Output only. The ID of the ad group.
"labels": [ # Output only. The resource names of labels attached to this ad group.
"A String",
],
"languageCode": "A 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
"lastModifiedTime": "A 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.
"name": "A 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.
"optimizedTargetingEnabled": True or False, # True if optimized targeting is enabled. Optimized Targeting is the replacement for Audience Expansion.
"percentCpcBidMicros": "A String", # 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].
"primaryStatus": "A String", # Output only. Provides aggregated view into why an ad group is not serving or not serving optimally.
"primaryStatusReasons": [ # Output only. Provides reasons for why an ad group is not serving or not serving optimally.
"A String",
],
"resourceName": "A String", # Immutable. The resource name of the ad group. Ad group resource names have the form: `customers/{customer_id}/adGroups/{ad_group_id}`
"startDate": "A 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
"status": "A String", # The status of the ad group.
"targetCpaMicros": "A String", # 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.
"targetCpcMicros": "A String", # Average amount in micros that the advertiser is willing to pay for every ad click. Overrides the target CPC configured at the campaign level.
"targetCpmMicros": "A String", # Average amount in micros that the advertiser is willing to pay for every thousand times the ad is shown.
"targetCpvMicros": "A String", # Average amount in micros that the advertiser is willing to pay for every ad view.
"targetRoas": 3.14, # 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.
"targetingSetting": { # 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 # Setting for targeting related features.
"targetRestrictionOperations": [ # 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.
{ # Operation to be performed on a target restriction list in a mutate.
"operator": "A String", # Type of list operation to perform.
"value": { # The list of per-targeting-dimension targeting settings. # The target restriction being added to or removed from the list.
"bidOnly": True or False, # 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": "A String", # The targeting dimension that these settings apply to.
},
},
],
"targetRestrictions": [ # The per-targeting-dimension setting to restrict the reach of your campaign or ad group.
{ # The list of per-targeting-dimension targeting settings.
"bidOnly": True or False, # 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": "A String", # The targeting dimension that these settings apply to.
},
],
},
"trackingUrlTemplate": "A String", # The URL template for constructing a tracking URL.
"type": "A String", # Immutable. The type of the ad group.
"urlCustomParameters": [ # The list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
{ # A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
"key": "A String", # The key matching the parameter tag name.
"value": "A String", # The value to be substituted.
},
],
"verticalAdsFormatSetting": { # Vertical ads setting feature to enable/disable ad group format controls in search campaigns. # Vertical ads setting feature to enable/disable ad group format controls in search campaigns. This setting requires AiMaxAdGroupSetting to be enabled and a travel feed to be attached to the campaign.
"disableTextAds": True or False, # If true, text ads will be disabled for this ad group.
"enableBookingLinks": True or False, # If true, booking links will be enabled for this ad group.
"enableVerticalPromotionAds": True or False, # If true, vertical promotion ads will be enabled for this ad group.
},
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"adOperation": { # A single update operation on an ad. # An ad mutate operation.
"policyValidationParameter": { # Parameter for controlling how policy exemption is done. # Configuration for how policies are validated.
"exemptPolicyViolationKeys": [ # 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.
{ # Key of the violation. The key is used for referring to a violation when filing an exemption request.
"policyName": "A String", # Unique ID of the violated policy.
"violatingText": "A 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.
},
],
"ignorablePolicyTopics": [ # 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.
"A String",
],
},
"update": { # An ad. # Update operation: The ad is expected to have a valid resource name in this format: `customers/{customer_id}/ads/{ad_id}`
"addedByGoogleAds": True or False, # 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.
"appAd": { # An app ad. # Details pertaining to an app ad.
"appDeepLink": { # An app deep link used inside an ad. # An app deep link asset that may be used with the ad.
"asset": "A String", # The Asset resource name of this app deep link asset.
},
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"html5MediaBundles": [ # List of media bundle assets that may be used with the ad.
{ # A media bundle asset used inside an ad.
"asset": "A String", # The Asset resource name of this media bundle.
},
],
"images": [ # List of image assets that may be displayed with the ad.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"mandatoryAdText": { # A text asset used inside an ad. # Mandatory ad text.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"youtubeVideos": [ # List of YouTube video assets that may be displayed with the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"appEngagementAd": { # 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. # Details pertaining to an app engagement ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"images": [ # List of image assets that may be displayed with the ad.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"videos": [ # List of video assets that may be displayed with the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"appPreRegistrationAd": { # 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. # Details pertaining to an app pre-registration ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"images": [ # List of image asset IDs whose images may be displayed with the ad.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"youtubeVideos": [ # List of YouTube video asset IDs whose videos may be displayed with the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"demandGenCarouselAd": { # A Demand Gen carousel ad. # Details pertaining to a Demand Gen carousel ad.
"businessName": "A String", # Required. The Advertiser/brand name.
"callToActionText": "A String", # Call to action text.
"carouselCards": [ # Required. Carousel cards that will display with the ad. Min 2 max 10.
{ # A Demand Gen carousel card asset used inside an ad.
"asset": "A String", # The Asset resource name of this discovery carousel card.
},
],
"description": { # A text asset used inside an ad. # Required. The descriptive text of the ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"headline": { # A text asset used inside an ad. # Required. Headline of the ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"logoImage": { # An image asset used inside an ad. # Required. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%).
"asset": "A String", # The Asset resource name of this image.
},
},
"demandGenMultiAssetAd": { # A Demand Gen multi asset ad. # Details pertaining to a Demand Gen multi asset ad.
"businessName": "A String", # The Advertiser/brand name. Maximum display width is 25. Required.
"callToActionText": "A String", # Call to action text.
"descriptions": [ # The descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # Headline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"marketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"portraitMarketingImages": [ # 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%).
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"squareMarketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"tallPortraitMarketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
},
"demandGenProductAd": { # A Demand Gen product ad. # Details pertaining to a Demand Gen product ad.
"breadcrumb1": "A String", # First part of text that appears in the ad with the displayed URL.
"breadcrumb2": "A String", # Second part of text that appears in the ad with the displayed URL.
"businessName": { # A text asset used inside an ad. # Required. The advertiser/brand name.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"callToAction": { # A call to action asset used inside an ad. # Asset of type CallToActionAsset used for the "Call To Action" button.
"asset": "A String", # The Asset resource name of this call to action asset.
},
"description": { # A text asset used inside an ad. # Required. Text asset used for the description.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"headline": { # A text asset used inside an ad. # Required. Text asset used for the short headline.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"logoImage": { # An image asset used inside an ad. # Required. 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%).
"asset": "A String", # The Asset resource name of this image.
},
},
"demandGenVideoResponsiveAd": { # A Demand Gen video responsive ad. # Details pertaining to a Demand Gen video responsive ad.
"breadcrumb1": "A String", # First part of text that appears in the ad with the displayed URL.
"breadcrumb2": "A String", # Second part of text that appears in the ad with the displayed URL.
"businessName": { # A text asset used inside an ad. # Required. The advertiser/brand name.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"callToActions": [ # Assets of type CallToActionAsset used for the "Call To Action" button.
{ # A call to action asset used inside an ad.
"asset": "A String", # The Asset resource name of this call to action asset.
},
],
"companionBanners": [ # List of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"descriptions": [ # List of text assets used for the description.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets used for the short headline.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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%).
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"longHeadlines": [ # List of text assets used for the long headline.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"videos": [ # List of YouTube video assets used for the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"devicePreference": "A String", # 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.
"displayUploadAd": { # 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. # Details pertaining to a display upload ad.
"displayUploadProductType": "A String", # The product type of this ad. See comments on the enum for details.
"mediaBundle": { # A media bundle asset used inside an ad. # A media bundle asset to be used in the ad. For information about the media bundle for HTML5_UPLOAD_AD, see https://support.google.com/google-ads/answer/1722096 Media bundles that are part of dynamic product types use a special format that needs to be created through the Google Web Designer. See https://support.google.com/webdesigner/answer/7543898 for more information.
"asset": "A String", # The Asset resource name of this media bundle.
},
},
"displayUrl": "A String", # The URL that appears in the ad description for some ad formats.
"expandedDynamicSearchAd": { # An expanded dynamic search ad. # Immutable. Details pertaining to an Expanded Dynamic Search Ad. This type of ad has its headline, final URLs, and display URL auto-generated at serving time according to domain name specific information provided by `dynamic_search_ads_setting` linked at the campaign level.
"description": "A String", # The description of the ad.
"description2": "A String", # The second description of the ad.
},
"expandedTextAd": { # An expanded text ad. # Details pertaining to an expanded text ad.
"description": "A String", # The description of the ad.
"description2": "A String", # The second description of the ad.
"headlinePart1": "A String", # The first part of the ad's headline.
"headlinePart2": "A String", # The second part of the ad's headline.
"headlinePart3": "A String", # The third part of the ad's headline.
"path1": "A String", # The text that can appear alongside the ad's displayed URL.
"path2": "A String", # Additional text that can appear alongside the ad's displayed URL.
},
"finalAppUrls": [ # A list of final app URLs that will be used on mobile if the user has the specific app installed.
{ # A URL for deep linking into an app for the given operating system.
"osType": "A String", # The operating system targeted by this URL. Required.
"url": "A 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.
},
],
"finalMobileUrls": [ # The list of possible final mobile URLs after all cross-domain redirects for the ad.
"A String",
],
"finalUrlSuffix": "A String", # The suffix to use when constructing a final URL.
"finalUrls": [ # The list of possible final URLs after all cross-domain redirects for the ad.
"A String",
],
"hotelAd": { # A hotel ad. # Details pertaining to a hotel ad.
},
"id": "A String", # Output only. The ID of the ad.
"imageAd": { # An image ad. # Immutable. Details pertaining to an Image ad.
"adIdToCopyImageFrom": "A String", # An ad ID to copy the image from.
"data": "A String", # Raw image data as bytes.
"imageAsset": { # An image asset used inside an ad. # The image assets used for the ad.
"asset": "A String", # The Asset resource name of this image.
},
"imageUrl": "A String", # URL of the full size image.
"mimeType": "A String", # The mime type of the image.
"name": "A 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.
"pixelHeight": "A String", # Height in pixels of the full size image.
"pixelWidth": "A String", # Width in pixels of the full size image.
"previewImageUrl": "A String", # URL of the preview size image.
"previewPixelHeight": "A String", # Height in pixels of the preview size image.
"previewPixelWidth": "A String", # Width in pixels of the preview size image.
},
"legacyAppInstallAd": { # A legacy app install ad that only can be used by a few select customers. # Immutable. Details pertaining to a legacy app install ad.
"appId": "A String", # The ID of the mobile app.
"appStore": "A String", # The app store the mobile app is available in.
"description1": "A String", # The first description line of the ad.
"description2": "A String", # The second description line of the ad.
"headline": "A String", # The headline of the ad.
},
"legacyResponsiveDisplayAd": { # A legacy responsive display ad. Ads of this type are labeled 'Responsive ads' in the Google Ads UI. # Details pertaining to a legacy responsive display ad.
"accentColor": "A 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.
"allowFlexibleColor": True or False, # 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.
"businessName": "A String", # The business name in the ad.
"callToActionText": "A String", # The call-to-action text for the ad.
"description": "A String", # The description of the ad.
"formatSetting": "A String", # Specifies which format the ad will be served in. Default is ALL_FORMATS.
"logoImage": "A String", # The MediaFile resource name of the logo image used in the ad.
"longHeadline": "A String", # The long version of the ad's headline.
"mainColor": "A 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.
"marketingImage": "A String", # The MediaFile resource name of the marketing image used in the ad.
"pricePrefix": "A String", # Prefix before price. For example, 'as low as'.
"promoText": "A String", # Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
"shortHeadline": "A String", # The short version of the ad's headline.
"squareLogoImage": "A String", # The MediaFile resource name of the square logo image used in the ad.
"squareMarketingImage": "A String", # The MediaFile resource name of the square marketing image used in the ad.
},
"localAd": { # A local ad. # Details pertaining to a local ad.
"callToActions": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"descriptions": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"marketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"path1": "A String", # First part of optional text that can be appended to the URL in the ad.
"path2": "A 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.
"videos": [ # List of YouTube video assets that may be displayed with the ad. At least 1 and at most 20 video assets must be specified.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"name": "A 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.
"productAd": { # A Search Ads 360 product ad. # Immutable. Details pertaining to a product ad.
},
"resourceName": "A String", # Immutable. The resource name of the ad. Ad resource names have the form: `customers/{customer_id}/ads/{ad_id}`
"responsiveDisplayAd": { # A responsive display ad. # Details pertaining to a responsive display ad.
"accentColor": "A 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.
"allowFlexibleColor": True or False, # 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.
"businessName": "A String", # The advertiser/brand name. Maximum display width is 25.
"callToActionText": "A String", # The call-to-action text for the ad. Maximum display width is 30.
"controlSpec": { # Specification for various creative controls for a responsive display ad. # Specification for various creative controls.
"enableAssetEnhancements": True or False, # Whether the advertiser has opted into the asset enhancements feature.
"enableAutogenVideo": True or False, # Whether the advertiser has opted into auto-gen video feature.
},
"descriptions": [ # Descriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"formatSetting": "A String", # Specifies which format the ad will be served in. Default is ALL_FORMATS.
"headlines": [ # Short format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"longHeadline": { # A text asset used inside an ad. # A required long format headline. The maximum length is 90 characters.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"mainColor": "A 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.
"marketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"pricePrefix": "A String", # Prefix before price. For example, 'as low as'.
"promoText": "A String", # Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
"squareLogoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"squareMarketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"youtubeVideos": [ # Optional YouTube videos for the ad. A maximum of 5 videos can be specified.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"responsiveSearchAd": { # 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 # Details pertaining to a responsive search ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"path1": "A String", # First part of text that can be appended to the URL in the ad.
"path2": "A 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.
},
"searchAds360ExpandedDynamicSearchAd": { # An expanded dynamic search ad. # Immutable. Details pertaining to an expanded dynamic search ad.
"adTrackingId": "A String", # The tracking id of the ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
},
"searchAds360ExpandedTextAd": { # A Search Ads 360 expanded text ad. # Immutable. Details pertaining to an expanded text ad.
"adTrackingId": "A String", # The tracking id of the ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
"headline": "A String", # The headline of the ad.
"headline2": "A String", # The second headline of the ad.
"headline3": "A String", # The third headline of the ad.
"path1": "A String", # Text appended to the auto-generated visible URL with a delimiter.
"path2": "A String", # Text appended to path1 with a delimiter.
},
"searchAds360ResponsiveSearchAd": { # A Search Ads 360 responsive search ad. # Immutable. Details pertaining to a responsive search ad.
"adTrackingId": "A String", # The tracking id of the ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"path1": "A String", # Text appended to the auto-generated visible URL with a delimiter.
"path2": "A String", # Text appended to path1 with a delimiter.
},
"searchAds360TextAd": { # A Search Ads 360 text ad. # Immutable. Details pertaining to a text ad.
"adTrackingId": "A String", # The tracking id of the ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
"displayMobileUrl": "A String", # The displayed mobile URL of the ad.
"displayUrl": "A String", # The displayed URL of the ad.
"headline": "A String", # The headline of the ad.
},
"shoppingComparisonListingAd": { # A Shopping Comparison Listing ad. # Details pertaining to a Shopping Comparison Listing ad.
"headline": "A String", # Headline of the ad. This field is required. Allowed length is between 25 and 45 characters.
},
"shoppingProductAd": { # A standard Shopping ad. # Details pertaining to a Shopping product ad.
},
"shoppingSmartAd": { # A Smart Shopping ad. # Details pertaining to a Smart Shopping ad.
},
"smartCampaignAd": { # A Smart campaign ad. # Details pertaining to a Smart campaign ad.
"descriptions": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
},
"systemManagedResourceSource": "A String", # Output only. If this ad is system managed, then this field will indicate the source. This field is read-only.
"textAd": { # A text ad. # Immutable. Details pertaining to a text ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
"headline": "A String", # The headline of the ad.
},
"trackingUrlTemplate": "A String", # The URL template for constructing a tracking URL.
"travelAd": { # A travel ad. # Details pertaining to a travel ad.
},
"type": "A String", # Output only. The type of ad.
"urlCollections": [ # Additional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad.
{ # Collection of urls that is tagged with a unique identifier.
"finalMobileUrls": [ # A list of possible final mobile URLs.
"A String",
],
"finalUrls": [ # A list of possible final URLs.
"A String",
],
"trackingUrlTemplate": "A String", # URL template for constructing a tracking URL.
"urlCollectionId": "A String", # Unique identifier for this UrlCollection instance.
},
],
"urlCustomParameters": [ # 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.
{ # A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
"key": "A String", # The key matching the parameter tag name.
"value": "A String", # The value to be substituted.
},
],
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"adParameterOperation": { # A single operation (create, update, remove) on ad parameter. # An ad parameter mutate operation.
"create": { # 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}" # Create operation: No resource name is expected for the new ad parameter.
"adGroupCriterion": "A String", # Immutable. The ad group criterion that this ad parameter belongs to.
"insertionText": "A 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.
"parameterIndex": "A String", # Immutable. The unique index of this ad parameter. Must be either 1 or 2.
"resourceName": "A 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}`
},
"remove": "A 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}`
"update": { # 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}" # Update operation: The ad parameter is expected to have a valid resource name.
"adGroupCriterion": "A String", # Immutable. The ad group criterion that this ad parameter belongs to.
"insertionText": "A 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.
"parameterIndex": "A String", # Immutable. The unique index of this ad parameter. Must be either 1 or 2.
"resourceName": "A 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}`
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"assetGroupAssetOperation": { # A single operation (create, remove) on an asset group asset. # An asset group asset mutate operation.
"create": { # AssetGroupAsset is the link between an asset and an asset group. Adding an AssetGroupAsset links an asset with an asset group. # Create operation: No resource name is expected for the new asset group asset.
"asset": "A String", # Immutable. The asset which this asset group asset is linking.
"assetGroup": "A String", # Immutable. The asset group which this asset group asset is linking.
"fieldType": "A String", # The description of the placement of the asset within the asset group. For example: HEADLINE, YOUTUBE_VIDEO etc
"policySummary": { # Contains policy summary information. # Output only. The policy information for this asset group asset.
"approvalStatus": "A String", # The overall approval status, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process the resource is.
},
"primaryStatus": "A String", # 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.
"primaryStatusDetails": [ # Output only. Provides the details of the primary status and its associated reasons.
{ # Provides the detail of a PrimaryStatus. Each asset link has a PrimaryStatus value (e.g. NOT_ELIGIBLE, meaning not serving), and list of corroborating PrimaryStatusReasons (e.g. [ASSET_DISAPPROVED]). Each reason may have some additional details annotated with it. For instance, when the reason is ASSET_DISAPPROVED, the details field will contain additional information about the offline evaluation errors which led to the asset being disapproved.
"assetDisapproved": { # Details related to AssetLinkPrimaryStatusReasonPB.ASSET_DISAPPROVED # Provides the details for AssetLinkPrimaryStatusReason.ASSET_DISAPPROVED
"offlineEvaluationErrorReasons": [ # Provides the quality evaluation disapproval reason of an asset.
"A String",
],
},
"reason": "A String", # Provides the reason of this PrimaryStatus.
"status": "A String", # Provides the PrimaryStatus of this status detail.
},
],
"primaryStatusReasons": [ # Output only. Provides a list of reasons for why an asset is not serving or not serving at full capacity.
"A String",
],
"resourceName": "A String", # Immutable. The resource name of the asset group asset. Asset group asset resource name have the form: `customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}`
"source": "A String", # Output only. Source of the asset group asset.
"status": "A String", # The status of the link between an asset and asset group.
},
"remove": "A String", # Remove operation: A resource name for the removed asset group asset is expected, in this format: `customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}`
"update": { # AssetGroupAsset is the link between an asset and an asset group. Adding an AssetGroupAsset links an asset with an asset group. # Update operation: The asset group asset is expected to have a valid resource name.
"asset": "A String", # Immutable. The asset which this asset group asset is linking.
"assetGroup": "A String", # Immutable. The asset group which this asset group asset is linking.
"fieldType": "A String", # The description of the placement of the asset within the asset group. For example: HEADLINE, YOUTUBE_VIDEO etc
"policySummary": { # Contains policy summary information. # Output only. The policy information for this asset group asset.
"approvalStatus": "A String", # The overall approval status, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process the resource is.
},
"primaryStatus": "A String", # 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.
"primaryStatusDetails": [ # Output only. Provides the details of the primary status and its associated reasons.
{ # Provides the detail of a PrimaryStatus. Each asset link has a PrimaryStatus value (e.g. NOT_ELIGIBLE, meaning not serving), and list of corroborating PrimaryStatusReasons (e.g. [ASSET_DISAPPROVED]). Each reason may have some additional details annotated with it. For instance, when the reason is ASSET_DISAPPROVED, the details field will contain additional information about the offline evaluation errors which led to the asset being disapproved.
"assetDisapproved": { # Details related to AssetLinkPrimaryStatusReasonPB.ASSET_DISAPPROVED # Provides the details for AssetLinkPrimaryStatusReason.ASSET_DISAPPROVED
"offlineEvaluationErrorReasons": [ # Provides the quality evaluation disapproval reason of an asset.
"A String",
],
},
"reason": "A String", # Provides the reason of this PrimaryStatus.
"status": "A String", # Provides the PrimaryStatus of this status detail.
},
],
"primaryStatusReasons": [ # Output only. Provides a list of reasons for why an asset is not serving or not serving at full capacity.
"A String",
],
"resourceName": "A String", # Immutable. The resource name of the asset group asset. Asset group asset resource name have the form: `customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}`
"source": "A String", # Output only. Source of the asset group asset.
"status": "A String", # The status of the link between an asset and asset group.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"assetGroupListingGroupFilterOperation": { # A single operation (create, remove) on an asset group listing group filter. # An asset group listing group filter mutate operation.
"create": { # AssetGroupListingGroupFilter represents a listing group filter tree node in an asset group. # Create operation: No resource name is expected for the new asset group listing group filter.
"assetGroup": "A String", # Immutable. The asset group which this asset group listing group filter is part of.
"caseValue": { # Listing dimensions for the asset group listing group filter. # Dimension value with which this listing group is refining its parent. Undefined for the root group.
"productBrand": { # Brand of the product. # Brand of a product offer.
"value": "A String", # String value of the product brand.
},
"productCategory": { # One element of a category at a certain level. Top-level categories are at level 1, their children at level 2, and so on. We currently support up to 5 levels. The user must specify a dimension type that indicates the level of the category. All cases of the same subdivision must have the same dimension type (category level). # Category of a product offer.
"categoryId": "A String", # ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
"level": "A String", # Indicates the level of the category in the taxonomy.
},
"productChannel": { # Locality of a product offer. # Locality of a product offer.
"channel": "A String", # Value of the locality.
},
"productCondition": { # Condition of a product offer. # Condition of a product offer.
"condition": "A String", # Value of the condition.
},
"productCustomAttribute": { # Custom attribute of a product offer. # Custom attribute of a product offer.
"index": "A String", # Indicates the index of the custom attribute.
"value": "A String", # String value of the product custom attribute.
},
"productItemId": { # Item id of a product offer. # Item id of a product offer.
"value": "A String", # Value of the id.
},
"productType": { # Type of a product offer. # Type of a product offer.
"level": "A String", # Level of the type.
"value": "A String", # Value of the type.
},
"webpage": { # Filters for URLs in a page feed and URLs from the advertiser web domain. Several root nodes with this dimension are allowed in an asset group and their conditions are considered in OR. # Filters for URLs in a page feed and URLs from the advertiser web domain.
"conditions": [ # The webpage conditions are case sensitive and these are and-ed together when evaluated for filtering. All the conditions should be of same type. Example1: for URL1 = www.ads.google.com?ocid=1&euid=2 and URL2 = www.ads.google.com?ocid=1 and with "ocid" and "euid" as url_contains conditions, URL1 will be matched, but URL2 not. Example2 : If URL1 has Label1, Label2 and URL2 has Label2, Label3, then with Label1 and Label2 as custom_label conditions, URL1 will be matched but not URL2. With Label2 as the only custom_label condition then both URL1 and URL2 will be matched.
{ # Matching condition for URL filtering.
"customLabel": "A String", # Filters the URLs in a page feed that have this custom label. A custom label can be added to a campaign by creating an AssetSet of type PAGE_FEED and linking it to the campaign using CampaignAssetSet.
"urlContains": "A String", # Filters the URLs in a page feed and the URLs from the advertiser web domain that contain this string.
},
],
},
},
"id": "A String", # Output only. The ID of the ListingGroupFilter.
"listingSource": "A String", # Immutable. The source of listings filtered by this listing group filter.
"parentListingGroupFilter": "A String", # Immutable. Resource name of the parent listing group subdivision. Null for the root listing group filter node.
"path": { # The path defining of dimensions defining a listing group filter. # Output only. The path of dimensions defining this listing group filter.
"dimensions": [ # Output only. The complete path of dimensions through the listing group filter hierarchy (excluding the root node) to this listing group filter.
{ # Listing dimensions for the asset group listing group filter.
"productBrand": { # Brand of the product. # Brand of a product offer.
"value": "A String", # String value of the product brand.
},
"productCategory": { # One element of a category at a certain level. Top-level categories are at level 1, their children at level 2, and so on. We currently support up to 5 levels. The user must specify a dimension type that indicates the level of the category. All cases of the same subdivision must have the same dimension type (category level). # Category of a product offer.
"categoryId": "A String", # ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
"level": "A String", # Indicates the level of the category in the taxonomy.
},
"productChannel": { # Locality of a product offer. # Locality of a product offer.
"channel": "A String", # Value of the locality.
},
"productCondition": { # Condition of a product offer. # Condition of a product offer.
"condition": "A String", # Value of the condition.
},
"productCustomAttribute": { # Custom attribute of a product offer. # Custom attribute of a product offer.
"index": "A String", # Indicates the index of the custom attribute.
"value": "A String", # String value of the product custom attribute.
},
"productItemId": { # Item id of a product offer. # Item id of a product offer.
"value": "A String", # Value of the id.
},
"productType": { # Type of a product offer. # Type of a product offer.
"level": "A String", # Level of the type.
"value": "A String", # Value of the type.
},
"webpage": { # Filters for URLs in a page feed and URLs from the advertiser web domain. Several root nodes with this dimension are allowed in an asset group and their conditions are considered in OR. # Filters for URLs in a page feed and URLs from the advertiser web domain.
"conditions": [ # The webpage conditions are case sensitive and these are and-ed together when evaluated for filtering. All the conditions should be of same type. Example1: for URL1 = www.ads.google.com?ocid=1&euid=2 and URL2 = www.ads.google.com?ocid=1 and with "ocid" and "euid" as url_contains conditions, URL1 will be matched, but URL2 not. Example2 : If URL1 has Label1, Label2 and URL2 has Label2, Label3, then with Label1 and Label2 as custom_label conditions, URL1 will be matched but not URL2. With Label2 as the only custom_label condition then both URL1 and URL2 will be matched.
{ # Matching condition for URL filtering.
"customLabel": "A String", # Filters the URLs in a page feed that have this custom label. A custom label can be added to a campaign by creating an AssetSet of type PAGE_FEED and linking it to the campaign using CampaignAssetSet.
"urlContains": "A String", # Filters the URLs in a page feed and the URLs from the advertiser web domain that contain this string.
},
],
},
},
],
},
"resourceName": "A String", # Immutable. The resource name of the asset group listing group filter. Asset group listing group filter resource name have the form: `customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}`
"type": "A String", # Immutable. Type of a listing group filter node.
},
"remove": "A String", # Remove operation: A resource name for the removed asset group listing group filter is expected, in this format: `customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}` An entity can be removed only if it's not referenced by other parent_listing_group_id. If multiple entities are being deleted, the mutates must be in the correct order.
"update": { # AssetGroupListingGroupFilter represents a listing group filter tree node in an asset group. # Update operation: The asset group listing group filter is expected to have a valid resource name.
"assetGroup": "A String", # Immutable. The asset group which this asset group listing group filter is part of.
"caseValue": { # Listing dimensions for the asset group listing group filter. # Dimension value with which this listing group is refining its parent. Undefined for the root group.
"productBrand": { # Brand of the product. # Brand of a product offer.
"value": "A String", # String value of the product brand.
},
"productCategory": { # One element of a category at a certain level. Top-level categories are at level 1, their children at level 2, and so on. We currently support up to 5 levels. The user must specify a dimension type that indicates the level of the category. All cases of the same subdivision must have the same dimension type (category level). # Category of a product offer.
"categoryId": "A String", # ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
"level": "A String", # Indicates the level of the category in the taxonomy.
},
"productChannel": { # Locality of a product offer. # Locality of a product offer.
"channel": "A String", # Value of the locality.
},
"productCondition": { # Condition of a product offer. # Condition of a product offer.
"condition": "A String", # Value of the condition.
},
"productCustomAttribute": { # Custom attribute of a product offer. # Custom attribute of a product offer.
"index": "A String", # Indicates the index of the custom attribute.
"value": "A String", # String value of the product custom attribute.
},
"productItemId": { # Item id of a product offer. # Item id of a product offer.
"value": "A String", # Value of the id.
},
"productType": { # Type of a product offer. # Type of a product offer.
"level": "A String", # Level of the type.
"value": "A String", # Value of the type.
},
"webpage": { # Filters for URLs in a page feed and URLs from the advertiser web domain. Several root nodes with this dimension are allowed in an asset group and their conditions are considered in OR. # Filters for URLs in a page feed and URLs from the advertiser web domain.
"conditions": [ # The webpage conditions are case sensitive and these are and-ed together when evaluated for filtering. All the conditions should be of same type. Example1: for URL1 = www.ads.google.com?ocid=1&euid=2 and URL2 = www.ads.google.com?ocid=1 and with "ocid" and "euid" as url_contains conditions, URL1 will be matched, but URL2 not. Example2 : If URL1 has Label1, Label2 and URL2 has Label2, Label3, then with Label1 and Label2 as custom_label conditions, URL1 will be matched but not URL2. With Label2 as the only custom_label condition then both URL1 and URL2 will be matched.
{ # Matching condition for URL filtering.
"customLabel": "A String", # Filters the URLs in a page feed that have this custom label. A custom label can be added to a campaign by creating an AssetSet of type PAGE_FEED and linking it to the campaign using CampaignAssetSet.
"urlContains": "A String", # Filters the URLs in a page feed and the URLs from the advertiser web domain that contain this string.
},
],
},
},
"id": "A String", # Output only. The ID of the ListingGroupFilter.
"listingSource": "A String", # Immutable. The source of listings filtered by this listing group filter.
"parentListingGroupFilter": "A String", # Immutable. Resource name of the parent listing group subdivision. Null for the root listing group filter node.
"path": { # The path defining of dimensions defining a listing group filter. # Output only. The path of dimensions defining this listing group filter.
"dimensions": [ # Output only. The complete path of dimensions through the listing group filter hierarchy (excluding the root node) to this listing group filter.
{ # Listing dimensions for the asset group listing group filter.
"productBrand": { # Brand of the product. # Brand of a product offer.
"value": "A String", # String value of the product brand.
},
"productCategory": { # One element of a category at a certain level. Top-level categories are at level 1, their children at level 2, and so on. We currently support up to 5 levels. The user must specify a dimension type that indicates the level of the category. All cases of the same subdivision must have the same dimension type (category level). # Category of a product offer.
"categoryId": "A String", # ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
"level": "A String", # Indicates the level of the category in the taxonomy.
},
"productChannel": { # Locality of a product offer. # Locality of a product offer.
"channel": "A String", # Value of the locality.
},
"productCondition": { # Condition of a product offer. # Condition of a product offer.
"condition": "A String", # Value of the condition.
},
"productCustomAttribute": { # Custom attribute of a product offer. # Custom attribute of a product offer.
"index": "A String", # Indicates the index of the custom attribute.
"value": "A String", # String value of the product custom attribute.
},
"productItemId": { # Item id of a product offer. # Item id of a product offer.
"value": "A String", # Value of the id.
},
"productType": { # Type of a product offer. # Type of a product offer.
"level": "A String", # Level of the type.
"value": "A String", # Value of the type.
},
"webpage": { # Filters for URLs in a page feed and URLs from the advertiser web domain. Several root nodes with this dimension are allowed in an asset group and their conditions are considered in OR. # Filters for URLs in a page feed and URLs from the advertiser web domain.
"conditions": [ # The webpage conditions are case sensitive and these are and-ed together when evaluated for filtering. All the conditions should be of same type. Example1: for URL1 = www.ads.google.com?ocid=1&euid=2 and URL2 = www.ads.google.com?ocid=1 and with "ocid" and "euid" as url_contains conditions, URL1 will be matched, but URL2 not. Example2 : If URL1 has Label1, Label2 and URL2 has Label2, Label3, then with Label1 and Label2 as custom_label conditions, URL1 will be matched but not URL2. With Label2 as the only custom_label condition then both URL1 and URL2 will be matched.
{ # Matching condition for URL filtering.
"customLabel": "A String", # Filters the URLs in a page feed that have this custom label. A custom label can be added to a campaign by creating an AssetSet of type PAGE_FEED and linking it to the campaign using CampaignAssetSet.
"urlContains": "A String", # Filters the URLs in a page feed and the URLs from the advertiser web domain that contain this string.
},
],
},
},
],
},
"resourceName": "A String", # Immutable. The resource name of the asset group listing group filter. Asset group listing group filter resource name have the form: `customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}`
"type": "A String", # Immutable. Type of a listing group filter node.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"assetGroupOperation": { # A single operation (create, remove) on an asset group. # An asset group mutate operation.
"create": { # An asset group. AssetGroupAsset is used to link an asset to the asset group. AssetGroupSignal is used to associate a signal to an asset group. # Create operation: No resource name is expected for the new asset group
"adStrength": "A String", # Output only. Overall ad strength of this asset group.
"assetCoverage": { # Information about the asset coverage of an asset group. # Output only. The asset coverage of this asset group.
"adStrengthActionItems": [ # Output only. A list of action items to improve the ad strength of an asset group.
{ # An action item to improve the ad strength of an asset group.
"actionItemType": "A String", # Output only. The action item type.
"addAssetDetails": { # The details of the asset to add. # Output only. The action item details for action item type ADD_ASSET.
"assetCount": 42, # Output only. The number of assets to add.
"assetFieldType": "A String", # Output only. The asset field type of the asset(s) to add.
"videoAspectRatioRequirement": "A String", # Output only. For video field types, the required aspect ratio of the video. When unset and asset_field_type is YOUTUBE_VIDEO, the system recommends the advertiser upload any YouTube video, regardless of aspect ratio.
},
},
],
},
"campaign": "A String", # Immutable. The campaign with which this asset group is associated. The asset which is linked to the asset group.
"finalMobileUrls": [ # A list of final mobile URLs after all cross domain redirects. In performance max, by default, the urls are eligible for expansion unless opted out.
"A String",
],
"finalUrls": [ # A list of final URLs after all cross domain redirects. In performance max, by default, the urls are eligible for expansion unless opted out.
"A String",
],
"id": "A String", # Output only. The ID of the asset group.
"name": "A String", # Required. Name of the asset group. Required. It must have a minimum length of 1 and maximum length of 128. It must be unique under a campaign.
"path1": "A String", # First part of text that may appear appended to the url displayed in the ad.
"path2": "A String", # Second part of text that may appear appended to the url displayed in the ad. This field can only be set when path1 is set.
"primaryStatus": "A String", # Output only. The primary status of the asset group. Provides insights into why an asset group is not serving or not serving optimally.
"primaryStatusReasons": [ # Output only. Provides reasons into why an asset group is not serving or not serving optimally. It will be empty when the asset group is serving without issues.
"A String",
],
"resourceName": "A String", # Immutable. The resource name of the asset group. Asset group resource names have the form: `customers/{customer_id}/assetGroups/{asset_group_id}`
"status": "A String", # The status of the asset group.
},
"remove": "A String", # Remove operation: A resource name for the removed asset group is expected, in this format: `customers/{customer_id}/assetGroups/{asset_group_id}`
"update": { # An asset group. AssetGroupAsset is used to link an asset to the asset group. AssetGroupSignal is used to associate a signal to an asset group. # Update operation: The asset group is expected to have a valid resource name.
"adStrength": "A String", # Output only. Overall ad strength of this asset group.
"assetCoverage": { # Information about the asset coverage of an asset group. # Output only. The asset coverage of this asset group.
"adStrengthActionItems": [ # Output only. A list of action items to improve the ad strength of an asset group.
{ # An action item to improve the ad strength of an asset group.
"actionItemType": "A String", # Output only. The action item type.
"addAssetDetails": { # The details of the asset to add. # Output only. The action item details for action item type ADD_ASSET.
"assetCount": 42, # Output only. The number of assets to add.
"assetFieldType": "A String", # Output only. The asset field type of the asset(s) to add.
"videoAspectRatioRequirement": "A String", # Output only. For video field types, the required aspect ratio of the video. When unset and asset_field_type is YOUTUBE_VIDEO, the system recommends the advertiser upload any YouTube video, regardless of aspect ratio.
},
},
],
},
"campaign": "A String", # Immutable. The campaign with which this asset group is associated. The asset which is linked to the asset group.
"finalMobileUrls": [ # A list of final mobile URLs after all cross domain redirects. In performance max, by default, the urls are eligible for expansion unless opted out.
"A String",
],
"finalUrls": [ # A list of final URLs after all cross domain redirects. In performance max, by default, the urls are eligible for expansion unless opted out.
"A String",
],
"id": "A String", # Output only. The ID of the asset group.
"name": "A String", # Required. Name of the asset group. Required. It must have a minimum length of 1 and maximum length of 128. It must be unique under a campaign.
"path1": "A String", # First part of text that may appear appended to the url displayed in the ad.
"path2": "A String", # Second part of text that may appear appended to the url displayed in the ad. This field can only be set when path1 is set.
"primaryStatus": "A String", # Output only. The primary status of the asset group. Provides insights into why an asset group is not serving or not serving optimally.
"primaryStatusReasons": [ # Output only. Provides reasons into why an asset group is not serving or not serving optimally. It will be empty when the asset group is serving without issues.
"A String",
],
"resourceName": "A String", # Immutable. The resource name of the asset group. Asset group resource names have the form: `customers/{customer_id}/assetGroups/{asset_group_id}`
"status": "A String", # The status of the asset group.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"assetGroupSignalOperation": { # A single operation (create, remove) on an asset group signal. # An asset group signal mutate operation.
"create": { # AssetGroupSignal represents a signal in an asset group. The existence of a signal tells the performance max campaign who's most likely to convert. Performance Max uses the signal to look for new people with similar or stronger intent to find conversions across Search, Display, Video, and more. # Create operation: No resource name is expected for the new asset group signal.
"approvalStatus": "A String", # Output only. Approval status is the output value for search theme signal after Google ads policy review. When using Audience signal, this field is not used and will be absent.
"assetGroup": "A String", # Immutable. The asset group which this asset group signal belongs to.
"audience": { # An audience criterion. # Immutable. The audience signal to be used by the performance max campaign.
"audience": "A String", # The Audience resource name.
},
"disapprovalReasons": [ # Output only. Computed for SearchTheme signals. When using Audience signal, this field is not used and will be absent.
"A String",
],
"resourceName": "A String", # Immutable. The resource name of the asset group signal. Asset group signal resource name have the form: `customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}`
"searchTheme": { # A Search Theme criterion only on Performance Max campaign. Represents a keyword-like advertiser input. # Immutable. The search_theme signal to be used by the performance max campaign. Mutate errors of search_theme criterion includes AssetGroupSignalError.UNSPECIFIED AssetGroupSignalError.UNKNOWN AssetGroupSignalError.TOO_MANY_WORDS AssetGroupSignalError.SEARCH_THEME_POLICY_VIOLATION FieldError.REQUIRED StringFormatError.ILLEGAL_CHARS StringLengthError.TOO_LONG ResourceCountLimitExceededError.RESOURCE_LIMIT
"text": "A String", # Each Search Theme has a value of a simple string, like keywords. There are limits on overall length, allowed characters, and number of words.
},
},
"exemptPolicyViolationKeys": [ # Optional. 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.
{ # Key of the violation. The key is used for referring to a violation when filing an exemption request.
"policyName": "A String", # Unique ID of the violated policy.
"violatingText": "A 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": "A String", # Remove operation: A resource name for the removed asset group signal is expected, in this format: `customers/{customer_id}/assetGroupSignals/{asset_group_id}~{criterion_id}`
},
"assetOperation": { # A single operation to create an asset. Supported asset types are YoutubeVideoAsset, MediaBundleAsset, ImageAsset, LeadFormAsset, LocationAsset, and ImageAsset. TextAsset can be created with an Ad inline, but it can also be created apart from an Ad like other assets. # An asset mutate operation.
"create": { # Asset is a part of an ad which can be shared across multiple ads. It can be an image (ImageAsset), a video (YoutubeVideoAsset), etc. Assets are immutable and cannot be removed. To stop an asset from serving, remove the asset from the entity that is using it. # Create operation: No resource name is expected for the new asset.
"appDeepLinkAsset": { # An app deep link asset # Immutable. An app deep link asset.
"appDeepLinkUri": "A String", # The uri for the app deep link, The uri can be either a custom scheme uri (e.g. mystore://shoes) or universal uri (e.g. http://www.mystore.com/shoes).
},
"bookOnGoogleAsset": { # A Book on Google asset. Used to redirect user to book through Google. Book on Google will change the redirect url to book directly through Google. # A book on google asset.
},
"businessMessageAsset": { # A business message asset. # A business message asset.
"callToAction": { # Display information that encourages the user to take action. # A call to action for the business message asset.
"callToActionDescription": "A String", # Required. Text providing a clear value proposition of what users expect once they take the action. Examples: 'Message us for a quote', 'Ask our expert team'.
"callToActionSelection": "A String", # Required. Pre-defined call to action text.
},
"facebookMessengerInfo": { # Facebook Messenger information to use for messaging. # Facebook Messenger.
"pageName": "A String", # Required. Facebook page name used for starting a chat on Facebook Messenger.
},
"messageProvider": "A String", # Required. Message provider of the business message asset.
"starterMessage": "A String", # Required. A welcome message to prompt the user to initiate a conversation.
"whatsappInfo": { # Whatsapp information to use for messaging. # Whatsapp.
"countryCode": "A String", # Required. Two-letter country code of the phone number. Examples: 'US', 'us'.
"phoneNumber": "A String", # Required. Whatsapp phone number of the business. Examples: '1234567890', '(123)456-7890'.
},
"zaloInfo": { # Zalo information to use for messaging. # Zalo.
"customName": "A String", # Custom name generated by the advertiser for their Zalo Account. These names will usually be registered brands or trademarks.
"oaId": "A String", # Zalo Official Account ID of the advertiser.
},
},
"callAsset": { # A Call asset. # A call asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"callConversionAction": "A String", # The conversion action to attribute a call conversion to. If not set, the default conversion action is used. This field only has effect if call_conversion_reporting_state is set to USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
"callConversionReportingState": "A String", # Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion.
"countryCode": "A String", # Required. Two-letter country code of the phone number. Examples: 'US', 'us'.
"phoneNumber": "A String", # Required. The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890'
},
"callToActionAsset": { # A call to action asset. # Immutable. A call to action asset.
"callToAction": "A String", # Call to action.
},
"calloutAsset": { # A Callout asset. # A callout asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"calloutText": "A String", # Required. The callout text. The length of this string should be between 1 and 25, inclusive.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
},
"creationTime": "A String", # Output only. The timestamp when this asset was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
"demandGenCarouselCardAsset": { # A Demand Gen Carousel Card asset. # Immutable. A Demand Gen carousel card asset.
"callToActionText": "A String", # Call to action text.
"headline": "A String", # Required. Headline of the carousel card.
"marketingImageAsset": "A String", # Asset resource name of the associated 1.91:1 marketing image. This and/or square marketing image asset is required.
"portraitMarketingImageAsset": "A String", # Asset resource name of the associated 4:5 portrait marketing image.
"squareMarketingImageAsset": "A String", # Asset resource name of the associated square marketing image. This and/or a marketing image asset is required.
},
"dynamicCustomAsset": { # A dynamic custom asset. # A dynamic custom asset.
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"contextualKeywords": [ # Contextual keywords, for example, Sedans, 4 door sedans.
"A String",
],
"formattedPrice": "A String", # Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $20,000.00.
"formattedSalePrice": "A String", # Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $15,000.00.
"id": "A String", # Required. ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag, for example, sedan. Required.
"id2": "A String", # ID2 which can be any sequence of letters and digits, for example, red. ID sequence (ID + ID2) must be unique.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"itemAddress": "A String", # Item address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
"itemCategory": "A String", # Item category, for example, Sedans.
"itemDescription": "A String", # Item description, for example, Best selling mid-size car.
"itemSubtitle": "A String", # Item subtitle, for example, At your Mountain View dealership.
"itemTitle": "A String", # Required. Item title, for example, Mid-size sedan. Required.
"price": "A String", # Price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 20,000.00 USD.
"salePrice": "A String", # Sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 15,000.00 USD. Must be less than the 'price' field.
"similarIds": [ # Similar IDs.
"A String",
],
},
"dynamicEducationAsset": { # A Dynamic Education asset. # A dynamic education asset.
"address": "A String", # School address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"contextualKeywords": [ # Contextual keywords, for example, Nursing certification, Health, Mountain View.
"A String",
],
"imageUrl": "A String", # Image url, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"locationId": "A String", # Location ID which can be any sequence of letters and digits and must be unique.
"programDescription": "A String", # Program description, for example, Nursing Certification.
"programId": "A String", # Required. Program ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"programName": "A String", # Required. Program name, for example, Nursing. Required.
"schoolName": "A String", # School name, for example, Mountain View School of Nursing.
"similarProgramIds": [ # Similar program IDs.
"A String",
],
"subject": "A String", # Subject of study, for example, Health.
"thumbnailImageUrl": "A String", # Thumbnail image url, for example, http://www.example.com/thumbnail.png. The thumbnail image will not be uploaded as image asset.
},
"dynamicFlightsAsset": { # A dynamic flights asset. # A dynamic flights asset.
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"customMapping": "A String", # A custom field which can be multiple key to values mapping separated by delimiters (",", "|" and ":"), in the forms of ": , , ... , | : , ... , | ... | : , ... ," for example, wifi: most | aircraft: 320, 77W | flights: 42 | legroom: 32".
"destinationId": "A String", # Required. Destination ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"destinationName": "A String", # Destination name, for example, Paris.
"flightDescription": "A String", # Required. Flight description, for example, Book your ticket. Required.
"flightPrice": "A String", # Flight price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
"flightSalePrice": "A String", # Flight sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'flight_price' field.
"formattedPrice": "A String", # Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
"formattedSalePrice": "A String", # Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"originId": "A String", # Origin ID which can be any sequence of letters and digits. The ID sequence (destination ID + origin ID) must be unique.
"originName": "A String", # Origin name, for example, London.
"similarDestinationIds": [ # Similar destination IDs, for example, PAR,LON.
"A String",
],
},
"dynamicHotelsAndRentalsAsset": { # A dynamic hotels and rentals asset. # A dynamic hotels and rentals asset.
"address": "A String", # Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"category": "A String", # Category, for example, Hotel suite.
"contextualKeywords": [ # Contextual keywords, for example, Mountain View "Hotels", South Bay hotels.
"A String",
],
"description": "A String", # Description, for example, Close to SJC Airport.
"destinationName": "A String", # Destination name, for example, Downtown Mountain View.
"formattedPrice": "A String", # Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
"formattedSalePrice": "A String", # Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"price": "A String", # Price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
"propertyId": "A String", # Required. Property ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"propertyName": "A String", # Required. Property name, for example, Mountain View Hotel. Required.
"salePrice": "A String", # ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field.
"similarPropertyIds": [ # Similar property IDs.
"A String",
],
"starRating": "A String", # Star rating. Must be a number between 1 to 5, inclusive.
},
"dynamicJobsAsset": { # A dynamic jobs asset. # A dynamic jobs asset.
"address": "A String", # Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403.
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"contextualKeywords": [ # Contextual keywords, for example, Software engineering job.
"A String",
],
"description": "A String", # Description, for example, Apply your technical skills.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"jobCategory": "A String", # Job category, for example, Technical.
"jobId": "A String", # Required. Job ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"jobSubtitle": "A String", # Job subtitle, for example, Level II.
"jobTitle": "A String", # Required. Job title, for example, Software engineer. Required.
"locationId": "A String", # Location ID which can be any sequence of letters and digits. The ID sequence (job ID + location ID) must be unique.
"salary": "A String", # Salary, for example, $100,000.
"similarJobIds": [ # Similar job IDs, for example, 1275.
"A String",
],
},
"dynamicLocalAsset": { # A dynamic local asset. # A dynamic local asset.
"address": "A String", # Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403.
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"category": "A String", # Category, for example, Food.
"contextualKeywords": [ # Contextual keywords, for example, Save groceries coupons.
"A String",
],
"dealId": "A String", # Required. Deal ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"dealName": "A String", # Required. Deal name, for example, 50% off at Mountain View Grocers. Required.
"description": "A String", # Description, for example, Save on your weekly bill.
"formattedPrice": "A String", # Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
"formattedSalePrice": "A String", # Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"price": "A String", # Price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
"salePrice": "A String", # Sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field.
"similarDealIds": [ # Similar deal IDs, for example, 1275.
"A String",
],
"subtitle": "A String", # Subtitle, for example, Groceries.
},
"dynamicRealEstateAsset": { # A dynamic real estate asset. # A dynamic real estate asset.
"address": "A String", # Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"cityName": "A String", # City name, for example, Mountain View, California.
"contextualKeywords": [ # Contextual keywords, for example, For sale; Houses for sale.
"A String",
],
"description": "A String", # Description, for example, 3 beds, 2 baths, 1568 sq. ft.
"formattedPrice": "A String", # Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $200,000.00.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"listingId": "A String", # Required. Listing ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"listingName": "A String", # Required. Listing name, for example, Boulevard Bungalow. Required.
"listingType": "A String", # Listing type, for example, For sale.
"price": "A String", # Price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 200,000.00 USD.
"propertyType": "A String", # Property type, for example, House.
"similarListingIds": [ # Similar listing IDs.
"A String",
],
},
"dynamicTravelAsset": { # A dynamic travel asset. # A dynamic travel asset.
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"category": "A String", # Category, for example, Express.
"contextualKeywords": [ # Contextual keywords, for example, Paris trains.
"A String",
],
"destinationAddress": "A String", # Destination address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403.
"destinationId": "A String", # Required. Destination ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"destinationName": "A String", # Destination name, for example, Paris.
"formattedPrice": "A String", # Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
"formattedSalePrice": "A String", # Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"originId": "A String", # Origin ID which can be any sequence of letters and digits. The ID sequence (destination ID + origin ID) must be unique.
"originName": "A String", # Origin name, for example, London.
"price": "A String", # Price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
"salePrice": "A String", # Sale price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field.
"similarDestinationIds": [ # Similar destination IDs, for example, NYC.
"A String",
],
"title": "A String", # Required. Title, for example, Book your train ticket. Required.
},
"engineStatus": "A String", # Output only. The Engine Status for an asset.
"fieldTypePolicySummaries": [ # Output only. Policy information for the asset for each FieldType.
{ # Contains policy information for an asset under AssetFieldType context.
"assetFieldType": "A String", # Output only. FieldType of this asset.
"assetSource": "A String", # Output only. Source of this asset.
"policySummaryInfo": { # Contains policy information for an asset. # Output only. Policy summary.
"approvalStatus": "A String", # Output only. The overall approval status of this asset, calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # Output only. The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Output only. Where in the review process this asset is.
},
},
],
"finalMobileUrls": [ # A list of possible final mobile URLs after all cross domain redirects.
"A String",
],
"finalUrlSuffix": "A String", # URL template for appending params to landing page URLs served with parallel tracking.
"finalUrls": [ # A list of possible final URLs after all cross domain redirects.
"A String",
],
"hotelCalloutAsset": { # An asset representing a hotel callout. # A hotel callout asset.
"languageCode": "A String", # Required. The language of the hotel callout. Represented as BCP 47 language tag.
"text": "A String", # Required. The text of the hotel callout asset. The length of this string should be between 1 and 25, inclusive.
},
"hotelPropertyAsset": { # A hotel property asset. # Immutable. A hotel property asset.
"hotelAddress": "A String", # Address of the hotel. Read-only.
"hotelName": "A String", # Name of the hotel. Read-only.
"placeId": "A String", # Place IDs uniquely identify a place in the Google Places database and on Google Maps. See https://developers.google.com/places/web-service/place-id to learn more.
},
"id": "A String", # Output only. The ID of the asset.
"imageAsset": { # An Image asset. # Output only. An image asset.
"data": "A String", # The raw bytes data of an image. This field is mutate only.
"fileSize": "A String", # File size of the image asset in bytes.
"fullSize": { # Metadata for an image at a certain size, either original or resized. # Metadata for this image at its original size.
"heightPixels": "A String", # Height of the image.
"url": "A String", # A URL that returns the image with this height and width.
"widthPixels": "A String", # Width of the image.
},
"mimeType": "A String", # MIME type of the image asset.
},
"lastModifiedTime": "A String", # Output only. The datetime when this asset was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
"leadFormAsset": { # A Lead Form asset. # A lead form asset.
"backgroundImageAsset": "A String", # Asset resource name of the background image. The image dimensions must be exactly 1200x628.
"businessName": "A String", # Required. The name of the business being advertised.
"callToActionDescription": "A String", # Required. Text giving a clear value proposition of what users expect once they expand the form.
"callToActionType": "A String", # Required. Pre-defined display text that encourages user to expand the form.
"customDisclosure": "A String", # Custom disclosure shown along with Google disclaimer on the lead form. Accessible to allowed customers only.
"customQuestionFields": [ # Ordered list of custom question fields. This field is subject to a limit of 5 qualifying questions per form.
{ # One custom question input field instance within a form.
"customQuestionText": "A String", # The exact custom question field text (for example, "What kind of vehicle do you have?").
"hasLocationAnswer": True or False, # Answer configuration for location question. If true, campaign/account level location data (state, city, business name etc) will be rendered on the Lead Form. Starting V13.1, has_location_answer can only be set for "What is your preferred dealership?" question, for advertisers with Location Assets setup at campaign/account level.
"singleChoiceAnswers": { # Defines possible answers for a single choice question, usually presented as a single-choice drop-down list. # Answer configuration for a single choice question. Minimum of 2 answers and maximum of 12 allowed.
"answers": [ # List of choices for a single question field. The order of entries defines UI order. Minimum of 2 answers required and maximum of 12 allowed.
"A String",
],
},
},
],
"deliveryMethods": [ # Configured methods for collected lead data to be delivered to advertiser. Only one method typed as WebhookDelivery can be configured.
{ # A configuration of how leads are delivered to the advertiser.
"webhook": { # Google notifies the advertiser of leads by making HTTP calls to an endpoint they specify. The requests contain JSON matching a schema that Google publishes as part of form ads documentation. # Webhook method of delivery.
"advertiserWebhookUrl": "A String", # Webhook url specified by advertiser to send the lead.
"googleSecret": "A String", # Anti-spoofing secret set by the advertiser as part of the webhook payload.
"payloadSchemaVersion": "A String", # The schema version that this delivery instance will use.
},
},
],
"description": "A String", # Required. Detailed description of the expanded form to describe what the form is asking for or facilitating.
"desiredIntent": "A String", # Chosen intent for the lead form, for example, more volume or more qualified.
"fields": [ # Ordered list of input fields. This field can be updated by reordering questions, but not by adding or removing questions.
{ # One input field instance within a form.
"hasLocationAnswer": True or False, # Answer configuration for location question. If true, campaign/account level location data (state, city, business name etc) will be rendered on the Lead Form. Starting V13.1, has_location_answer can only be set for "What is your preferred dealership?" question, for advertisers with Location Assets setup at campaign/account level.
"inputType": "A String", # Describes the input type, which may be a predefined type such as "full name" or a pre-vetted question like "What kind of vehicle do you have?".
"singleChoiceAnswers": { # Defines possible answers for a single choice question, usually presented as a single-choice drop-down list. # Answer configuration for a single choice question. Can be set only for pre-vetted question fields. Minimum of 2 answers required and maximum of 12 allowed.
"answers": [ # List of choices for a single question field. The order of entries defines UI order. Minimum of 2 answers required and maximum of 12 allowed.
"A String",
],
},
},
],
"headline": "A String", # Required. Headline of the expanded form to describe what the form is asking for or facilitating.
"postSubmitCallToActionType": "A String", # Pre-defined display text that encourages user action after the form is submitted.
"postSubmitDescription": "A String", # Detailed description shown after form submission that describes how the advertiser will follow up with the user.
"postSubmitHeadline": "A String", # Headline of text shown after form submission that describes how the advertiser will follow up with the user.
"privacyPolicyUrl": "A String", # Required. Link to a page describing the policy on how the collected data is handled by the advertiser/business.
},
"locationAsset": { # A location asset. # Output only. A location asset.
"businessProfileLocations": [ # The list of business locations for the customer. This will only be returned if the Location Asset is syncing from the Business Profile account. It is possible to have multiple Business Profile listings under the same account that point to the same Place ID.
{ # Business Profile location data synced from the linked Business Profile account.
"labels": [ # Advertiser specified label for the location on the Business Profile account. This is synced from the Business Profile account.
"A String",
],
"listingId": "A String", # Listing ID of this Business Profile location. This is synced from the linked Business Profile account.
"storeCode": "A String", # Business Profile store code of this location. This is synced from the Business Profile account.
},
],
"locationOwnershipType": "A String", # The type of location ownership. If the type is BUSINESS_OWNER, it will be served as a location extension. If the type is AFFILIATE, it will be served as an affiliate location.
"placeId": "A String", # Place IDs uniquely identify a place in the Google Places database and on Google Maps. This field is unique for a given customer ID and asset type. See https://developers.google.com/places/web-service/place-id to learn more about Place ID.
},
"mediaBundleAsset": { # A MediaBundle asset. # Immutable. A media bundle asset.
"data": "A String", # Media bundle (ZIP file) asset data. The format of the uploaded ZIP file depends on the ad field where it will be used. For more information on the format, see the documentation of the ad field where you plan on using the MediaBundleAsset. This field is mutate only.
},
"mobileAppAsset": { # An asset representing a mobile app. # A mobile app asset.
"appId": "A String", # Required. A string that uniquely identifies a mobile application. It should just contain the platform native id, like "com.android.ebay" for Android or "12345689" for iOS.
"appStore": "A String", # Required. The application store that distributes this specific app.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"linkText": "A String", # Required. The visible text displayed when the link is rendered in an ad. The length of this string should be between 1 and 25, inclusive.
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
},
"name": "A String", # Optional name of the asset.
"orientation": "A String", # Output only. Orientation of the asset. This is only supported for image and video assets.
"pageFeedAsset": { # A Page Feed asset. # A page feed asset.
"labels": [ # Labels used to group the page urls.
"A String",
],
"pageUrl": "A String", # Required. The webpage that advertisers want to target.
},
"policySummary": { # Contains policy information for an asset. # Output only. Policy information for the asset.
"approvalStatus": "A String", # Output only. The overall approval status of this asset, calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # Output only. The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Output only. Where in the review process this asset is.
},
"priceAsset": { # An asset representing a list of price offers. # A price asset.
"languageCode": "A String", # Required. The language of the price asset. Represented as BCP 47 language tag.
"priceOfferings": [ # The price offerings of the price asset. The size of this collection should be between 3 and 8, inclusive.
{ # A single price offering within a PriceAsset.
"description": "A String", # Required. The description of the price offering. The length of this string should be between 1 and 25, inclusive.
"finalMobileUrl": "A String", # The final mobile URL after all cross domain redirects.
"finalUrl": "A String", # Required. The final URL after all cross domain redirects.
"header": "A String", # Required. The header of the price offering. The length of this string should be between 1 and 25, inclusive.
"price": { # Represents a price in a particular currency. # Required. The price value of the price offering.
"amountMicros": "A String", # Amount in micros. One million is equivalent to one unit.
"currencyCode": "A String", # Three-character ISO 4217 currency code.
},
"unit": "A String", # The price unit of the price offering.
},
],
"priceQualifier": "A String", # The price qualifier of the price asset.
"type": "A String", # Required. The type of the price asset.
},
"promotionAsset": { # A Promotion asset. # A promotion asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"discountModifier": "A String", # A modifier for qualification of the discount.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"languageCode": "A String", # The language of the promotion. Represented as BCP 47 language tag.
"moneyAmountOff": { # Represents a price in a particular currency. # Money amount off for discount in the promotion. Either this or percent_off is required.
"amountMicros": "A String", # Amount in micros. One million is equivalent to one unit.
"currencyCode": "A String", # Three-character ISO 4217 currency code.
},
"occasion": "A String", # The occasion the promotion was intended for. If an occasion is set, the redemption window will need to fall within the date range associated with the occasion.
"ordersOverAmount": { # Represents a price in a particular currency. # The amount the total order needs to be for the user to be eligible for the promotion.
"amountMicros": "A String", # Amount in micros. One million is equivalent to one unit.
"currencyCode": "A String", # Three-character ISO 4217 currency code.
},
"percentOff": "A String", # Percentage off discount in the promotion. 1,000,000 = 100%. Either this or money_amount_off is required.
"promotionBarcodeInfo": { # Barcode info to generate promotion barcode. # Barcode info used to generate promotion barcode for user to be eligible for the promotion.
"barcodeContent": "A String", # Promotion message to be encoded in the barcode.
"type": "A String", # Barcode type used to generate barcode with the correct format.
},
"promotionCode": "A String", # A code the user should use in order to be eligible for the promotion.
"promotionQrCodeInfo": { # QR code info to generate promotion QR code. # QR code info used to generate promotion QR code for user to be eligible for the promotion.
"qrCodeContent": "A String", # Promotion message to be encoded in the QR code.
},
"promotionTarget": "A String", # Required. A freeform description of what the promotion is targeting.
"redemptionEndDate": "A String", # Last date of when the promotion is eligible to be redeemed, in yyyy-MM-dd format.
"redemptionStartDate": "A String", # Start date of when the promotion is eligible to be redeemed, in yyyy-MM-dd format.
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
"termsAndConditionsText": "A String", # Terms and conditions of the promotion.
"termsAndConditionsUri": "A String", # URI to the terms and conditions of the promotion.
},
"resourceName": "A String", # Immutable. The resource name of the asset. Asset resource names have the form: `customers/{customer_id}/assets/{asset_id}`
"searchAds360CallAsset": { # A unified call asset. # Output only. A unified call asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"callConversionAction": "A String", # The conversion action to attribute a call conversion to. If not set, the default conversion action is used. This field only has effect if call_conversion_reporting_state is set to USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
"callConversionReportingState": "A String", # Output only. Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion.
"callOnly": True or False, # Whether the call only shows the phone number without a link to the website. Applies to Microsoft Ads.
"callTrackingEnabled": True or False, # Whether the call should be enabled on call tracking. Applies to Microsoft Ads.
"countryCode": "A String", # Two-letter country code of the phone number. Examples: 'US', 'us'.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"phoneNumber": "A String", # The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890'
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
"useSearcherTimeZone": True or False, # Whether to show the call extension in search user's time zone. Applies to Microsoft Ads.
},
"searchAds360CalloutAsset": { # A unified callout asset. # Output only. A unified callout asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"calloutText": "A String", # The callout text. The length of this string should be between 1 and 25, inclusive.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
"useSearcherTimeZone": True or False, # Whether to show the asset in search user's time zone. Applies to Microsoft Ads.
},
"searchAds360LocationAsset": { # A unified location asset. # Output only. A unified location asset.
"businessProfileLocations": [ # The list of business locations for the customer. This will only be returned if the Location Asset is syncing from the Business Profile account. It is possible to have multiple Business Profile listings under the same account that point to the same Place ID.
{ # Business Profile location data synced from the linked Business Profile account.
"labels": [ # Advertiser specified label for the location on the Business Profile account. This is synced from the Business Profile account.
"A String",
],
"listingId": "A String", # Listing ID of this Business Profile location. This is synced from the linked Business Profile account.
"storeCode": "A String", # Business Profile store code of this location. This is synced from the Business Profile account.
},
],
"locationOwnershipType": "A String", # The type of location ownership. If the type is BUSINESS_OWNER, it will be served as a location extension. If the type is AFFILIATE, it will be served as an affiliate location.
"placeId": "A String", # Place IDs uniquely identify a place in the Google Places database and on Google Maps. This field is unique for a given customer ID and asset type. See https://developers.google.com/places/web-service/place-id to learn more about Place ID.
},
"searchAds360PageFeedAsset": { # A Unified Page Feed asset. # Output only. A unified page feed asset.
"labels": [ # Labels used to group the page urls.
"A String",
],
"pageUrl": "A String", # The webpage that advertisers want to target.
},
"searchAds360SitelinkAsset": { # A unified sitelink asset. # Output only. A unified sitelink asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"description1": "A String", # First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set.
"description2": "A String", # Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"linkText": "A String", # URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive.
"mobilePreferred": True or False, # Whether the preference is for the sitelink asset to be displayed on mobile devices. Applies to Microsoft Ads.
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
"trackingId": "A String", # ID used for tracking clicks for the sitelink asset. This is a Yahoo! Japan only field.
"useSearcherTimeZone": True or False, # Whether to show the sitelink asset in search user's time zone. Applies to Microsoft Ads.
},
"sitelinkAsset": { # A Sitelink asset. # A sitelink asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"description1": "A String", # First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set.
"description2": "A String", # Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"linkText": "A String", # Required. URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive.
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
},
"source": "A String", # Output only. Source of the asset.
"status": "A String", # Output only. The status of the asset.
"structuredSnippetAsset": { # A Structured Snippet asset. # A structured snippet asset.
"header": "A String", # Required. The header of the snippet. This string should be one of the predefined values at https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers
"values": [ # Required. The values in the snippet. The size of this collection should be between 3 and 10, inclusive. The length of each value should be between 1 and 25 characters, inclusive.
"A String",
],
},
"textAsset": { # A Text asset. # Immutable. A text asset.
"text": "A String", # Text content of the text asset.
},
"trackingUrlTemplate": "A String", # URL template for constructing a tracking URL.
"type": "A String", # Output only. Type of the asset.
"urlCustomParameters": [ # A list of mappings to be used for substituting URL custom parameter tags in the tracking_url_template, final_urls, and/or final_mobile_urls.
{ # A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
"key": "A String", # The key matching the parameter tag name.
"value": "A String", # The value to be substituted.
},
],
"youtubeVideoAsset": { # A YouTube asset. # Immutable. A YouTube video asset.
"youtubeVideoId": "A String", # YouTube video id. This is the 11 character string value used in the YouTube video URL.
"youtubeVideoTitle": "A String", # YouTube video title.
},
},
"update": { # Asset is a part of an ad which can be shared across multiple ads. It can be an image (ImageAsset), a video (YoutubeVideoAsset), etc. Assets are immutable and cannot be removed. To stop an asset from serving, remove the asset from the entity that is using it. # Update operation: The asset is expected to have a valid resource name in this format: `customers/{customer_id}/assets/{asset_id}`
"appDeepLinkAsset": { # An app deep link asset # Immutable. An app deep link asset.
"appDeepLinkUri": "A String", # The uri for the app deep link, The uri can be either a custom scheme uri (e.g. mystore://shoes) or universal uri (e.g. http://www.mystore.com/shoes).
},
"bookOnGoogleAsset": { # A Book on Google asset. Used to redirect user to book through Google. Book on Google will change the redirect url to book directly through Google. # A book on google asset.
},
"businessMessageAsset": { # A business message asset. # A business message asset.
"callToAction": { # Display information that encourages the user to take action. # A call to action for the business message asset.
"callToActionDescription": "A String", # Required. Text providing a clear value proposition of what users expect once they take the action. Examples: 'Message us for a quote', 'Ask our expert team'.
"callToActionSelection": "A String", # Required. Pre-defined call to action text.
},
"facebookMessengerInfo": { # Facebook Messenger information to use for messaging. # Facebook Messenger.
"pageName": "A String", # Required. Facebook page name used for starting a chat on Facebook Messenger.
},
"messageProvider": "A String", # Required. Message provider of the business message asset.
"starterMessage": "A String", # Required. A welcome message to prompt the user to initiate a conversation.
"whatsappInfo": { # Whatsapp information to use for messaging. # Whatsapp.
"countryCode": "A String", # Required. Two-letter country code of the phone number. Examples: 'US', 'us'.
"phoneNumber": "A String", # Required. Whatsapp phone number of the business. Examples: '1234567890', '(123)456-7890'.
},
"zaloInfo": { # Zalo information to use for messaging. # Zalo.
"customName": "A String", # Custom name generated by the advertiser for their Zalo Account. These names will usually be registered brands or trademarks.
"oaId": "A String", # Zalo Official Account ID of the advertiser.
},
},
"callAsset": { # A Call asset. # A call asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"callConversionAction": "A String", # The conversion action to attribute a call conversion to. If not set, the default conversion action is used. This field only has effect if call_conversion_reporting_state is set to USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
"callConversionReportingState": "A String", # Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion.
"countryCode": "A String", # Required. Two-letter country code of the phone number. Examples: 'US', 'us'.
"phoneNumber": "A String", # Required. The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890'
},
"callToActionAsset": { # A call to action asset. # Immutable. A call to action asset.
"callToAction": "A String", # Call to action.
},
"calloutAsset": { # A Callout asset. # A callout asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"calloutText": "A String", # Required. The callout text. The length of this string should be between 1 and 25, inclusive.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
},
"creationTime": "A String", # Output only. The timestamp when this asset was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
"demandGenCarouselCardAsset": { # A Demand Gen Carousel Card asset. # Immutable. A Demand Gen carousel card asset.
"callToActionText": "A String", # Call to action text.
"headline": "A String", # Required. Headline of the carousel card.
"marketingImageAsset": "A String", # Asset resource name of the associated 1.91:1 marketing image. This and/or square marketing image asset is required.
"portraitMarketingImageAsset": "A String", # Asset resource name of the associated 4:5 portrait marketing image.
"squareMarketingImageAsset": "A String", # Asset resource name of the associated square marketing image. This and/or a marketing image asset is required.
},
"dynamicCustomAsset": { # A dynamic custom asset. # A dynamic custom asset.
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"contextualKeywords": [ # Contextual keywords, for example, Sedans, 4 door sedans.
"A String",
],
"formattedPrice": "A String", # Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $20,000.00.
"formattedSalePrice": "A String", # Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $15,000.00.
"id": "A String", # Required. ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag, for example, sedan. Required.
"id2": "A String", # ID2 which can be any sequence of letters and digits, for example, red. ID sequence (ID + ID2) must be unique.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"itemAddress": "A String", # Item address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
"itemCategory": "A String", # Item category, for example, Sedans.
"itemDescription": "A String", # Item description, for example, Best selling mid-size car.
"itemSubtitle": "A String", # Item subtitle, for example, At your Mountain View dealership.
"itemTitle": "A String", # Required. Item title, for example, Mid-size sedan. Required.
"price": "A String", # Price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 20,000.00 USD.
"salePrice": "A String", # Sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 15,000.00 USD. Must be less than the 'price' field.
"similarIds": [ # Similar IDs.
"A String",
],
},
"dynamicEducationAsset": { # A Dynamic Education asset. # A dynamic education asset.
"address": "A String", # School address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"contextualKeywords": [ # Contextual keywords, for example, Nursing certification, Health, Mountain View.
"A String",
],
"imageUrl": "A String", # Image url, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"locationId": "A String", # Location ID which can be any sequence of letters and digits and must be unique.
"programDescription": "A String", # Program description, for example, Nursing Certification.
"programId": "A String", # Required. Program ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"programName": "A String", # Required. Program name, for example, Nursing. Required.
"schoolName": "A String", # School name, for example, Mountain View School of Nursing.
"similarProgramIds": [ # Similar program IDs.
"A String",
],
"subject": "A String", # Subject of study, for example, Health.
"thumbnailImageUrl": "A String", # Thumbnail image url, for example, http://www.example.com/thumbnail.png. The thumbnail image will not be uploaded as image asset.
},
"dynamicFlightsAsset": { # A dynamic flights asset. # A dynamic flights asset.
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"customMapping": "A String", # A custom field which can be multiple key to values mapping separated by delimiters (",", "|" and ":"), in the forms of ": , , ... , | : , ... , | ... | : , ... ," for example, wifi: most | aircraft: 320, 77W | flights: 42 | legroom: 32".
"destinationId": "A String", # Required. Destination ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"destinationName": "A String", # Destination name, for example, Paris.
"flightDescription": "A String", # Required. Flight description, for example, Book your ticket. Required.
"flightPrice": "A String", # Flight price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
"flightSalePrice": "A String", # Flight sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'flight_price' field.
"formattedPrice": "A String", # Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
"formattedSalePrice": "A String", # Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"originId": "A String", # Origin ID which can be any sequence of letters and digits. The ID sequence (destination ID + origin ID) must be unique.
"originName": "A String", # Origin name, for example, London.
"similarDestinationIds": [ # Similar destination IDs, for example, PAR,LON.
"A String",
],
},
"dynamicHotelsAndRentalsAsset": { # A dynamic hotels and rentals asset. # A dynamic hotels and rentals asset.
"address": "A String", # Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"category": "A String", # Category, for example, Hotel suite.
"contextualKeywords": [ # Contextual keywords, for example, Mountain View "Hotels", South Bay hotels.
"A String",
],
"description": "A String", # Description, for example, Close to SJC Airport.
"destinationName": "A String", # Destination name, for example, Downtown Mountain View.
"formattedPrice": "A String", # Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
"formattedSalePrice": "A String", # Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"price": "A String", # Price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
"propertyId": "A String", # Required. Property ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"propertyName": "A String", # Required. Property name, for example, Mountain View Hotel. Required.
"salePrice": "A String", # ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field.
"similarPropertyIds": [ # Similar property IDs.
"A String",
],
"starRating": "A String", # Star rating. Must be a number between 1 to 5, inclusive.
},
"dynamicJobsAsset": { # A dynamic jobs asset. # A dynamic jobs asset.
"address": "A String", # Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403.
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"contextualKeywords": [ # Contextual keywords, for example, Software engineering job.
"A String",
],
"description": "A String", # Description, for example, Apply your technical skills.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"jobCategory": "A String", # Job category, for example, Technical.
"jobId": "A String", # Required. Job ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"jobSubtitle": "A String", # Job subtitle, for example, Level II.
"jobTitle": "A String", # Required. Job title, for example, Software engineer. Required.
"locationId": "A String", # Location ID which can be any sequence of letters and digits. The ID sequence (job ID + location ID) must be unique.
"salary": "A String", # Salary, for example, $100,000.
"similarJobIds": [ # Similar job IDs, for example, 1275.
"A String",
],
},
"dynamicLocalAsset": { # A dynamic local asset. # A dynamic local asset.
"address": "A String", # Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403.
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"category": "A String", # Category, for example, Food.
"contextualKeywords": [ # Contextual keywords, for example, Save groceries coupons.
"A String",
],
"dealId": "A String", # Required. Deal ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"dealName": "A String", # Required. Deal name, for example, 50% off at Mountain View Grocers. Required.
"description": "A String", # Description, for example, Save on your weekly bill.
"formattedPrice": "A String", # Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
"formattedSalePrice": "A String", # Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"price": "A String", # Price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
"salePrice": "A String", # Sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field.
"similarDealIds": [ # Similar deal IDs, for example, 1275.
"A String",
],
"subtitle": "A String", # Subtitle, for example, Groceries.
},
"dynamicRealEstateAsset": { # A dynamic real estate asset. # A dynamic real estate asset.
"address": "A String", # Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"cityName": "A String", # City name, for example, Mountain View, California.
"contextualKeywords": [ # Contextual keywords, for example, For sale; Houses for sale.
"A String",
],
"description": "A String", # Description, for example, 3 beds, 2 baths, 1568 sq. ft.
"formattedPrice": "A String", # Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $200,000.00.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"listingId": "A String", # Required. Listing ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"listingName": "A String", # Required. Listing name, for example, Boulevard Bungalow. Required.
"listingType": "A String", # Listing type, for example, For sale.
"price": "A String", # Price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 200,000.00 USD.
"propertyType": "A String", # Property type, for example, House.
"similarListingIds": [ # Similar listing IDs.
"A String",
],
},
"dynamicTravelAsset": { # A dynamic travel asset. # A dynamic travel asset.
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"category": "A String", # Category, for example, Express.
"contextualKeywords": [ # Contextual keywords, for example, Paris trains.
"A String",
],
"destinationAddress": "A String", # Destination address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403.
"destinationId": "A String", # Required. Destination ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"destinationName": "A String", # Destination name, for example, Paris.
"formattedPrice": "A String", # Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
"formattedSalePrice": "A String", # Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"originId": "A String", # Origin ID which can be any sequence of letters and digits. The ID sequence (destination ID + origin ID) must be unique.
"originName": "A String", # Origin name, for example, London.
"price": "A String", # Price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
"salePrice": "A String", # Sale price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field.
"similarDestinationIds": [ # Similar destination IDs, for example, NYC.
"A String",
],
"title": "A String", # Required. Title, for example, Book your train ticket. Required.
},
"engineStatus": "A String", # Output only. The Engine Status for an asset.
"fieldTypePolicySummaries": [ # Output only. Policy information for the asset for each FieldType.
{ # Contains policy information for an asset under AssetFieldType context.
"assetFieldType": "A String", # Output only. FieldType of this asset.
"assetSource": "A String", # Output only. Source of this asset.
"policySummaryInfo": { # Contains policy information for an asset. # Output only. Policy summary.
"approvalStatus": "A String", # Output only. The overall approval status of this asset, calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # Output only. The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Output only. Where in the review process this asset is.
},
},
],
"finalMobileUrls": [ # A list of possible final mobile URLs after all cross domain redirects.
"A String",
],
"finalUrlSuffix": "A String", # URL template for appending params to landing page URLs served with parallel tracking.
"finalUrls": [ # A list of possible final URLs after all cross domain redirects.
"A String",
],
"hotelCalloutAsset": { # An asset representing a hotel callout. # A hotel callout asset.
"languageCode": "A String", # Required. The language of the hotel callout. Represented as BCP 47 language tag.
"text": "A String", # Required. The text of the hotel callout asset. The length of this string should be between 1 and 25, inclusive.
},
"hotelPropertyAsset": { # A hotel property asset. # Immutable. A hotel property asset.
"hotelAddress": "A String", # Address of the hotel. Read-only.
"hotelName": "A String", # Name of the hotel. Read-only.
"placeId": "A String", # Place IDs uniquely identify a place in the Google Places database and on Google Maps. See https://developers.google.com/places/web-service/place-id to learn more.
},
"id": "A String", # Output only. The ID of the asset.
"imageAsset": { # An Image asset. # Output only. An image asset.
"data": "A String", # The raw bytes data of an image. This field is mutate only.
"fileSize": "A String", # File size of the image asset in bytes.
"fullSize": { # Metadata for an image at a certain size, either original or resized. # Metadata for this image at its original size.
"heightPixels": "A String", # Height of the image.
"url": "A String", # A URL that returns the image with this height and width.
"widthPixels": "A String", # Width of the image.
},
"mimeType": "A String", # MIME type of the image asset.
},
"lastModifiedTime": "A String", # Output only. The datetime when this asset was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
"leadFormAsset": { # A Lead Form asset. # A lead form asset.
"backgroundImageAsset": "A String", # Asset resource name of the background image. The image dimensions must be exactly 1200x628.
"businessName": "A String", # Required. The name of the business being advertised.
"callToActionDescription": "A String", # Required. Text giving a clear value proposition of what users expect once they expand the form.
"callToActionType": "A String", # Required. Pre-defined display text that encourages user to expand the form.
"customDisclosure": "A String", # Custom disclosure shown along with Google disclaimer on the lead form. Accessible to allowed customers only.
"customQuestionFields": [ # Ordered list of custom question fields. This field is subject to a limit of 5 qualifying questions per form.
{ # One custom question input field instance within a form.
"customQuestionText": "A String", # The exact custom question field text (for example, "What kind of vehicle do you have?").
"hasLocationAnswer": True or False, # Answer configuration for location question. If true, campaign/account level location data (state, city, business name etc) will be rendered on the Lead Form. Starting V13.1, has_location_answer can only be set for "What is your preferred dealership?" question, for advertisers with Location Assets setup at campaign/account level.
"singleChoiceAnswers": { # Defines possible answers for a single choice question, usually presented as a single-choice drop-down list. # Answer configuration for a single choice question. Minimum of 2 answers and maximum of 12 allowed.
"answers": [ # List of choices for a single question field. The order of entries defines UI order. Minimum of 2 answers required and maximum of 12 allowed.
"A String",
],
},
},
],
"deliveryMethods": [ # Configured methods for collected lead data to be delivered to advertiser. Only one method typed as WebhookDelivery can be configured.
{ # A configuration of how leads are delivered to the advertiser.
"webhook": { # Google notifies the advertiser of leads by making HTTP calls to an endpoint they specify. The requests contain JSON matching a schema that Google publishes as part of form ads documentation. # Webhook method of delivery.
"advertiserWebhookUrl": "A String", # Webhook url specified by advertiser to send the lead.
"googleSecret": "A String", # Anti-spoofing secret set by the advertiser as part of the webhook payload.
"payloadSchemaVersion": "A String", # The schema version that this delivery instance will use.
},
},
],
"description": "A String", # Required. Detailed description of the expanded form to describe what the form is asking for or facilitating.
"desiredIntent": "A String", # Chosen intent for the lead form, for example, more volume or more qualified.
"fields": [ # Ordered list of input fields. This field can be updated by reordering questions, but not by adding or removing questions.
{ # One input field instance within a form.
"hasLocationAnswer": True or False, # Answer configuration for location question. If true, campaign/account level location data (state, city, business name etc) will be rendered on the Lead Form. Starting V13.1, has_location_answer can only be set for "What is your preferred dealership?" question, for advertisers with Location Assets setup at campaign/account level.
"inputType": "A String", # Describes the input type, which may be a predefined type such as "full name" or a pre-vetted question like "What kind of vehicle do you have?".
"singleChoiceAnswers": { # Defines possible answers for a single choice question, usually presented as a single-choice drop-down list. # Answer configuration for a single choice question. Can be set only for pre-vetted question fields. Minimum of 2 answers required and maximum of 12 allowed.
"answers": [ # List of choices for a single question field. The order of entries defines UI order. Minimum of 2 answers required and maximum of 12 allowed.
"A String",
],
},
},
],
"headline": "A String", # Required. Headline of the expanded form to describe what the form is asking for or facilitating.
"postSubmitCallToActionType": "A String", # Pre-defined display text that encourages user action after the form is submitted.
"postSubmitDescription": "A String", # Detailed description shown after form submission that describes how the advertiser will follow up with the user.
"postSubmitHeadline": "A String", # Headline of text shown after form submission that describes how the advertiser will follow up with the user.
"privacyPolicyUrl": "A String", # Required. Link to a page describing the policy on how the collected data is handled by the advertiser/business.
},
"locationAsset": { # A location asset. # Output only. A location asset.
"businessProfileLocations": [ # The list of business locations for the customer. This will only be returned if the Location Asset is syncing from the Business Profile account. It is possible to have multiple Business Profile listings under the same account that point to the same Place ID.
{ # Business Profile location data synced from the linked Business Profile account.
"labels": [ # Advertiser specified label for the location on the Business Profile account. This is synced from the Business Profile account.
"A String",
],
"listingId": "A String", # Listing ID of this Business Profile location. This is synced from the linked Business Profile account.
"storeCode": "A String", # Business Profile store code of this location. This is synced from the Business Profile account.
},
],
"locationOwnershipType": "A String", # The type of location ownership. If the type is BUSINESS_OWNER, it will be served as a location extension. If the type is AFFILIATE, it will be served as an affiliate location.
"placeId": "A String", # Place IDs uniquely identify a place in the Google Places database and on Google Maps. This field is unique for a given customer ID and asset type. See https://developers.google.com/places/web-service/place-id to learn more about Place ID.
},
"mediaBundleAsset": { # A MediaBundle asset. # Immutable. A media bundle asset.
"data": "A String", # Media bundle (ZIP file) asset data. The format of the uploaded ZIP file depends on the ad field where it will be used. For more information on the format, see the documentation of the ad field where you plan on using the MediaBundleAsset. This field is mutate only.
},
"mobileAppAsset": { # An asset representing a mobile app. # A mobile app asset.
"appId": "A String", # Required. A string that uniquely identifies a mobile application. It should just contain the platform native id, like "com.android.ebay" for Android or "12345689" for iOS.
"appStore": "A String", # Required. The application store that distributes this specific app.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"linkText": "A String", # Required. The visible text displayed when the link is rendered in an ad. The length of this string should be between 1 and 25, inclusive.
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
},
"name": "A String", # Optional name of the asset.
"orientation": "A String", # Output only. Orientation of the asset. This is only supported for image and video assets.
"pageFeedAsset": { # A Page Feed asset. # A page feed asset.
"labels": [ # Labels used to group the page urls.
"A String",
],
"pageUrl": "A String", # Required. The webpage that advertisers want to target.
},
"policySummary": { # Contains policy information for an asset. # Output only. Policy information for the asset.
"approvalStatus": "A String", # Output only. The overall approval status of this asset, calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # Output only. The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Output only. Where in the review process this asset is.
},
"priceAsset": { # An asset representing a list of price offers. # A price asset.
"languageCode": "A String", # Required. The language of the price asset. Represented as BCP 47 language tag.
"priceOfferings": [ # The price offerings of the price asset. The size of this collection should be between 3 and 8, inclusive.
{ # A single price offering within a PriceAsset.
"description": "A String", # Required. The description of the price offering. The length of this string should be between 1 and 25, inclusive.
"finalMobileUrl": "A String", # The final mobile URL after all cross domain redirects.
"finalUrl": "A String", # Required. The final URL after all cross domain redirects.
"header": "A String", # Required. The header of the price offering. The length of this string should be between 1 and 25, inclusive.
"price": { # Represents a price in a particular currency. # Required. The price value of the price offering.
"amountMicros": "A String", # Amount in micros. One million is equivalent to one unit.
"currencyCode": "A String", # Three-character ISO 4217 currency code.
},
"unit": "A String", # The price unit of the price offering.
},
],
"priceQualifier": "A String", # The price qualifier of the price asset.
"type": "A String", # Required. The type of the price asset.
},
"promotionAsset": { # A Promotion asset. # A promotion asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"discountModifier": "A String", # A modifier for qualification of the discount.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"languageCode": "A String", # The language of the promotion. Represented as BCP 47 language tag.
"moneyAmountOff": { # Represents a price in a particular currency. # Money amount off for discount in the promotion. Either this or percent_off is required.
"amountMicros": "A String", # Amount in micros. One million is equivalent to one unit.
"currencyCode": "A String", # Three-character ISO 4217 currency code.
},
"occasion": "A String", # The occasion the promotion was intended for. If an occasion is set, the redemption window will need to fall within the date range associated with the occasion.
"ordersOverAmount": { # Represents a price in a particular currency. # The amount the total order needs to be for the user to be eligible for the promotion.
"amountMicros": "A String", # Amount in micros. One million is equivalent to one unit.
"currencyCode": "A String", # Three-character ISO 4217 currency code.
},
"percentOff": "A String", # Percentage off discount in the promotion. 1,000,000 = 100%. Either this or money_amount_off is required.
"promotionBarcodeInfo": { # Barcode info to generate promotion barcode. # Barcode info used to generate promotion barcode for user to be eligible for the promotion.
"barcodeContent": "A String", # Promotion message to be encoded in the barcode.
"type": "A String", # Barcode type used to generate barcode with the correct format.
},
"promotionCode": "A String", # A code the user should use in order to be eligible for the promotion.
"promotionQrCodeInfo": { # QR code info to generate promotion QR code. # QR code info used to generate promotion QR code for user to be eligible for the promotion.
"qrCodeContent": "A String", # Promotion message to be encoded in the QR code.
},
"promotionTarget": "A String", # Required. A freeform description of what the promotion is targeting.
"redemptionEndDate": "A String", # Last date of when the promotion is eligible to be redeemed, in yyyy-MM-dd format.
"redemptionStartDate": "A String", # Start date of when the promotion is eligible to be redeemed, in yyyy-MM-dd format.
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
"termsAndConditionsText": "A String", # Terms and conditions of the promotion.
"termsAndConditionsUri": "A String", # URI to the terms and conditions of the promotion.
},
"resourceName": "A String", # Immutable. The resource name of the asset. Asset resource names have the form: `customers/{customer_id}/assets/{asset_id}`
"searchAds360CallAsset": { # A unified call asset. # Output only. A unified call asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"callConversionAction": "A String", # The conversion action to attribute a call conversion to. If not set, the default conversion action is used. This field only has effect if call_conversion_reporting_state is set to USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
"callConversionReportingState": "A String", # Output only. Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion.
"callOnly": True or False, # Whether the call only shows the phone number without a link to the website. Applies to Microsoft Ads.
"callTrackingEnabled": True or False, # Whether the call should be enabled on call tracking. Applies to Microsoft Ads.
"countryCode": "A String", # Two-letter country code of the phone number. Examples: 'US', 'us'.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"phoneNumber": "A String", # The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890'
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
"useSearcherTimeZone": True or False, # Whether to show the call extension in search user's time zone. Applies to Microsoft Ads.
},
"searchAds360CalloutAsset": { # A unified callout asset. # Output only. A unified callout asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"calloutText": "A String", # The callout text. The length of this string should be between 1 and 25, inclusive.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
"useSearcherTimeZone": True or False, # Whether to show the asset in search user's time zone. Applies to Microsoft Ads.
},
"searchAds360LocationAsset": { # A unified location asset. # Output only. A unified location asset.
"businessProfileLocations": [ # The list of business locations for the customer. This will only be returned if the Location Asset is syncing from the Business Profile account. It is possible to have multiple Business Profile listings under the same account that point to the same Place ID.
{ # Business Profile location data synced from the linked Business Profile account.
"labels": [ # Advertiser specified label for the location on the Business Profile account. This is synced from the Business Profile account.
"A String",
],
"listingId": "A String", # Listing ID of this Business Profile location. This is synced from the linked Business Profile account.
"storeCode": "A String", # Business Profile store code of this location. This is synced from the Business Profile account.
},
],
"locationOwnershipType": "A String", # The type of location ownership. If the type is BUSINESS_OWNER, it will be served as a location extension. If the type is AFFILIATE, it will be served as an affiliate location.
"placeId": "A String", # Place IDs uniquely identify a place in the Google Places database and on Google Maps. This field is unique for a given customer ID and asset type. See https://developers.google.com/places/web-service/place-id to learn more about Place ID.
},
"searchAds360PageFeedAsset": { # A Unified Page Feed asset. # Output only. A unified page feed asset.
"labels": [ # Labels used to group the page urls.
"A String",
],
"pageUrl": "A String", # The webpage that advertisers want to target.
},
"searchAds360SitelinkAsset": { # A unified sitelink asset. # Output only. A unified sitelink asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"description1": "A String", # First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set.
"description2": "A String", # Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"linkText": "A String", # URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive.
"mobilePreferred": True or False, # Whether the preference is for the sitelink asset to be displayed on mobile devices. Applies to Microsoft Ads.
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
"trackingId": "A String", # ID used for tracking clicks for the sitelink asset. This is a Yahoo! Japan only field.
"useSearcherTimeZone": True or False, # Whether to show the sitelink asset in search user's time zone. Applies to Microsoft Ads.
},
"sitelinkAsset": { # A Sitelink asset. # A sitelink asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"description1": "A String", # First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set.
"description2": "A String", # Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"linkText": "A String", # Required. URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive.
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
},
"source": "A String", # Output only. Source of the asset.
"status": "A String", # Output only. The status of the asset.
"structuredSnippetAsset": { # A Structured Snippet asset. # A structured snippet asset.
"header": "A String", # Required. The header of the snippet. This string should be one of the predefined values at https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers
"values": [ # Required. The values in the snippet. The size of this collection should be between 3 and 10, inclusive. The length of each value should be between 1 and 25 characters, inclusive.
"A String",
],
},
"textAsset": { # A Text asset. # Immutable. A text asset.
"text": "A String", # Text content of the text asset.
},
"trackingUrlTemplate": "A String", # URL template for constructing a tracking URL.
"type": "A String", # Output only. Type of the asset.
"urlCustomParameters": [ # A list of mappings to be used for substituting URL custom parameter tags in the tracking_url_template, final_urls, and/or final_mobile_urls.
{ # A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
"key": "A String", # The key matching the parameter tag name.
"value": "A String", # The value to be substituted.
},
],
"youtubeVideoAsset": { # A YouTube asset. # Immutable. A YouTube video asset.
"youtubeVideoId": "A String", # YouTube video id. This is the 11 character string value used in the YouTube video URL.
"youtubeVideoTitle": "A String", # YouTube video title.
},
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"assetSetAssetOperation": { # A single operation (create, remove) on an asset set asset. # An asset set asset mutate operation.
"create": { # AssetSetAsset is the link between an asset and an asset set. Adding an AssetSetAsset links an asset with an asset set. # Create operation: No resource name is expected for the new asset set asset
"asset": "A String", # Immutable. The asset which this asset set asset is linking to.
"assetSet": "A String", # Immutable. The asset set which this asset set asset is linking to.
"resourceName": "A String", # Immutable. The resource name of the asset set asset. Asset set asset resource names have the form: `customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}`
"status": "A String", # Output only. The status of the asset set asset. Read-only.
},
"remove": "A String", # Remove operation: A resource name for the removed asset set asset is expected, in this format: `customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}`
},
"assetSetOperation": { # A single operation (create, remove) on an asset set. # An asset set mutate operation.
"create": { # An asset set representing a collection of assets. Use AssetSetAsset to link an asset to the asset set. # Create operation: No resource name is expected for the new asset set
"businessProfileLocationGroup": { # 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. # Business Profile location group asset set data.
"dynamicBusinessProfileLocationGroupFilter": { # Represents a filter on Business Profile locations in an asset set. If multiple filters are provided, they are AND'ed together. # Filter for dynamic Business Profile location sets.
"businessNameFilter": { # Business Profile location group business name filter. # Used to filter Business Profile locations by business name.
"businessName": "A String", # Business name string to use for filtering.
"filterType": "A String", # The type of string matching to use when filtering with business_name.
},
"labelFilters": [ # 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.
"A String",
],
"listingIdFilters": [ # Used to filter Business Profile locations by listing ids.
"A String",
],
},
},
"chainLocationGroup": { # 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. # 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": [ # Used to filter chain locations by chain ids. Only Locations that belong to the specified chain(s) will be in the asset set.
{ # One chain level filter on location in a feed item set. The filtering logic among all the fields is AND.
"chainId": "A String", # 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": [ # 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.
"A String",
],
},
],
},
"hotelPropertyData": { # For Performance Max for travel goals campaigns with a Hotel Center account link. Read-only. # Output only. For Performance Max for travel goals campaigns with a Hotel Center account link. Read-only.
"hotelCenterId": "A String", # Output only. The hotel center ID of the partner.
"partnerName": "A String", # Output only. Name of the hotel partner.
},
"id": "A String", # Output only. The ID of the asset set.
"locationGroupParentAssetSetId": "A String", # 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.
"locationSet": { # 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. # Location asset set data. This will be used for sync level location set. This can only be set if AssetSet's type is LOCATION_SYNC.
"businessProfileLocationSet": { # 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. # Data used to configure a location set populated from Google Business Profile locations.
"businessAccountId": "A 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.
"businessNameFilter": "A 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": "A String", # Required. Immutable. Email address of a Google Business Profile account or email address of a manager of the Google Business Profile account.
"httpAuthorizationToken": "A String", # Required. Immutable. The HTTP authorization token used to obtain authorization.
"labelFilters": [ # 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.
"A String",
],
"listingIdFilters": [ # 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.
"A String",
],
},
"chainLocationSet": { # Data used to configure a location set populated with the specified chains. # Data used to configure a location on chain set populated with the specified chains.
"chains": [ # Required. A list of chain level filters, all filters are OR'ed together.
{ # One chain level filter on location in a feed item set. The filtering logic among all the fields is AND.
"chainId": "A String", # 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": [ # 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.
"A String",
],
},
],
"relationshipType": "A String", # Required. Immutable. Relationship type the specified chains have with this advertiser.
},
"locationOwnershipType": "A String", # Required. Immutable. Location Ownership Type (owned location or affiliate location).
"mapsLocationSet": { # Wrapper for multiple maps location sync data # Only set if locations are synced based on selected maps locations
"mapsLocations": [ # Required. A list of maps location info that user manually synced in.
{ # Wrapper for place ids
"placeId": "A String", # Place ID of the Maps location.
},
],
},
},
"merchantCenterFeed": { # Merchant ID and Feed Label from Google Merchant Center. # Merchant ID and Feed Label from Google Merchant Center.
"feedLabel": "A String", # Optional. Feed Label from Google Merchant Center.
"merchantId": "A String", # Required. Merchant ID from Google Merchant Center
},
"name": "A String", # Required. Name of the asset set. Required. It must have a minimum length of 1 and maximum length of 128.
"resourceName": "A String", # Immutable. The resource name of the asset set. Asset set resource names have the form: `customers/{customer_id}/assetSets/{asset_set_id}`
"status": "A String", # Output only. The status of the asset set. Read-only.
"type": "A String", # Required. Immutable. The type of the asset set. Required.
},
"remove": "A String", # Remove operation: A resource name for the removed asset set is expected, in this format: `customers/{customer_id}/assetSets/{asset_set_id}`
"update": { # An asset set representing a collection of assets. Use AssetSetAsset to link an asset to the asset set. # Update operation: The asset set is expected to have a valid resource name.
"businessProfileLocationGroup": { # 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. # Business Profile location group asset set data.
"dynamicBusinessProfileLocationGroupFilter": { # Represents a filter on Business Profile locations in an asset set. If multiple filters are provided, they are AND'ed together. # Filter for dynamic Business Profile location sets.
"businessNameFilter": { # Business Profile location group business name filter. # Used to filter Business Profile locations by business name.
"businessName": "A String", # Business name string to use for filtering.
"filterType": "A String", # The type of string matching to use when filtering with business_name.
},
"labelFilters": [ # 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.
"A String",
],
"listingIdFilters": [ # Used to filter Business Profile locations by listing ids.
"A String",
],
},
},
"chainLocationGroup": { # 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. # 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": [ # Used to filter chain locations by chain ids. Only Locations that belong to the specified chain(s) will be in the asset set.
{ # One chain level filter on location in a feed item set. The filtering logic among all the fields is AND.
"chainId": "A String", # 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": [ # 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.
"A String",
],
},
],
},
"hotelPropertyData": { # For Performance Max for travel goals campaigns with a Hotel Center account link. Read-only. # Output only. For Performance Max for travel goals campaigns with a Hotel Center account link. Read-only.
"hotelCenterId": "A String", # Output only. The hotel center ID of the partner.
"partnerName": "A String", # Output only. Name of the hotel partner.
},
"id": "A String", # Output only. The ID of the asset set.
"locationGroupParentAssetSetId": "A String", # 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.
"locationSet": { # 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. # Location asset set data. This will be used for sync level location set. This can only be set if AssetSet's type is LOCATION_SYNC.
"businessProfileLocationSet": { # 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. # Data used to configure a location set populated from Google Business Profile locations.
"businessAccountId": "A 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.
"businessNameFilter": "A 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": "A String", # Required. Immutable. Email address of a Google Business Profile account or email address of a manager of the Google Business Profile account.
"httpAuthorizationToken": "A String", # Required. Immutable. The HTTP authorization token used to obtain authorization.
"labelFilters": [ # 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.
"A String",
],
"listingIdFilters": [ # 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.
"A String",
],
},
"chainLocationSet": { # Data used to configure a location set populated with the specified chains. # Data used to configure a location on chain set populated with the specified chains.
"chains": [ # Required. A list of chain level filters, all filters are OR'ed together.
{ # One chain level filter on location in a feed item set. The filtering logic among all the fields is AND.
"chainId": "A String", # 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": [ # 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.
"A String",
],
},
],
"relationshipType": "A String", # Required. Immutable. Relationship type the specified chains have with this advertiser.
},
"locationOwnershipType": "A String", # Required. Immutable. Location Ownership Type (owned location or affiliate location).
"mapsLocationSet": { # Wrapper for multiple maps location sync data # Only set if locations are synced based on selected maps locations
"mapsLocations": [ # Required. A list of maps location info that user manually synced in.
{ # Wrapper for place ids
"placeId": "A String", # Place ID of the Maps location.
},
],
},
},
"merchantCenterFeed": { # Merchant ID and Feed Label from Google Merchant Center. # Merchant ID and Feed Label from Google Merchant Center.
"feedLabel": "A String", # Optional. Feed Label from Google Merchant Center.
"merchantId": "A String", # Required. Merchant ID from Google Merchant Center
},
"name": "A String", # Required. Name of the asset set. Required. It must have a minimum length of 1 and maximum length of 128.
"resourceName": "A String", # Immutable. The resource name of the asset set. Asset set resource names have the form: `customers/{customer_id}/assetSets/{asset_set_id}`
"status": "A String", # Output only. The status of the asset set. Read-only.
"type": "A String", # Required. Immutable. The type of the asset set. Required.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"audienceOperation": { # A single operation (create, update) on an audience. # An audience mutate operation.
"create": { # 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. # Create operation: No resource name is expected for the new audience
"assetGroup": "A 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.
"description": "A String", # Description of this audience.
"dimensions": [ # Positive dimensions specifying the audience composition.
{ # Positive dimension specifying user's audience.
"age": { # Dimension specifying users by their age. # Dimension specifying users by their age.
"ageRanges": [ # Contiguous age range to be included in the dimension.
{ # Contiguous age range.
"maxAge": 42, # Maximum age to include. A maximum age need not be specified. If specified, max_age must be greater than min_age, and allowed values are 24, 34, 44, 54, and 64.
"minAge": 42, # Minimum age to include. A minimum age must be specified and must be at least 18. Allowed values are 18, 25, 35, 45, 55, and 65.
},
],
"includeUndetermined": True or False, # Include users whose age is not determined.
},
"audienceSegments": { # Dimension specifying users by their membership in other audience segments. # Dimension specifying users by their membership in other audience segments.
"segments": [ # Included audience segments. Users are included if they belong to at least one segment.
{ # Positive audience segment.
"customAudience": { # Custom audience segment. # Custom audience segment.
"customAudience": "A String", # The custom audience resource.
},
"detailedDemographic": { # Detailed demographic segment. # Detailed demographic segment.
"detailedDemographic": "A String", # The detailed demographic resource.
},
"lifeEvent": { # Live event segment. # Live-event audience segment.
"lifeEvent": "A String", # The life event resource.
},
"userInterest": { # User interest segment. # Affinity or In-market segment.
"userInterestCategory": "A String", # The user interest resource.
},
"userList": { # User list segment. # User list segment.
"userList": "A String", # The user list resource.
},
},
],
},
"gender": { # Dimension specifying users by their gender. # Dimension specifying users by their gender.
"genders": [ # Included gender demographic segments.
"A String",
],
"includeUndetermined": True or False, # Include users whose gender is not determined.
},
"householdIncome": { # Dimension specifying users by their household income. # Dimension specifying users by their household income.
"includeUndetermined": True or False, # Include users whose household income is not determined.
"incomeRanges": [ # Included household income demographic segments.
"A String",
],
},
"parentalStatus": { # Dimension specifying users by their parental status. # Dimension specifying users by their parental status.
"includeUndetermined": True or False, # Include users whose parental status is undetermined.
"parentalStatuses": [ # Included parental status demographic segments.
"A String",
],
},
},
],
"exclusionDimension": { # Negative dimension specifying users to exclude from the audience. # Negative dimension specifying the audience composition.
"exclusions": [ # Audience segment to be excluded.
{ # An audience segment to be excluded from an audience.
"userList": { # User list segment. # User list segment to be excluded.
"userList": "A String", # The user list resource.
},
},
],
},
"id": "A String", # Output only. ID of the audience.
"name": "A 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.
"resourceName": "A String", # Immutable. The resource name of the audience. Audience names have the form: `customers/{customer_id}/audiences/{audience_id}`
"scope": "A String", # 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.
"status": "A String", # Output only. Status of this audience. Indicates whether the audience is enabled or removed.
},
"update": { # 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. # Update operation: The audience is expected to have a valid resource name.
"assetGroup": "A 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.
"description": "A String", # Description of this audience.
"dimensions": [ # Positive dimensions specifying the audience composition.
{ # Positive dimension specifying user's audience.
"age": { # Dimension specifying users by their age. # Dimension specifying users by their age.
"ageRanges": [ # Contiguous age range to be included in the dimension.
{ # Contiguous age range.
"maxAge": 42, # Maximum age to include. A maximum age need not be specified. If specified, max_age must be greater than min_age, and allowed values are 24, 34, 44, 54, and 64.
"minAge": 42, # Minimum age to include. A minimum age must be specified and must be at least 18. Allowed values are 18, 25, 35, 45, 55, and 65.
},
],
"includeUndetermined": True or False, # Include users whose age is not determined.
},
"audienceSegments": { # Dimension specifying users by their membership in other audience segments. # Dimension specifying users by their membership in other audience segments.
"segments": [ # Included audience segments. Users are included if they belong to at least one segment.
{ # Positive audience segment.
"customAudience": { # Custom audience segment. # Custom audience segment.
"customAudience": "A String", # The custom audience resource.
},
"detailedDemographic": { # Detailed demographic segment. # Detailed demographic segment.
"detailedDemographic": "A String", # The detailed demographic resource.
},
"lifeEvent": { # Live event segment. # Live-event audience segment.
"lifeEvent": "A String", # The life event resource.
},
"userInterest": { # User interest segment. # Affinity or In-market segment.
"userInterestCategory": "A String", # The user interest resource.
},
"userList": { # User list segment. # User list segment.
"userList": "A String", # The user list resource.
},
},
],
},
"gender": { # Dimension specifying users by their gender. # Dimension specifying users by their gender.
"genders": [ # Included gender demographic segments.
"A String",
],
"includeUndetermined": True or False, # Include users whose gender is not determined.
},
"householdIncome": { # Dimension specifying users by their household income. # Dimension specifying users by their household income.
"includeUndetermined": True or False, # Include users whose household income is not determined.
"incomeRanges": [ # Included household income demographic segments.
"A String",
],
},
"parentalStatus": { # Dimension specifying users by their parental status. # Dimension specifying users by their parental status.
"includeUndetermined": True or False, # Include users whose parental status is undetermined.
"parentalStatuses": [ # Included parental status demographic segments.
"A String",
],
},
},
],
"exclusionDimension": { # Negative dimension specifying users to exclude from the audience. # Negative dimension specifying the audience composition.
"exclusions": [ # Audience segment to be excluded.
{ # An audience segment to be excluded from an audience.
"userList": { # User list segment. # User list segment to be excluded.
"userList": "A String", # The user list resource.
},
},
],
},
"id": "A String", # Output only. ID of the audience.
"name": "A 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.
"resourceName": "A String", # Immutable. The resource name of the audience. Audience names have the form: `customers/{customer_id}/audiences/{audience_id}`
"scope": "A String", # 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.
"status": "A String", # Output only. Status of this audience. Indicates whether the audience is enabled or removed.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"biddingDataExclusionOperation": { # A single operation (create, remove, update) on a data exclusion. # A bidding data exclusion mutate operation.
"create": { # 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. # Create operation: No resource name is expected for the new data exclusion.
"advertisingChannelTypes": [ # 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.
"A String",
],
"campaigns": [ # 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.
"A String",
],
"dataExclusionId": "A String", # Output only. The ID of the data exclusion.
"description": "A String", # The description of the data exclusion. The description can be at most 2048 characters.
"devices": [ # If not specified, all devices will be included in this exclusion. Otherwise, only the specified targeted devices will be included in this exclusion.
"A String",
],
"endDateTime": "A 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].
"name": "A String", # The name of the data exclusion. The name can be at most 255 characters.
"resourceName": "A String", # Immutable. The resource name of the data exclusion. Data exclusion resource names have the form: `customers/{customer_id}/biddingDataExclusions/{data_exclusion_id}`
"scope": "A String", # The scope of the data exclusion.
"startDateTime": "A 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.
"status": "A String", # Output only. The status of the data exclusion.
},
"remove": "A String", # Remove operation: A resource name for the removed data exclusion is expected, in this format: `customers/{customer_id}/biddingDataExclusions/{data_exclusion_id}`
"update": { # 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. # Update operation: The data exclusion is expected to have a valid resource name.
"advertisingChannelTypes": [ # 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.
"A String",
],
"campaigns": [ # 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.
"A String",
],
"dataExclusionId": "A String", # Output only. The ID of the data exclusion.
"description": "A String", # The description of the data exclusion. The description can be at most 2048 characters.
"devices": [ # If not specified, all devices will be included in this exclusion. Otherwise, only the specified targeted devices will be included in this exclusion.
"A String",
],
"endDateTime": "A 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].
"name": "A String", # The name of the data exclusion. The name can be at most 255 characters.
"resourceName": "A String", # Immutable. The resource name of the data exclusion. Data exclusion resource names have the form: `customers/{customer_id}/biddingDataExclusions/{data_exclusion_id}`
"scope": "A String", # The scope of the data exclusion.
"startDateTime": "A 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.
"status": "A String", # Output only. The status of the data exclusion.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"biddingSeasonalityAdjustmentOperation": { # A single operation (create, remove, update) on a seasonality adjustment. # A bidding seasonality adjustment mutate operation.
"create": { # Represents a bidding seasonality adjustment. Cannot be used in manager accounts. See "About seasonality adjustments" at https://support.google.com/google-ads/answer/10369906. # Create operation: No resource name is expected for the new seasonality adjustment.
"advertisingChannelTypes": [ # 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.
"A String",
],
"campaigns": [ # 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.
"A String",
],
"conversionRateModifier": 3.14, # 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.
"description": "A String", # The description of the seasonality adjustment. The description can be at most 2048 characters.
"devices": [ # If not specified, all devices will be included in this adjustment. Otherwise, only the specified targeted devices will be included in this adjustment.
"A String",
],
"endDateTime": "A 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].
"name": "A String", # The name of the seasonality adjustment. The name can be at most 255 characters.
"resourceName": "A String", # Immutable. The resource name of the seasonality adjustment. Seasonality adjustment resource names have the form: `customers/{customer_id}/biddingSeasonalityAdjustments/{seasonality_adjustment_id}`
"scope": "A String", # The scope of the seasonality adjustment.
"seasonalityAdjustmentId": "A String", # Output only. The ID of the seasonality adjustment.
"startDateTime": "A 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.
"status": "A String", # Output only. The status of the seasonality adjustment.
},
"remove": "A String", # Remove operation: A resource name for the removed seasonality adjustment is expected, in this format: `customers/{customer_id}/biddingSeasonalityAdjustments/{seasonality_adjustment_id}`
"update": { # Represents a bidding seasonality adjustment. Cannot be used in manager accounts. See "About seasonality adjustments" at https://support.google.com/google-ads/answer/10369906. # Update operation: The seasonality adjustment is expected to have a valid resource name.
"advertisingChannelTypes": [ # 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.
"A String",
],
"campaigns": [ # 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.
"A String",
],
"conversionRateModifier": 3.14, # 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.
"description": "A String", # The description of the seasonality adjustment. The description can be at most 2048 characters.
"devices": [ # If not specified, all devices will be included in this adjustment. Otherwise, only the specified targeted devices will be included in this adjustment.
"A String",
],
"endDateTime": "A 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].
"name": "A String", # The name of the seasonality adjustment. The name can be at most 255 characters.
"resourceName": "A String", # Immutable. The resource name of the seasonality adjustment. Seasonality adjustment resource names have the form: `customers/{customer_id}/biddingSeasonalityAdjustments/{seasonality_adjustment_id}`
"scope": "A String", # The scope of the seasonality adjustment.
"seasonalityAdjustmentId": "A String", # Output only. The ID of the seasonality adjustment.
"startDateTime": "A 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.
"status": "A String", # Output only. The status of the seasonality adjustment.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"biddingStrategyOperation": { # A single operation (create, update, remove) on a bidding strategy. # A bidding strategy mutate operation.
"create": { # A bidding strategy. # Create operation: No resource name is expected for the new bidding strategy.
"alignedCampaignBudgetId": "A String", # 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.
"campaignCount": "A String", # Output only. The number of campaigns attached to this bidding strategy. This field is read-only.
"currencyCode": "A 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.
"effectiveCurrencyCode": "A 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.
"enhancedCpc": { # 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. # A 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.
},
"id": "A String", # Output only. The ID of the bidding strategy.
"maximizeConversionValue": { # An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget. # An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget.
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetRoas": 3.14, # 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.
"targetRoasTolerancePercentMillis": "A String", # 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.
},
"maximizeConversions": { # An automated bidding strategy to help get the most conversions for your campaigns while spending your budget. # An automated bidding strategy to help get the most conversions for your campaigns while spending your budget.
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetCpaMicros": "A String", # 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.
},
"name": "A 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": "A String", # Output only. The number of non-removed campaigns attached to this bidding strategy. This field is read-only.
"resourceName": "A String", # Immutable. The resource name of the bidding strategy. Bidding strategy resource names have the form: `customers/{customer_id}/biddingStrategies/{bidding_strategy_id}`
"status": "A String", # Output only. The status of the bidding strategy. This field is read-only.
"targetCpa": { # An automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set. # A bidding strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetCpaMicros": "A String", # Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
},
"targetImpressionShare": { # 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). # A bidding strategy that automatically optimizes towards a chosen percentage of impressions.
"cpcBidCeilingMicros": "A String", # 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.
"location": "A String", # The targeted location on the search results page.
"locationFractionMicros": "A String", # The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.
},
"targetRoas": { # An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS). # A bidding strategy that helps you maximize revenue while averaging a specific target Return On Ad Spend (ROAS).
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetRoas": 3.14, # Required. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.
"targetRoasTolerancePercentMillis": "A String", # 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.
},
"targetSpend": { # An automated bid strategy that sets your bids to help get as many clicks as possible within your budget. # A bid strategy that sets your bids to help get as many clicks as possible within your budget.
"cpcBidCeilingMicros": "A String", # Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
"targetSpendMicros": "A String", # 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.
},
"type": "A String", # Output only. The type of the bidding strategy. Create a bidding strategy by setting the bidding scheme. This field is read-only.
},
"remove": "A String", # Remove operation: A resource name for the removed bidding strategy is expected, in this format: `customers/{customer_id}/biddingStrategies/{bidding_strategy_id}`
"update": { # A bidding strategy. # Update operation: The bidding strategy is expected to have a valid resource name.
"alignedCampaignBudgetId": "A String", # 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.
"campaignCount": "A String", # Output only. The number of campaigns attached to this bidding strategy. This field is read-only.
"currencyCode": "A 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.
"effectiveCurrencyCode": "A 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.
"enhancedCpc": { # 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. # A 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.
},
"id": "A String", # Output only. The ID of the bidding strategy.
"maximizeConversionValue": { # An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget. # An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget.
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetRoas": 3.14, # 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.
"targetRoasTolerancePercentMillis": "A String", # 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.
},
"maximizeConversions": { # An automated bidding strategy to help get the most conversions for your campaigns while spending your budget. # An automated bidding strategy to help get the most conversions for your campaigns while spending your budget.
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetCpaMicros": "A String", # 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.
},
"name": "A 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": "A String", # Output only. The number of non-removed campaigns attached to this bidding strategy. This field is read-only.
"resourceName": "A String", # Immutable. The resource name of the bidding strategy. Bidding strategy resource names have the form: `customers/{customer_id}/biddingStrategies/{bidding_strategy_id}`
"status": "A String", # Output only. The status of the bidding strategy. This field is read-only.
"targetCpa": { # An automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set. # A bidding strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetCpaMicros": "A String", # Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
},
"targetImpressionShare": { # 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). # A bidding strategy that automatically optimizes towards a chosen percentage of impressions.
"cpcBidCeilingMicros": "A String", # 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.
"location": "A String", # The targeted location on the search results page.
"locationFractionMicros": "A String", # The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.
},
"targetRoas": { # An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS). # A bidding strategy that helps you maximize revenue while averaging a specific target Return On Ad Spend (ROAS).
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetRoas": 3.14, # Required. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.
"targetRoasTolerancePercentMillis": "A String", # 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.
},
"targetSpend": { # An automated bid strategy that sets your bids to help get as many clicks as possible within your budget. # A bid strategy that sets your bids to help get as many clicks as possible within your budget.
"cpcBidCeilingMicros": "A String", # Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
"targetSpendMicros": "A String", # 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.
},
"type": "A String", # Output only. The type of the bidding strategy. Create a bidding strategy by setting the bidding scheme. This field is read-only.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"campaignAssetOperation": { # A single operation (create, remove) on a campaign asset. # A campaign asset mutate operation.
"create": { # A link between a Campaign and an Asset. # Create operation: No resource name is expected for the new campaign asset.
"asset": "A String", # Immutable. The asset which is linked to the campaign.
"campaign": "A String", # Immutable. The campaign to which the asset is linked.
"fieldType": "A String", # Immutable. Role that the asset takes under the linked campaign. Required.
"primaryStatus": "A String", # 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.
"primaryStatusDetails": [ # Output only. Provides the details of the primary status and its associated reasons.
{ # Provides the detail of a PrimaryStatus. Each asset link has a PrimaryStatus value (e.g. NOT_ELIGIBLE, meaning not serving), and list of corroborating PrimaryStatusReasons (e.g. [ASSET_DISAPPROVED]). Each reason may have some additional details annotated with it. For instance, when the reason is ASSET_DISAPPROVED, the details field will contain additional information about the offline evaluation errors which led to the asset being disapproved.
"assetDisapproved": { # Details related to AssetLinkPrimaryStatusReasonPB.ASSET_DISAPPROVED # Provides the details for AssetLinkPrimaryStatusReason.ASSET_DISAPPROVED
"offlineEvaluationErrorReasons": [ # Provides the quality evaluation disapproval reason of an asset.
"A String",
],
},
"reason": "A String", # Provides the reason of this PrimaryStatus.
"status": "A String", # Provides the PrimaryStatus of this status detail.
},
],
"primaryStatusReasons": [ # Output only. Provides a list of reasons for why an asset is not serving or not serving at full capacity.
"A String",
],
"resourceName": "A 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}`
"source": "A String", # Output only. Source of the campaign asset link.
"status": "A String", # Status of the campaign asset.
},
"remove": "A 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}`
"update": { # A link between a Campaign and an Asset. # Update operation: The campaign asset is expected to have a valid resource name.
"asset": "A String", # Immutable. The asset which is linked to the campaign.
"campaign": "A String", # Immutable. The campaign to which the asset is linked.
"fieldType": "A String", # Immutable. Role that the asset takes under the linked campaign. Required.
"primaryStatus": "A String", # 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.
"primaryStatusDetails": [ # Output only. Provides the details of the primary status and its associated reasons.
{ # Provides the detail of a PrimaryStatus. Each asset link has a PrimaryStatus value (e.g. NOT_ELIGIBLE, meaning not serving), and list of corroborating PrimaryStatusReasons (e.g. [ASSET_DISAPPROVED]). Each reason may have some additional details annotated with it. For instance, when the reason is ASSET_DISAPPROVED, the details field will contain additional information about the offline evaluation errors which led to the asset being disapproved.
"assetDisapproved": { # Details related to AssetLinkPrimaryStatusReasonPB.ASSET_DISAPPROVED # Provides the details for AssetLinkPrimaryStatusReason.ASSET_DISAPPROVED
"offlineEvaluationErrorReasons": [ # Provides the quality evaluation disapproval reason of an asset.
"A String",
],
},
"reason": "A String", # Provides the reason of this PrimaryStatus.
"status": "A String", # Provides the PrimaryStatus of this status detail.
},
],
"primaryStatusReasons": [ # Output only. Provides a list of reasons for why an asset is not serving or not serving at full capacity.
"A String",
],
"resourceName": "A 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}`
"source": "A String", # Output only. Source of the campaign asset link.
"status": "A String", # Status of the campaign asset.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"campaignAssetSetOperation": { # A single operation (create, remove) on a campaign asset set. # A campaign asset mutate operation.
"create": { # CampaignAssetSet is the linkage between a campaign and an asset set. Adding a CampaignAssetSet links an asset set with a campaign. # Create operation: No resource name is expected for the new campaign asset set.
"assetSet": "A String", # Immutable. The asset set which is linked to the campaign.
"campaign": "A String", # Immutable. The campaign to which this asset set is linked.
"resourceName": "A String", # Immutable. The resource name of the campaign asset set. Asset set asset resource names have the form: `customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}`
"status": "A String", # Output only. The status of the campaign asset set asset. Read-only.
},
"remove": "A String", # Remove operation: A resource name for the removed campaign asset set is expected, in this format: `customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}`
},
"campaignBidModifierOperation": { # A single operation (create, remove, update) on a campaign bid modifier. # A campaign bid modifier mutate operation.
"create": { # Represents a bid-modifiable only criterion at the campaign level. # Create operation: No resource name is expected for the new campaign bid modifier.
"bidModifier": 3.14, # The modifier for the bid when the criterion matches.
"campaign": "A String", # Output only. The campaign to which this criterion belongs.
"criterionId": "A String", # Output only. The ID of the criterion to bid modify. This field is ignored for mutates.
"interactionType": { # Criterion for Interaction Type. # Immutable. Criterion for interaction type. Only supported for search campaigns.
"type": "A String", # The interaction type.
},
"resourceName": "A String", # Immutable. The resource name of the campaign bid modifier. Campaign bid modifier resource names have the form: `customers/{customer_id}/campaignBidModifiers/{campaign_id}~{criterion_id}`
},
"remove": "A String", # Remove operation: A resource name for the removed campaign bid modifier is expected, in this format: `customers/{customer_id}/CampaignBidModifiers/{campaign_id}~{criterion_id}`
"update": { # Represents a bid-modifiable only criterion at the campaign level. # Update operation: The campaign bid modifier is expected to have a valid resource name.
"bidModifier": 3.14, # The modifier for the bid when the criterion matches.
"campaign": "A String", # Output only. The campaign to which this criterion belongs.
"criterionId": "A String", # Output only. The ID of the criterion to bid modify. This field is ignored for mutates.
"interactionType": { # Criterion for Interaction Type. # Immutable. Criterion for interaction type. Only supported for search campaigns.
"type": "A String", # The interaction type.
},
"resourceName": "A String", # Immutable. The resource name of the campaign bid modifier. Campaign bid modifier resource names have the form: `customers/{customer_id}/campaignBidModifiers/{campaign_id}~{criterion_id}`
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"campaignBudgetOperation": { # A single operation (create, update, remove) on a campaign budget. # A campaign budget mutate operation.
"create": { # A campaign budget. # Create operation: No resource name is expected for the new budget.
"alignedBiddingStrategyId": "A String", # ID of the portfolio bidding strategy that this shared campaign budget is aligned with. When a bidding strategy and a campaign budget are aligned, they are attached to the same set of campaigns. After a campaign budget is aligned with a bidding strategy, campaigns that are added to the campaign budget must also use the aligned bidding strategy.
"amountMicros": "A String", # The average daily amount to be spent by the campaign. This field is used when the CampaignBudget `period` is set to `DAILY`, which is the default. Amount is specified in micros in the account's local currency. One million micros is equivalent to one currency unit. The effective monthly spend is capped at 30.4 times this daily amount. This field is mutually exclusive with 'total_amount_micros'. Only one of 'amount_micros' or 'total_amount_micros' should be set.
"deliveryMethod": "A String", # The delivery method that determines the rate at which the campaign budget is spent. Defaults to STANDARD if unspecified in a create operation.
"explicitlyShared": True or False, # Specifies whether the budget is explicitly shared. Defaults to true if unspecified in a create operation. If true, the budget was created with the purpose of sharing across one or more campaigns. If false, the budget was created with the intention of only being used with a single campaign. The budget's name and status will stay in sync with the campaign's name and status. Attempting to share the budget with a second campaign will result in an error. A non-shared budget can become an explicitly shared. The same operation must also assign the budget a name. A shared campaign budget can never become non-shared.
"hasRecommendedBudget": True or False, # Output only. Indicates whether there is a recommended budget for this campaign budget. This field is read-only.
"id": "A String", # Output only. The ID of the campaign budget. A campaign budget is created using the CampaignBudgetService create operation and is assigned a budget ID. A budget ID can be shared across different campaigns; the system will then allocate the campaign budget among different campaigns to get optimum results.
"name": "A String", # The name of the campaign budget. When creating a campaign budget through CampaignBudgetService, every explicitly shared campaign budget must have a non-null, non-empty name. Campaign budgets that are not explicitly shared derive their name from the attached campaign's name. The length of this string must be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
"period": "A String", # Immutable. Period over which to spend the budget. Defaults to DAILY if not specified.
"recommendedBudgetAmountMicros": "A String", # Output only. The recommended budget amount. If no recommendation is available, this will be set to the budget amount. Amount is specified in micros, where one million is equivalent to one currency unit. This field is read-only.
"recommendedBudgetEstimatedChangeWeeklyClicks": "A String", # Output only. The estimated change in weekly clicks if the recommended budget is applied. This field is read-only.
"recommendedBudgetEstimatedChangeWeeklyCostMicros": "A String", # Output only. The estimated change in weekly cost in micros if the recommended budget is applied. One million is equivalent to one currency unit. This field is read-only.
"recommendedBudgetEstimatedChangeWeeklyInteractions": "A String", # Output only. The estimated change in weekly interactions if the recommended budget is applied. This field is read-only.
"recommendedBudgetEstimatedChangeWeeklyViews": "A String", # Output only. The estimated change in weekly views if the recommended budget is applied. This field is read-only.
"referenceCount": "A String", # Output only. The number of campaigns actively using the budget. This field is read-only.
"resourceName": "A String", # Immutable. The resource name of the campaign budget. Campaign budget resource names have the form: `customers/{customer_id}/campaignBudgets/{campaign_budget_id}`
"status": "A String", # Output only. The status of this campaign budget. This field is read-only.
"totalAmountMicros": "A String", # The total amount to be spent by the campaign over its entire duration. This field is used *only* when the CampaignBudget `period` is set to `CUSTOM_PERIOD`. It represents the budget cap for the campaign's lifetime, rather than a daily limit. The amount is specified in micros in the account's local currency. One million micros is equivalent to one currency unit. This field is mutually exclusive with 'amount_micros'. Only one of 'total_amount_micros' or 'amount_micros' should be set.
"type": "A String", # Immutable. The type of the campaign budget.
},
"remove": "A String", # Remove operation: A resource name for the removed budget is expected, in this format: `customers/{customer_id}/campaignBudgets/{budget_id}`
"update": { # A campaign budget. # Update operation: The campaign budget is expected to have a valid resource name.
"alignedBiddingStrategyId": "A String", # ID of the portfolio bidding strategy that this shared campaign budget is aligned with. When a bidding strategy and a campaign budget are aligned, they are attached to the same set of campaigns. After a campaign budget is aligned with a bidding strategy, campaigns that are added to the campaign budget must also use the aligned bidding strategy.
"amountMicros": "A String", # The average daily amount to be spent by the campaign. This field is used when the CampaignBudget `period` is set to `DAILY`, which is the default. Amount is specified in micros in the account's local currency. One million micros is equivalent to one currency unit. The effective monthly spend is capped at 30.4 times this daily amount. This field is mutually exclusive with 'total_amount_micros'. Only one of 'amount_micros' or 'total_amount_micros' should be set.
"deliveryMethod": "A String", # The delivery method that determines the rate at which the campaign budget is spent. Defaults to STANDARD if unspecified in a create operation.
"explicitlyShared": True or False, # Specifies whether the budget is explicitly shared. Defaults to true if unspecified in a create operation. If true, the budget was created with the purpose of sharing across one or more campaigns. If false, the budget was created with the intention of only being used with a single campaign. The budget's name and status will stay in sync with the campaign's name and status. Attempting to share the budget with a second campaign will result in an error. A non-shared budget can become an explicitly shared. The same operation must also assign the budget a name. A shared campaign budget can never become non-shared.
"hasRecommendedBudget": True or False, # Output only. Indicates whether there is a recommended budget for this campaign budget. This field is read-only.
"id": "A String", # Output only. The ID of the campaign budget. A campaign budget is created using the CampaignBudgetService create operation and is assigned a budget ID. A budget ID can be shared across different campaigns; the system will then allocate the campaign budget among different campaigns to get optimum results.
"name": "A String", # The name of the campaign budget. When creating a campaign budget through CampaignBudgetService, every explicitly shared campaign budget must have a non-null, non-empty name. Campaign budgets that are not explicitly shared derive their name from the attached campaign's name. The length of this string must be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
"period": "A String", # Immutable. Period over which to spend the budget. Defaults to DAILY if not specified.
"recommendedBudgetAmountMicros": "A String", # Output only. The recommended budget amount. If no recommendation is available, this will be set to the budget amount. Amount is specified in micros, where one million is equivalent to one currency unit. This field is read-only.
"recommendedBudgetEstimatedChangeWeeklyClicks": "A String", # Output only. The estimated change in weekly clicks if the recommended budget is applied. This field is read-only.
"recommendedBudgetEstimatedChangeWeeklyCostMicros": "A String", # Output only. The estimated change in weekly cost in micros if the recommended budget is applied. One million is equivalent to one currency unit. This field is read-only.
"recommendedBudgetEstimatedChangeWeeklyInteractions": "A String", # Output only. The estimated change in weekly interactions if the recommended budget is applied. This field is read-only.
"recommendedBudgetEstimatedChangeWeeklyViews": "A String", # Output only. The estimated change in weekly views if the recommended budget is applied. This field is read-only.
"referenceCount": "A String", # Output only. The number of campaigns actively using the budget. This field is read-only.
"resourceName": "A String", # Immutable. The resource name of the campaign budget. Campaign budget resource names have the form: `customers/{customer_id}/campaignBudgets/{campaign_budget_id}`
"status": "A String", # Output only. The status of this campaign budget. This field is read-only.
"totalAmountMicros": "A String", # The total amount to be spent by the campaign over its entire duration. This field is used *only* when the CampaignBudget `period` is set to `CUSTOM_PERIOD`. It represents the budget cap for the campaign's lifetime, rather than a daily limit. The amount is specified in micros in the account's local currency. One million micros is equivalent to one currency unit. This field is mutually exclusive with 'amount_micros'. Only one of 'total_amount_micros' or 'amount_micros' should be set.
"type": "A String", # Immutable. The type of the campaign budget.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"campaignConversionGoalOperation": { # A single operation (update) on a campaign conversion goal. # A campaign conversion goal mutate operation.
"update": { # The biddability setting for the specified campaign only for all conversion actions with a matching category and origin. # Update operation: The customer conversion goal is expected to have a valid resource name.
"biddable": True or False, # The biddability of the campaign conversion goal.
"campaign": "A String", # Immutable. The campaign with which this campaign conversion goal is associated.
"category": "A String", # The conversion category of this campaign conversion goal.
"origin": "A String", # The conversion origin of this campaign conversion goal.
"resourceName": "A String", # Immutable. The resource name of the campaign conversion goal. Campaign conversion goal resource names have the form: `customers/{customer_id}/campaignConversionGoals/{campaign_id}~{category}~{origin}`
"searchAds360Biddable": True or False, # Search Ads 360 biddability of the campaign conversion goal.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"campaignCriterionOperation": { # A single operation (create, update, remove) on a campaign criterion. # A campaign criterion mutate operation.
"create": { # A campaign criterion. # Create operation: No resource name is expected for the new criterion.
"adSchedule": { # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day. # Immutable. Ad Schedule.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
"ageRange": { # An age range criterion. # Immutable. Age range.
"type": "A String", # Type of the age range.
},
"bidModifier": 3.14, # The modifier for the bids when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. Use 0 to opt out of a Device type.
"brandList": { # 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. # Immutable. Brand list campaign criterion.
"sharedSet": "A String", # Shared set resource name of the brand list.
},
"campaign": "A String", # Immutable. The campaign to which the criterion belongs.
"carrier": { # Represents a Carrier Criterion. # Immutable. Carrier.
"carrierConstant": "A String", # The Carrier constant resource name.
},
"combinedAudience": { # A combined audience criterion. # Immutable. Combined Audience.
"combinedAudience": "A String", # The CombinedAudience resource name.
},
"contentLabel": { # Content Label for category exclusion. # Immutable. ContentLabel.
"type": "A String", # Content label type, required for CREATE operations.
},
"criterionId": "A String", # Output only. The ID of the criterion. This field is ignored during mutate.
"device": { # A device criterion. # Immutable. Device.
"type": "A String", # Type of the device.
},
"displayName": "A String", # Output only. The display name of the criterion. This field is ignored for mutates.
"extendedDemographic": { # Represents an extended demographic criterion. # Immutable. Extended demographic criterion.
"extendedDemographicId": "A String", # Taxonomy id of the extended demographic group.
},
"gender": { # A gender criterion. # Immutable. Gender.
"type": "A String", # Type of the gender.
},
"incomeRange": { # An income range criterion. # Immutable. Income range.
"type": "A String", # Type of the income range.
},
"ipBlock": { # 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 # Immutable. IpBlock. You can exclude up to 500 IP addresses per campaign.
"ipAddress": "A String", # The IP address or the CIDR block to be excluded.
},
"keyword": { # A keyword criterion. # Immutable. Keyword.
"matchType": "A String", # The match type of the keyword.
"text": "A String", # The text of the keyword (at most 80 characters and 10 words).
},
"keywordTheme": { # A Smart Campaign keyword theme. # Immutable. Smart Campaign Keyword Theme.
"freeFormKeywordTheme": "A String", # Free-form text to be matched to a Smart Campaign keyword theme constant on a best-effort basis.
"keywordThemeConstant": "A String", # The resource name of a Smart Campaign keyword theme constant. `keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id}`
},
"language": { # A language criterion. # Immutable. Language.
"languageConstant": "A String", # The language constant resource name.
},
"lastModifiedTime": "A String", # Output only. The datetime when this campaign criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
"lifeEvent": { # Represents a life event criterion. # Immutable. Life event campaign criterion.
"lifeEventId": "A String", # Taxonomy id of the life event.
},
"listingScope": { # A listing scope criterion. # Immutable. Listing scope.
"dimensions": [ # Scope of the campaign criterion.
{ # Listing dimensions for listing group criterion.
"activityCity": { # The city where the travel activity is available. # The city where the travel activity is available.
"value": "A String", # String value of the activity city. The Geo Target Constant resource name.
},
"activityCountry": { # The country where the travel activity is available. # The country where the travel activity is available.
"value": "A String", # String value of the activity country. The Geo Target Constant resource name.
},
"activityId": { # Advertiser-specific activity ID. # Advertiser-specific activity ID.
"value": "A String", # String value of the activity ID.
},
"activityRating": { # Rating of the activity as a number 1 to 5, where 5 is the best. # Rating of the activity as a number 1 to 5, where 5 is the best.
"value": "A String", # Long value of the activity rating.
},
"activityState": { # The state where the travel activity is available. # The state where the travel activity is available.
"value": "A String", # String value of the activity state. The Geo Target Constant resource name.
},
"hotelCity": { # City the hotel is located in. # City the hotel is located in.
"cityCriterion": "A String", # The Geo Target Constant resource name.
},
"hotelClass": { # Class of the hotel as a number of stars 1 to 5. # Class of the hotel as a number of stars 1 to 5.
"value": "A String", # Long value of the hotel class.
},
"hotelCountryRegion": { # Country or Region the hotel is located in. # Country or Region the hotel is located in.
"countryRegionCriterion": "A String", # The Geo Target Constant resource name.
},
"hotelId": { # Advertiser-specific hotel ID. # Advertiser-specific hotel ID.
"value": "A String", # String value of the hotel ID.
},
"hotelState": { # State the hotel is located in. # State the hotel is located in.
"stateCriterion": "A String", # The Geo Target Constant resource name.
},
"productBrand": { # Brand of the product. # Brand of a product offer.
"value": "A String", # String value of the product brand.
},
"productCategory": { # Category of a product offer. # Category of a product offer.
"categoryId": "A String", # ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
"level": "A String", # Level of the product category.
},
"productChannel": { # Locality of a product offer. # Locality of a product offer.
"channel": "A String", # Value of the locality.
},
"productChannelExclusivity": { # Availability of a product offer. # Availability of a product offer.
"channelExclusivity": "A String", # Value of the availability.
},
"productCondition": { # Condition of a product offer. # Condition of a product offer.
"condition": "A String", # Value of the condition.
},
"productCustomAttribute": { # Custom attribute of a product offer. # Custom attribute of a product offer.
"index": "A String", # Indicates the index of the custom attribute.
"value": "A String", # String value of the product custom attribute.
},
"productGrouping": { # Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product grouping.
},
"productItemId": { # Item id of a product offer. # Item id of a product offer.
"value": "A String", # Value of the id.
},
"productLabels": { # Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product labels.
},
"productLegacyCondition": { # Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product legacy condition.
},
"productType": { # Type of a product offer. # Type of a product offer.
"level": "A String", # Level of the type.
"value": "A String", # Value of the type.
},
"productTypeFull": { # Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product full type.
},
"unknownListingDimension": { # Unknown listing dimension. # Unknown dimension. Set when no other listing dimension is set.
},
},
],
},
"localServiceId": { # A Local Services Ads service ID. Represents a service type (such as install_faucet) that a Local Services Campaign can target. # Immutable. GLS service campaign criterion.
"serviceId": "A String", # The criterion resource name.
},
"location": { # A location criterion. # Immutable. Location.
"geoTargetConstant": "A String", # The geo target constant resource name.
},
"locationGroup": { # A radius around a list of locations specified through a feed. # Immutable. Location Group
"enableCustomerLevelLocationAssetSet": True or False, # Denotes that the latest customer level asset set is used for targeting. Used with radius and radius_units. Cannot be used with feed, geo target constants or feed item sets. When using asset sets, either this field or location_group_asset_sets should be specified. Both cannot be used at the same time. This can only be set in CREATE operations.
"feedItemSets": [ # FeedItemSets whose FeedItems are targeted. If multiple IDs are specified, then all items that appear in at least one set are targeted. This field cannot be used with geo_target_constants. This is optional and can only be set in CREATE operations.
"A String",
],
"geoTargetConstants": [ # Geo target constant(s) restricting the scope of the geographic area within the feed. Currently only one geo target constant is allowed.
"A String",
],
"locationGroupAssetSets": [ # AssetSets whose Assets are targeted. If multiple IDs are specified, then all items that appear in at least one set are targeted. This field cannot be used with feed, geo target constants or feed item sets. When using asset sets, either this field or enable_customer_level_location_asset_set should be specified. Both cannot be used at the same time. This can only be set in CREATE operations.
"A String",
],
"radius": "A String", # Distance in units specifying the radius around targeted locations. This is required and must be set in CREATE operations.
"radiusUnits": "A String", # Unit of the radius. Miles and meters are supported for geo target constants. Milli miles and meters are supported for feed item sets. This is required and must be set in CREATE operations.
},
"mobileAppCategory": { # A mobile app category criterion. # Immutable. Mobile app category.
"mobileAppCategoryConstant": "A String", # The mobile app category constant resource name.
},
"mobileApplication": { # A mobile application criterion. # Immutable. Mobile application.
"appId": "A 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": "A String", # Name of this mobile application.
},
"mobileDevice": { # A mobile device criterion. # Immutable. Mobile Device.
"mobileDeviceConstant": "A String", # The mobile device constant resource name.
},
"negative": True or False, # Immutable. Whether to target (`false`) or exclude (`true`) the criterion.
"operatingSystemVersion": { # Represents an operating system version to be targeted. # Immutable. Operating system version.
"operatingSystemVersionConstant": "A String", # The operating system version constant resource name.
},
"parentalStatus": { # A parental status criterion. # Immutable. Parental status.
"type": "A String", # Type of the parental status.
},
"placement": { # A placement criterion. This can be used to modify bids for sites when targeting the content network. # Immutable. Placement.
"url": "A String", # URL of the placement. For example, "http://www.domain.com".
},
"proximity": { # A Proximity criterion. The geo point and radius determine what geographical area is included. The address is a description of the geo point that does not affect ad serving. There are two ways to create a proximity. First, by setting an address and radius. The geo point will be automatically computed. Second, by setting a geo point and radius. The address is an optional label that won't be validated. # Immutable. Proximity.
"address": { # Address for proximity criterion. # Full address.
"cityName": "A String", # Name of the city.
"countryCode": "A String", # Country code.
"postalCode": "A String", # Postal code.
"provinceCode": "A String", # Province or state code.
"provinceName": "A String", # Province or state name.
"streetAddress": "A String", # Street address line 1.
"streetAddress2": "A String", # Street address line 2. This field is write-only. It is only used for calculating the longitude and latitude of an address when geo_point is empty.
},
"geoPoint": { # Geo point for proximity criterion. # Latitude and longitude.
"latitudeInMicroDegrees": 42, # Micro degrees for the latitude.
"longitudeInMicroDegrees": 42, # Micro degrees for the longitude.
},
"radius": 3.14, # The radius of the proximity.
"radiusUnits": "A String", # The unit of measurement of the radius. Default is KILOMETERS.
},
"resourceName": "A String", # Immutable. The resource name of the campaign criterion. Campaign criterion resource names have the form: `customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}`
"status": "A String", # The status of the criterion.
"topic": { # 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"). # Immutable. Topic.
"path": [ # 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.
"A String",
],
"topicConstant": "A String", # The Topic Constant resource name.
},
"type": "A String", # Output only. The type of the criterion.
"userInterest": { # Represents a particular interest-based topic to be targeted. # Immutable. User Interest.
"userInterestCategory": "A String", # The UserInterest resource name.
},
"userList": { # A User List criterion. Represents a user list that is defined by the advertiser to be targeted. # Immutable. User List.
"userList": "A String", # The User List resource name.
},
"videoLineup": { # A Video lineup criterion. # Immutable. Video lineup criterion.
"videoLineupId": "A String", # ID for a Video lineup. Contact your Google business development representative for details.
},
"webpage": { # Represents a criterion for targeting webpages of an advertiser's website. # Immutable. Webpage.
"conditions": [ # 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.
{ # Logical expression for targeting webpages of an advertiser's website.
"argument": "A String", # Argument of webpage targeting condition.
"operand": "A String", # Operand of webpage targeting condition.
"operator": "A String", # Operator of webpage targeting condition.
},
],
"coveragePercentage": 3.14, # 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.
"criterionName": "A 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.
"sample": { # List of sample urls that match the website target # List of sample urls that match the website target. This field is read-only.
"sampleUrls": [ # Webpage sample urls
"A String",
],
},
},
"webpageList": { # Represents a list of webpage criteria. # Immutable. Webpage list. This criterion is not publicly available.
"sharedSet": "A String", # Shared set resource name of the webpage list.
},
"youtubeChannel": { # A YouTube Channel criterion. # Immutable. YouTube Channel.
"channelId": "A String", # The YouTube uploader channel id or the channel code of a YouTube channel.
},
"youtubeVideo": { # A YouTube Video criterion. # Immutable. YouTube Video.
"videoId": "A String", # YouTube video id as it appears on the YouTube watch page.
},
},
"remove": "A String", # Remove operation: A resource name for the removed criterion is expected, in this format: `customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}`
"update": { # A campaign criterion. # Update operation: The criterion is expected to have a valid resource name. Note that for smart campaigns, you cannot use the update method to edit the geolocation target.
"adSchedule": { # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day. # Immutable. Ad Schedule.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
"ageRange": { # An age range criterion. # Immutable. Age range.
"type": "A String", # Type of the age range.
},
"bidModifier": 3.14, # The modifier for the bids when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. Use 0 to opt out of a Device type.
"brandList": { # 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. # Immutable. Brand list campaign criterion.
"sharedSet": "A String", # Shared set resource name of the brand list.
},
"campaign": "A String", # Immutable. The campaign to which the criterion belongs.
"carrier": { # Represents a Carrier Criterion. # Immutable. Carrier.
"carrierConstant": "A String", # The Carrier constant resource name.
},
"combinedAudience": { # A combined audience criterion. # Immutable. Combined Audience.
"combinedAudience": "A String", # The CombinedAudience resource name.
},
"contentLabel": { # Content Label for category exclusion. # Immutable. ContentLabel.
"type": "A String", # Content label type, required for CREATE operations.
},
"criterionId": "A String", # Output only. The ID of the criterion. This field is ignored during mutate.
"device": { # A device criterion. # Immutable. Device.
"type": "A String", # Type of the device.
},
"displayName": "A String", # Output only. The display name of the criterion. This field is ignored for mutates.
"extendedDemographic": { # Represents an extended demographic criterion. # Immutable. Extended demographic criterion.
"extendedDemographicId": "A String", # Taxonomy id of the extended demographic group.
},
"gender": { # A gender criterion. # Immutable. Gender.
"type": "A String", # Type of the gender.
},
"incomeRange": { # An income range criterion. # Immutable. Income range.
"type": "A String", # Type of the income range.
},
"ipBlock": { # 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 # Immutable. IpBlock. You can exclude up to 500 IP addresses per campaign.
"ipAddress": "A String", # The IP address or the CIDR block to be excluded.
},
"keyword": { # A keyword criterion. # Immutable. Keyword.
"matchType": "A String", # The match type of the keyword.
"text": "A String", # The text of the keyword (at most 80 characters and 10 words).
},
"keywordTheme": { # A Smart Campaign keyword theme. # Immutable. Smart Campaign Keyword Theme.
"freeFormKeywordTheme": "A String", # Free-form text to be matched to a Smart Campaign keyword theme constant on a best-effort basis.
"keywordThemeConstant": "A String", # The resource name of a Smart Campaign keyword theme constant. `keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id}`
},
"language": { # A language criterion. # Immutable. Language.
"languageConstant": "A String", # The language constant resource name.
},
"lastModifiedTime": "A String", # Output only. The datetime when this campaign criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
"lifeEvent": { # Represents a life event criterion. # Immutable. Life event campaign criterion.
"lifeEventId": "A String", # Taxonomy id of the life event.
},
"listingScope": { # A listing scope criterion. # Immutable. Listing scope.
"dimensions": [ # Scope of the campaign criterion.
{ # Listing dimensions for listing group criterion.
"activityCity": { # The city where the travel activity is available. # The city where the travel activity is available.
"value": "A String", # String value of the activity city. The Geo Target Constant resource name.
},
"activityCountry": { # The country where the travel activity is available. # The country where the travel activity is available.
"value": "A String", # String value of the activity country. The Geo Target Constant resource name.
},
"activityId": { # Advertiser-specific activity ID. # Advertiser-specific activity ID.
"value": "A String", # String value of the activity ID.
},
"activityRating": { # Rating of the activity as a number 1 to 5, where 5 is the best. # Rating of the activity as a number 1 to 5, where 5 is the best.
"value": "A String", # Long value of the activity rating.
},
"activityState": { # The state where the travel activity is available. # The state where the travel activity is available.
"value": "A String", # String value of the activity state. The Geo Target Constant resource name.
},
"hotelCity": { # City the hotel is located in. # City the hotel is located in.
"cityCriterion": "A String", # The Geo Target Constant resource name.
},
"hotelClass": { # Class of the hotel as a number of stars 1 to 5. # Class of the hotel as a number of stars 1 to 5.
"value": "A String", # Long value of the hotel class.
},
"hotelCountryRegion": { # Country or Region the hotel is located in. # Country or Region the hotel is located in.
"countryRegionCriterion": "A String", # The Geo Target Constant resource name.
},
"hotelId": { # Advertiser-specific hotel ID. # Advertiser-specific hotel ID.
"value": "A String", # String value of the hotel ID.
},
"hotelState": { # State the hotel is located in. # State the hotel is located in.
"stateCriterion": "A String", # The Geo Target Constant resource name.
},
"productBrand": { # Brand of the product. # Brand of a product offer.
"value": "A String", # String value of the product brand.
},
"productCategory": { # Category of a product offer. # Category of a product offer.
"categoryId": "A String", # ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
"level": "A String", # Level of the product category.
},
"productChannel": { # Locality of a product offer. # Locality of a product offer.
"channel": "A String", # Value of the locality.
},
"productChannelExclusivity": { # Availability of a product offer. # Availability of a product offer.
"channelExclusivity": "A String", # Value of the availability.
},
"productCondition": { # Condition of a product offer. # Condition of a product offer.
"condition": "A String", # Value of the condition.
},
"productCustomAttribute": { # Custom attribute of a product offer. # Custom attribute of a product offer.
"index": "A String", # Indicates the index of the custom attribute.
"value": "A String", # String value of the product custom attribute.
},
"productGrouping": { # Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product grouping.
},
"productItemId": { # Item id of a product offer. # Item id of a product offer.
"value": "A String", # Value of the id.
},
"productLabels": { # Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product labels.
},
"productLegacyCondition": { # Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product legacy condition.
},
"productType": { # Type of a product offer. # Type of a product offer.
"level": "A String", # Level of the type.
"value": "A String", # Value of the type.
},
"productTypeFull": { # Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product full type.
},
"unknownListingDimension": { # Unknown listing dimension. # Unknown dimension. Set when no other listing dimension is set.
},
},
],
},
"localServiceId": { # A Local Services Ads service ID. Represents a service type (such as install_faucet) that a Local Services Campaign can target. # Immutable. GLS service campaign criterion.
"serviceId": "A String", # The criterion resource name.
},
"location": { # A location criterion. # Immutable. Location.
"geoTargetConstant": "A String", # The geo target constant resource name.
},
"locationGroup": { # A radius around a list of locations specified through a feed. # Immutable. Location Group
"enableCustomerLevelLocationAssetSet": True or False, # Denotes that the latest customer level asset set is used for targeting. Used with radius and radius_units. Cannot be used with feed, geo target constants or feed item sets. When using asset sets, either this field or location_group_asset_sets should be specified. Both cannot be used at the same time. This can only be set in CREATE operations.
"feedItemSets": [ # FeedItemSets whose FeedItems are targeted. If multiple IDs are specified, then all items that appear in at least one set are targeted. This field cannot be used with geo_target_constants. This is optional and can only be set in CREATE operations.
"A String",
],
"geoTargetConstants": [ # Geo target constant(s) restricting the scope of the geographic area within the feed. Currently only one geo target constant is allowed.
"A String",
],
"locationGroupAssetSets": [ # AssetSets whose Assets are targeted. If multiple IDs are specified, then all items that appear in at least one set are targeted. This field cannot be used with feed, geo target constants or feed item sets. When using asset sets, either this field or enable_customer_level_location_asset_set should be specified. Both cannot be used at the same time. This can only be set in CREATE operations.
"A String",
],
"radius": "A String", # Distance in units specifying the radius around targeted locations. This is required and must be set in CREATE operations.
"radiusUnits": "A String", # Unit of the radius. Miles and meters are supported for geo target constants. Milli miles and meters are supported for feed item sets. This is required and must be set in CREATE operations.
},
"mobileAppCategory": { # A mobile app category criterion. # Immutable. Mobile app category.
"mobileAppCategoryConstant": "A String", # The mobile app category constant resource name.
},
"mobileApplication": { # A mobile application criterion. # Immutable. Mobile application.
"appId": "A 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": "A String", # Name of this mobile application.
},
"mobileDevice": { # A mobile device criterion. # Immutable. Mobile Device.
"mobileDeviceConstant": "A String", # The mobile device constant resource name.
},
"negative": True or False, # Immutable. Whether to target (`false`) or exclude (`true`) the criterion.
"operatingSystemVersion": { # Represents an operating system version to be targeted. # Immutable. Operating system version.
"operatingSystemVersionConstant": "A String", # The operating system version constant resource name.
},
"parentalStatus": { # A parental status criterion. # Immutable. Parental status.
"type": "A String", # Type of the parental status.
},
"placement": { # A placement criterion. This can be used to modify bids for sites when targeting the content network. # Immutable. Placement.
"url": "A String", # URL of the placement. For example, "http://www.domain.com".
},
"proximity": { # A Proximity criterion. The geo point and radius determine what geographical area is included. The address is a description of the geo point that does not affect ad serving. There are two ways to create a proximity. First, by setting an address and radius. The geo point will be automatically computed. Second, by setting a geo point and radius. The address is an optional label that won't be validated. # Immutable. Proximity.
"address": { # Address for proximity criterion. # Full address.
"cityName": "A String", # Name of the city.
"countryCode": "A String", # Country code.
"postalCode": "A String", # Postal code.
"provinceCode": "A String", # Province or state code.
"provinceName": "A String", # Province or state name.
"streetAddress": "A String", # Street address line 1.
"streetAddress2": "A String", # Street address line 2. This field is write-only. It is only used for calculating the longitude and latitude of an address when geo_point is empty.
},
"geoPoint": { # Geo point for proximity criterion. # Latitude and longitude.
"latitudeInMicroDegrees": 42, # Micro degrees for the latitude.
"longitudeInMicroDegrees": 42, # Micro degrees for the longitude.
},
"radius": 3.14, # The radius of the proximity.
"radiusUnits": "A String", # The unit of measurement of the radius. Default is KILOMETERS.
},
"resourceName": "A String", # Immutable. The resource name of the campaign criterion. Campaign criterion resource names have the form: `customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}`
"status": "A String", # The status of the criterion.
"topic": { # 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"). # Immutable. Topic.
"path": [ # 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.
"A String",
],
"topicConstant": "A String", # The Topic Constant resource name.
},
"type": "A String", # Output only. The type of the criterion.
"userInterest": { # Represents a particular interest-based topic to be targeted. # Immutable. User Interest.
"userInterestCategory": "A String", # The UserInterest resource name.
},
"userList": { # A User List criterion. Represents a user list that is defined by the advertiser to be targeted. # Immutable. User List.
"userList": "A String", # The User List resource name.
},
"videoLineup": { # A Video lineup criterion. # Immutable. Video lineup criterion.
"videoLineupId": "A String", # ID for a Video lineup. Contact your Google business development representative for details.
},
"webpage": { # Represents a criterion for targeting webpages of an advertiser's website. # Immutable. Webpage.
"conditions": [ # 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.
{ # Logical expression for targeting webpages of an advertiser's website.
"argument": "A String", # Argument of webpage targeting condition.
"operand": "A String", # Operand of webpage targeting condition.
"operator": "A String", # Operator of webpage targeting condition.
},
],
"coveragePercentage": 3.14, # 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.
"criterionName": "A 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.
"sample": { # List of sample urls that match the website target # List of sample urls that match the website target. This field is read-only.
"sampleUrls": [ # Webpage sample urls
"A String",
],
},
},
"webpageList": { # Represents a list of webpage criteria. # Immutable. Webpage list. This criterion is not publicly available.
"sharedSet": "A String", # Shared set resource name of the webpage list.
},
"youtubeChannel": { # A YouTube Channel criterion. # Immutable. YouTube Channel.
"channelId": "A String", # The YouTube uploader channel id or the channel code of a YouTube channel.
},
"youtubeVideo": { # A YouTube Video criterion. # Immutable. YouTube Video.
"videoId": "A String", # YouTube video id as it appears on the YouTube watch page.
},
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"campaignCustomizerOperation": { # A single operation (create, remove) on a customizer attribute. # A campaign customizer mutate operation.
"create": { # A customizer value for the associated CustomizerAttribute at the Campaign level. # Create operation: No resource name is expected for the new campaign customizer
"campaign": "A String", # Immutable. The campaign to which the customizer attribute is linked.
"customizerAttribute": "A String", # Required. Immutable. The customizer attribute which is linked to the campaign.
"resourceName": "A String", # Immutable. The resource name of the campaign customizer. Campaign customizer resource names have the form: `customers/{customer_id}/campaignCustomizers/{campaign_id}~{customizer_attribute_id}`
"status": "A String", # Output only. The status of the campaign customizer.
"value": { # A customizer value that is referenced in customizer linkage entities like CustomerCustomizer, CampaignCustomizer, etc. # Required. The value to associate with the customizer attribute at this level. The value must be of the type specified for the CustomizerAttribute.
"stringValue": "A String", # Required. Value to insert in creative text. Customizer values of all types are stored as string to make formatting unambiguous.
"type": "A String", # 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.
},
},
"remove": "A String", # Remove operation: A resource name for the removed campaign customizer is expected, in this format: `customers/{customer_id}/campaignCustomizers/{campaign_id}~{customizer_attribute_id}`
},
"campaignDraftOperation": { # A single operation (create, update, remove) on a campaign draft. # A campaign draft mutate operation.
"create": { # A campaign draft. # Create operation: No resource name is expected for the new campaign draft.
"baseCampaign": "A String", # Immutable. The base campaign to which the draft belongs.
"draftCampaign": "A String", # Output only. Resource name of the Campaign that results from overlaying the draft changes onto the base campaign. This field is read-only.
"draftId": "A String", # Output only. The ID of the draft. This field is read-only.
"hasExperimentRunning": True or False, # Output only. Whether there is an experiment based on this draft currently serving.
"longRunningOperation": "A 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.
"name": "A 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.
"resourceName": "A 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}`
"status": "A String", # 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.
},
"remove": "A 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}`
"update": { # A campaign draft. # Update operation: The campaign draft is expected to have a valid resource name.
"baseCampaign": "A String", # Immutable. The base campaign to which the draft belongs.
"draftCampaign": "A String", # Output only. Resource name of the Campaign that results from overlaying the draft changes onto the base campaign. This field is read-only.
"draftId": "A String", # Output only. The ID of the draft. This field is read-only.
"hasExperimentRunning": True or False, # Output only. Whether there is an experiment based on this draft currently serving.
"longRunningOperation": "A 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.
"name": "A 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.
"resourceName": "A 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}`
"status": "A String", # 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.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"campaignGroupOperation": { # A single operation (create, update, remove) on a campaign group. # A campaign group mutate operation.
"create": { # A campaign group. # Create operation: No resource name is expected for the new campaign group.
"id": "A String", # Output only. The ID of the campaign group.
"name": "A 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": "A String", # Immutable. The resource name of the campaign group. Campaign group resource names have the form: `customers/{customer_id}/campaignGroups/{campaign_group_id}`
"status": "A String", # The status of the campaign group. When a new campaign group is added, the status defaults to ENABLED.
},
"remove": "A String", # Remove operation: A resource name for the removed campaign group is expected, in this format: `customers/{customer_id}/campaignGroups/{campaign_group_id}`
"update": { # A campaign group. # Update operation: The campaign group is expected to have a valid resource name.
"id": "A String", # Output only. The ID of the campaign group.
"name": "A 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": "A String", # Immutable. The resource name of the campaign group. Campaign group resource names have the form: `customers/{customer_id}/campaignGroups/{campaign_group_id}`
"status": "A String", # The status of the campaign group. When a new campaign group is added, the status defaults to ENABLED.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"campaignLabelOperation": { # A single operation (create, remove) on a campaign-label relationship. # A campaign label mutate operation.
"create": { # Represents a relationship between a campaign and a label. # Create operation: No resource name is expected for the new campaign-label relationship.
"campaign": "A String", # Immutable. The campaign to which the label is attached.
"label": "A String", # Immutable. The label assigned to the campaign.
"ownerCustomerId": "A String", # Output only. The ID of the Customer which owns the label.
"resourceName": "A String", # Immutable. Name of the resource. Campaign label resource names have the form: `customers/{owner_customer_id}/campaignLabels/{campaign_id}~{label_id}`
},
"remove": "A String", # Remove operation: A resource name for the campaign-label relationship being removed, in this format: `customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}`
},
"campaignOperation": { # A single operation (create, update, remove) on a campaign. # A campaign mutate operation.
"create": { # A campaign. # Create operation: No resource name is expected for the new campaign.
"accessibleBiddingStrategy": "A String", # Output only. Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource.
"adServingOptimizationStatus": "A String", # The ad serving optimization status of the campaign.
"advertisingChannelSubType": "A String", # Immutable. Optional refinement to `advertising_channel_type`. Must be a valid sub-type of the parent channel type. Can be set only when creating campaigns. After campaign is created, the field can not be changed.
"advertisingChannelType": "A String", # Immutable. The primary serving target for ads within the campaign. The targeting options can be refined in `network_settings`. This field is required and should not be empty when creating new campaigns. Can be set only when creating campaigns. After the campaign is created, the field can not be changed.
"aiMaxSetting": { # Settings for AI Max in search campaigns. # Settings for AI Max in search campaigns.
"bundlingRequired": "A String", # Output only. Indicates whether a search campaign has adopted AI Max before, and is required to have AI Max enabled to adopt campaign-level text asset automation and brand list targeting in all API versions.
"enableAiMax": True or False, # Controls whether or not AI Max features are served for this campaign. Individual AI Max features are enabled or disabled by their respective settings. But if enable_ai_max is set to false or cleared, then no AI Max features will serve for this campaign, regardless of the other settings. Search Term Matching is enabled by default when AI Max is enabled, and can be disabled at the ad group level.
},
"appCampaignSetting": { # Campaign-level settings for App Campaigns. # The setting related to App Campaign.
"appId": "A String", # Immutable. A string that uniquely identifies a mobile application.
"appStore": "A String", # Immutable. The application store that distributes this specific app.
"biddingStrategyGoalType": "A String", # Represents the goal which the bidding strategy of this app campaign should optimize towards.
},
"assetAutomationSettings": [ # Contains the opt-in/out status of each AssetAutomationType. See documentation of each asset automation type enum for default opt in/out behavior.
{ # Asset automation setting contains pair of AssetAutomationType and the asset automation opt-in/out status
"assetAutomationStatus": "A String", # The opt-in/out status of asset automation type.
"assetAutomationType": "A String", # The asset automation type advertiser would like to opt-in/out.
},
],
"audienceSetting": { # Settings for the audience targeting. # Immutable. Setting for audience related features.
"useAudienceGrouped": True or False, # Immutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead.
},
"baseCampaign": "A String", # Output only. The resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to `resource_name`. This field is read-only.
"biddingStrategy": "A String", # The resource name of the portfolio bidding strategy used by the campaign.
"biddingStrategySystemStatus": "A String", # Output only. The system status of the campaign's bidding strategy.
"biddingStrategyType": "A String", # Output only. The type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the `bidding_strategy` field to create a portfolio bidding strategy. This field is read-only.
"brandGuidelines": { # Settings that control the visual appearance of your brand in a campaign's automatically generated assets and formats. Only applicable to Performance Max campaigns.
"accentColor": "A String", # The accent brand color, entered as a hex code (e.g., #00ff00). You must provide the accent_color if you provide a main_color.
"mainColor": "A String", # The main brand color, entered as a hex code (e.g., #00ff00). You must provide the main_color if you provide an accent_color.
"predefinedFontFamily": "A String", # The brand's font family. Must be one of the following Google Fonts (case sensitive): Open Sans, Roboto, Montserrat, Poppins, Lato, Oswald, Playfair Display, Roboto Slab.
},
"brandGuidelinesEnabled": True or False, # Immutable. Whether Brand Guidelines are enabled for this Campaign. Only applicable to Performance Max campaigns. If enabled, business name and logo assets must be linked as CampaignAssets instead of AssetGroupAssets.
"campaignBudget": "A String", # The resource name of the campaign budget of the campaign.
"campaignGroup": "A String", # The resource name of the campaign group that this campaign belongs to.
"commission": { # Commission is an automatic bidding strategy in which the advertiser pays a certain portion of the conversion value. # Commission is an automatic bidding strategy in which the advertiser pays a certain portion of the conversion value.
"commissionRateMicros": "A String", # Commission rate defines the portion of the conversion value that the advertiser will be billed. A commission rate of x should be passed into this field as (x * 1,000,000). For example, 106,000 represents a commission rate of 0.106 (10.6%).
},
"containsEuPoliticalAdvertising": "A String", # The advertiser should self-declare whether this campaign contains political advertising content targeted towards the European Union.
"demandGenCampaignSettings": { # Settings for Demand Gen campaign. # Settings for Demand Gen campaign.
"upgradedTargeting": True or False, # Immutable. Specifies whether this campaign uses upgraded targeting options. When this field is set to `true`, you can use location and language targeting at the ad group level as opposed to the standard campaign-level targeting.
},
"dynamicSearchAdsSetting": { # The setting for controlling Dynamic Search Ads (DSA). # The setting for controlling Dynamic Search Ads (DSA).
"domainName": "A String", # Required. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com".
"languageCode": "A String", # Required. The language code specifying the language of the domain, for example, "en".
"useSuppliedUrlsOnly": True or False, # Whether the campaign uses advertiser supplied URLs exclusively.
},
"effectiveLabels": [ # Output only. The resource names of effective labels attached to this campaign. An effective label is a label inherited or directly assigned to this campaign.
"A String",
],
"endDateTime": "A String", # The last day and time of the campaign in serving customer's timezone in "yyyy-MM-dd HH:mm:ss" format. Set the time component to 23:59:59 for daily granularity, time granularity is only supported for some campaign types. On create, defaults to running indefinitely. To set an existing campaign to run indefinitely, clear this field.
"engineId": "A String", # Output only. ID of the campaign 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 "campaign.id" instead.
"excludedParentAssetFieldTypes": [ # The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level.
"A String",
],
"excludedParentAssetSetTypes": [ # The asset set types that should be excluded from this campaign. Asset set links with these types will not be inherited by this campaign from the upper level. 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 campaign, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this campaign. Only LOCATION_SYNC is currently supported.
"A String",
],
"experimentType": "A String", # Output only. The type of campaign: normal, draft, or experiment.
"feedTypes": [ # Output only. Types of feeds that are attached directly to this campaign.
"A String",
],
"finalUrlSuffix": "A String", # Suffix used to append query parameters to landing pages that are served with parallel tracking.
"frequencyCaps": [ # A list that limits how often each user will see this campaign's ads.
{ # A rule specifying the maximum number of times an ad (or some set of ads) can be shown to a user over a particular time period.
"cap": 42, # Maximum number of events allowed during the time range by this cap.
"key": { # A group of fields used as keys for a frequency cap. There can be no more than one frequency cap with the same key. # The key of a particular frequency cap. There can be no more than one frequency cap with the same key.
"eventType": "A String", # The type of event that the cap applies to (for example, impression).
"level": "A String", # The level on which the cap is to be applied (for example, ad group ad, ad group). The cap is applied to all the entities of this level.
"timeLength": 42, # Number of time units the cap lasts.
"timeUnit": "A String", # Unit of time the cap is defined at (for example, day, week).
},
},
],
"geoTargetTypeSetting": { # Represents a collection of settings related to ads geotargeting. # The setting for ads geotargeting.
"negativeGeoTargetType": "A String", # The setting used for negative geotargeting in this particular campaign.
"positiveGeoTargetType": "A String", # The setting used for positive geotargeting in this particular campaign.
},
"hotelPropertyAssetSet": "A String", # Immutable. The resource name for a set of hotel properties for Performance Max for travel goals campaigns.
"hotelSetting": { # Campaign-level settings for hotel ads. # Output only. The hotel setting for the campaign.
"hotelCenterId": "A String", # Output only. The linked Hotel Center account.
},
"id": "A String", # Output only. The ID of the campaign.
"keywordMatchType": "A String", # Keyword match type of Campaign. Set to BROAD to set broad matching for all keywords in a campaign.
"labels": [ # Output only. The resource names of labels attached to this campaign.
"A String",
],
"lastModifiedTime": "A String", # Output only. The datetime when this campaign was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
"listingType": "A String", # Immutable. Listing type of ads served for this campaign. Field is restricted for usage with Performance Max campaigns.
"localCampaignSetting": { # Campaign setting for local campaigns. # The setting for local campaign.
"locationSourceType": "A String", # The location source type for this local campaign.
},
"localServicesCampaignSettings": { # Settings for LocalServicesCampaign subresource. # The Local Services Campaign related settings.
"categoryBids": [ # Categorical level bids associated with MANUAL_CPA bidding strategy.
{ # Category bids in LocalServicesReportingCampaignSettings.
"categoryId": "A String", # Category for which the bid will be associated with. For example, xcat:service_area_business_plumber.
"manualCpaBidMicros": "A String", # Manual CPA bid for the category. Bid must be greater than the reserve price associated for that category. Value is in micros and in the advertiser's currency.
"targetCpaBidMicros": "A String", # Target CPA bid for the category. Value is in micros and in the advertiser's currency.
},
],
},
"manualCpa": { # Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. # Standard Manual CPA bidding strategy. Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. Supported only for Local Services campaigns.
},
"manualCpc": { # Manual click-based bidding where user pays per click. # Standard Manual CPC bidding strategy. Manual click-based bidding where user pays per click.
"enhancedCpcEnabled": True or False, # Whether bids are to be enhanced based on conversion optimizer data.
},
"manualCpm": { # Manual impression-based bidding where user pays per thousand impressions. # Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
},
"manualCpv": { # View based bidding where user pays per video view. # A bidding strategy that pays a configurable amount per video view.
},
"maximizeConversionValue": { # An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget. # Standard Maximize Conversion Value bidding strategy that automatically sets bids to maximize revenue while spending your budget.
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetRoas": 3.14, # 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.
"targetRoasTolerancePercentMillis": "A String", # 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.
},
"maximizeConversions": { # An automated bidding strategy to help get the most conversions for your campaigns while spending your budget. # Standard Maximize Conversions bidding strategy that automatically maximizes number of conversions while spending your budget.
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetCpaMicros": "A String", # 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.
},
"missingEuPoliticalAdvertisingDeclaration": True or False, # Output only. Indicates whether this campaign is missing a declaration about whether it contains political advertising targeted towards the EU and is ineligible for any exemptions. If this field is true, use the contains_eu_political_advertising field to add the required declaration. This field is read-only.
"name": "A String", # The name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
"networkSettings": { # The network settings for the campaign. # The network settings for the campaign.
"targetContentNetwork": True or False, # Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
"targetGoogleSearch": True or False, # Whether ads will be served with google.com search results.
"targetGoogleTvNetwork": True or False, # Whether ads will be served on the Google TV network.
"targetPartnerSearchNetwork": True or False, # Whether ads will be served on the partner network. This is available only to some select partner accounts. Unless you have been instructed to use this field, it likely does not apply to your account. This does not control whether ads will be served on Google Search Partners Network; use `target_search_network` for that instead.
"targetSearchNetwork": True or False, # Whether ads will be served on sites in the Google Search Partners Network (requires `target_google_search` to also be `true`).
"targetYoutube": True or False, # Whether ads will be served on YouTube.
},
"optimizationGoalSetting": { # Optimization goal setting for this campaign, which includes a set of optimization goal types. # Optimization goal setting for this campaign, which includes a set of optimization goal types.
"optimizationGoalTypes": [ # The list of optimization goal types.
"A String",
],
},
"optimizationScore": 3.14, # Output only. Optimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See "About optimization score" at https://support.google.com/google-ads/answer/9061546. This field is read-only.
"paymentMode": "A String", # Payment mode for the campaign.
"percentCpc": { # A bidding strategy where bids are a fraction of the advertised price for some good or service. # Standard Percent Cpc bidding strategy where bids are a fraction of the advertised price for some good or service.
"cpcBidCeilingMicros": "A String", # Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined.
"enhancedCpcEnabled": True or False, # Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not.
},
"performanceMaxUpgrade": { # Information about a campaign being upgraded to Performance Max. # Output only. Information about campaigns being upgraded to Performance Max.
"performanceMaxCampaign": "A String", # Output only. The resource name of the Performance Max campaign the campaign is upgraded to.
"preUpgradeCampaign": "A String", # Output only. The resource name of the legacy campaign upgraded to Performance Max.
"status": "A String", # Output only. The upgrade status of a campaign requested to be upgraded to Performance Max.
},
"pmaxCampaignSettings": { # Settings for Performance Max campaigns. # Settings for Performance Max campaign.
"brandTargetingOverrides": { # Overrides of brand targeting for various ad types. # Overrides of brand targeting for various ad types.
"ignoreExclusionsForShoppingAds": True or False, # If true, brand exclusions are ignored for Shopping ads.
},
},
"primaryStatus": "A String", # Output only. The primary status of the campaign. Provides insight into why a campaign is not serving or not serving optimally. Modification to the campaign and its related entities might take a while to be reflected in this status.
"primaryStatusReasons": [ # Output only. The primary status reasons of the campaign. Provides insight into why a campaign is not serving or not serving optimally. These reasons are aggregated to determine an overall CampaignPrimaryStatus.
"A String",
],
"realTimeBiddingSetting": { # Settings for Real-Time Bidding, a feature only available for campaigns targeting the Ad Exchange network. # Settings for Real-Time Bidding, a feature only available for campaigns targeting the Ad Exchange network.
"optIn": True or False, # Whether the campaign is opted in to real-time bidding.
},
"resourceName": "A String", # Immutable. The resource name of the campaign. Campaign resource names have the form: `customers/{customer_id}/campaigns/{campaign_id}`
"selectiveOptimization": { # Selective optimization setting for this campaign, which includes a set of conversion actions to optimize this campaign towards. This feature only applies to app campaigns that use MULTI_CHANNEL as AdvertisingChannelType and APP_CAMPAIGN or APP_CAMPAIGN_FOR_ENGAGEMENT as AdvertisingChannelSubType. # Selective optimization setting for this campaign, which includes a set of conversion actions to optimize this campaign towards. This feature only applies to app campaigns that use MULTI_CHANNEL as AdvertisingChannelType and APP_CAMPAIGN or APP_CAMPAIGN_FOR_ENGAGEMENT as AdvertisingChannelSubType.
"conversionActions": [ # The selected set of resource names for conversion actions for optimizing this campaign.
"A String",
],
},
"selectiveOptimizationMode": "A String", # Selective optimization mode for this campaign.
"servingStatus": "A String", # Output only. The ad serving status of the campaign.
"shoppingSetting": { # The setting for Shopping campaigns. Defines the universe of products that can be advertised by the campaign, and how this campaign interacts with other Shopping campaigns. # The setting for controlling Shopping campaigns.
"advertisingPartnerIds": [ # The list of Google Ads accounts IDs of advertising partners cooperating within the campaign. This feature is currently available only for accounts having an advertising partner link. This feature is currently supported only for Performance Max, Shopping, Search and Demand Gen campaign types.
"A String",
],
"campaignPriority": 42, # Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set.
"disableProductFeed": True or False, # Disable the optional product feed. This field is currently supported only for Demand Gen campaigns. See https://support.google.com/google-ads/answer/13721750 to learn more about this feature.
"enableLocal": True or False, # Whether to include local products.
"feedLabel": "A String", # Feed label of products to include in the campaign. Valid feed labels may contain a maximum of 20 characters including uppercase letters, numbers, hyphens, and underscores. If you previously used the deprecated `sales_country` in the two-letter country code (`XX`) format, the `feed_label` field should be used instead. For more information see the [feed label](//support.google.com/merchants/answer/12453549) support article.
"merchantId": "A String", # ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
"useVehicleInventory": True or False, # Immutable. Whether to target Vehicle Listing inventory.
},
"startDateTime": "A String", # The date and time when campaign started in serving. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. Set the time component to 00:00:00 for daily granularity, time granularity is only supported for some campaign types.
"status": "A String", # The status of the campaign. When a new campaign is added, the status defaults to ENABLED.
"targetCpa": { # An automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set. # Standard Target CPA bidding strategy that automatically sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetCpaMicros": "A String", # Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
},
"targetCpc": { # An automated bidding strategy that sets bids to help get as many clicks as possible at the target cost-per-click (CPC) you set. # An automated bidding strategy that sets bids to help get as many clicks as possible at the target cost-per-click (CPC) you set.
"targetCpcMicros": "A String", # Average CPC target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
},
"targetCpm": { # Target CPM (cost per thousand impressions) is an automated bidding strategy that sets bids to optimize performance given the target CPM you set. # A bidding strategy that automatically optimizes cost per thousand impressions.
},
"targetImpressionShare": { # 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). # Target Impression Share bidding strategy. An automated bidding strategy that sets bids to achieve a chosen percentage of impressions.
"cpcBidCeilingMicros": "A String", # 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.
"location": "A String", # The targeted location on the search results page.
"locationFractionMicros": "A String", # The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.
},
"targetRoas": { # An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS). # Standard Target ROAS bidding strategy that automatically maximizes revenue while averaging a specific target return on ad spend (ROAS).
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetRoas": 3.14, # Required. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.
"targetRoasTolerancePercentMillis": "A String", # 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.
},
"targetSpend": { # An automated bid strategy that sets your bids to help get as many clicks as possible within your budget. # Standard Target Spend bidding strategy that automatically sets your bids to help get as many clicks as possible within your budget.
"cpcBidCeilingMicros": "A String", # Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
"targetSpendMicros": "A String", # 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.
},
"targetingSetting": { # 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 # Setting for targeting related features.
"targetRestrictionOperations": [ # 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.
{ # Operation to be performed on a target restriction list in a mutate.
"operator": "A String", # Type of list operation to perform.
"value": { # The list of per-targeting-dimension targeting settings. # The target restriction being added to or removed from the list.
"bidOnly": True or False, # 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": "A String", # The targeting dimension that these settings apply to.
},
},
],
"targetRestrictions": [ # The per-targeting-dimension setting to restrict the reach of your campaign or ad group.
{ # The list of per-targeting-dimension targeting settings.
"bidOnly": True or False, # 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": "A String", # The targeting dimension that these settings apply to.
},
],
},
"thirdPartyIntegrationPartners": { # Container for Campaign level third party integration partners. # Third-Party integration partners.
"brandLiftIntegrationPartners": [ # Third party integration partners for Brand Lift verification for this Campaign.
{ # Container for third party Brand Lift integration data for Campaign.
"brandLiftIntegrationPartner": "A String", # Allowed third party integration partners for Brand Lift verification.
"brandLiftIntegrationPartnerData": { # Contains third party measurement partner related data for video campaigns. # Third party partner data for YouTube Brand Lift verification. This is optional metadata for partners to join or attach data to Ads campaigns.
"clientId": "A String", # The client ID that allows the measurement partner to join multiple campaigns for a particular advertiser.
"thirdPartyPlacementId": "A String", # The third party placement ID that maps the measurement partner data with a campaign (or a group of related campaigns) specific data.
},
"shareCost": True or False, # If true, then cost data will be shared with this vendor.
},
],
"brandSafetyIntegrationPartners": [ # Third party integration partners for brand safety verification for this Campaign.
{ # Container for third party brand safety integration data for Campaign.
"brandSafetyIntegrationPartner": "A String", # Allowed third party integration partners for brand safety verification.
"brandSafetyIntegrationPartnerData": { # Contains third party measurement partner related data for video campaigns. # Third party partner data for YouTube brand safety verification. This is optional metadata for partners to join or attach data to Ads campaigns.
"clientId": "A String", # The client ID that allows the measurement partner to join multiple campaigns for a particular advertiser.
"thirdPartyPlacementId": "A String", # The third party placement ID that maps the measurement partner data with a campaign (or a group of related campaigns) specific data.
},
},
],
"reachIntegrationPartners": [ # Third party integration partners for reach verification for this Campaign.
{ # Container for third party reach integration data for Campaign.
"reachIntegrationPartner": "A String", # Allowed third party integration partners for reach verification.
"reachIntegrationPartnerData": { # Contains third party measurement partner related data for video campaigns. # Third party partner data for YouTube Reach verification. This is optional metadata for partners to join or attach data to Ads campaigns.
"clientId": "A String", # The client ID that allows the measurement partner to join multiple campaigns for a particular advertiser.
"thirdPartyPlacementId": "A String", # The third party placement ID that maps the measurement partner data with a campaign (or a group of related campaigns) specific data.
},
"shareCost": True or False, # If true, then cost data will be shared with this vendor.
},
],
"viewabilityIntegrationPartners": [ # Third party integration partners for YouTube viewability verification for this Campaign.
{ # Container for third party viewability integration data for Campaign.
"shareCost": True or False, # If true, then cost data will be shared with this vendor.
"viewabilityIntegrationPartner": "A String", # Allowed third party integration partners for YouTube viewability verification.
"viewabilityIntegrationPartnerData": { # Contains third party measurement partner related data for video campaigns. # Third party partner data for YouTube viewability verification. This is optional metadata for partners to join or attach data to Ads campaigns.
"clientId": "A String", # The client ID that allows the measurement partner to join multiple campaigns for a particular advertiser.
"thirdPartyPlacementId": "A String", # The third party placement ID that maps the measurement partner data with a campaign (or a group of related campaigns) specific data.
},
},
],
},
"trackingSetting": { # Campaign-level settings for tracking information. # Output only. Campaign-level settings for tracking information.
"trackingUrl": "A String", # Output only. The url used for dynamic tracking.
},
"trackingUrlTemplate": "A String", # The URL template for constructing a tracking URL.
"travelCampaignSettings": { # Settings for Travel campaign. # Settings for Travel campaign.
"travelAccountId": "A String", # Immutable. The Travel account ID associated with the Travel campaign.
},
"urlCustomParameters": [ # The list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
{ # A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
"key": "A String", # The key matching the parameter tag name.
"value": "A String", # The value to be substituted.
},
],
"vanityPharma": { # Describes how unbranded pharma ads will be displayed. # Describes how unbranded pharma ads will be displayed.
"vanityPharmaDisplayUrlMode": "A String", # The display mode for vanity pharma URLs.
"vanityPharmaText": "A String", # The text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs.
},
"videoBrandSafetySuitability": "A String", # Brand Safety setting at the individual campaign level. Allows for selecting an inventory type to show your ads on content that is the right fit for your brand. See https://support.google.com/google-ads/answer/7515513.
},
"remove": "A String", # Remove operation: A resource name for the removed campaign is expected, in this format: `customers/{customer_id}/campaigns/{campaign_id}`
"update": { # A campaign. # Update operation: The campaign is expected to have a valid resource name.
"accessibleBiddingStrategy": "A String", # Output only. Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource.
"adServingOptimizationStatus": "A String", # The ad serving optimization status of the campaign.
"advertisingChannelSubType": "A String", # Immutable. Optional refinement to `advertising_channel_type`. Must be a valid sub-type of the parent channel type. Can be set only when creating campaigns. After campaign is created, the field can not be changed.
"advertisingChannelType": "A String", # Immutable. The primary serving target for ads within the campaign. The targeting options can be refined in `network_settings`. This field is required and should not be empty when creating new campaigns. Can be set only when creating campaigns. After the campaign is created, the field can not be changed.
"aiMaxSetting": { # Settings for AI Max in search campaigns. # Settings for AI Max in search campaigns.
"bundlingRequired": "A String", # Output only. Indicates whether a search campaign has adopted AI Max before, and is required to have AI Max enabled to adopt campaign-level text asset automation and brand list targeting in all API versions.
"enableAiMax": True or False, # Controls whether or not AI Max features are served for this campaign. Individual AI Max features are enabled or disabled by their respective settings. But if enable_ai_max is set to false or cleared, then no AI Max features will serve for this campaign, regardless of the other settings. Search Term Matching is enabled by default when AI Max is enabled, and can be disabled at the ad group level.
},
"appCampaignSetting": { # Campaign-level settings for App Campaigns. # The setting related to App Campaign.
"appId": "A String", # Immutable. A string that uniquely identifies a mobile application.
"appStore": "A String", # Immutable. The application store that distributes this specific app.
"biddingStrategyGoalType": "A String", # Represents the goal which the bidding strategy of this app campaign should optimize towards.
},
"assetAutomationSettings": [ # Contains the opt-in/out status of each AssetAutomationType. See documentation of each asset automation type enum for default opt in/out behavior.
{ # Asset automation setting contains pair of AssetAutomationType and the asset automation opt-in/out status
"assetAutomationStatus": "A String", # The opt-in/out status of asset automation type.
"assetAutomationType": "A String", # The asset automation type advertiser would like to opt-in/out.
},
],
"audienceSetting": { # Settings for the audience targeting. # Immutable. Setting for audience related features.
"useAudienceGrouped": True or False, # Immutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead.
},
"baseCampaign": "A String", # Output only. The resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to `resource_name`. This field is read-only.
"biddingStrategy": "A String", # The resource name of the portfolio bidding strategy used by the campaign.
"biddingStrategySystemStatus": "A String", # Output only. The system status of the campaign's bidding strategy.
"biddingStrategyType": "A String", # Output only. The type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the `bidding_strategy` field to create a portfolio bidding strategy. This field is read-only.
"brandGuidelines": { # Settings that control the visual appearance of your brand in a campaign's automatically generated assets and formats. Only applicable to Performance Max campaigns.
"accentColor": "A String", # The accent brand color, entered as a hex code (e.g., #00ff00). You must provide the accent_color if you provide a main_color.
"mainColor": "A String", # The main brand color, entered as a hex code (e.g., #00ff00). You must provide the main_color if you provide an accent_color.
"predefinedFontFamily": "A String", # The brand's font family. Must be one of the following Google Fonts (case sensitive): Open Sans, Roboto, Montserrat, Poppins, Lato, Oswald, Playfair Display, Roboto Slab.
},
"brandGuidelinesEnabled": True or False, # Immutable. Whether Brand Guidelines are enabled for this Campaign. Only applicable to Performance Max campaigns. If enabled, business name and logo assets must be linked as CampaignAssets instead of AssetGroupAssets.
"campaignBudget": "A String", # The resource name of the campaign budget of the campaign.
"campaignGroup": "A String", # The resource name of the campaign group that this campaign belongs to.
"commission": { # Commission is an automatic bidding strategy in which the advertiser pays a certain portion of the conversion value. # Commission is an automatic bidding strategy in which the advertiser pays a certain portion of the conversion value.
"commissionRateMicros": "A String", # Commission rate defines the portion of the conversion value that the advertiser will be billed. A commission rate of x should be passed into this field as (x * 1,000,000). For example, 106,000 represents a commission rate of 0.106 (10.6%).
},
"containsEuPoliticalAdvertising": "A String", # The advertiser should self-declare whether this campaign contains political advertising content targeted towards the European Union.
"demandGenCampaignSettings": { # Settings for Demand Gen campaign. # Settings for Demand Gen campaign.
"upgradedTargeting": True or False, # Immutable. Specifies whether this campaign uses upgraded targeting options. When this field is set to `true`, you can use location and language targeting at the ad group level as opposed to the standard campaign-level targeting.
},
"dynamicSearchAdsSetting": { # The setting for controlling Dynamic Search Ads (DSA). # The setting for controlling Dynamic Search Ads (DSA).
"domainName": "A String", # Required. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com".
"languageCode": "A String", # Required. The language code specifying the language of the domain, for example, "en".
"useSuppliedUrlsOnly": True or False, # Whether the campaign uses advertiser supplied URLs exclusively.
},
"effectiveLabels": [ # Output only. The resource names of effective labels attached to this campaign. An effective label is a label inherited or directly assigned to this campaign.
"A String",
],
"endDateTime": "A String", # The last day and time of the campaign in serving customer's timezone in "yyyy-MM-dd HH:mm:ss" format. Set the time component to 23:59:59 for daily granularity, time granularity is only supported for some campaign types. On create, defaults to running indefinitely. To set an existing campaign to run indefinitely, clear this field.
"engineId": "A String", # Output only. ID of the campaign 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 "campaign.id" instead.
"excludedParentAssetFieldTypes": [ # The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level.
"A String",
],
"excludedParentAssetSetTypes": [ # The asset set types that should be excluded from this campaign. Asset set links with these types will not be inherited by this campaign from the upper level. 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 campaign, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this campaign. Only LOCATION_SYNC is currently supported.
"A String",
],
"experimentType": "A String", # Output only. The type of campaign: normal, draft, or experiment.
"feedTypes": [ # Output only. Types of feeds that are attached directly to this campaign.
"A String",
],
"finalUrlSuffix": "A String", # Suffix used to append query parameters to landing pages that are served with parallel tracking.
"frequencyCaps": [ # A list that limits how often each user will see this campaign's ads.
{ # A rule specifying the maximum number of times an ad (or some set of ads) can be shown to a user over a particular time period.
"cap": 42, # Maximum number of events allowed during the time range by this cap.
"key": { # A group of fields used as keys for a frequency cap. There can be no more than one frequency cap with the same key. # The key of a particular frequency cap. There can be no more than one frequency cap with the same key.
"eventType": "A String", # The type of event that the cap applies to (for example, impression).
"level": "A String", # The level on which the cap is to be applied (for example, ad group ad, ad group). The cap is applied to all the entities of this level.
"timeLength": 42, # Number of time units the cap lasts.
"timeUnit": "A String", # Unit of time the cap is defined at (for example, day, week).
},
},
],
"geoTargetTypeSetting": { # Represents a collection of settings related to ads geotargeting. # The setting for ads geotargeting.
"negativeGeoTargetType": "A String", # The setting used for negative geotargeting in this particular campaign.
"positiveGeoTargetType": "A String", # The setting used for positive geotargeting in this particular campaign.
},
"hotelPropertyAssetSet": "A String", # Immutable. The resource name for a set of hotel properties for Performance Max for travel goals campaigns.
"hotelSetting": { # Campaign-level settings for hotel ads. # Output only. The hotel setting for the campaign.
"hotelCenterId": "A String", # Output only. The linked Hotel Center account.
},
"id": "A String", # Output only. The ID of the campaign.
"keywordMatchType": "A String", # Keyword match type of Campaign. Set to BROAD to set broad matching for all keywords in a campaign.
"labels": [ # Output only. The resource names of labels attached to this campaign.
"A String",
],
"lastModifiedTime": "A String", # Output only. The datetime when this campaign was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
"listingType": "A String", # Immutable. Listing type of ads served for this campaign. Field is restricted for usage with Performance Max campaigns.
"localCampaignSetting": { # Campaign setting for local campaigns. # The setting for local campaign.
"locationSourceType": "A String", # The location source type for this local campaign.
},
"localServicesCampaignSettings": { # Settings for LocalServicesCampaign subresource. # The Local Services Campaign related settings.
"categoryBids": [ # Categorical level bids associated with MANUAL_CPA bidding strategy.
{ # Category bids in LocalServicesReportingCampaignSettings.
"categoryId": "A String", # Category for which the bid will be associated with. For example, xcat:service_area_business_plumber.
"manualCpaBidMicros": "A String", # Manual CPA bid for the category. Bid must be greater than the reserve price associated for that category. Value is in micros and in the advertiser's currency.
"targetCpaBidMicros": "A String", # Target CPA bid for the category. Value is in micros and in the advertiser's currency.
},
],
},
"manualCpa": { # Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. # Standard Manual CPA bidding strategy. Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. Supported only for Local Services campaigns.
},
"manualCpc": { # Manual click-based bidding where user pays per click. # Standard Manual CPC bidding strategy. Manual click-based bidding where user pays per click.
"enhancedCpcEnabled": True or False, # Whether bids are to be enhanced based on conversion optimizer data.
},
"manualCpm": { # Manual impression-based bidding where user pays per thousand impressions. # Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
},
"manualCpv": { # View based bidding where user pays per video view. # A bidding strategy that pays a configurable amount per video view.
},
"maximizeConversionValue": { # An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget. # Standard Maximize Conversion Value bidding strategy that automatically sets bids to maximize revenue while spending your budget.
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetRoas": 3.14, # 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.
"targetRoasTolerancePercentMillis": "A String", # 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.
},
"maximizeConversions": { # An automated bidding strategy to help get the most conversions for your campaigns while spending your budget. # Standard Maximize Conversions bidding strategy that automatically maximizes number of conversions while spending your budget.
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetCpaMicros": "A String", # 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.
},
"missingEuPoliticalAdvertisingDeclaration": True or False, # Output only. Indicates whether this campaign is missing a declaration about whether it contains political advertising targeted towards the EU and is ineligible for any exemptions. If this field is true, use the contains_eu_political_advertising field to add the required declaration. This field is read-only.
"name": "A String", # The name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
"networkSettings": { # The network settings for the campaign. # The network settings for the campaign.
"targetContentNetwork": True or False, # Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
"targetGoogleSearch": True or False, # Whether ads will be served with google.com search results.
"targetGoogleTvNetwork": True or False, # Whether ads will be served on the Google TV network.
"targetPartnerSearchNetwork": True or False, # Whether ads will be served on the partner network. This is available only to some select partner accounts. Unless you have been instructed to use this field, it likely does not apply to your account. This does not control whether ads will be served on Google Search Partners Network; use `target_search_network` for that instead.
"targetSearchNetwork": True or False, # Whether ads will be served on sites in the Google Search Partners Network (requires `target_google_search` to also be `true`).
"targetYoutube": True or False, # Whether ads will be served on YouTube.
},
"optimizationGoalSetting": { # Optimization goal setting for this campaign, which includes a set of optimization goal types. # Optimization goal setting for this campaign, which includes a set of optimization goal types.
"optimizationGoalTypes": [ # The list of optimization goal types.
"A String",
],
},
"optimizationScore": 3.14, # Output only. Optimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See "About optimization score" at https://support.google.com/google-ads/answer/9061546. This field is read-only.
"paymentMode": "A String", # Payment mode for the campaign.
"percentCpc": { # A bidding strategy where bids are a fraction of the advertised price for some good or service. # Standard Percent Cpc bidding strategy where bids are a fraction of the advertised price for some good or service.
"cpcBidCeilingMicros": "A String", # Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined.
"enhancedCpcEnabled": True or False, # Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not.
},
"performanceMaxUpgrade": { # Information about a campaign being upgraded to Performance Max. # Output only. Information about campaigns being upgraded to Performance Max.
"performanceMaxCampaign": "A String", # Output only. The resource name of the Performance Max campaign the campaign is upgraded to.
"preUpgradeCampaign": "A String", # Output only. The resource name of the legacy campaign upgraded to Performance Max.
"status": "A String", # Output only. The upgrade status of a campaign requested to be upgraded to Performance Max.
},
"pmaxCampaignSettings": { # Settings for Performance Max campaigns. # Settings for Performance Max campaign.
"brandTargetingOverrides": { # Overrides of brand targeting for various ad types. # Overrides of brand targeting for various ad types.
"ignoreExclusionsForShoppingAds": True or False, # If true, brand exclusions are ignored for Shopping ads.
},
},
"primaryStatus": "A String", # Output only. The primary status of the campaign. Provides insight into why a campaign is not serving or not serving optimally. Modification to the campaign and its related entities might take a while to be reflected in this status.
"primaryStatusReasons": [ # Output only. The primary status reasons of the campaign. Provides insight into why a campaign is not serving or not serving optimally. These reasons are aggregated to determine an overall CampaignPrimaryStatus.
"A String",
],
"realTimeBiddingSetting": { # Settings for Real-Time Bidding, a feature only available for campaigns targeting the Ad Exchange network. # Settings for Real-Time Bidding, a feature only available for campaigns targeting the Ad Exchange network.
"optIn": True or False, # Whether the campaign is opted in to real-time bidding.
},
"resourceName": "A String", # Immutable. The resource name of the campaign. Campaign resource names have the form: `customers/{customer_id}/campaigns/{campaign_id}`
"selectiveOptimization": { # Selective optimization setting for this campaign, which includes a set of conversion actions to optimize this campaign towards. This feature only applies to app campaigns that use MULTI_CHANNEL as AdvertisingChannelType and APP_CAMPAIGN or APP_CAMPAIGN_FOR_ENGAGEMENT as AdvertisingChannelSubType. # Selective optimization setting for this campaign, which includes a set of conversion actions to optimize this campaign towards. This feature only applies to app campaigns that use MULTI_CHANNEL as AdvertisingChannelType and APP_CAMPAIGN or APP_CAMPAIGN_FOR_ENGAGEMENT as AdvertisingChannelSubType.
"conversionActions": [ # The selected set of resource names for conversion actions for optimizing this campaign.
"A String",
],
},
"selectiveOptimizationMode": "A String", # Selective optimization mode for this campaign.
"servingStatus": "A String", # Output only. The ad serving status of the campaign.
"shoppingSetting": { # The setting for Shopping campaigns. Defines the universe of products that can be advertised by the campaign, and how this campaign interacts with other Shopping campaigns. # The setting for controlling Shopping campaigns.
"advertisingPartnerIds": [ # The list of Google Ads accounts IDs of advertising partners cooperating within the campaign. This feature is currently available only for accounts having an advertising partner link. This feature is currently supported only for Performance Max, Shopping, Search and Demand Gen campaign types.
"A String",
],
"campaignPriority": 42, # Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set.
"disableProductFeed": True or False, # Disable the optional product feed. This field is currently supported only for Demand Gen campaigns. See https://support.google.com/google-ads/answer/13721750 to learn more about this feature.
"enableLocal": True or False, # Whether to include local products.
"feedLabel": "A String", # Feed label of products to include in the campaign. Valid feed labels may contain a maximum of 20 characters including uppercase letters, numbers, hyphens, and underscores. If you previously used the deprecated `sales_country` in the two-letter country code (`XX`) format, the `feed_label` field should be used instead. For more information see the [feed label](//support.google.com/merchants/answer/12453549) support article.
"merchantId": "A String", # ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
"useVehicleInventory": True or False, # Immutable. Whether to target Vehicle Listing inventory.
},
"startDateTime": "A String", # The date and time when campaign started in serving. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. Set the time component to 00:00:00 for daily granularity, time granularity is only supported for some campaign types.
"status": "A String", # The status of the campaign. When a new campaign is added, the status defaults to ENABLED.
"targetCpa": { # An automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set. # Standard Target CPA bidding strategy that automatically sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetCpaMicros": "A String", # Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
},
"targetCpc": { # An automated bidding strategy that sets bids to help get as many clicks as possible at the target cost-per-click (CPC) you set. # An automated bidding strategy that sets bids to help get as many clicks as possible at the target cost-per-click (CPC) you set.
"targetCpcMicros": "A String", # Average CPC target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
},
"targetCpm": { # Target CPM (cost per thousand impressions) is an automated bidding strategy that sets bids to optimize performance given the target CPM you set. # A bidding strategy that automatically optimizes cost per thousand impressions.
},
"targetImpressionShare": { # 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). # Target Impression Share bidding strategy. An automated bidding strategy that sets bids to achieve a chosen percentage of impressions.
"cpcBidCeilingMicros": "A String", # 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.
"location": "A String", # The targeted location on the search results page.
"locationFractionMicros": "A String", # The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.
},
"targetRoas": { # An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS). # Standard Target ROAS bidding strategy that automatically maximizes revenue while averaging a specific target return on ad spend (ROAS).
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetRoas": 3.14, # Required. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.
"targetRoasTolerancePercentMillis": "A String", # 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.
},
"targetSpend": { # An automated bid strategy that sets your bids to help get as many clicks as possible within your budget. # Standard Target Spend bidding strategy that automatically sets your bids to help get as many clicks as possible within your budget.
"cpcBidCeilingMicros": "A String", # Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
"targetSpendMicros": "A String", # 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.
},
"targetingSetting": { # 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 # Setting for targeting related features.
"targetRestrictionOperations": [ # 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.
{ # Operation to be performed on a target restriction list in a mutate.
"operator": "A String", # Type of list operation to perform.
"value": { # The list of per-targeting-dimension targeting settings. # The target restriction being added to or removed from the list.
"bidOnly": True or False, # 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": "A String", # The targeting dimension that these settings apply to.
},
},
],
"targetRestrictions": [ # The per-targeting-dimension setting to restrict the reach of your campaign or ad group.
{ # The list of per-targeting-dimension targeting settings.
"bidOnly": True or False, # 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": "A String", # The targeting dimension that these settings apply to.
},
],
},
"thirdPartyIntegrationPartners": { # Container for Campaign level third party integration partners. # Third-Party integration partners.
"brandLiftIntegrationPartners": [ # Third party integration partners for Brand Lift verification for this Campaign.
{ # Container for third party Brand Lift integration data for Campaign.
"brandLiftIntegrationPartner": "A String", # Allowed third party integration partners for Brand Lift verification.
"brandLiftIntegrationPartnerData": { # Contains third party measurement partner related data for video campaigns. # Third party partner data for YouTube Brand Lift verification. This is optional metadata for partners to join or attach data to Ads campaigns.
"clientId": "A String", # The client ID that allows the measurement partner to join multiple campaigns for a particular advertiser.
"thirdPartyPlacementId": "A String", # The third party placement ID that maps the measurement partner data with a campaign (or a group of related campaigns) specific data.
},
"shareCost": True or False, # If true, then cost data will be shared with this vendor.
},
],
"brandSafetyIntegrationPartners": [ # Third party integration partners for brand safety verification for this Campaign.
{ # Container for third party brand safety integration data for Campaign.
"brandSafetyIntegrationPartner": "A String", # Allowed third party integration partners for brand safety verification.
"brandSafetyIntegrationPartnerData": { # Contains third party measurement partner related data for video campaigns. # Third party partner data for YouTube brand safety verification. This is optional metadata for partners to join or attach data to Ads campaigns.
"clientId": "A String", # The client ID that allows the measurement partner to join multiple campaigns for a particular advertiser.
"thirdPartyPlacementId": "A String", # The third party placement ID that maps the measurement partner data with a campaign (or a group of related campaigns) specific data.
},
},
],
"reachIntegrationPartners": [ # Third party integration partners for reach verification for this Campaign.
{ # Container for third party reach integration data for Campaign.
"reachIntegrationPartner": "A String", # Allowed third party integration partners for reach verification.
"reachIntegrationPartnerData": { # Contains third party measurement partner related data for video campaigns. # Third party partner data for YouTube Reach verification. This is optional metadata for partners to join or attach data to Ads campaigns.
"clientId": "A String", # The client ID that allows the measurement partner to join multiple campaigns for a particular advertiser.
"thirdPartyPlacementId": "A String", # The third party placement ID that maps the measurement partner data with a campaign (or a group of related campaigns) specific data.
},
"shareCost": True or False, # If true, then cost data will be shared with this vendor.
},
],
"viewabilityIntegrationPartners": [ # Third party integration partners for YouTube viewability verification for this Campaign.
{ # Container for third party viewability integration data for Campaign.
"shareCost": True or False, # If true, then cost data will be shared with this vendor.
"viewabilityIntegrationPartner": "A String", # Allowed third party integration partners for YouTube viewability verification.
"viewabilityIntegrationPartnerData": { # Contains third party measurement partner related data for video campaigns. # Third party partner data for YouTube viewability verification. This is optional metadata for partners to join or attach data to Ads campaigns.
"clientId": "A String", # The client ID that allows the measurement partner to join multiple campaigns for a particular advertiser.
"thirdPartyPlacementId": "A String", # The third party placement ID that maps the measurement partner data with a campaign (or a group of related campaigns) specific data.
},
},
],
},
"trackingSetting": { # Campaign-level settings for tracking information. # Output only. Campaign-level settings for tracking information.
"trackingUrl": "A String", # Output only. The url used for dynamic tracking.
},
"trackingUrlTemplate": "A String", # The URL template for constructing a tracking URL.
"travelCampaignSettings": { # Settings for Travel campaign. # Settings for Travel campaign.
"travelAccountId": "A String", # Immutable. The Travel account ID associated with the Travel campaign.
},
"urlCustomParameters": [ # The list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
{ # A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
"key": "A String", # The key matching the parameter tag name.
"value": "A String", # The value to be substituted.
},
],
"vanityPharma": { # Describes how unbranded pharma ads will be displayed. # Describes how unbranded pharma ads will be displayed.
"vanityPharmaDisplayUrlMode": "A String", # The display mode for vanity pharma URLs.
"vanityPharmaText": "A String", # The text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs.
},
"videoBrandSafetySuitability": "A String", # Brand Safety setting at the individual campaign level. Allows for selecting an inventory type to show your ads on content that is the right fit for your brand. See https://support.google.com/google-ads/answer/7515513.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"campaignSharedSetOperation": { # A single operation (create, remove) on a campaign shared set. # A campaign shared set mutate operation.
"create": { # CampaignSharedSets are used for managing the shared sets associated with a campaign. # Create operation: No resource name is expected for the new campaign shared set.
"campaign": "A String", # Immutable. The campaign to which the campaign shared set belongs.
"resourceName": "A String", # Immutable. The resource name of the campaign shared set. Campaign shared set resource names have the form: `customers/{customer_id}/campaignSharedSets/{campaign_id}~{shared_set_id}`
"sharedSet": "A String", # Immutable. The shared set associated with the campaign. This may be a negative keyword shared set of another customer. This customer should be a manager of the other customer, otherwise the campaign shared set will exist but have no serving effect. Only negative keyword shared sets can be associated with Shopping campaigns. Only negative placement shared sets can be associated with Display mobile app campaigns.
"status": "A String", # Output only. The status of this campaign shared set. Read only.
},
"remove": "A String", # Remove operation: A resource name for the removed campaign shared set is expected, in this format: `customers/{customer_id}/campaignSharedSets/{campaign_id}~{shared_set_id}`
},
"conversionActionOperation": { # A single operation (create, update, remove) on a conversion action. # A conversion action mutate operation.
"create": { # A conversion action. # Create operation: No resource name is expected for the new conversion action.
"appId": "A String", # App ID for an app conversion action.
"attributionModelSettings": { # Settings related to this conversion action's attribution model. # Settings related to this conversion action's attribution model.
"attributionModel": "A String", # The attribution model type of this conversion action.
"dataDrivenModelStatus": "A String", # Output only. The status of the data-driven attribution model for the conversion action.
},
"category": "A String", # The category of conversions reported for this conversion action.
"clickThroughLookbackWindowDays": "A String", # The maximum number of days that may elapse between an interaction (for example, a click) and a conversion event.
"countingType": "A String", # How to count conversion events for the conversion action.
"creationTime": "A String", # Output only. Timestamp of the Floodlight activity's creation, formatted in ISO 8601.
"firebaseSettings": { # Settings related to a Firebase conversion action. # Output only. Firebase settings for Firebase conversion types.
"eventName": "A String", # Output only. The event name of a Firebase conversion.
"projectId": "A String", # Output only. The Firebase project ID of the conversion.
"propertyId": "A String", # Output only. The GA property ID of the conversion.
"propertyName": "A String", # Output only. The GA property name of the conversion.
},
"floodlightSettings": { # Settings related to a Floodlight conversion action. # Output only. Floodlight settings for Floodlight conversion types.
"activityGroupTag": "A String", # Output only. String used to identify a Floodlight activity group when reporting conversions.
"activityId": "A String", # Output only. ID of the Floodlight activity in DoubleClick Campaign Manager (DCM).
"activityTag": "A String", # Output only. String used to identify a Floodlight activity when reporting conversions.
},
"googleAnalytics4Settings": { # Settings related to a Google Analytics 4 conversion action. # Output only. Google Analytics 4 settings for Google Analytics 4 conversion types.
"eventName": "A String", # Output only. The name of the GA 4 event.
"propertyId": "A String", # Output only. The ID of the GA 4 property.
"propertyName": "A String", # Output only. The name of the GA 4 property.
},
"id": "A String", # Output only. The ID of the conversion action.
"includeInClientAccountConversionsMetric": True or False, # Whether this conversion action should be included in the "client_account_conversions" metric.
"includeInConversionsMetric": True or False, # Output only. Whether this conversion action should be included in the "conversions" metric.
"mobileAppVendor": "A String", # Output only. Mobile app vendor for an app conversion action.
"name": "A String", # The name of the conversion action. This field is required and should not be empty when creating new conversion actions.
"origin": "A String", # Output only. The conversion origin of this conversion action.
"ownerCustomer": "A String", # Output only. The resource name of the conversion action owner customer, or null if this is a system-defined conversion action.
"phoneCallDurationSeconds": "A String", # 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.
"primaryForGoal": True or False, # 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.
"resourceName": "A String", # Immutable. The resource name of the conversion action. Conversion action resource names have the form: `customers/{customer_id}/conversionActions/{conversion_action_id}`
"status": "A String", # The status of this conversion action for conversion event accrual.
"tagSnippets": [ # Output only. The snippets used for tracking conversions.
{ # The site tag and event snippet pair for a TrackingCodeType.
"eventSnippet": "A String", # The event snippet that works with the site tag to track actions that should be counted as conversions.
"globalSiteTag": "A String", # The site tag that adds visitors to your basic remarketing lists and sets new cookies on your domain.
"pageFormat": "A String", # The format of the web page where the tracking tag and snippet will be installed, for example, HTML.
"type": "A String", # The type of the generated tag snippets for tracking conversions.
},
],
"thirdPartyAppAnalyticsSettings": { # Settings related to a third party app analytics conversion action. # Output only. Third Party App Analytics settings for third party conversion types.
"eventName": "A String", # Output only. The event name of a third-party app analytics conversion.
"providerName": "A String", # Output only. Name of the third-party app analytics provider.
},
"type": "A String", # Immutable. The type of this conversion action.
"valueSettings": { # Settings related to the value for conversion events associated with this conversion action. # Settings related to the value for conversion events associated with this conversion action.
"alwaysUseDefaultValue": True or False, # 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": "A 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.
"defaultValue": 3.14, # 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.
},
"viewThroughLookbackWindowDays": "A String", # The maximum number of days which may elapse between an impression and a conversion without an interaction.
},
"remove": "A String", # Remove operation: A resource name for the removed conversion action is expected, in this format: `customers/{customer_id}/conversionActions/{conversion_action_id}`
"update": { # A conversion action. # Update operation: The conversion action is expected to have a valid resource name.
"appId": "A String", # App ID for an app conversion action.
"attributionModelSettings": { # Settings related to this conversion action's attribution model. # Settings related to this conversion action's attribution model.
"attributionModel": "A String", # The attribution model type of this conversion action.
"dataDrivenModelStatus": "A String", # Output only. The status of the data-driven attribution model for the conversion action.
},
"category": "A String", # The category of conversions reported for this conversion action.
"clickThroughLookbackWindowDays": "A String", # The maximum number of days that may elapse between an interaction (for example, a click) and a conversion event.
"countingType": "A String", # How to count conversion events for the conversion action.
"creationTime": "A String", # Output only. Timestamp of the Floodlight activity's creation, formatted in ISO 8601.
"firebaseSettings": { # Settings related to a Firebase conversion action. # Output only. Firebase settings for Firebase conversion types.
"eventName": "A String", # Output only. The event name of a Firebase conversion.
"projectId": "A String", # Output only. The Firebase project ID of the conversion.
"propertyId": "A String", # Output only. The GA property ID of the conversion.
"propertyName": "A String", # Output only. The GA property name of the conversion.
},
"floodlightSettings": { # Settings related to a Floodlight conversion action. # Output only. Floodlight settings for Floodlight conversion types.
"activityGroupTag": "A String", # Output only. String used to identify a Floodlight activity group when reporting conversions.
"activityId": "A String", # Output only. ID of the Floodlight activity in DoubleClick Campaign Manager (DCM).
"activityTag": "A String", # Output only. String used to identify a Floodlight activity when reporting conversions.
},
"googleAnalytics4Settings": { # Settings related to a Google Analytics 4 conversion action. # Output only. Google Analytics 4 settings for Google Analytics 4 conversion types.
"eventName": "A String", # Output only. The name of the GA 4 event.
"propertyId": "A String", # Output only. The ID of the GA 4 property.
"propertyName": "A String", # Output only. The name of the GA 4 property.
},
"id": "A String", # Output only. The ID of the conversion action.
"includeInClientAccountConversionsMetric": True or False, # Whether this conversion action should be included in the "client_account_conversions" metric.
"includeInConversionsMetric": True or False, # Output only. Whether this conversion action should be included in the "conversions" metric.
"mobileAppVendor": "A String", # Output only. Mobile app vendor for an app conversion action.
"name": "A String", # The name of the conversion action. This field is required and should not be empty when creating new conversion actions.
"origin": "A String", # Output only. The conversion origin of this conversion action.
"ownerCustomer": "A String", # Output only. The resource name of the conversion action owner customer, or null if this is a system-defined conversion action.
"phoneCallDurationSeconds": "A String", # 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.
"primaryForGoal": True or False, # 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.
"resourceName": "A String", # Immutable. The resource name of the conversion action. Conversion action resource names have the form: `customers/{customer_id}/conversionActions/{conversion_action_id}`
"status": "A String", # The status of this conversion action for conversion event accrual.
"tagSnippets": [ # Output only. The snippets used for tracking conversions.
{ # The site tag and event snippet pair for a TrackingCodeType.
"eventSnippet": "A String", # The event snippet that works with the site tag to track actions that should be counted as conversions.
"globalSiteTag": "A String", # The site tag that adds visitors to your basic remarketing lists and sets new cookies on your domain.
"pageFormat": "A String", # The format of the web page where the tracking tag and snippet will be installed, for example, HTML.
"type": "A String", # The type of the generated tag snippets for tracking conversions.
},
],
"thirdPartyAppAnalyticsSettings": { # Settings related to a third party app analytics conversion action. # Output only. Third Party App Analytics settings for third party conversion types.
"eventName": "A String", # Output only. The event name of a third-party app analytics conversion.
"providerName": "A String", # Output only. Name of the third-party app analytics provider.
},
"type": "A String", # Immutable. The type of this conversion action.
"valueSettings": { # Settings related to the value for conversion events associated with this conversion action. # Settings related to the value for conversion events associated with this conversion action.
"alwaysUseDefaultValue": True or False, # 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": "A 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.
"defaultValue": 3.14, # 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.
},
"viewThroughLookbackWindowDays": "A String", # The maximum number of days which may elapse between an impression and a conversion without an interaction.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"conversionCustomVariableOperation": { # A single operation (create, update) on a conversion custom variable. # A conversion custom variable mutate operation.
"create": { # A conversion custom variable. See "About custom Floodlight metrics and dimensions in the new Search Ads 360" at https://support.google.com/sa360/answer/13567857 # Create operation: No resource name is expected for the new conversion custom variable.
"cardinality": "A String", # Output only. Cardinality of the conversion custom variable.
"customColumnIds": [ # Output only. The IDs of custom columns that use this conversion custom variable.
"A String",
],
"family": "A String", # Output only. Family of the conversion custom variable.
"floodlightConversionCustomVariableInfo": { # Information for Search Ads 360 Floodlight Conversion Custom Variables. # Output only. Fields for Search Ads 360 floodlight conversion custom variables.
"floodlightVariableDataType": "A String", # Output only. Floodlight variable data type defined in Search Ads 360.
"floodlightVariableType": "A String", # Output only. Floodlight variable type defined in Search Ads 360.
},
"id": "A String", # Output only. The ID of the conversion custom variable.
"name": "A String", # Required. The name of the conversion custom variable. Name should be unique. The maximum length of name is 100 characters. There should not be any extra spaces before and after.
"ownerCustomer": "A String", # Output only. The resource name of the customer that owns the conversion custom variable.
"resourceName": "A String", # Immutable. The resource name of the conversion custom variable. Conversion custom variable resource names have the form: `customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}`
"status": "A String", # The status of the conversion custom variable for conversion event accrual.
"tag": "A String", # Required. Immutable. The tag of the conversion custom variable. Tag should be unique and consist of a "u" character directly followed with a number less than ormequal to 100. For example: "u4".
},
"update": { # A conversion custom variable. See "About custom Floodlight metrics and dimensions in the new Search Ads 360" at https://support.google.com/sa360/answer/13567857 # Update operation: The conversion custom variable is expected to have a valid resource name.
"cardinality": "A String", # Output only. Cardinality of the conversion custom variable.
"customColumnIds": [ # Output only. The IDs of custom columns that use this conversion custom variable.
"A String",
],
"family": "A String", # Output only. Family of the conversion custom variable.
"floodlightConversionCustomVariableInfo": { # Information for Search Ads 360 Floodlight Conversion Custom Variables. # Output only. Fields for Search Ads 360 floodlight conversion custom variables.
"floodlightVariableDataType": "A String", # Output only. Floodlight variable data type defined in Search Ads 360.
"floodlightVariableType": "A String", # Output only. Floodlight variable type defined in Search Ads 360.
},
"id": "A String", # Output only. The ID of the conversion custom variable.
"name": "A String", # Required. The name of the conversion custom variable. Name should be unique. The maximum length of name is 100 characters. There should not be any extra spaces before and after.
"ownerCustomer": "A String", # Output only. The resource name of the customer that owns the conversion custom variable.
"resourceName": "A String", # Immutable. The resource name of the conversion custom variable. Conversion custom variable resource names have the form: `customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}`
"status": "A String", # The status of the conversion custom variable for conversion event accrual.
"tag": "A String", # Required. Immutable. The tag of the conversion custom variable. Tag should be unique and consist of a "u" character directly followed with a number less than ormequal to 100. For example: "u4".
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"conversionGoalCampaignConfigOperation": { # A single operation (update) on a conversion goal campaign config. # A conversion goal campaign config mutate operation.
"update": { # Conversion goal settings for a Campaign. # Update operation: The conversion goal campaign config is expected to have a valid resource name.
"campaign": "A String", # Immutable. The campaign with which this conversion goal campaign config is associated.
"customConversionGoal": "A String", # The custom conversion goal the campaign is using for optimization.
"goalConfigLevel": "A String", # The level of goal config the campaign is using.
"resourceName": "A String", # Immutable. The resource name of the conversion goal campaign config. Conversion goal campaign config resource names have the form: `customers/{customer_id}/conversionGoalCampaignConfigs/{campaign_id}`
"searchAds360CustomConversionGoal": "A String", # The Search Ads 360 custom conversion goal the campaign is using for optimization.
"searchAds360GoalConfigLevel": "A String", # The level of Search Ads 360 goal config the campaign is using.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"conversionValueRuleOperation": { # A single operation (create, update, remove) on a conversion value rule. # A conversion value rule mutate operation.
"create": { # A conversion value rule # Create operation: No resource name is expected for the new conversion value rule.
"action": { # Action applied when rule is applied. # Action applied when the rule is triggered.
"operation": "A String", # Specifies applied operation.
"value": 3.14, # Specifies applied value.
},
"audienceCondition": { # Condition on Audience dimension. # Condition for audience that must be satisfied for the value rule to apply.
"userInterests": [ # User Interests.
"A String",
],
"userLists": [ # User Lists.
"A String",
],
},
"deviceCondition": { # Condition on Device dimension. # Condition for device type that must be satisfied for the value rule to apply.
"deviceTypes": [ # Value for device type condition.
"A String",
],
},
"geoLocationCondition": { # Condition on Geo dimension. # Condition for Geo location that must be satisfied for the value rule to apply.
"excludedGeoMatchType": "A String", # Excluded Geo location match type.
"excludedGeoTargetConstants": [ # Geo locations that advertisers want to exclude.
"A String",
],
"geoMatchType": "A String", # Included Geo location match type.
"geoTargetConstants": [ # Geo locations that advertisers want to include.
"A String",
],
},
"id": "A String", # Output only. The ID of the conversion value rule.
"itineraryCondition": { # Condition on Itinerary dimension. # Condition for itinerary that must be satisfied for the value rule to apply.
"advanceBookingWindow": { # Range for the number of days between the date of the booking and the start of the itinerary. # Range for the number of days between the date of the booking and the start of the itinerary.
"maxDays": 42, # Maximum number of days between the date of the booking the start date.
"minDays": 42, # Minimum number of days between the date of the booking the start date.
},
"travelLength": { # Range for the itinerary length in number of nights. # Range for the itinerary length in number of nights.
"maxNights": 42, # Maximum number of days between the start date and the end date.
"minNights": 42, # Minimum number of nights between the start date and the end date.
},
"travelStartDay": { # The days of the week on which an itinerary's travel can start. # The days of the week on which this itinerary's travel can start.
"friday": True or False, # The travel can start on Friday.
"monday": True or False, # The travel can start on Monday.
"saturday": True or False, # The travel can start on Saturday.
"sunday": True or False, # The travel can start on Sunday.
"thursday": True or False, # The travel can start on Thursday.
"tuesday": True or False, # The travel can start on Tuesday.
"wednesday": True or False, # The travel can start on Wednesday.
},
},
"ownerCustomer": "A 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 **
"resourceName": "A 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}`
"status": "A String", # The status of the conversion value rule.
},
"remove": "A 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}`
"update": { # A conversion value rule # Update operation: The conversion value rule is expected to have a valid resource name.
"action": { # Action applied when rule is applied. # Action applied when the rule is triggered.
"operation": "A String", # Specifies applied operation.
"value": 3.14, # Specifies applied value.
},
"audienceCondition": { # Condition on Audience dimension. # Condition for audience that must be satisfied for the value rule to apply.
"userInterests": [ # User Interests.
"A String",
],
"userLists": [ # User Lists.
"A String",
],
},
"deviceCondition": { # Condition on Device dimension. # Condition for device type that must be satisfied for the value rule to apply.
"deviceTypes": [ # Value for device type condition.
"A String",
],
},
"geoLocationCondition": { # Condition on Geo dimension. # Condition for Geo location that must be satisfied for the value rule to apply.
"excludedGeoMatchType": "A String", # Excluded Geo location match type.
"excludedGeoTargetConstants": [ # Geo locations that advertisers want to exclude.
"A String",
],
"geoMatchType": "A String", # Included Geo location match type.
"geoTargetConstants": [ # Geo locations that advertisers want to include.
"A String",
],
},
"id": "A String", # Output only. The ID of the conversion value rule.
"itineraryCondition": { # Condition on Itinerary dimension. # Condition for itinerary that must be satisfied for the value rule to apply.
"advanceBookingWindow": { # Range for the number of days between the date of the booking and the start of the itinerary. # Range for the number of days between the date of the booking and the start of the itinerary.
"maxDays": 42, # Maximum number of days between the date of the booking the start date.
"minDays": 42, # Minimum number of days between the date of the booking the start date.
},
"travelLength": { # Range for the itinerary length in number of nights. # Range for the itinerary length in number of nights.
"maxNights": 42, # Maximum number of days between the start date and the end date.
"minNights": 42, # Minimum number of nights between the start date and the end date.
},
"travelStartDay": { # The days of the week on which an itinerary's travel can start. # The days of the week on which this itinerary's travel can start.
"friday": True or False, # The travel can start on Friday.
"monday": True or False, # The travel can start on Monday.
"saturday": True or False, # The travel can start on Saturday.
"sunday": True or False, # The travel can start on Sunday.
"thursday": True or False, # The travel can start on Thursday.
"tuesday": True or False, # The travel can start on Tuesday.
"wednesday": True or False, # The travel can start on Wednesday.
},
},
"ownerCustomer": "A 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 **
"resourceName": "A 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}`
"status": "A String", # The status of the conversion value rule.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"conversionValueRuleSetOperation": { # A single operation (create, update, remove) on a conversion value rule set. # A conversion value rule set mutate operation.
"create": { # 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. # Create operation: No resource name is expected for the new conversion value rule set.
"attachmentType": "A String", # Immutable. Defines the scope where the conversion value rule set is attached.
"campaign": "A String", # The resource name of the campaign when the conversion value rule set is attached to a campaign.
"conversionActionCategories": [ # Immutable. The conversion action categories of the conversion value rule set.
"A String",
],
"conversionValueRules": [ # Resource names of rules within the rule set.
"A String",
],
"dimensions": [ # 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.
"A String",
],
"id": "A String", # Output only. The ID of the conversion value rule set.
"ownerCustomer": "A 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": "A 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}`
"status": "A String", # Output only. The status of the conversion value rule set. ** Read-only **
},
"remove": "A 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}`
"update": { # 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. # Update operation: The conversion value rule set is expected to have a valid resource name.
"attachmentType": "A String", # Immutable. Defines the scope where the conversion value rule set is attached.
"campaign": "A String", # The resource name of the campaign when the conversion value rule set is attached to a campaign.
"conversionActionCategories": [ # Immutable. The conversion action categories of the conversion value rule set.
"A String",
],
"conversionValueRules": [ # Resource names of rules within the rule set.
"A String",
],
"dimensions": [ # 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.
"A String",
],
"id": "A String", # Output only. The ID of the conversion value rule set.
"ownerCustomer": "A 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": "A 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}`
"status": "A String", # Output only. The status of the conversion value rule set. ** Read-only **
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"customConversionGoalOperation": { # A single operation (create, remove) on a custom conversion goal. # A custom conversion goal mutate operation.
"create": { # Custom conversion goal that can make arbitrary conversion actions biddable. # Create operation: No resource name is expected for the new custom conversion goal
"conversionActions": [ # Conversion actions that the custom conversion goal makes biddable.
"A String",
],
"id": "A String", # Immutable. The ID for this custom conversion goal.
"name": "A String", # The name for this custom conversion goal.
"resourceName": "A String", # Immutable. The resource name of the custom conversion goal. Custom conversion goal resource names have the form: `customers/{customer_id}/customConversionGoals/{goal_id}`
"status": "A String", # The status of the custom conversion goal.
},
"remove": "A String", # Remove operation: A resource name for the removed custom conversion goal is expected, in this format: 'customers/{customer_id}/customConversionGoals/{goal_id}'
"update": { # Custom conversion goal that can make arbitrary conversion actions biddable. # Update operation: The custom conversion goal is expected to have a valid resource name.
"conversionActions": [ # Conversion actions that the custom conversion goal makes biddable.
"A String",
],
"id": "A String", # Immutable. The ID for this custom conversion goal.
"name": "A String", # The name for this custom conversion goal.
"resourceName": "A String", # Immutable. The resource name of the custom conversion goal. Custom conversion goal resource names have the form: `customers/{customer_id}/customConversionGoals/{goal_id}`
"status": "A String", # The status of the custom conversion goal.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"customerAssetOperation": { # A single operation (create, update, remove) on a customer asset. # A customer asset mutate operation.
"create": { # A link between a customer and an asset. # Create operation: No resource name is expected for the new customer asset.
"asset": "A String", # Required. Immutable. The asset which is linked to the customer.
"fieldType": "A String", # Required. Immutable. Role that the asset takes for the customer link.
"primaryStatus": "A String", # 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.
"primaryStatusDetails": [ # Output only. Provides the details of the primary status and its associated reasons.
{ # Provides the detail of a PrimaryStatus. Each asset link has a PrimaryStatus value (e.g. NOT_ELIGIBLE, meaning not serving), and list of corroborating PrimaryStatusReasons (e.g. [ASSET_DISAPPROVED]). Each reason may have some additional details annotated with it. For instance, when the reason is ASSET_DISAPPROVED, the details field will contain additional information about the offline evaluation errors which led to the asset being disapproved.
"assetDisapproved": { # Details related to AssetLinkPrimaryStatusReasonPB.ASSET_DISAPPROVED # Provides the details for AssetLinkPrimaryStatusReason.ASSET_DISAPPROVED
"offlineEvaluationErrorReasons": [ # Provides the quality evaluation disapproval reason of an asset.
"A String",
],
},
"reason": "A String", # Provides the reason of this PrimaryStatus.
"status": "A String", # Provides the PrimaryStatus of this status detail.
},
],
"primaryStatusReasons": [ # Output only. Provides a list of reasons for why an asset is not serving or not serving at full capacity.
"A String",
],
"resourceName": "A String", # Immutable. The resource name of the customer asset. CustomerAsset resource names have the form: `customers/{customer_id}/customerAssets/{asset_id}~{field_type}`
"source": "A String", # Output only. Source of the customer asset link.
"status": "A String", # Status of the customer asset.
},
"remove": "A String", # Remove operation: A resource name for the removed customer asset is expected, in this format: `customers/{customer_id}/customerAssets/{asset_id}~{field_type}`
"update": { # A link between a customer and an asset. # Update operation: The customer asset is expected to have a valid resource name.
"asset": "A String", # Required. Immutable. The asset which is linked to the customer.
"fieldType": "A String", # Required. Immutable. Role that the asset takes for the customer link.
"primaryStatus": "A String", # 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.
"primaryStatusDetails": [ # Output only. Provides the details of the primary status and its associated reasons.
{ # Provides the detail of a PrimaryStatus. Each asset link has a PrimaryStatus value (e.g. NOT_ELIGIBLE, meaning not serving), and list of corroborating PrimaryStatusReasons (e.g. [ASSET_DISAPPROVED]). Each reason may have some additional details annotated with it. For instance, when the reason is ASSET_DISAPPROVED, the details field will contain additional information about the offline evaluation errors which led to the asset being disapproved.
"assetDisapproved": { # Details related to AssetLinkPrimaryStatusReasonPB.ASSET_DISAPPROVED # Provides the details for AssetLinkPrimaryStatusReason.ASSET_DISAPPROVED
"offlineEvaluationErrorReasons": [ # Provides the quality evaluation disapproval reason of an asset.
"A String",
],
},
"reason": "A String", # Provides the reason of this PrimaryStatus.
"status": "A String", # Provides the PrimaryStatus of this status detail.
},
],
"primaryStatusReasons": [ # Output only. Provides a list of reasons for why an asset is not serving or not serving at full capacity.
"A String",
],
"resourceName": "A String", # Immutable. The resource name of the customer asset. CustomerAsset resource names have the form: `customers/{customer_id}/customerAssets/{asset_id}~{field_type}`
"source": "A String", # Output only. Source of the customer asset link.
"status": "A String", # Status of the customer asset.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"customerConversionGoalOperation": { # A single operation (update) on a customer conversion goal. # A customer conversion goal mutate operation.
"update": { # Biddability control for conversion actions with a matching category and origin. # Update operation: The customer conversion goal is expected to have a valid resource name.
"biddable": True or False, # The biddability of the customer conversion goal.
"category": "A String", # The conversion category of this customer conversion goal. Only conversion actions that have this category will be included in this goal.
"origin": "A String", # The conversion origin of this customer conversion goal. Only conversion actions that have this conversion origin will be included in this goal.
"resourceName": "A String", # Immutable. The resource name of the customer conversion goal. Customer conversion goal resource names have the form: `customers/{customer_id}/customerConversionGoals/{category}~{origin}`
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"customerCustomizerOperation": { # A single operation (create, remove) on a customizer attribute. # A customer customizer mutate operation.
"create": { # A customizer value for the associated CustomizerAttribute at the Customer level. # Create operation: No resource name is expected for the new customer customizer
"customizerAttribute": "A String", # Required. Immutable. The customizer attribute which is linked to the customer.
"resourceName": "A String", # Immutable. The resource name of the customer customizer. Customer customizer resource names have the form: `customers/{customer_id}/customerCustomizers/{customizer_attribute_id}`
"status": "A String", # Output only. The status of the customer customizer attribute.
"value": { # A customizer value that is referenced in customizer linkage entities like CustomerCustomizer, CampaignCustomizer, etc. # Required. The value to associate with the customizer attribute at this level. The value must be of the type specified for the CustomizerAttribute.
"stringValue": "A String", # Required. Value to insert in creative text. Customizer values of all types are stored as string to make formatting unambiguous.
"type": "A String", # 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.
},
},
"remove": "A String", # Remove operation: A resource name for the removed customer customizer is expected, in this format: `customers/{customer_id}/customerCustomizers/{customizer_attribute_id}`
},
"customerLabelOperation": { # A single operation (create, remove) on a customer-label relationship. # A customer label mutate operation.
"create": { # Represents a relationship between a customer and a label. This customer may not have access to all the labels attached to it. Additional CustomerLabels may be returned by increasing permissions with login-customer-id. # Create operation: No resource name is expected for the new customer-label relationship.
"customer": "A String", # Output only. The resource name of the customer to which the label is attached. Read only.
"label": "A String", # Output only. The resource name of the label assigned to the customer. Note: the Customer ID portion of the label resource name is not validated when creating a new CustomerLabel.
"resourceName": "A String", # Immutable. Name of the resource. Customer label resource names have the form: `customers/{customer_id}/customerLabels/{label_id}`
},
"remove": "A String", # Remove operation: A resource name for the customer-label relationship being removed, in this format: `customers/{customer_id}/customerLabels/{label_id}`
},
"customerNegativeCriterionOperation": { # A single operation (create or remove) on a customer level negative criterion. # A customer negative criterion mutate operation.
"create": { # A negative criterion for exclusions at the customer level. # Create operation: No resource name is expected for the new criterion.
"contentLabel": { # Content Label for category exclusion. # Immutable. ContentLabel.
"type": "A String", # Content label type, required for CREATE operations.
},
"id": "A String", # Output only. The ID of the criterion.
"ipBlock": { # 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 # Immutable. IpBlock. You can exclude up to 500 IP addresses per account.
"ipAddress": "A String", # The IP address or the CIDR block to be excluded.
},
"mobileAppCategory": { # A mobile app category criterion. # Immutable. MobileAppCategory.
"mobileAppCategoryConstant": "A String", # The mobile app category constant resource name.
},
"mobileApplication": { # A mobile application criterion. # Immutable. MobileApplication.
"appId": "A 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": "A String", # Name of this mobile application.
},
"negativeKeywordList": { # 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. # Immutable. NegativeKeywordList.
"sharedSet": "A String", # The NegativeKeywordListInfo shared set resource name.
},
"placement": { # A placement criterion. This can be used to modify bids for sites when targeting the content network. # Immutable. Placement.
"url": "A String", # URL of the placement. For example, "http://www.domain.com".
},
"placementList": { # A Placement List criterion. Represents a shared set of placements that can be excluded at the account-level. # Immutable. PlacementList.
"sharedSet": "A String", # The PlacementListInfo shared set resource name.
},
"resourceName": "A String", # Immutable. The resource name of the customer negative criterion. Customer negative criterion resource names have the form: `customers/{customer_id}/customerNegativeCriteria/{criterion_id}`
"type": "A String", # Output only. The type of the criterion.
"youtubeChannel": { # A YouTube Channel criterion. # Immutable. YouTube Channel.
"channelId": "A String", # The YouTube uploader channel id or the channel code of a YouTube channel.
},
"youtubeVideo": { # A YouTube Video criterion. # Immutable. YouTube Video.
"videoId": "A String", # YouTube video id as it appears on the YouTube watch page.
},
},
"remove": "A String", # Remove operation: A resource name for the removed criterion is expected, in this format: `customers/{customer_id}/customerNegativeCriteria/{criterion_id}`
},
"customerOperation": { # A single update on a customer. # A customer mutate operation.
"update": { # A customer. # Mutate operation. Only updates are supported for customer.
"accountLevel": "A String", # Output only. The account level of the customer: Manager, Sub-manager, Associate manager, Service account.
"accountStatus": "A String", # Output only. Account status, for example, Enabled, Paused, Removed, etc.
"accountType": "A String", # Output only. Engine account type, for example, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track, etc.
"associateManagerDescriptiveName": "A String", # Output only. The descriptive name of the associate manager.
"associateManagerId": "A String", # Output only. The customer ID of the associate manager. A 0 value indicates that the customer has no SA360 associate manager.
"autoTaggingEnabled": True or False, # Whether auto-tagging is enabled for the customer.
"callReportingSetting": { # Call reporting setting for a customer. # Call reporting setting for a customer.
"callConversionAction": "A String", # Customer-level call conversion action to attribute a call conversion to. If not set a default conversion action is used. Only in effect when call_conversion_reporting_enabled is set to true.
"callConversionReportingEnabled": True or False, # Whether to enable call conversion reporting.
"callReportingEnabled": True or False, # Enable reporting of phone call events by redirecting them through Google System.
},
"containsEuPoliticalAdvertising": "A String", # Output only. Returns the advertiser self-declaration status of whether this customer contains political advertising content targeted towards the European Union. You can use the Google Ads UI to update this account-level declaration, or use the API to update the self-declaration status of individual campaigns.
"conversionTrackingSetting": { # A collection of customer-wide settings related to Search Ads 360 Conversion Tracking. # Conversion tracking setting for a customer.
"acceptedCustomerDataTerms": True or False, # Output only. Whether the customer has accepted customer data terms. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. For more information, see https://support.google.com/adspolicy/answer/7475709.
"conversionTrackingId": "A String", # Output only. The conversion tracking id used for this account. This id doesn't indicate whether the customer uses conversion tracking (conversion_tracking_status does). This field is read-only.
"conversionTrackingStatus": "A String", # Output only. Conversion tracking status. It indicates whether the customer is using conversion tracking, and who is the conversion tracking owner of this customer. If this customer is using cross-account conversion tracking, the value returned will differ based on the `login-customer-id` of the request.
"crossAccountConversionTrackingId": "A String", # Output only. The conversion tracking id of the customer's manager. This is set when the customer is opted into cross-account conversion tracking, and it overrides conversion_tracking_id.
"enhancedConversionsForLeadsEnabled": True or False, # Output only. Whether the customer is opted-in for enhanced conversions for leads. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only.
"googleAdsConversionCustomer": "A String", # The resource name of the customer where conversions are created and managed. This field is read-only.
"googleAdsCrossAccountConversionTrackingId": "A String", # Output only. The conversion tracking id of the customer's manager. This is set when the customer is opted into conversion tracking, and it overrides conversion_tracking_id. This field can only be managed through the Google Ads UI. This field is read-only.
},
"creationTime": "A String", # Output only. The timestamp when this customer was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
"currencyCode": "A String", # Immutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
"customerAgreementSetting": { # Customer Agreement Setting for a customer. # Output only. Customer Agreement Setting for a customer.
"acceptedLeadFormTerms": True or False, # Output only. Whether the customer has accepted lead form term of service.
},
"descriptiveName": "A String", # Optional, non-unique descriptive name of the customer.
"doubleClickCampaignManagerSetting": { # DoubleClick Campaign Manager (DCM) setting for a manager customer. # Output only. DoubleClick Campaign Manager (DCM) setting for a manager customer.
"advertiserId": "A String", # Output only. ID of the Campaign Manager advertiser associated with this customer.
"networkId": "A String", # Output only. ID of the Campaign Manager network associated with this customer.
"timeZone": "A String", # Output only. Time zone of the Campaign Manager network associated with this customer in IANA Time Zone Database format, such as America/New_York.
},
"engineId": "A String", # Output only. ID of the account in the external engine account.
"finalUrlSuffix": "A String", # The URL template for appending params to the final URL.
"hasPartnersBadge": True or False, # Output only. Whether the Customer has a Partners program badge. If the Customer is not associated with the Partners program, this will be false. For more information, see https://support.google.com/partners/answer/3125774.
"id": "A String", # Output only. The ID of the customer.
"imageAssetAutoMigrationDone": True or False, # Output only. True if feed based image has been migrated to asset based image.
"imageAssetAutoMigrationDoneDateTime": "A String", # Output only. Timestamp of migration from feed based image to asset base image in yyyy-MM-dd HH:mm:ss format.
"lastModifiedTime": "A String", # Output only. The datetime when this customer was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
"localServicesSettings": { # Settings for Local Services customer. # Output only. Settings for Local Services customer.
"granularInsuranceStatuses": [ # Output only. A read-only list of geo vertical level insurance statuses.
{ # Insurance status at geo + vertical level.
"categoryId": "A String", # Output only. Service category associated with the status. For example, xcat:service_area_business_plumber. For more details see: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
"geoCriterionId": "A String", # Output only. Geotarget criterion ID associated with the status. Can be on country or state/province geo level, depending on requirements and location. See https://developers.google.com/google-ads/api/data/geotargets for more information.
"verificationStatus": "A String", # Output only. Granular insurance status, per geo + vertical.
},
],
"granularLicenseStatuses": [ # Output only. A read-only list of geo vertical level license statuses.
{ # License status at geo + vertical level.
"categoryId": "A String", # Output only. Service category associated with the status. For example, xcat:service_area_business_plumber. For more details see: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
"geoCriterionId": "A String", # Output only. Geotarget criterion ID associated with the status. Can be on country or state/province geo level, depending on requirements and location. See https://developers.google.com/google-ads/api/data/geotargets for more information.
"verificationStatus": "A String", # Output only. Granular license status, per geo + vertical.
},
],
},
"locationAssetAutoMigrationDone": True or False, # Output only. True if feed based location has been migrated to asset based location.
"locationAssetAutoMigrationDoneDateTime": "A String", # Output only. Timestamp of migration from feed based location to asset base location in yyyy-MM-dd HH:mm:ss format.
"manager": True or False, # Output only. Whether the customer is a manager.
"managerDescriptiveName": "A String", # Output only. The descriptive name of the manager.
"managerId": "A String", # Output only. The customer ID of the manager. A 0 value indicates that the customer has no SA360 manager.
"optimizationScore": 3.14, # Output only. Optimization score of the customer. Optimization score is an estimate of how well a customer's campaigns are set to perform. It ranges from 0% (0.0) to 100% (1.0). This field is null for all manager customers, and for unscored non-manager customers. See "About optimization score" at https://support.google.com/google-ads/answer/9061546. This field is read-only.
"optimizationScoreWeight": 3.14, # Output only. Optimization score weight of the customer. Optimization score weight can be used to compare/aggregate optimization scores across multiple non-manager customers. The aggregate optimization score of a manager is computed as the sum over all of their customers of `Customer.optimization_score * Customer.optimization_score_weight`. This field is 0 for all manager customers, and for unscored non-manager customers. This field is read-only.
"payPerConversionEligibilityFailureReasons": [ # Output only. Reasons why the customer is not eligible to use PaymentMode.CONVERSIONS. If the list is empty, the customer is eligible. This field is read-only.
"A String",
],
"remarketingSetting": { # Remarketing setting for a customer. # Output only. Remarketing setting for a customer.
"googleGlobalSiteTag": "A String", # Output only. The Google tag.
},
"resourceName": "A String", # Immutable. The resource name of the customer. Customer resource names have the form: `customers/{customer_id}`
"status": "A String", # Output only. The status of the customer.
"subManagerDescriptiveName": "A String", # Output only. The descriptive name of the sub manager.
"subManagerId": "A String", # Output only. The customer ID of the sub manager. A 0 value indicates that the customer has no sub SA360 manager.
"testAccount": True or False, # Output only. Whether the customer is a test account.
"timeZone": "A String", # Immutable. The local timezone ID of the customer.
"trackingUrlTemplate": "A String", # The URL template for constructing a tracking URL out of parameters.
"videoBrandSafetySuitability": "A String", # Brand Safety setting at the account level. Allows for selecting an inventory type to show your ads on content that is the right fit for your brand. See https://support.google.com/google-ads/answer/7515513.
"videoCustomer": { # Video specific information about a Customer. # Video specific information about a Customer.
"thirdPartyIntegrationPartners": { # Container for Customer level third party integration partners. # Third Party integration partners.
"brandLiftIntegrationPartners": [ # Allowed third party integration partners for Brand Lift verification.
{ # Container for third party Brand Lift integration data for Customer.
"allowShareCost": True or False, # If true, cost data can be shared with this vendor.
"brandLiftIntegrationPartner": "A String", # Allowed Third Party integration partners for Brand Lift verification.
},
],
"brandSafetyIntegrationPartners": [ # Allowed third party integration partners for brand safety verification.
{ # Container for third party brand safety integration data for Customer.
"brandSafetyIntegrationPartner": "A String", # Allowed third party integration partners for brand safety verification.
},
],
"reachIntegrationPartners": [ # Allowed third party integration partners for reach verification.
{ # Container for third party reach integration data for Customer.
"allowShareCost": True or False, # If true, cost data can be shared with this vendor.
"reachIntegrationPartner": "A String", # Allowed Third Party integration partners for reach verification.
},
],
"viewabilityIntegrationPartners": [ # Allowed third party integration partners for YouTube viewability verification.
{ # Container for third party viewability integration data for Customer.
"allowShareCost": True or False, # If true, cost data can be shared with this vendor.
"viewabilityIntegrationPartner": "A String", # Allowed third party integration partners for YouTube viewability verification.
},
],
},
},
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"customizerAttributeOperation": { # A single operation (create, remove) on a customizer attribute. # A customizer attribute mutate operation.
"create": { # 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. # Create operation: No resource name is expected for the new customizer attribute
"id": "A String", # Output only. The ID of the customizer attribute.
"name": "A 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": "A String", # Immutable. The resource name of the customizer attribute. Customizer Attribute resource names have the form: `customers/{customer_id}/customizerAttributes/{customizer_attribute_id}`
"status": "A String", # Output only. The status of the customizer attribute.
"type": "A String", # Immutable. The type of the customizer attribute.
},
"remove": "A String", # Remove operation: A resource name for the removed customizer attribute is expected, in this format: `customers/{customer_id}/customizerAttributes/{customizer_attribute_id}`
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"experimentArmOperation": { # A single operation on an experiment arm. # An experiment arm mutate operation.
"create": { # A Google ads experiment for users to experiment changes on multiple campaigns, compare the performance, and apply the effective changes. # Create operation
"assetGroups": [ # List of asset groups in the experiment arm.
{ # Holds the asset groups included in an arm of an Optimize Assets experiment.
"assetGroup": "A String", # Asset group resource name.
"assetGroupAssets": [ # List of asset group assets under the asset group.
{ # Holds the details of an asset within an asset group for an Optimize Assets experiment arm.
"asset": "A String", # Asset resource name of the asset group asset.
"fieldType": "A String", # Field type of the asset group asset.
},
],
},
],
"campaigns": [ # List of campaigns in the trial arm. The max length is one.
"A String",
],
"control": True or False, # Whether this arm is a control arm. A control arm is the arm against which the other arms are compared.
"experiment": "A String", # Immutable. The experiment to which the ExperimentArm belongs.
"inDesignCampaigns": [ # Output only. The in design campaigns in the treatment experiment arm.
"A String",
],
"name": "A String", # Required. The name of the experiment arm. It must have a minimum length of 1 and maximum length of 1024. It must be unique under an experiment.
"resourceName": "A String", # Immutable. The resource name of the experiment arm. Experiment arm resource names have the form: `customers/{customer_id}/experimentArms/{TrialArm.trial_id}~{TrialArm.trial_arm_id}`
"trafficSplit": "A String", # Traffic split of the trial arm. The value should be between 1 and 100 and must total 100 between the two trial arms.
},
"remove": "A String", # Remove operation: The experiment arm is expected to have a valid resource name, in this format: `customers/{customer_id}/experiments/{campaign_experiment_id}`
"update": { # A Google ads experiment for users to experiment changes on multiple campaigns, compare the performance, and apply the effective changes. # Update operation: The experiment arm is expected to have a valid resource name.
"assetGroups": [ # List of asset groups in the experiment arm.
{ # Holds the asset groups included in an arm of an Optimize Assets experiment.
"assetGroup": "A String", # Asset group resource name.
"assetGroupAssets": [ # List of asset group assets under the asset group.
{ # Holds the details of an asset within an asset group for an Optimize Assets experiment arm.
"asset": "A String", # Asset resource name of the asset group asset.
"fieldType": "A String", # Field type of the asset group asset.
},
],
},
],
"campaigns": [ # List of campaigns in the trial arm. The max length is one.
"A String",
],
"control": True or False, # Whether this arm is a control arm. A control arm is the arm against which the other arms are compared.
"experiment": "A String", # Immutable. The experiment to which the ExperimentArm belongs.
"inDesignCampaigns": [ # Output only. The in design campaigns in the treatment experiment arm.
"A String",
],
"name": "A String", # Required. The name of the experiment arm. It must have a minimum length of 1 and maximum length of 1024. It must be unique under an experiment.
"resourceName": "A String", # Immutable. The resource name of the experiment arm. Experiment arm resource names have the form: `customers/{customer_id}/experimentArms/{TrialArm.trial_id}~{TrialArm.trial_arm_id}`
"trafficSplit": "A String", # Traffic split of the trial arm. The value should be between 1 and 100 and must total 100 between the two trial arms.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"experimentOperation": { # A single operation on an experiment. # An experiment mutate operation.
"create": { # A Google ads experiment for users to experiment changes on multiple campaigns, compare the performance, and apply the effective changes. # Create operation
"description": "A String", # The description of the experiment. It must have a minimum length of 1 and maximum length of 2048.
"endDate": "A String", # Date when the experiment ends. By default, the experiment ends on the campaign's end date. If this field is set, then the experiment ends at the end of the specified date in the customer's time zone. Format: YYYY-MM-DD Example: 2019-04-18
"experimentId": "A String", # Output only. The ID of the experiment. Read only.
"goals": [ # The goals of this experiment.
{ # A metric goal for an experiment.
"direction": "A String", # The metric direction of the goal. For example, increase, decrease, no change.
"metric": "A String", # The metric of the goal. For example, clicks, impressions, cost, conversions, etc.
},
],
"longRunningOperation": "A String", # Output only. The resource name of the long-running operation that can be used to poll for completion of experiment schedule or promote. The most recent long running operation is returned.
"name": "A String", # Required. The name of the experiment. It must have a minimum length of 1 and maximum length of 1024. It must be unique under a customer.
"promoteStatus": "A String", # Output only. The status of the experiment promotion process.
"resourceName": "A String", # Immutable. The resource name of the experiment. Experiment resource names have the form: `customers/{customer_id}/experiments/{experiment_id}`
"startDate": "A String", # Date when the experiment starts. By default, the experiment starts now or on the campaign's start date, whichever is later. If this field is set, then the experiment starts at the beginning of the specified date in the customer's time zone. Format: YYYY-MM-DD Example: 2019-03-14
"status": "A String", # The Advertiser-chosen status of this experiment.
"suffix": "A String", # For system managed experiments, the advertiser must provide a suffix during construction, in the setup stage before moving to initiated. The suffix will be appended to the in-design and experiment campaign names so that the name is base campaign name + suffix.
"syncEnabled": True or False, # Immutable. Set to true if changes to base campaigns should be synced to the trial campaigns. Any changes made directly to trial campaigns will be preserved. This field can only be set when the experiment is being created.
"type": "A String", # Required. The product/feature that uses this experiment.
},
"remove": "A String", # Remove operation: The experiment is expected to have a valid resource name, in this format: `customers/{customer_id}/experiments/{campaign_experiment_id}`
"update": { # A Google ads experiment for users to experiment changes on multiple campaigns, compare the performance, and apply the effective changes. # Update operation: The experiment is expected to have a valid resource name.
"description": "A String", # The description of the experiment. It must have a minimum length of 1 and maximum length of 2048.
"endDate": "A String", # Date when the experiment ends. By default, the experiment ends on the campaign's end date. If this field is set, then the experiment ends at the end of the specified date in the customer's time zone. Format: YYYY-MM-DD Example: 2019-04-18
"experimentId": "A String", # Output only. The ID of the experiment. Read only.
"goals": [ # The goals of this experiment.
{ # A metric goal for an experiment.
"direction": "A String", # The metric direction of the goal. For example, increase, decrease, no change.
"metric": "A String", # The metric of the goal. For example, clicks, impressions, cost, conversions, etc.
},
],
"longRunningOperation": "A String", # Output only. The resource name of the long-running operation that can be used to poll for completion of experiment schedule or promote. The most recent long running operation is returned.
"name": "A String", # Required. The name of the experiment. It must have a minimum length of 1 and maximum length of 1024. It must be unique under a customer.
"promoteStatus": "A String", # Output only. The status of the experiment promotion process.
"resourceName": "A String", # Immutable. The resource name of the experiment. Experiment resource names have the form: `customers/{customer_id}/experiments/{experiment_id}`
"startDate": "A String", # Date when the experiment starts. By default, the experiment starts now or on the campaign's start date, whichever is later. If this field is set, then the experiment starts at the beginning of the specified date in the customer's time zone. Format: YYYY-MM-DD Example: 2019-03-14
"status": "A String", # The Advertiser-chosen status of this experiment.
"suffix": "A String", # For system managed experiments, the advertiser must provide a suffix during construction, in the setup stage before moving to initiated. The suffix will be appended to the in-design and experiment campaign names so that the name is base campaign name + suffix.
"syncEnabled": True or False, # Immutable. Set to true if changes to base campaigns should be synced to the trial campaigns. Any changes made directly to trial campaigns will be preserved. This field can only be set when the experiment is being created.
"type": "A String", # Required. The product/feature that uses this experiment.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"keywordPlanAdGroupKeywordOperation": { # A single operation (create, update, remove) on a Keyword Plan ad group keyword. # A keyword plan ad group keyword operation.
"create": { # A Keyword Plan ad group keyword. Max number of keyword plan keywords per plan: 10000. # Create operation: No resource name is expected for the new Keyword Plan ad group keyword.
"cpcBidMicros": "A String", # A keyword level max cpc bid in micros (for example, $1 = 1mm). The currency is the same as the account currency code. This will override any CPC bid set at the keyword plan ad group level. Not applicable for negative keywords. (negative = true) This field is Optional.
"id": "A String", # Output only. The ID of the Keyword Plan keyword.
"keywordPlanAdGroup": "A String", # The Keyword Plan ad group to which this keyword belongs.
"matchType": "A String", # The keyword match type.
"negative": True or False, # Immutable. If true, the keyword is negative.
"resourceName": "A String", # Immutable. The resource name of the Keyword Plan ad group keyword. KeywordPlanAdGroupKeyword resource names have the form: `customers/{customer_id}/keywordPlanAdGroupKeywords/{kp_ad_group_keyword_id}`
"text": "A String", # The keyword text.
},
"remove": "A String", # Remove operation: A resource name for the removed Keyword Plan ad group keyword is expected, in this format: `customers/{customer_id}/keywordPlanAdGroupKeywords/{kp_ad_group_keyword_id}`
"update": { # A Keyword Plan ad group keyword. Max number of keyword plan keywords per plan: 10000. # Update operation: The Keyword Plan ad group keyword is expected to have a valid resource name.
"cpcBidMicros": "A String", # A keyword level max cpc bid in micros (for example, $1 = 1mm). The currency is the same as the account currency code. This will override any CPC bid set at the keyword plan ad group level. Not applicable for negative keywords. (negative = true) This field is Optional.
"id": "A String", # Output only. The ID of the Keyword Plan keyword.
"keywordPlanAdGroup": "A String", # The Keyword Plan ad group to which this keyword belongs.
"matchType": "A String", # The keyword match type.
"negative": True or False, # Immutable. If true, the keyword is negative.
"resourceName": "A String", # Immutable. The resource name of the Keyword Plan ad group keyword. KeywordPlanAdGroupKeyword resource names have the form: `customers/{customer_id}/keywordPlanAdGroupKeywords/{kp_ad_group_keyword_id}`
"text": "A String", # The keyword text.
},
"updateMask": "A String", # The FieldMask that determines which resource fields are modified in an update.
},
"keywordPlanAdGroupOperation": { # A single operation (create, update, remove) on a Keyword Plan ad group. # A keyword plan ad group operation.
"create": { # A Keyword Planner ad group. Max number of keyword plan ad groups per plan: 200. # Create operation: No resource name is expected for the new Keyword Plan ad group.
"cpcBidMicros": "A String", # A default ad group max cpc bid in micros in account currency for all biddable keywords under the keyword plan ad group. If not set, will inherit from parent campaign.
"id": "A String", # Output only. The ID of the keyword plan ad group.
"keywordPlanCampaign": "A String", # The keyword plan campaign to which this ad group belongs.
"name": "A String", # The name of the keyword plan ad group. This field is required and should not be empty when creating keyword plan ad group.
"resourceName": "A String", # Immutable. The resource name of the Keyword Planner ad group. KeywordPlanAdGroup resource names have the form: `customers/{customer_id}/keywordPlanAdGroups/{kp_ad_group_id}`
},
"remove": "A String", # Remove operation: A resource name for the removed Keyword Plan ad group is expected, in this format: `customers/{customer_id}/keywordPlanAdGroups/{kp_ad_group_id}`
"update": { # A Keyword Planner ad group. Max number of keyword plan ad groups per plan: 200. # Update operation: The Keyword Plan ad group is expected to have a valid resource name.
"cpcBidMicros": "A String", # A default ad group max cpc bid in micros in account currency for all biddable keywords under the keyword plan ad group. If not set, will inherit from parent campaign.
"id": "A String", # Output only. The ID of the keyword plan ad group.
"keywordPlanCampaign": "A String", # The keyword plan campaign to which this ad group belongs.
"name": "A String", # The name of the keyword plan ad group. This field is required and should not be empty when creating keyword plan ad group.
"resourceName": "A String", # Immutable. The resource name of the Keyword Planner ad group. KeywordPlanAdGroup resource names have the form: `customers/{customer_id}/keywordPlanAdGroups/{kp_ad_group_id}`
},
"updateMask": "A String", # The FieldMask that determines which resource fields are modified in an update.
},
"keywordPlanCampaignKeywordOperation": { # A single operation (create, update, remove) on a Keyword Plan campaign keyword. # A keyword plan campaign keyword operation.
"create": { # A Keyword Plan Campaign keyword. Only negative keywords are supported for Campaign Keyword. # Create operation: No resource name is expected for the new Keyword Plan campaign keyword.
"id": "A String", # Output only. The ID of the Keyword Plan negative keyword.
"keywordPlanCampaign": "A String", # The Keyword Plan campaign to which this negative keyword belongs.
"matchType": "A String", # The keyword match type.
"negative": True or False, # Immutable. If true, the keyword is negative. Must be set to true. Only negative campaign keywords are supported.
"resourceName": "A String", # Immutable. The resource name of the Keyword Plan Campaign keyword. KeywordPlanCampaignKeyword resource names have the form: `customers/{customer_id}/keywordPlanCampaignKeywords/{kp_campaign_keyword_id}`
"text": "A String", # The keyword text.
},
"remove": "A String", # Remove operation: A resource name for the removed Keyword Plan campaign keywords expected in this format: `customers/{customer_id}/keywordPlanCampaignKeywords/{kp_campaign_keyword_id}`
"update": { # A Keyword Plan Campaign keyword. Only negative keywords are supported for Campaign Keyword. # Update operation: The Keyword Plan campaign keyword expected to have a valid resource name.
"id": "A String", # Output only. The ID of the Keyword Plan negative keyword.
"keywordPlanCampaign": "A String", # The Keyword Plan campaign to which this negative keyword belongs.
"matchType": "A String", # The keyword match type.
"negative": True or False, # Immutable. If true, the keyword is negative. Must be set to true. Only negative campaign keywords are supported.
"resourceName": "A String", # Immutable. The resource name of the Keyword Plan Campaign keyword. KeywordPlanCampaignKeyword resource names have the form: `customers/{customer_id}/keywordPlanCampaignKeywords/{kp_campaign_keyword_id}`
"text": "A String", # The keyword text.
},
"updateMask": "A String", # The FieldMask that determines which resource fields are modified in an update.
},
"keywordPlanCampaignOperation": { # A single operation (create, update, remove) on a Keyword Plan campaign. # A keyword plan campaign operation.
"create": { # A Keyword Plan campaign. Max number of keyword plan campaigns per plan allowed: 1. # Create operation: No resource name is expected for the new Keyword Plan campaign.
"cpcBidMicros": "A String", # A default max cpc bid in micros, and in the account currency, for all ad groups under the campaign. This field is required and should not be empty when creating Keyword Plan campaigns.
"geoTargets": [ # The geo targets. Max number allowed: 20.
{ # A geo target.
"geoTargetConstant": "A String", # Required. The resource name of the geo target.
},
],
"id": "A String", # Output only. The ID of the Keyword Plan campaign.
"keywordPlan": "A String", # The keyword plan this campaign belongs to.
"keywordPlanNetwork": "A String", # Targeting network. This field is required and should not be empty when creating Keyword Plan campaigns.
"languageConstants": [ # The languages targeted for the Keyword Plan campaign. Max allowed: 1.
"A String",
],
"name": "A String", # The name of the Keyword Plan campaign. This field is required and should not be empty when creating Keyword Plan campaigns.
"resourceName": "A String", # Immutable. The resource name of the Keyword Plan campaign. KeywordPlanCampaign resource names have the form: `customers/{customer_id}/keywordPlanCampaigns/{kp_campaign_id}`
},
"remove": "A String", # Remove operation: A resource name for the removed Keyword Plan campaign is expected, in this format: `customers/{customer_id}/keywordPlanCampaigns/{keywordPlan_campaign_id}`
"update": { # A Keyword Plan campaign. Max number of keyword plan campaigns per plan allowed: 1. # Update operation: The Keyword Plan campaign is expected to have a valid resource name.
"cpcBidMicros": "A String", # A default max cpc bid in micros, and in the account currency, for all ad groups under the campaign. This field is required and should not be empty when creating Keyword Plan campaigns.
"geoTargets": [ # The geo targets. Max number allowed: 20.
{ # A geo target.
"geoTargetConstant": "A String", # Required. The resource name of the geo target.
},
],
"id": "A String", # Output only. The ID of the Keyword Plan campaign.
"keywordPlan": "A String", # The keyword plan this campaign belongs to.
"keywordPlanNetwork": "A String", # Targeting network. This field is required and should not be empty when creating Keyword Plan campaigns.
"languageConstants": [ # The languages targeted for the Keyword Plan campaign. Max allowed: 1.
"A String",
],
"name": "A String", # The name of the Keyword Plan campaign. This field is required and should not be empty when creating Keyword Plan campaigns.
"resourceName": "A String", # Immutable. The resource name of the Keyword Plan campaign. KeywordPlanCampaign resource names have the form: `customers/{customer_id}/keywordPlanCampaigns/{kp_campaign_id}`
},
"updateMask": "A String", # The FieldMask that determines which resource fields are modified in an update.
},
"keywordPlanOperation": { # A single operation (create, update, remove) on a keyword plan. # A keyword plan operation.
"create": { # A Keyword Planner plan. Max number of saved keyword plans: 10000. It's possible to remove plans if limit is reached. # Create operation: No resource name is expected for the new keyword plan.
"forecastPeriod": { # The forecasting period associated with the keyword plan. # The date period used for forecasting the plan.
"dateInterval": "A String", # A future date range relative to the current date used for forecasting.
"dateRange": { # A date range. # The custom date range used for forecasting. It cannot be greater than a year. The start and end dates must be in the future. Otherwise, an error will be returned when the forecasting action is performed. The start and end dates are inclusive.
"endDate": "A String", # The end date, in yyyy-mm-dd format. This date is inclusive.
"startDate": "A String", # The start date, in yyyy-mm-dd format. This date is inclusive.
},
},
"id": "A String", # Output only. The ID of the keyword plan.
"name": "A String", # The name of the keyword plan. This field is required and should not be empty when creating new keyword plans.
"resourceName": "A String", # Immutable. The resource name of the Keyword Planner plan. KeywordPlan resource names have the form: `customers/{customer_id}/keywordPlans/{kp_plan_id}`
},
"remove": "A String", # Remove operation: A resource name for the removed keyword plan is expected in this format: `customers/{customer_id}/keywordPlans/{keyword_plan_id}`
"update": { # A Keyword Planner plan. Max number of saved keyword plans: 10000. It's possible to remove plans if limit is reached. # Update operation: The keyword plan is expected to have a valid resource name.
"forecastPeriod": { # The forecasting period associated with the keyword plan. # The date period used for forecasting the plan.
"dateInterval": "A String", # A future date range relative to the current date used for forecasting.
"dateRange": { # A date range. # The custom date range used for forecasting. It cannot be greater than a year. The start and end dates must be in the future. Otherwise, an error will be returned when the forecasting action is performed. The start and end dates are inclusive.
"endDate": "A String", # The end date, in yyyy-mm-dd format. This date is inclusive.
"startDate": "A String", # The start date, in yyyy-mm-dd format. This date is inclusive.
},
},
"id": "A String", # Output only. The ID of the keyword plan.
"name": "A String", # The name of the keyword plan. This field is required and should not be empty when creating new keyword plans.
"resourceName": "A String", # Immutable. The resource name of the Keyword Planner plan. KeywordPlan resource names have the form: `customers/{customer_id}/keywordPlans/{kp_plan_id}`
},
"updateMask": "A String", # The FieldMask that determines which resource fields are modified in an update.
},
"labelOperation": { # A single operation (create, remove, update) on a label. # A label mutate operation.
"create": { # A label. # Create operation: No resource name is expected for the new label.
"id": "A String", # Output only. ID of the label. Read only.
"name": "A String", # The name of the label. This field is required and should not be empty when creating a new label. The length of this string should be between 1 and 80, inclusive.
"resourceName": "A String", # Immutable. Name of the resource. Label resource names have the form: `customers/{owner_customer_id}/labels/{label_id}`
"status": "A String", # Output only. Status of the label. Read only.
"textLabel": { # A type of label displaying text on a colored background. # A type of label displaying text on a colored background.
"backgroundColor": "A String", # Background color of the label in HEX format. This string must match the regular expression '^\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts.
"description": "A String", # A short description of the label. The length must be no more than 200 characters.
},
},
"remove": "A String", # Remove operation: A resource name for the label being removed, in this format: `customers/{customer_id}/labels/{label_id}`
"update": { # A label. # Update operation: The label is expected to have a valid resource name.
"id": "A String", # Output only. ID of the label. Read only.
"name": "A String", # The name of the label. This field is required and should not be empty when creating a new label. The length of this string should be between 1 and 80, inclusive.
"resourceName": "A String", # Immutable. Name of the resource. Label resource names have the form: `customers/{owner_customer_id}/labels/{label_id}`
"status": "A String", # Output only. Status of the label. Read only.
"textLabel": { # A type of label displaying text on a colored background. # A type of label displaying text on a colored background.
"backgroundColor": "A String", # Background color of the label in HEX format. This string must match the regular expression '^\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts.
"description": "A String", # A short description of the label. The length must be no more than 200 characters.
},
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"recommendationSubscriptionOperation": { # A single operation (create, update) on a recommendation subscription. RecommendationSubscriptionService.MutateRecommendationSubscription # A recommendation subscription mutate operation.
"create": { # Recommendation Subscription resource # Create operation: No resource name is expected for the new subscription.
"createDateTime": "A String", # Output only. Time in seconds when the subscription was first created. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
"modifyDateTime": "A String", # Output only. Contains the time in microseconds, when the Recommendation Subscription was last updated. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
"resourceName": "A String", # Immutable. The resource name of the recommendation subscription. `customers/{customer_id}/recommendationSubscriptions/{recommendation_type}`
"status": "A String", # Required. Status of the subscription, either enabled or paused.
"type": "A String", # Required. Immutable. The type of recommendation subscribed to.
},
"update": { # Recommendation Subscription resource # Update operation: The subscription is expected to have a valid resource name.
"createDateTime": "A String", # Output only. Time in seconds when the subscription was first created. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
"modifyDateTime": "A String", # Output only. Contains the time in microseconds, when the Recommendation Subscription was last updated. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
"resourceName": "A String", # Immutable. The resource name of the recommendation subscription. `customers/{customer_id}/recommendationSubscriptions/{recommendation_type}`
"status": "A String", # Required. Status of the subscription, either enabled or paused.
"type": "A String", # Required. Immutable. The type of recommendation subscribed to.
},
"updateMask": "A String", # Optional. FieldMask that determines which resource fields are modified in an update.
},
"remarketingActionOperation": { # A single operation (create, update) on a remarketing action. # A remarketing action mutate operation.
"create": { # A remarketing action. A snippet of JavaScript code that will collect the product id and the type of page people visited (product page, shopping cart page, purchase page, general site visit) on an advertiser's website. # Create operation: No resource name is expected for the new remarketing action.
"id": "A String", # Output only. Id of the remarketing action.
"name": "A String", # The name of the remarketing action. This field is required and should not be empty when creating new remarketing actions.
"resourceName": "A String", # Immutable. The resource name of the remarketing action. Remarketing action resource names have the form: `customers/{customer_id}/remarketingActions/{remarketing_action_id}`
"tagSnippets": [ # Output only. The snippets used for tracking remarketing actions.
{ # The site tag and event snippet pair for a TrackingCodeType.
"eventSnippet": "A String", # The event snippet that works with the site tag to track actions that should be counted as conversions.
"globalSiteTag": "A String", # The site tag that adds visitors to your basic remarketing lists and sets new cookies on your domain.
"pageFormat": "A String", # The format of the web page where the tracking tag and snippet will be installed, for example, HTML.
"type": "A String", # The type of the generated tag snippets for tracking conversions.
},
],
},
"update": { # A remarketing action. A snippet of JavaScript code that will collect the product id and the type of page people visited (product page, shopping cart page, purchase page, general site visit) on an advertiser's website. # Update operation: The remarketing action is expected to have a valid resource name.
"id": "A String", # Output only. Id of the remarketing action.
"name": "A String", # The name of the remarketing action. This field is required and should not be empty when creating new remarketing actions.
"resourceName": "A String", # Immutable. The resource name of the remarketing action. Remarketing action resource names have the form: `customers/{customer_id}/remarketingActions/{remarketing_action_id}`
"tagSnippets": [ # Output only. The snippets used for tracking remarketing actions.
{ # The site tag and event snippet pair for a TrackingCodeType.
"eventSnippet": "A String", # The event snippet that works with the site tag to track actions that should be counted as conversions.
"globalSiteTag": "A String", # The site tag that adds visitors to your basic remarketing lists and sets new cookies on your domain.
"pageFormat": "A String", # The format of the web page where the tracking tag and snippet will be installed, for example, HTML.
"type": "A String", # The type of the generated tag snippets for tracking conversions.
},
],
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"searchAds360CampaignOperation": { # A single operation (update) on a Search Ads 360 campaign. # A Search Ads 360 campaign mutate operation.
"update": { # A Search Ads 360 campaign. # Update operation: The Search Ads 360 campaign is expected to have a valid resource name.
"productAttributionFilterType": "A String", # The type of product attribution filtering to apply to this campaign.
"resourceName": "A String", # Immutable. The resource name of the Search Ads 360 campaign. Search Ads 360 campaign resource names have the form: `customers/{customer_id}/searchAds360Campaigns/{campaign_id}`
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"sharedCriterionOperation": { # A single operation (create, remove) on an shared criterion. # A shared criterion mutate operation.
"create": { # A criterion belonging to a shared set. # Create operation: No resource name is expected for the new shared criterion.
"brand": { # Represents a Brand Criterion used for targeting based on commercial knowledge graph. # Immutable. Brand.
"displayName": "A String", # Output only. A text representation of a brand.
"entityId": "A String", # The Commercial KG MID for the brand.
"primaryUrl": "A String", # Output only. The primary url of a brand.
"rejectionReason": "A String", # Output only. The rejection reason when a brand status is REJECTED.
"status": "A String", # Output only. The status of a brand.
},
"criterionId": "A String", # Output only. The ID of the criterion. This field is ignored for mutates.
"keyword": { # A keyword criterion. # Immutable. Keyword.
"matchType": "A String", # The match type of the keyword.
"text": "A String", # The text of the keyword (at most 80 characters and 10 words).
},
"mobileAppCategory": { # A mobile app category criterion. # Immutable. Mobile App Category.
"mobileAppCategoryConstant": "A String", # The mobile app category constant resource name.
},
"mobileApplication": { # A mobile application criterion. # Immutable. Mobile application.
"appId": "A 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": "A String", # Name of this mobile application.
},
"negative": True or False, # Immutable. If true, the criterion is excluded. If false, the criterion is targeted.
"placement": { # A placement criterion. This can be used to modify bids for sites when targeting the content network. # Immutable. Placement.
"url": "A String", # URL of the placement. For example, "http://www.domain.com".
},
"resourceName": "A String", # Immutable. The resource name of the shared criterion. Shared set resource names have the form: `customers/{customer_id}/sharedCriteria/{shared_set_id}~{criterion_id}`
"sharedSet": "A String", # Immutable. The shared set to which the shared criterion belongs.
"type": "A String", # Output only. The type of the criterion.
"verticalAdsItemGroupRule": { # A criterion to represent a single item group rule in Vertical Ads. # Immutable. Vertical ads item group rule.
"cityCriterionId": "A String", # The resource name of the Geo Target Constant for the city.
"countryCriterionId": "A String", # The resource name of the Geo Target Constant for the country.
"hotelClass": "A String", # Integer value specifying the class rating for a hotel. Ranges from 1 to 5 stars.
"itemCode": "A String", # The id specifying a particular Vertical Ad listing.
"regionCriterionId": "A String", # The resource name of the Geo Target Constant for the region.
},
"webpage": { # Represents a criterion for targeting webpages of an advertiser's website. # Immutable. Webpage.
"conditions": [ # 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.
{ # Logical expression for targeting webpages of an advertiser's website.
"argument": "A String", # Argument of webpage targeting condition.
"operand": "A String", # Operand of webpage targeting condition.
"operator": "A String", # Operator of webpage targeting condition.
},
],
"coveragePercentage": 3.14, # 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.
"criterionName": "A 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.
"sample": { # List of sample urls that match the website target # List of sample urls that match the website target. This field is read-only.
"sampleUrls": [ # Webpage sample urls
"A String",
],
},
},
"youtubeChannel": { # A YouTube Channel criterion. # Immutable. YouTube Channel.
"channelId": "A String", # The YouTube uploader channel id or the channel code of a YouTube channel.
},
"youtubeVideo": { # A YouTube Video criterion. # Immutable. YouTube Video.
"videoId": "A String", # YouTube video id as it appears on the YouTube watch page.
},
},
"remove": "A String", # Remove operation: A resource name for the removed shared criterion is expected, in this format: `customers/{customer_id}/sharedCriteria/{shared_set_id}~{criterion_id}`
},
"sharedSetOperation": { # A single operation (create, update, remove) on an shared set. # A shared set mutate operation.
"create": { # SharedSets are used for sharing criterion exclusions across multiple campaigns. # Create operation: No resource name is expected for the new shared set.
"id": "A String", # Output only. The ID of this shared set. Read only.
"memberCount": "A String", # Output only. The number of shared criteria within this shared set. Read only.
"name": "A String", # The name of this shared set. Required. Shared Sets must have names that are unique among active shared sets of the same type. The length of this string should be between 1 and 255 UTF-8 bytes, inclusive.
"referenceCount": "A String", # Output only. The number of campaigns associated with this shared set. Read only.
"resourceName": "A String", # Immutable. The resource name of the shared set. Shared set resource names have the form: `customers/{customer_id}/sharedSets/{shared_set_id}`
"status": "A String", # Output only. The status of this shared set. Read only.
"type": "A String", # Immutable. The type of this shared set: each shared set holds only a single kind of resource. Required. Immutable.
"verticalAdsItemVerticalType": "A String", # Immutable. Shared sets of type VERTICAL_ADS_ITEM_GROUP_RULE_LIST are associated with a particular vertical (e.g. hotels, things to do, flights, etc.). This field is required for shared sets of type VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
},
"remove": "A String", # Remove operation: A resource name for the removed shared set is expected, in this format: `customers/{customer_id}/sharedSets/{shared_set_id}`
"update": { # SharedSets are used for sharing criterion exclusions across multiple campaigns. # Update operation: The shared set is expected to have a valid resource name.
"id": "A String", # Output only. The ID of this shared set. Read only.
"memberCount": "A String", # Output only. The number of shared criteria within this shared set. Read only.
"name": "A String", # The name of this shared set. Required. Shared Sets must have names that are unique among active shared sets of the same type. The length of this string should be between 1 and 255 UTF-8 bytes, inclusive.
"referenceCount": "A String", # Output only. The number of campaigns associated with this shared set. Read only.
"resourceName": "A String", # Immutable. The resource name of the shared set. Shared set resource names have the form: `customers/{customer_id}/sharedSets/{shared_set_id}`
"status": "A String", # Output only. The status of this shared set. Read only.
"type": "A String", # Immutable. The type of this shared set: each shared set holds only a single kind of resource. Required. Immutable.
"verticalAdsItemVerticalType": "A String", # Immutable. Shared sets of type VERTICAL_ADS_ITEM_GROUP_RULE_LIST are associated with a particular vertical (e.g. hotels, things to do, flights, etc.). This field is required for shared sets of type VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"smartCampaignSettingOperation": { # A single operation to update Smart campaign settings for a campaign. # A Smart campaign setting mutate operation.
"update": { # Settings for configuring Smart campaigns. # Update operation: The Smart campaign setting must specify a valid resource name.
"adOptimizedBusinessProfileSetting": { # Settings for configuring a business profile optimized for ads as this campaign's landing page. # Settings for configuring a business profile optimized for ads as this campaign's landing page. This campaign must be linked to a business profile to use this option. For more information on this feature, consult https://support.google.com/google-ads/answer/9827068.
"includeLeadForm": True or False, # 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.
},
"advertisingLanguageCode": "A 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).
"businessName": "A String", # The name of the business.
"businessProfileLocation": "A 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.
"campaign": "A String", # Output only. The campaign to which these settings apply.
"finalUrl": "A String", # The user-provided landing page URL for this Campaign.
"phoneNumber": { # Phone number and country code in smart campaign settings. # Phone number and country code.
"countryCode": "A String", # Upper-case, two-letter country code as defined by ISO-3166.
"phoneNumber": "A String", # Phone number of the smart campaign.
},
"resourceName": "A String", # Immutable. The resource name of the Smart campaign setting. Smart campaign setting resource names have the form: `customers/{customer_id}/smartCampaignSettings/{campaign_id}`
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
"userListOperation": { # A single operation (create, update) on a user list. # A user list mutate operation.
"create": { # 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`. # Create operation: No resource name is expected for the new user list.
"accessReason": "A String", # 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.
"accountUserListStatus": "A String", # 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.
"basicUserList": { # User list targeting as a collection of conversion or remarketing actions.
"actions": [ # Actions associated with this user list.
{ # Represents an action type used for building remarketing user lists.
"conversionAction": "A String", # A conversion action that's not generated from remarketing.
"remarketingAction": "A String", # A remarketing action.
},
],
},
"closingReason": "A String", # 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.
"crmBasedUserList": { # UserList of CRM users provided by the advertiser. # User list of CRM users provided by the advertiser.
"appId": "A 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": "A String", # Data source of the list. Default value is FIRST_PARTY. Only customers on the allow-list can create third-party sourced CRM lists.
"uploadKeyType": "A String", # Matching key type of the list. Mixed data types are not allowed on the same list. This field is required for an ADD operation.
},
"description": "A String", # Description of this user list.
"eligibleForDisplay": True or False, # Output only. Indicates this user list is eligible for Google Display Network. This field is read-only.
"eligibleForSearch": True or False, # Indicates if this user list is eligible for Google Search Network.
"id": "A String", # Output only. Id of the user list.
"integrationCode": "A String", # An ID from external system. It is used by user list sellers to correlate IDs on their systems.
"logicalUserList": { # Represents a user list that is a custom combination of user lists. # User list that is a custom combination of user lists.
"rules": [ # 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.
{ # A user list logical rule. A rule has a logical operator (and/or/not) and a list of user lists as operands.
"operator": "A String", # The logical operator of the rule.
"ruleOperands": [ # The list of operands of the rule.
{ # Operand of logical user list that consists of a user list.
"userList": "A String", # Resource name of a user list as an operand.
},
],
},
],
},
"lookalikeUserList": { # LookalikeUserlist, composed of users similar to those of a configurable seed (set of UserLists) # Immutable. Lookalike User List.
"countryCodes": [ # Countries targeted by the Lookalike. Two-letter country code as defined by ISO-3166
"A String",
],
"expansionLevel": "A String", # Expansion level, reflecting the size of the lookalike audience
"seedUserListIds": [ # Seed UserList ID from which this list is derived, provided by user.
"A String",
],
},
"matchRatePercentage": 42, # 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.
"membershipLifeSpan": "A String", # 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.
"membershipStatus": "A String", # 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.
"name": "A 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`.
"readOnly": True or False, # 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.
"resourceName": "A String", # Immutable. The resource name of the user list. User list resource names have the form: `customers/{customer_id}/userLists/{user_list_id}`
"ruleBasedUserList": { # Representation of a userlist that is generated by a rule. # User list generated by a rule.
"flexibleRuleUserList": { # 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. # 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": [ # 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.
{ # Flexible rule that wraps the common rule and a lookback window.
"lookbackWindowDays": "A String", # Lookback window for this rule in days. From now until X days ago.
"rule": { # A client defined rule based on custom parameters sent by web sites or uploaded by the advertiser. # List of rule item groups that defines this rule. Rule item groups are grouped together.
"ruleItemGroups": [ # List of rule item groups that defines this rule. Rule item groups are grouped together based on rule_type.
{ # A group of rule items.
"ruleItems": [ # Rule items that will be grouped together based on rule_type.
{ # An atomic rule item.
"dateRuleItem": { # A rule item composed of a date operation. # An atomic rule item composed of a date operation.
"offsetInDays": "A String", # The relative date value of the right hand side denoted by number of days offset from now. The value field will override this field when both are present.
"operator": "A String", # Date comparison operator. This field is required and must be populated when creating new date rule item.
"value": "A String", # String representing date value to be compared with the rule variable. Supported date format is YYYY-MM-DD. Times are reported in the customer's time zone.
},
"name": "A String", # Rule variable name. It should match the corresponding key name fired by the pixel. A name must begin with US-ascii letters or underscore or UTF8 code that is greater than 127 and consist of US-ascii letters or digits or underscore or UTF8 code that is greater than 127. For websites, there are two built-in variable URL (name = 'url__') and referrer URL (name = 'ref_url__'). This field must be populated when creating a new rule item.
"numberRuleItem": { # A rule item composed of a number operation. # An atomic rule item composed of a number operation.
"operator": "A String", # Number comparison operator. This field is required and must be populated when creating a new number rule item.
"value": 3.14, # Number value to be compared with the variable. This field is required and must be populated when creating a new number rule item.
},
"stringRuleItem": { # A rule item composed of a string operation. # An atomic rule item composed of a string operation.
"operator": "A String", # String comparison operator. This field is required and must be populated when creating a new string rule item.
"value": "A String", # The right hand side of the string rule item. For URLs or referrer URLs, the value can not contain illegal URL chars such as newlines, quotes, tabs, or parentheses. This field is required and must be populated when creating a new string rule item.
},
},
],
},
],
"ruleType": "A String", # Rule type is used to determine how to group rule items. The default is OR of ANDs (disjunctive normal form). That is, rule items will be ANDed together within rule item groups and the groups themselves will be ORed together. OR of ANDs is the only supported type for FlexibleRuleUserList.
},
},
],
"inclusiveOperands": [ # 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.
{ # Flexible rule that wraps the common rule and a lookback window.
"lookbackWindowDays": "A String", # Lookback window for this rule in days. From now until X days ago.
"rule": { # A client defined rule based on custom parameters sent by web sites or uploaded by the advertiser. # List of rule item groups that defines this rule. Rule item groups are grouped together.
"ruleItemGroups": [ # List of rule item groups that defines this rule. Rule item groups are grouped together based on rule_type.
{ # A group of rule items.
"ruleItems": [ # Rule items that will be grouped together based on rule_type.
{ # An atomic rule item.
"dateRuleItem": { # A rule item composed of a date operation. # An atomic rule item composed of a date operation.
"offsetInDays": "A String", # The relative date value of the right hand side denoted by number of days offset from now. The value field will override this field when both are present.
"operator": "A String", # Date comparison operator. This field is required and must be populated when creating new date rule item.
"value": "A String", # String representing date value to be compared with the rule variable. Supported date format is YYYY-MM-DD. Times are reported in the customer's time zone.
},
"name": "A String", # Rule variable name. It should match the corresponding key name fired by the pixel. A name must begin with US-ascii letters or underscore or UTF8 code that is greater than 127 and consist of US-ascii letters or digits or underscore or UTF8 code that is greater than 127. For websites, there are two built-in variable URL (name = 'url__') and referrer URL (name = 'ref_url__'). This field must be populated when creating a new rule item.
"numberRuleItem": { # A rule item composed of a number operation. # An atomic rule item composed of a number operation.
"operator": "A String", # Number comparison operator. This field is required and must be populated when creating a new number rule item.
"value": 3.14, # Number value to be compared with the variable. This field is required and must be populated when creating a new number rule item.
},
"stringRuleItem": { # A rule item composed of a string operation. # An atomic rule item composed of a string operation.
"operator": "A String", # String comparison operator. This field is required and must be populated when creating a new string rule item.
"value": "A String", # The right hand side of the string rule item. For URLs or referrer URLs, the value can not contain illegal URL chars such as newlines, quotes, tabs, or parentheses. This field is required and must be populated when creating a new string rule item.
},
},
],
},
],
"ruleType": "A String", # Rule type is used to determine how to group rule items. The default is OR of ANDs (disjunctive normal form). That is, rule items will be ANDed together within rule item groups and the groups themselves will be ORed together. OR of ANDs is the only supported type for FlexibleRuleUserList.
},
},
],
"inclusiveRuleOperator": "A String", # Operator that defines how the inclusive operands are combined.
},
"prepopulationStatus": "A String", # 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.
},
"similarUserList": { # SimilarUserList is a list of users which are similar to users from another UserList. These lists are read-only and automatically created by Google. # Output only. User list which are similar to users from another UserList. These lists are readonly and automatically created by google.
"seedUserList": "A String", # Seed UserList from which this list is derived.
},
"sizeForDisplay": "A String", # 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.
"sizeForSearch": "A String", # 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.
"sizeRangeForDisplay": "A String", # Output only. Size range in terms of number of users of the UserList, on the Google Display Network. This field is read-only.
"sizeRangeForSearch": "A String", # Output only. Size range in terms of number of users of the UserList, for Search ads. This field is read-only.
"type": "A String", # Output only. Type of this list. This field is read-only.
},
"remove": "A String", # Remove operation: A resource name for the removed user list is expected, in this format: `customers/{customer_id}/userLists/{user_list_id}`
"update": { # 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`. # Update operation: The user list is expected to have a valid resource name.
"accessReason": "A String", # 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.
"accountUserListStatus": "A String", # 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.
"basicUserList": { # User list targeting as a collection of conversion or remarketing actions.
"actions": [ # Actions associated with this user list.
{ # Represents an action type used for building remarketing user lists.
"conversionAction": "A String", # A conversion action that's not generated from remarketing.
"remarketingAction": "A String", # A remarketing action.
},
],
},
"closingReason": "A String", # 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.
"crmBasedUserList": { # UserList of CRM users provided by the advertiser. # User list of CRM users provided by the advertiser.
"appId": "A 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": "A String", # Data source of the list. Default value is FIRST_PARTY. Only customers on the allow-list can create third-party sourced CRM lists.
"uploadKeyType": "A String", # Matching key type of the list. Mixed data types are not allowed on the same list. This field is required for an ADD operation.
},
"description": "A String", # Description of this user list.
"eligibleForDisplay": True or False, # Output only. Indicates this user list is eligible for Google Display Network. This field is read-only.
"eligibleForSearch": True or False, # Indicates if this user list is eligible for Google Search Network.
"id": "A String", # Output only. Id of the user list.
"integrationCode": "A String", # An ID from external system. It is used by user list sellers to correlate IDs on their systems.
"logicalUserList": { # Represents a user list that is a custom combination of user lists. # User list that is a custom combination of user lists.
"rules": [ # 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.
{ # A user list logical rule. A rule has a logical operator (and/or/not) and a list of user lists as operands.
"operator": "A String", # The logical operator of the rule.
"ruleOperands": [ # The list of operands of the rule.
{ # Operand of logical user list that consists of a user list.
"userList": "A String", # Resource name of a user list as an operand.
},
],
},
],
},
"lookalikeUserList": { # LookalikeUserlist, composed of users similar to those of a configurable seed (set of UserLists) # Immutable. Lookalike User List.
"countryCodes": [ # Countries targeted by the Lookalike. Two-letter country code as defined by ISO-3166
"A String",
],
"expansionLevel": "A String", # Expansion level, reflecting the size of the lookalike audience
"seedUserListIds": [ # Seed UserList ID from which this list is derived, provided by user.
"A String",
],
},
"matchRatePercentage": 42, # 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.
"membershipLifeSpan": "A String", # 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.
"membershipStatus": "A String", # 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.
"name": "A 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`.
"readOnly": True or False, # 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.
"resourceName": "A String", # Immutable. The resource name of the user list. User list resource names have the form: `customers/{customer_id}/userLists/{user_list_id}`
"ruleBasedUserList": { # Representation of a userlist that is generated by a rule. # User list generated by a rule.
"flexibleRuleUserList": { # 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. # 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": [ # 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.
{ # Flexible rule that wraps the common rule and a lookback window.
"lookbackWindowDays": "A String", # Lookback window for this rule in days. From now until X days ago.
"rule": { # A client defined rule based on custom parameters sent by web sites or uploaded by the advertiser. # List of rule item groups that defines this rule. Rule item groups are grouped together.
"ruleItemGroups": [ # List of rule item groups that defines this rule. Rule item groups are grouped together based on rule_type.
{ # A group of rule items.
"ruleItems": [ # Rule items that will be grouped together based on rule_type.
{ # An atomic rule item.
"dateRuleItem": { # A rule item composed of a date operation. # An atomic rule item composed of a date operation.
"offsetInDays": "A String", # The relative date value of the right hand side denoted by number of days offset from now. The value field will override this field when both are present.
"operator": "A String", # Date comparison operator. This field is required and must be populated when creating new date rule item.
"value": "A String", # String representing date value to be compared with the rule variable. Supported date format is YYYY-MM-DD. Times are reported in the customer's time zone.
},
"name": "A String", # Rule variable name. It should match the corresponding key name fired by the pixel. A name must begin with US-ascii letters or underscore or UTF8 code that is greater than 127 and consist of US-ascii letters or digits or underscore or UTF8 code that is greater than 127. For websites, there are two built-in variable URL (name = 'url__') and referrer URL (name = 'ref_url__'). This field must be populated when creating a new rule item.
"numberRuleItem": { # A rule item composed of a number operation. # An atomic rule item composed of a number operation.
"operator": "A String", # Number comparison operator. This field is required and must be populated when creating a new number rule item.
"value": 3.14, # Number value to be compared with the variable. This field is required and must be populated when creating a new number rule item.
},
"stringRuleItem": { # A rule item composed of a string operation. # An atomic rule item composed of a string operation.
"operator": "A String", # String comparison operator. This field is required and must be populated when creating a new string rule item.
"value": "A String", # The right hand side of the string rule item. For URLs or referrer URLs, the value can not contain illegal URL chars such as newlines, quotes, tabs, or parentheses. This field is required and must be populated when creating a new string rule item.
},
},
],
},
],
"ruleType": "A String", # Rule type is used to determine how to group rule items. The default is OR of ANDs (disjunctive normal form). That is, rule items will be ANDed together within rule item groups and the groups themselves will be ORed together. OR of ANDs is the only supported type for FlexibleRuleUserList.
},
},
],
"inclusiveOperands": [ # 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.
{ # Flexible rule that wraps the common rule and a lookback window.
"lookbackWindowDays": "A String", # Lookback window for this rule in days. From now until X days ago.
"rule": { # A client defined rule based on custom parameters sent by web sites or uploaded by the advertiser. # List of rule item groups that defines this rule. Rule item groups are grouped together.
"ruleItemGroups": [ # List of rule item groups that defines this rule. Rule item groups are grouped together based on rule_type.
{ # A group of rule items.
"ruleItems": [ # Rule items that will be grouped together based on rule_type.
{ # An atomic rule item.
"dateRuleItem": { # A rule item composed of a date operation. # An atomic rule item composed of a date operation.
"offsetInDays": "A String", # The relative date value of the right hand side denoted by number of days offset from now. The value field will override this field when both are present.
"operator": "A String", # Date comparison operator. This field is required and must be populated when creating new date rule item.
"value": "A String", # String representing date value to be compared with the rule variable. Supported date format is YYYY-MM-DD. Times are reported in the customer's time zone.
},
"name": "A String", # Rule variable name. It should match the corresponding key name fired by the pixel. A name must begin with US-ascii letters or underscore or UTF8 code that is greater than 127 and consist of US-ascii letters or digits or underscore or UTF8 code that is greater than 127. For websites, there are two built-in variable URL (name = 'url__') and referrer URL (name = 'ref_url__'). This field must be populated when creating a new rule item.
"numberRuleItem": { # A rule item composed of a number operation. # An atomic rule item composed of a number operation.
"operator": "A String", # Number comparison operator. This field is required and must be populated when creating a new number rule item.
"value": 3.14, # Number value to be compared with the variable. This field is required and must be populated when creating a new number rule item.
},
"stringRuleItem": { # A rule item composed of a string operation. # An atomic rule item composed of a string operation.
"operator": "A String", # String comparison operator. This field is required and must be populated when creating a new string rule item.
"value": "A String", # The right hand side of the string rule item. For URLs or referrer URLs, the value can not contain illegal URL chars such as newlines, quotes, tabs, or parentheses. This field is required and must be populated when creating a new string rule item.
},
},
],
},
],
"ruleType": "A String", # Rule type is used to determine how to group rule items. The default is OR of ANDs (disjunctive normal form). That is, rule items will be ANDed together within rule item groups and the groups themselves will be ORed together. OR of ANDs is the only supported type for FlexibleRuleUserList.
},
},
],
"inclusiveRuleOperator": "A String", # Operator that defines how the inclusive operands are combined.
},
"prepopulationStatus": "A String", # 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.
},
"similarUserList": { # SimilarUserList is a list of users which are similar to users from another UserList. These lists are read-only and automatically created by Google. # Output only. User list which are similar to users from another UserList. These lists are readonly and automatically created by google.
"seedUserList": "A String", # Seed UserList from which this list is derived.
},
"sizeForDisplay": "A String", # 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.
"sizeForSearch": "A String", # 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.
"sizeRangeForDisplay": "A String", # Output only. Size range in terms of number of users of the UserList, on the Google Display Network. This field is read-only.
"sizeRangeForSearch": "A String", # Output only. Size range in terms of number of users of the UserList, for Search ads. This field is read-only.
"type": "A String", # Output only. Type of this list. This field is read-only.
},
"updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
},
},
],
"sequenceToken": "A String", # A token used to enforce sequencing. The first AddBatchJobOperations request for a batch job should not set sequence_token. Subsequent requests must set sequence_token to the value of next_sequence_token received in the previous AddBatchJobOperations response.
}

x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format

Returns:
An object of the form:

{ # Response message for BatchJobService.AddBatchJobOperations.
"nextSequenceToken": "A String", # The sequence token to be used when calling AddBatchJobOperations again if more operations need to be added. The next AddBatchJobOperations request must set the sequence_token field to the value of this field.
"totalOperations": "A String", # The total number of operations added so far for this batch job.
}

close()

Close httplib2 connections.

listResults(resourceName, pageSize=None, pageToken=None, responseContentType=None, x__xgafv=None)

Returns the results of the batch job. The job must be done. Supports standard list paging. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [BatchJobError]() [HeaderError]() [InternalError]() [QuotaError]() [RequestError]()

Args:
resourceName: string, Required. The resource name of the batch job whose results are being listed. (required)
pageSize: integer, A parameter
pageToken: string, Token of the page to retrieve. If not specified, the first page of results will be returned. Use the value obtained from `next_page_token` in the previous response in order to request the next page of results.
responseContentType: string, The response content type setting. Determines whether the mutable resource or just the resource name should be returned.
Allowed values
UNSPECIFIED - Not specified. Will return the resource name only in the response.
RESOURCE_NAME_ONLY - The mutate response will be the resource name.
MUTABLE_RESOURCE - The mutate response will contain the resource name and the resource with mutable fields if possible. Otherwise, only the resource name will be returned.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format

Returns:
An object of the form:

{ # Response message for BatchJobService.ListBatchJobResults.
"nextPageToken": "A String", # Pagination token used to retrieve the next page of results. Pass the content of this string as the `page_token` attribute of the next request. `next_page_token` is not returned for the last page.
"results": [ # The list of rows that matched the query.
{ # An individual batch job result.
"mutateOperationResponse": { # Response message for the resource mutate. # Response for the mutate. May be empty if errors occurred.
"adGroupAdLabelResult": { # The result for an ad group ad label mutate. # The result for the ad group ad label mutate.
"resourceName": "A String", # Returned for successful operations.
},
"adGroupAdResult": { # The result for the ad mutate. # The result for the ad group ad mutate.
"adGroupAd": { # An ad group ad. # The mutated ad group ad with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"actionItems": [ # 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.".
"A String",
],
"ad": { # An ad. # Immutable. The ad.
"addedByGoogleAds": True or False, # 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.
"appAd": { # An app ad. # Details pertaining to an app ad.
"appDeepLink": { # An app deep link used inside an ad. # An app deep link asset that may be used with the ad.
"asset": "A String", # The Asset resource name of this app deep link asset.
},
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"html5MediaBundles": [ # List of media bundle assets that may be used with the ad.
{ # A media bundle asset used inside an ad.
"asset": "A String", # The Asset resource name of this media bundle.
},
],
"images": [ # List of image assets that may be displayed with the ad.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"mandatoryAdText": { # A text asset used inside an ad. # Mandatory ad text.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"youtubeVideos": [ # List of YouTube video assets that may be displayed with the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"appEngagementAd": { # 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. # Details pertaining to an app engagement ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"images": [ # List of image assets that may be displayed with the ad.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"videos": [ # List of video assets that may be displayed with the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"appPreRegistrationAd": { # 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. # Details pertaining to an app pre-registration ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"images": [ # List of image asset IDs whose images may be displayed with the ad.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"youtubeVideos": [ # List of YouTube video asset IDs whose videos may be displayed with the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"demandGenCarouselAd": { # A Demand Gen carousel ad. # Details pertaining to a Demand Gen carousel ad.
"businessName": "A String", # Required. The Advertiser/brand name.
"callToActionText": "A String", # Call to action text.
"carouselCards": [ # Required. Carousel cards that will display with the ad. Min 2 max 10.
{ # A Demand Gen carousel card asset used inside an ad.
"asset": "A String", # The Asset resource name of this discovery carousel card.
},
],
"description": { # A text asset used inside an ad. # Required. The descriptive text of the ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"headline": { # A text asset used inside an ad. # Required. Headline of the ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"logoImage": { # An image asset used inside an ad. # Required. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%).
"asset": "A String", # The Asset resource name of this image.
},
},
"demandGenMultiAssetAd": { # A Demand Gen multi asset ad. # Details pertaining to a Demand Gen multi asset ad.
"businessName": "A String", # The Advertiser/brand name. Maximum display width is 25. Required.
"callToActionText": "A String", # Call to action text.
"descriptions": [ # The descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # Headline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"marketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"portraitMarketingImages": [ # 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%).
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"squareMarketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"tallPortraitMarketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
},
"demandGenProductAd": { # A Demand Gen product ad. # Details pertaining to a Demand Gen product ad.
"breadcrumb1": "A String", # First part of text that appears in the ad with the displayed URL.
"breadcrumb2": "A String", # Second part of text that appears in the ad with the displayed URL.
"businessName": { # A text asset used inside an ad. # Required. The advertiser/brand name.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"callToAction": { # A call to action asset used inside an ad. # Asset of type CallToActionAsset used for the "Call To Action" button.
"asset": "A String", # The Asset resource name of this call to action asset.
},
"description": { # A text asset used inside an ad. # Required. Text asset used for the description.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"headline": { # A text asset used inside an ad. # Required. Text asset used for the short headline.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"logoImage": { # An image asset used inside an ad. # Required. 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%).
"asset": "A String", # The Asset resource name of this image.
},
},
"demandGenVideoResponsiveAd": { # A Demand Gen video responsive ad. # Details pertaining to a Demand Gen video responsive ad.
"breadcrumb1": "A String", # First part of text that appears in the ad with the displayed URL.
"breadcrumb2": "A String", # Second part of text that appears in the ad with the displayed URL.
"businessName": { # A text asset used inside an ad. # Required. The advertiser/brand name.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"callToActions": [ # Assets of type CallToActionAsset used for the "Call To Action" button.
{ # A call to action asset used inside an ad.
"asset": "A String", # The Asset resource name of this call to action asset.
},
],
"companionBanners": [ # List of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"descriptions": [ # List of text assets used for the description.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets used for the short headline.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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%).
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"longHeadlines": [ # List of text assets used for the long headline.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"videos": [ # List of YouTube video assets used for the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"devicePreference": "A String", # 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.
"displayUploadAd": { # 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. # Details pertaining to a display upload ad.
"displayUploadProductType": "A String", # The product type of this ad. See comments on the enum for details.
"mediaBundle": { # A media bundle asset used inside an ad. # A media bundle asset to be used in the ad. For information about the media bundle for HTML5_UPLOAD_AD, see https://support.google.com/google-ads/answer/1722096 Media bundles that are part of dynamic product types use a special format that needs to be created through the Google Web Designer. See https://support.google.com/webdesigner/answer/7543898 for more information.
"asset": "A String", # The Asset resource name of this media bundle.
},
},
"displayUrl": "A String", # The URL that appears in the ad description for some ad formats.
"expandedDynamicSearchAd": { # An expanded dynamic search ad. # Immutable. Details pertaining to an Expanded Dynamic Search Ad. This type of ad has its headline, final URLs, and display URL auto-generated at serving time according to domain name specific information provided by `dynamic_search_ads_setting` linked at the campaign level.
"description": "A String", # The description of the ad.
"description2": "A String", # The second description of the ad.
},
"expandedTextAd": { # An expanded text ad. # Details pertaining to an expanded text ad.
"description": "A String", # The description of the ad.
"description2": "A String", # The second description of the ad.
"headlinePart1": "A String", # The first part of the ad's headline.
"headlinePart2": "A String", # The second part of the ad's headline.
"headlinePart3": "A String", # The third part of the ad's headline.
"path1": "A String", # The text that can appear alongside the ad's displayed URL.
"path2": "A String", # Additional text that can appear alongside the ad's displayed URL.
},
"finalAppUrls": [ # A list of final app URLs that will be used on mobile if the user has the specific app installed.
{ # A URL for deep linking into an app for the given operating system.
"osType": "A String", # The operating system targeted by this URL. Required.
"url": "A 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.
},
],
"finalMobileUrls": [ # The list of possible final mobile URLs after all cross-domain redirects for the ad.
"A String",
],
"finalUrlSuffix": "A String", # The suffix to use when constructing a final URL.
"finalUrls": [ # The list of possible final URLs after all cross-domain redirects for the ad.
"A String",
],
"hotelAd": { # A hotel ad. # Details pertaining to a hotel ad.
},
"id": "A String", # Output only. The ID of the ad.
"imageAd": { # An image ad. # Immutable. Details pertaining to an Image ad.
"adIdToCopyImageFrom": "A String", # An ad ID to copy the image from.
"data": "A String", # Raw image data as bytes.
"imageAsset": { # An image asset used inside an ad. # The image assets used for the ad.
"asset": "A String", # The Asset resource name of this image.
},
"imageUrl": "A String", # URL of the full size image.
"mimeType": "A String", # The mime type of the image.
"name": "A 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.
"pixelHeight": "A String", # Height in pixels of the full size image.
"pixelWidth": "A String", # Width in pixels of the full size image.
"previewImageUrl": "A String", # URL of the preview size image.
"previewPixelHeight": "A String", # Height in pixels of the preview size image.
"previewPixelWidth": "A String", # Width in pixels of the preview size image.
},
"legacyAppInstallAd": { # A legacy app install ad that only can be used by a few select customers. # Immutable. Details pertaining to a legacy app install ad.
"appId": "A String", # The ID of the mobile app.
"appStore": "A String", # The app store the mobile app is available in.
"description1": "A String", # The first description line of the ad.
"description2": "A String", # The second description line of the ad.
"headline": "A String", # The headline of the ad.
},
"legacyResponsiveDisplayAd": { # A legacy responsive display ad. Ads of this type are labeled 'Responsive ads' in the Google Ads UI. # Details pertaining to a legacy responsive display ad.
"accentColor": "A 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.
"allowFlexibleColor": True or False, # 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.
"businessName": "A String", # The business name in the ad.
"callToActionText": "A String", # The call-to-action text for the ad.
"description": "A String", # The description of the ad.
"formatSetting": "A String", # Specifies which format the ad will be served in. Default is ALL_FORMATS.
"logoImage": "A String", # The MediaFile resource name of the logo image used in the ad.
"longHeadline": "A String", # The long version of the ad's headline.
"mainColor": "A 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.
"marketingImage": "A String", # The MediaFile resource name of the marketing image used in the ad.
"pricePrefix": "A String", # Prefix before price. For example, 'as low as'.
"promoText": "A String", # Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
"shortHeadline": "A String", # The short version of the ad's headline.
"squareLogoImage": "A String", # The MediaFile resource name of the square logo image used in the ad.
"squareMarketingImage": "A String", # The MediaFile resource name of the square marketing image used in the ad.
},
"localAd": { # A local ad. # Details pertaining to a local ad.
"callToActions": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"descriptions": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"marketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"path1": "A String", # First part of optional text that can be appended to the URL in the ad.
"path2": "A 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.
"videos": [ # List of YouTube video assets that may be displayed with the ad. At least 1 and at most 20 video assets must be specified.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"name": "A 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.
"productAd": { # A Search Ads 360 product ad. # Immutable. Details pertaining to a product ad.
},
"resourceName": "A String", # Immutable. The resource name of the ad. Ad resource names have the form: `customers/{customer_id}/ads/{ad_id}`
"responsiveDisplayAd": { # A responsive display ad. # Details pertaining to a responsive display ad.
"accentColor": "A 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.
"allowFlexibleColor": True or False, # 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.
"businessName": "A String", # The advertiser/brand name. Maximum display width is 25.
"callToActionText": "A String", # The call-to-action text for the ad. Maximum display width is 30.
"controlSpec": { # Specification for various creative controls for a responsive display ad. # Specification for various creative controls.
"enableAssetEnhancements": True or False, # Whether the advertiser has opted into the asset enhancements feature.
"enableAutogenVideo": True or False, # Whether the advertiser has opted into auto-gen video feature.
},
"descriptions": [ # Descriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"formatSetting": "A String", # Specifies which format the ad will be served in. Default is ALL_FORMATS.
"headlines": [ # Short format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"longHeadline": { # A text asset used inside an ad. # A required long format headline. The maximum length is 90 characters.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"mainColor": "A 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.
"marketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"pricePrefix": "A String", # Prefix before price. For example, 'as low as'.
"promoText": "A String", # Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
"squareLogoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"squareMarketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"youtubeVideos": [ # Optional YouTube videos for the ad. A maximum of 5 videos can be specified.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"responsiveSearchAd": { # 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 # Details pertaining to a responsive search ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"path1": "A String", # First part of text that can be appended to the URL in the ad.
"path2": "A 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.
},
"searchAds360ExpandedDynamicSearchAd": { # An expanded dynamic search ad. # Immutable. Details pertaining to an expanded dynamic search ad.
"adTrackingId": "A String", # The tracking id of the ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
},
"searchAds360ExpandedTextAd": { # A Search Ads 360 expanded text ad. # Immutable. Details pertaining to an expanded text ad.
"adTrackingId": "A String", # The tracking id of the ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
"headline": "A String", # The headline of the ad.
"headline2": "A String", # The second headline of the ad.
"headline3": "A String", # The third headline of the ad.
"path1": "A String", # Text appended to the auto-generated visible URL with a delimiter.
"path2": "A String", # Text appended to path1 with a delimiter.
},
"searchAds360ResponsiveSearchAd": { # A Search Ads 360 responsive search ad. # Immutable. Details pertaining to a responsive search ad.
"adTrackingId": "A String", # The tracking id of the ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"path1": "A String", # Text appended to the auto-generated visible URL with a delimiter.
"path2": "A String", # Text appended to path1 with a delimiter.
},
"searchAds360TextAd": { # A Search Ads 360 text ad. # Immutable. Details pertaining to a text ad.
"adTrackingId": "A String", # The tracking id of the ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
"displayMobileUrl": "A String", # The displayed mobile URL of the ad.
"displayUrl": "A String", # The displayed URL of the ad.
"headline": "A String", # The headline of the ad.
},
"shoppingComparisonListingAd": { # A Shopping Comparison Listing ad. # Details pertaining to a Shopping Comparison Listing ad.
"headline": "A String", # Headline of the ad. This field is required. Allowed length is between 25 and 45 characters.
},
"shoppingProductAd": { # A standard Shopping ad. # Details pertaining to a Shopping product ad.
},
"shoppingSmartAd": { # A Smart Shopping ad. # Details pertaining to a Smart Shopping ad.
},
"smartCampaignAd": { # A Smart campaign ad. # Details pertaining to a Smart campaign ad.
"descriptions": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
},
"systemManagedResourceSource": "A String", # Output only. If this ad is system managed, then this field will indicate the source. This field is read-only.
"textAd": { # A text ad. # Immutable. Details pertaining to a text ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
"headline": "A String", # The headline of the ad.
},
"trackingUrlTemplate": "A String", # The URL template for constructing a tracking URL.
"travelAd": { # A travel ad. # Details pertaining to a travel ad.
},
"type": "A String", # Output only. The type of ad.
"urlCollections": [ # Additional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad.
{ # Collection of urls that is tagged with a unique identifier.
"finalMobileUrls": [ # A list of possible final mobile URLs.
"A String",
],
"finalUrls": [ # A list of possible final URLs.
"A String",
],
"trackingUrlTemplate": "A String", # URL template for constructing a tracking URL.
"urlCollectionId": "A String", # Unique identifier for this UrlCollection instance.
},
],
"urlCustomParameters": [ # 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.
{ # A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
"key": "A String", # The key matching the parameter tag name.
"value": "A String", # The value to be substituted.
},
],
},
"adGroup": "A String", # Immutable. The ad group to which the ad belongs.
"adGroupAdAssetAutomationSettings": [ # Settings that control the types of asset automation. See the AssetAutomationTypeEnum documentation for the default opt in/out behavior of each type.
{ # Asset automation setting for an AdGroupAd.
"assetAutomationStatus": "A String", # The opt-in/out status for the specified asset automation type.
"assetAutomationType": "A String", # The asset automation type that this setting configures.
},
],
"adStrength": "A String", # Output only. Overall ad strength for this ad group ad.
"creationTime": "A 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.
"effectiveLabels": [ # 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.
"A String",
],
"engineId": "A 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.
"engineStatus": "A String", # 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.
"labels": [ # Output only. The resource names of labels attached to this ad group ad.
"A String",
],
"lastModifiedTime": "A 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.
"policySummary": { # Contains policy information for an ad. # Output only. Policy information for the ad.
"approvalStatus": "A String", # Output only. The overall approval status of this ad, calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # Output only. The list of policy findings for this ad.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Output only. Where in the review process this ad is.
},
"primaryStatus": "A String", # Output only. Provides aggregated view into why an ad group ad is not serving or not serving optimally.
"primaryStatusReasons": [ # Output only. Provides reasons for why an ad group ad is not serving or not serving optimally.
"A String",
],
"resourceName": "A 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}`
"status": "A String", # The status of the ad.
},
"resourceName": "A String", # The resource name returned for successful operations.
},
"adGroupAssetResult": { # The result for the ad group asset mutate. # The result for the ad group asset mutate.
"adGroupAsset": { # A link between an ad group and an asset. # The mutated ad group asset with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"adGroup": "A String", # Required. Immutable. The ad group to which the asset is linked.
"asset": "A String", # Required. Immutable. The asset which is linked to the ad group.
"fieldType": "A String", # Required. Immutable. Role that the asset takes under the linked ad group.
"primaryStatus": "A String", # 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.
"primaryStatusDetails": [ # Output only. Provides the details of the primary status and its associated reasons.
{ # Provides the detail of a PrimaryStatus. Each asset link has a PrimaryStatus value (e.g. NOT_ELIGIBLE, meaning not serving), and list of corroborating PrimaryStatusReasons (e.g. [ASSET_DISAPPROVED]). Each reason may have some additional details annotated with it. For instance, when the reason is ASSET_DISAPPROVED, the details field will contain additional information about the offline evaluation errors which led to the asset being disapproved.
"assetDisapproved": { # Details related to AssetLinkPrimaryStatusReasonPB.ASSET_DISAPPROVED # Provides the details for AssetLinkPrimaryStatusReason.ASSET_DISAPPROVED
"offlineEvaluationErrorReasons": [ # Provides the quality evaluation disapproval reason of an asset.
"A String",
],
},
"reason": "A String", # Provides the reason of this PrimaryStatus.
"status": "A String", # Provides the PrimaryStatus of this status detail.
},
],
"primaryStatusReasons": [ # Output only. Provides a list of reasons for why an asset is not serving or not serving at full capacity.
"A String",
],
"resourceName": "A String", # Immutable. The resource name of the ad group asset. AdGroupAsset resource names have the form: `customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}`
"source": "A String", # Output only. Source of the adgroup asset link.
"status": "A String", # Status of the ad group asset.
},
"resourceName": "A String", # Returned for successful operations.
},
"adGroupBidModifierResult": { # The result for the criterion mutate. # The result for the ad group bid modifier mutate.
"adGroupBidModifier": { # Represents an ad group bid modifier. # The mutated ad group bid modifier with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"adGroup": "A String", # Immutable. The ad group to which this criterion belongs.
"baseAdGroup": "A 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.
"bidModifier": 3.14, # 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.
"bidModifierSource": "A String", # Output only. Bid modifier source.
"criterionId": "A String", # Output only. The ID of the criterion to bid modify. This field is ignored for mutates.
"device": { # A device criterion. # Immutable. A device criterion.
"type": "A String", # Type of the device.
},
"hotelAdvanceBookingWindow": { # Criterion for number of days prior to the stay the booking is being made. # Immutable. Criterion for number of days prior to the stay the booking is being made.
"maxDays": "A String", # High end of the number of days prior to the stay.
"minDays": "A String", # Low end of the number of days prior to the stay.
},
"hotelCheckInDateRange": { # Criterion for a check-in date range. # Immutable. Criterion for a hotel check-in date range.
"endDate": "A String", # End date in the YYYY-MM-DD format.
"startDate": "A String", # Start date in the YYYY-MM-DD format.
},
"hotelCheckInDay": { # Criterion for day of the week the booking is for. # Immutable. Criterion for day of the week the booking is for.
"dayOfWeek": "A String", # The day of the week.
},
"hotelDateSelectionType": { # Criterion for hotel date selection (default dates versus user selected). # Immutable. Criterion for hotel date selection (default dates versus user selected).
"type": "A String", # Type of the hotel date selection
},
"hotelLengthOfStay": { # Criterion for length of hotel stay in nights. # Immutable. Criterion for length of hotel stay in nights.
"maxNights": "A String", # High end of the number of nights in the stay.
"minNights": "A String", # Low end of the number of nights in the stay.
},
"resourceName": "A 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}`
},
"resourceName": "A String", # Returned for successful operations.
},
"adGroupCriterionCustomizerResult": { # The result for the ad group criterion customizer mutate. # The result for the ad group criterion customizer mutate.
"adGroupCriterionCustomizer": { # A customizer value for the associated CustomizerAttribute at the AdGroupCriterion level. # The mutated AdGroupCriterionCustomizer with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"adGroupCriterion": "A String", # Immutable. The ad group criterion to which the customizer attribute is linked. It must be a keyword criterion.
"customizerAttribute": "A String", # Required. Immutable. The customizer attribute which is linked to the ad group criterion.
"resourceName": "A String", # Immutable. The resource name of the ad group criterion customizer. Ad group criterion customizer resource names have the form: `customers/{customer_id}/adGroupCriterionCustomizers/{ad_group_id}~{criterion_id}~{customizer_attribute_id}`
"status": "A String", # Output only. The status of the ad group criterion customizer.
"value": { # A customizer value that is referenced in customizer linkage entities like CustomerCustomizer, CampaignCustomizer, etc. # Required. The value to associate with the customizer attribute at this level. The value must be of the type specified for the CustomizerAttribute.
"stringValue": "A String", # Required. Value to insert in creative text. Customizer values of all types are stored as string to make formatting unambiguous.
"type": "A String", # 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.
},
},
"resourceName": "A String", # Returned for successful operations.
},
"adGroupCriterionLabelResult": { # The result for an ad group criterion label mutate. # The result for the ad group criterion label mutate.
"resourceName": "A String", # Returned for successful operations.
},
"adGroupCriterionResult": { # The result for the criterion mutate. # The result for the ad group criterion mutate.
"adGroupCriterion": { # An ad group criterion. The ad_group_criterion report only returns criteria that were explicitly added to the ad group. # The mutated ad group criterion with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"adGroup": "A String", # Immutable. The ad group to which the criterion belongs.
"ageRange": { # An age range criterion. # Immutable. Age range.
"type": "A String", # Type of the age range.
},
"appPaymentModel": { # An app payment model criterion. # Immutable. App Payment Model.
"type": "A String", # Type of the app payment model.
},
"approvalStatus": "A String", # Output only. Approval status of the criterion.
"audience": { # An audience criterion. # Immutable. Audience.
"audience": "A String", # The Audience resource name.
},
"bidModifier": 3.14, # 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.
"brandList": { # 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. # Immutable. Brand list criterion.
"sharedSet": "A String", # Shared set resource name of the brand list.
},
"combinedAudience": { # A combined audience criterion. # Immutable. Combined Audience.
"combinedAudience": "A String", # The CombinedAudience resource name.
},
"cpcBidMicros": "A String", # The CPC (cost-per-click) bid.
"cpmBidMicros": "A String", # The CPM (cost-per-thousand viewable impressions) bid.
"cpvBidMicros": "A String", # The CPV (cost-per-view) bid.
"creationTime": "A 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.
"criterionId": "A String", # Output only. The ID of the criterion.
"customAffinity": { # A custom affinity criterion. A criterion of this type is only targetable. # Immutable. Custom Affinity.
"customAffinity": "A String", # The CustomInterest resource name.
},
"customAudience": { # A custom audience criterion. # Immutable. Custom Audience.
"customAudience": "A String", # The CustomAudience resource name.
},
"customIntent": { # A custom intent criterion. A criterion of this type is only targetable. # Immutable. Custom Intent.
"customIntent": "A String", # The CustomInterest resource name.
},
"disapprovalReasons": [ # 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.
"A String",
],
"displayName": "A String", # Output only. The display name of the criterion.
"effectiveCpcBidMicros": "A String", # Output only. The effective CPC (cost-per-click) bid.
"effectiveCpcBidSource": "A String", # Output only. Source of the effective CPC bid.
"effectiveCpmBidMicros": "A String", # Output only. The effective CPM (cost-per-thousand viewable impressions) bid.
"effectiveCpmBidSource": "A String", # Output only. Source of the effective CPM bid.
"effectiveCpvBidMicros": "A String", # Output only. The effective CPV (cost-per-view) bid.
"effectiveCpvBidSource": "A String", # Output only. Source of the effective CPV bid.
"effectiveLabels": [ # 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.
"A String",
],
"effectivePercentCpcBidMicros": "A String", # Output only. The effective Percent CPC bid amount.
"effectivePercentCpcBidSource": "A String", # Output only. Source of the effective Percent CPC bid.
"engineId": "A 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.
"engineStatus": "A String", # Output only. The Engine Status for ad group criterion.
"extendedDemographic": { # Represents an extended demographic criterion. # Immutable. Extended demographic criterion.
"extendedDemographicId": "A String", # Taxonomy id of the extended demographic group.
},
"finalMobileUrls": [ # The list of possible final mobile URLs after all cross-domain redirects.
"A String",
],
"finalUrlSuffix": "A String", # URL template for appending params to final URL.
"finalUrls": [ # The list of possible final URLs after all cross-domain redirects for the ad.
"A String",
],
"gender": { # A gender criterion. # Immutable. Gender.
"type": "A String", # Type of the gender.
},
"incomeRange": { # An income range criterion. # Immutable. Income range.
"type": "A String", # Type of the income range.
},
"keyword": { # A keyword criterion. # Immutable. Keyword.
"matchType": "A String", # The match type of the keyword.
"text": "A String", # The text of the keyword (at most 80 characters and 10 words).
},
"labels": [ # Output only. The resource names of labels attached to this ad group criterion.
"A String",
],
"language": { # A language criterion. # Immutable. Language.
"languageConstant": "A String", # The language constant resource name.
},
"lastModifiedTime": "A 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.
"lifeEvent": { # Represents a life event criterion. # Immutable. Life event campaign criterion.
"lifeEventId": "A String", # Taxonomy id of the life event.
},
"listingGroup": { # A listing group criterion. # Immutable. Listing group.
"caseValue": { # Listing dimensions for listing group criterion. # Dimension value with which this listing group is refining its parent. Undefined for the root group.
"activityCity": { # The city where the travel activity is available. # The city where the travel activity is available.
"value": "A String", # String value of the activity city. The Geo Target Constant resource name.
},
"activityCountry": { # The country where the travel activity is available. # The country where the travel activity is available.
"value": "A String", # String value of the activity country. The Geo Target Constant resource name.
},
"activityId": { # Advertiser-specific activity ID. # Advertiser-specific activity ID.
"value": "A String", # String value of the activity ID.
},
"activityRating": { # Rating of the activity as a number 1 to 5, where 5 is the best. # Rating of the activity as a number 1 to 5, where 5 is the best.
"value": "A String", # Long value of the activity rating.
},
"activityState": { # The state where the travel activity is available. # The state where the travel activity is available.
"value": "A String", # String value of the activity state. The Geo Target Constant resource name.
},
"hotelCity": { # City the hotel is located in. # City the hotel is located in.
"cityCriterion": "A String", # The Geo Target Constant resource name.
},
"hotelClass": { # Class of the hotel as a number of stars 1 to 5. # Class of the hotel as a number of stars 1 to 5.
"value": "A String", # Long value of the hotel class.
},
"hotelCountryRegion": { # Country or Region the hotel is located in. # Country or Region the hotel is located in.
"countryRegionCriterion": "A String", # The Geo Target Constant resource name.
},
"hotelId": { # Advertiser-specific hotel ID. # Advertiser-specific hotel ID.
"value": "A String", # String value of the hotel ID.
},
"hotelState": { # State the hotel is located in. # State the hotel is located in.
"stateCriterion": "A String", # The Geo Target Constant resource name.
},
"productBrand": { # Brand of the product. # Brand of a product offer.
"value": "A String", # String value of the product brand.
},
"productCategory": { # Category of a product offer. # Category of a product offer.
"categoryId": "A String", # ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
"level": "A String", # Level of the product category.
},
"productChannel": { # Locality of a product offer. # Locality of a product offer.
"channel": "A String", # Value of the locality.
},
"productChannelExclusivity": { # Availability of a product offer. # Availability of a product offer.
"channelExclusivity": "A String", # Value of the availability.
},
"productCondition": { # Condition of a product offer. # Condition of a product offer.
"condition": "A String", # Value of the condition.
},
"productCustomAttribute": { # Custom attribute of a product offer. # Custom attribute of a product offer.
"index": "A String", # Indicates the index of the custom attribute.
"value": "A String", # String value of the product custom attribute.
},
"productGrouping": { # Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product grouping.
},
"productItemId": { # Item id of a product offer. # Item id of a product offer.
"value": "A String", # Value of the id.
},
"productLabels": { # Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product labels.
},
"productLegacyCondition": { # Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product legacy condition.
},
"productType": { # Type of a product offer. # Type of a product offer.
"level": "A String", # Level of the type.
"value": "A String", # Value of the type.
},
"productTypeFull": { # Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product full type.
},
"unknownListingDimension": { # Unknown listing dimension. # Unknown dimension. Set when no other listing dimension is set.
},
},
"parentAdGroupCriterion": "A String", # Resource name of ad group criterion which is the parent listing group subdivision. Null for the root group.
"path": { # The path of dimensions defining a listing group. # The path of dimensions defining this listing group.
"dimensions": [ # The complete path of dimensions through the listing group hierarchy, from the root (excluding the root itself) to this listing group.
{ # Listing dimensions for listing group criterion.
"activityCity": { # The city where the travel activity is available. # The city where the travel activity is available.
"value": "A String", # String value of the activity city. The Geo Target Constant resource name.
},
"activityCountry": { # The country where the travel activity is available. # The country where the travel activity is available.
"value": "A String", # String value of the activity country. The Geo Target Constant resource name.
},
"activityId": { # Advertiser-specific activity ID. # Advertiser-specific activity ID.
"value": "A String", # String value of the activity ID.
},
"activityRating": { # Rating of the activity as a number 1 to 5, where 5 is the best. # Rating of the activity as a number 1 to 5, where 5 is the best.
"value": "A String", # Long value of the activity rating.
},
"activityState": { # The state where the travel activity is available. # The state where the travel activity is available.
"value": "A String", # String value of the activity state. The Geo Target Constant resource name.
},
"hotelCity": { # City the hotel is located in. # City the hotel is located in.
"cityCriterion": "A String", # The Geo Target Constant resource name.
},
"hotelClass": { # Class of the hotel as a number of stars 1 to 5. # Class of the hotel as a number of stars 1 to 5.
"value": "A String", # Long value of the hotel class.
},
"hotelCountryRegion": { # Country or Region the hotel is located in. # Country or Region the hotel is located in.
"countryRegionCriterion": "A String", # The Geo Target Constant resource name.
},
"hotelId": { # Advertiser-specific hotel ID. # Advertiser-specific hotel ID.
"value": "A String", # String value of the hotel ID.
},
"hotelState": { # State the hotel is located in. # State the hotel is located in.
"stateCriterion": "A String", # The Geo Target Constant resource name.
},
"productBrand": { # Brand of the product. # Brand of a product offer.
"value": "A String", # String value of the product brand.
},
"productCategory": { # Category of a product offer. # Category of a product offer.
"categoryId": "A String", # ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
"level": "A String", # Level of the product category.
},
"productChannel": { # Locality of a product offer. # Locality of a product offer.
"channel": "A String", # Value of the locality.
},
"productChannelExclusivity": { # Availability of a product offer. # Availability of a product offer.
"channelExclusivity": "A String", # Value of the availability.
},
"productCondition": { # Condition of a product offer. # Condition of a product offer.
"condition": "A String", # Value of the condition.
},
"productCustomAttribute": { # Custom attribute of a product offer. # Custom attribute of a product offer.
"index": "A String", # Indicates the index of the custom attribute.
"value": "A String", # String value of the product custom attribute.
},
"productGrouping": { # Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product grouping.
},
"productItemId": { # Item id of a product offer. # Item id of a product offer.
"value": "A String", # Value of the id.
},
"productLabels": { # Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product labels.
},
"productLegacyCondition": { # Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product legacy condition.
},
"productType": { # Type of a product offer. # Type of a product offer.
"level": "A String", # Level of the type.
"value": "A String", # Value of the type.
},
"productTypeFull": { # Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product full type.
},
"unknownListingDimension": { # Unknown listing dimension. # Unknown dimension. Set when no other listing dimension is set.
},
},
],
},
"type": "A String", # Type of the listing group.
},
"location": { # A location criterion. # Immutable. Location.
"geoTargetConstant": "A String", # The geo target constant resource name.
},
"mobileAppCategory": { # A mobile app category criterion. # Immutable. Mobile app category.
"mobileAppCategoryConstant": "A String", # The mobile app category constant resource name.
},
"mobileApplication": { # A mobile application criterion. # Immutable. Mobile application.
"appId": "A 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": "A String", # Name of this mobile application.
},
"negative": True or False, # 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.
"parentalStatus": { # A parental status criterion. # Immutable. Parental status.
"type": "A String", # Type of the parental status.
},
"percentCpcBidMicros": "A String", # 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].
"placement": { # A placement criterion. This can be used to modify bids for sites when targeting the content network. # Immutable. Placement.
"url": "A String", # URL of the placement. For example, "http://www.domain.com".
},
"positionEstimates": { # Estimates for criterion bids at various positions. # Output only. Estimates for criterion bids at various positions.
"estimatedAddClicksAtFirstPositionCpc": "A String", # 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.
"estimatedAddCostAtFirstPositionCpc": "A String", # Output only. Estimate of how your cost per week might change when changing your keyword bid to the value in first_position_cpc_micros.
"firstPageCpcMicros": "A String", # Output only. The estimate of the CPC bid required for ad to be shown on first page of search results.
"firstPositionCpcMicros": "A String", # 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.
"topOfPageCpcMicros": "A String", # Output only. The estimate of the CPC bid required for ad to be displayed at the top of the first page of search results.
},
"primaryStatus": "A String", # Output only. The primary status for the ad group criterion.
"primaryStatusReasons": [ # Output only. The primary status reasons for the ad group criterion.
"A String",
],
"qualityInfo": { # A container for ad group criterion quality information. # Output only. Information regarding the quality of the criterion.
"creativeQualityScore": "A String", # Output only. The performance of the ad compared to other advertisers.
"postClickQualityScore": "A String", # Output only. The quality score of the landing page.
"qualityScore": 42, # Output only. The quality score. This field may not be populated if Google does not have enough information to determine a value.
"searchPredictedCtr": "A String", # Output only. The click-through rate compared to that of other advertisers.
},
"resourceName": "A 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}`
"status": "A String", # 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.
"systemServingStatus": "A String", # Output only. Serving status of the criterion.
"topic": { # 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"). # Immutable. Topic.
"path": [ # 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.
"A String",
],
"topicConstant": "A String", # The Topic Constant resource name.
},
"trackingUrlTemplate": "A String", # The URL template for constructing a tracking URL.
"type": "A String", # Output only. The type of the criterion.
"urlCustomParameters": [ # The list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
{ # A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
"key": "A String", # The key matching the parameter tag name.
"value": "A String", # The value to be substituted.
},
],
"userInterest": { # Represents a particular interest-based topic to be targeted. # Immutable. User Interest.
"userInterestCategory": "A String", # The UserInterest resource name.
},
"userList": { # A User List criterion. Represents a user list that is defined by the advertiser to be targeted. # Immutable. User List.
"userList": "A String", # The User List resource name.
},
"verticalAdsItemGroupRuleList": { # A criterion for targeting a shared set of rules for item groups in Vertical Ads (e.g., for hotel ads). # Immutable. Vertical ads item group rule list criterion.
"sharedSet": "A String", # The shared set resource name of the vertical ads item group rule list.
},
"videoLineup": { # A Video lineup criterion. # Immutable. Video lineup criterion.
"videoLineupId": "A String", # ID for a Video lineup. Contact your Google business development representative for details.
},
"webpage": { # Represents a criterion for targeting webpages of an advertiser's website. # Immutable. Webpage
"conditions": [ # 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.
{ # Logical expression for targeting webpages of an advertiser's website.
"argument": "A String", # Argument of webpage targeting condition.
"operand": "A String", # Operand of webpage targeting condition.
"operator": "A String", # Operator of webpage targeting condition.
},
],
"coveragePercentage": 3.14, # 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.
"criterionName": "A 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.
"sample": { # List of sample urls that match the website target # List of sample urls that match the website target. This field is read-only.
"sampleUrls": [ # Webpage sample urls
"A String",
],
},
},
"youtubeChannel": { # A YouTube Channel criterion. # Immutable. YouTube Channel.
"channelId": "A String", # The YouTube uploader channel id or the channel code of a YouTube channel.
},
"youtubeVideo": { # A YouTube Video criterion. # Immutable. YouTube Video.
"videoId": "A String", # YouTube video id as it appears on the YouTube watch page.
},
},
"resourceName": "A String", # Returned for successful operations.
},
"adGroupCustomizerResult": { # The result for the ad group customizer mutate. # The result for the ad group customizer mutate.
"adGroupCustomizer": { # A customizer value for the associated CustomizerAttribute at the AdGroup level. # The mutated AdGroupCustomizer with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"adGroup": "A String", # Immutable. The ad group to which the customizer attribute is linked.
"customizerAttribute": "A String", # Required. Immutable. The customizer attribute which is linked to the ad group.
"resourceName": "A 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": "A String", # Output only. The status of the ad group customizer.
"value": { # A customizer value that is referenced in customizer linkage entities like CustomerCustomizer, CampaignCustomizer, etc. # Required. The value to associate with the customizer attribute at this level. The value must be of the type specified for the CustomizerAttribute.
"stringValue": "A String", # Required. Value to insert in creative text. Customizer values of all types are stored as string to make formatting unambiguous.
"type": "A String", # 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.
},
},
"resourceName": "A String", # Returned for successful operations.
},
"adGroupLabelResult": { # The result for an ad group label mutate. # The result for the ad group label mutate.
"resourceName": "A String", # Returned for successful operations.
},
"adGroupResult": { # The result for the ad group mutate. # The result for the ad group mutate.
"adGroup": { # An ad group. # The mutated ad group with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"adRotationMode": "A String", # The ad rotation mode of the ad group.
"aiMaxAdGroupSetting": { # Settings for AI Max feature in standard search adgroups. # Settings for AI Max feature in standard search adgroups.
"disableSearchTermMatching": True or False, # 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.
},
"audienceSetting": { # Settings for the audience targeting. # Immutable. Setting for audience related features.
"useAudienceGrouped": True or False, # Immutable. If true, this ad group uses an Audience resource for audience targeting. If false, this ad group may use audience segment criteria instead.
},
"baseAdGroup": "A 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.
"campaign": "A String", # Immutable. The campaign to which the ad group belongs.
"cpcBidMicros": "A String", # 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.
"cpmBidMicros": "A String", # The maximum CPM (cost-per-thousand viewable impressions) bid.
"cpvBidMicros": "A String", # The CPV (cost-per-view) bid.
"creationTime": "A 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.
"demandGenAdGroupSettings": { # Settings for Demand Gen ad groups. # Settings for Demand Gen ad groups.
"channelControls": { # Channel controls for Demand Gen ad groups. # Channel controls for Demand Gen ad groups.
"channelConfig": "A String", # Output only. Channel configuration reflecting which field in the oneof is populated.
"channelStrategy": "A String", # High level channel strategy.
"selectedChannels": { # Explicitly selected channels for channel controls in Demand Gen ad groups. # Explicitly selected channels. This field should be set with at least one true value when present.
"discover": True or False, # Whether to enable ads on the Discover channel.
"display": True or False, # Whether to enable ads on the Display channel.
"gmail": True or False, # Whether to enable ads on the Gmail channel.
"youtubeInFeed": True or False, # Whether to enable ads on the YouTube In-Feed channel.
"youtubeInStream": True or False, # Whether to enable ads on the YouTube In-Stream channel.
"youtubeShorts": True or False, # Whether to enable ads on the YouTube Shorts channel.
},
},
},
"displayCustomBidDimension": "A String", # 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.
"effectiveCpcBidMicros": "A String", # 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.
"effectiveLabels": [ # 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.
"A String",
],
"effectiveTargetCpaMicros": "A String", # Output only. The effective target CPA (cost-per-acquisition). This field is read-only.
"effectiveTargetCpaSource": "A String", # Output only. Source of the effective target CPA. This field is read-only.
"effectiveTargetCpc": "A String", # Output only. The effective target CPC (cost-per-click). This field is read-only.
"effectiveTargetCpcSource": "A String", # Output only. Source of the effective target CPC. This field is read-only.
"effectiveTargetRoas": 3.14, # Output only. The effective target ROAS (return-on-ad-spend). This field is read-only.
"effectiveTargetRoasSource": "A String", # Output only. Source of the effective target ROAS. This field is read-only.
"endDate": "A 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
"engineId": "A 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.
"engineStatus": "A String", # Output only. The Engine Status for ad group.
"excludeDemographicExpansion": True or False, # 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.
"excludedParentAssetFieldTypes": [ # 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.
"A String",
],
"excludedParentAssetSetTypes": [ # 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.
"A String",
],
"finalUrlSuffix": "A String", # URL template for appending params to Final URL.
"fixedCpmMicros": "A String", # The fixed amount in micros that the advertiser pays for every thousand impressions of the ad.
"id": "A String", # Output only. The ID of the ad group.
"labels": [ # Output only. The resource names of labels attached to this ad group.
"A String",
],
"languageCode": "A 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
"lastModifiedTime": "A 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.
"name": "A 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.
"optimizedTargetingEnabled": True or False, # True if optimized targeting is enabled. Optimized Targeting is the replacement for Audience Expansion.
"percentCpcBidMicros": "A String", # 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].
"primaryStatus": "A String", # Output only. Provides aggregated view into why an ad group is not serving or not serving optimally.
"primaryStatusReasons": [ # Output only. Provides reasons for why an ad group is not serving or not serving optimally.
"A String",
],
"resourceName": "A String", # Immutable. The resource name of the ad group. Ad group resource names have the form: `customers/{customer_id}/adGroups/{ad_group_id}`
"startDate": "A 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
"status": "A String", # The status of the ad group.
"targetCpaMicros": "A String", # 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.
"targetCpcMicros": "A String", # Average amount in micros that the advertiser is willing to pay for every ad click. Overrides the target CPC configured at the campaign level.
"targetCpmMicros": "A String", # Average amount in micros that the advertiser is willing to pay for every thousand times the ad is shown.
"targetCpvMicros": "A String", # Average amount in micros that the advertiser is willing to pay for every ad view.
"targetRoas": 3.14, # 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.
"targetingSetting": { # 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 # Setting for targeting related features.
"targetRestrictionOperations": [ # 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.
{ # Operation to be performed on a target restriction list in a mutate.
"operator": "A String", # Type of list operation to perform.
"value": { # The list of per-targeting-dimension targeting settings. # The target restriction being added to or removed from the list.
"bidOnly": True or False, # 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": "A String", # The targeting dimension that these settings apply to.
},
},
],
"targetRestrictions": [ # The per-targeting-dimension setting to restrict the reach of your campaign or ad group.
{ # The list of per-targeting-dimension targeting settings.
"bidOnly": True or False, # 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": "A String", # The targeting dimension that these settings apply to.
},
],
},
"trackingUrlTemplate": "A String", # The URL template for constructing a tracking URL.
"type": "A String", # Immutable. The type of the ad group.
"urlCustomParameters": [ # The list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
{ # A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
"key": "A String", # The key matching the parameter tag name.
"value": "A String", # The value to be substituted.
},
],
"verticalAdsFormatSetting": { # Vertical ads setting feature to enable/disable ad group format controls in search campaigns. # Vertical ads setting feature to enable/disable ad group format controls in search campaigns. This setting requires AiMaxAdGroupSetting to be enabled and a travel feed to be attached to the campaign.
"disableTextAds": True or False, # If true, text ads will be disabled for this ad group.
"enableBookingLinks": True or False, # If true, booking links will be enabled for this ad group.
"enableVerticalPromotionAds": True or False, # If true, vertical promotion ads will be enabled for this ad group.
},
},
"resourceName": "A String", # Returned for successful operations.
},
"adParameterResult": { # The result for the ad parameter mutate. # The result for the ad parameter mutate.
"adParameter": { # 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}" # The mutated AdParameter with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"adGroupCriterion": "A String", # Immutable. The ad group criterion that this ad parameter belongs to.
"insertionText": "A 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.
"parameterIndex": "A String", # Immutable. The unique index of this ad parameter. Must be either 1 or 2.
"resourceName": "A 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}`
},
"resourceName": "A String", # The resource name returned for successful operations.
},
"adResult": { # The result for the ad mutate. # The result for the ad mutate.
"ad": { # An ad. # The mutated ad with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"addedByGoogleAds": True or False, # 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.
"appAd": { # An app ad. # Details pertaining to an app ad.
"appDeepLink": { # An app deep link used inside an ad. # An app deep link asset that may be used with the ad.
"asset": "A String", # The Asset resource name of this app deep link asset.
},
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"html5MediaBundles": [ # List of media bundle assets that may be used with the ad.
{ # A media bundle asset used inside an ad.
"asset": "A String", # The Asset resource name of this media bundle.
},
],
"images": [ # List of image assets that may be displayed with the ad.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"mandatoryAdText": { # A text asset used inside an ad. # Mandatory ad text.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"youtubeVideos": [ # List of YouTube video assets that may be displayed with the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"appEngagementAd": { # 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. # Details pertaining to an app engagement ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"images": [ # List of image assets that may be displayed with the ad.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"videos": [ # List of video assets that may be displayed with the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"appPreRegistrationAd": { # 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. # Details pertaining to an app pre-registration ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"images": [ # List of image asset IDs whose images may be displayed with the ad.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"youtubeVideos": [ # List of YouTube video asset IDs whose videos may be displayed with the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"demandGenCarouselAd": { # A Demand Gen carousel ad. # Details pertaining to a Demand Gen carousel ad.
"businessName": "A String", # Required. The Advertiser/brand name.
"callToActionText": "A String", # Call to action text.
"carouselCards": [ # Required. Carousel cards that will display with the ad. Min 2 max 10.
{ # A Demand Gen carousel card asset used inside an ad.
"asset": "A String", # The Asset resource name of this discovery carousel card.
},
],
"description": { # A text asset used inside an ad. # Required. The descriptive text of the ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"headline": { # A text asset used inside an ad. # Required. Headline of the ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"logoImage": { # An image asset used inside an ad. # Required. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%).
"asset": "A String", # The Asset resource name of this image.
},
},
"demandGenMultiAssetAd": { # A Demand Gen multi asset ad. # Details pertaining to a Demand Gen multi asset ad.
"businessName": "A String", # The Advertiser/brand name. Maximum display width is 25. Required.
"callToActionText": "A String", # Call to action text.
"descriptions": [ # The descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # Headline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"marketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"portraitMarketingImages": [ # 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%).
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"squareMarketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"tallPortraitMarketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
},
"demandGenProductAd": { # A Demand Gen product ad. # Details pertaining to a Demand Gen product ad.
"breadcrumb1": "A String", # First part of text that appears in the ad with the displayed URL.
"breadcrumb2": "A String", # Second part of text that appears in the ad with the displayed URL.
"businessName": { # A text asset used inside an ad. # Required. The advertiser/brand name.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"callToAction": { # A call to action asset used inside an ad. # Asset of type CallToActionAsset used for the "Call To Action" button.
"asset": "A String", # The Asset resource name of this call to action asset.
},
"description": { # A text asset used inside an ad. # Required. Text asset used for the description.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"headline": { # A text asset used inside an ad. # Required. Text asset used for the short headline.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"logoImage": { # An image asset used inside an ad. # Required. 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%).
"asset": "A String", # The Asset resource name of this image.
},
},
"demandGenVideoResponsiveAd": { # A Demand Gen video responsive ad. # Details pertaining to a Demand Gen video responsive ad.
"breadcrumb1": "A String", # First part of text that appears in the ad with the displayed URL.
"breadcrumb2": "A String", # Second part of text that appears in the ad with the displayed URL.
"businessName": { # A text asset used inside an ad. # Required. The advertiser/brand name.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"callToActions": [ # Assets of type CallToActionAsset used for the "Call To Action" button.
{ # A call to action asset used inside an ad.
"asset": "A String", # The Asset resource name of this call to action asset.
},
],
"companionBanners": [ # List of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"descriptions": [ # List of text assets used for the description.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets used for the short headline.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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%).
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"longHeadlines": [ # List of text assets used for the long headline.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"videos": [ # List of YouTube video assets used for the ad.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"devicePreference": "A String", # 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.
"displayUploadAd": { # 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. # Details pertaining to a display upload ad.
"displayUploadProductType": "A String", # The product type of this ad. See comments on the enum for details.
"mediaBundle": { # A media bundle asset used inside an ad. # A media bundle asset to be used in the ad. For information about the media bundle for HTML5_UPLOAD_AD, see https://support.google.com/google-ads/answer/1722096 Media bundles that are part of dynamic product types use a special format that needs to be created through the Google Web Designer. See https://support.google.com/webdesigner/answer/7543898 for more information.
"asset": "A String", # The Asset resource name of this media bundle.
},
},
"displayUrl": "A String", # The URL that appears in the ad description for some ad formats.
"expandedDynamicSearchAd": { # An expanded dynamic search ad. # Immutable. Details pertaining to an Expanded Dynamic Search Ad. This type of ad has its headline, final URLs, and display URL auto-generated at serving time according to domain name specific information provided by `dynamic_search_ads_setting` linked at the campaign level.
"description": "A String", # The description of the ad.
"description2": "A String", # The second description of the ad.
},
"expandedTextAd": { # An expanded text ad. # Details pertaining to an expanded text ad.
"description": "A String", # The description of the ad.
"description2": "A String", # The second description of the ad.
"headlinePart1": "A String", # The first part of the ad's headline.
"headlinePart2": "A String", # The second part of the ad's headline.
"headlinePart3": "A String", # The third part of the ad's headline.
"path1": "A String", # The text that can appear alongside the ad's displayed URL.
"path2": "A String", # Additional text that can appear alongside the ad's displayed URL.
},
"finalAppUrls": [ # A list of final app URLs that will be used on mobile if the user has the specific app installed.
{ # A URL for deep linking into an app for the given operating system.
"osType": "A String", # The operating system targeted by this URL. Required.
"url": "A 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.
},
],
"finalMobileUrls": [ # The list of possible final mobile URLs after all cross-domain redirects for the ad.
"A String",
],
"finalUrlSuffix": "A String", # The suffix to use when constructing a final URL.
"finalUrls": [ # The list of possible final URLs after all cross-domain redirects for the ad.
"A String",
],
"hotelAd": { # A hotel ad. # Details pertaining to a hotel ad.
},
"id": "A String", # Output only. The ID of the ad.
"imageAd": { # An image ad. # Immutable. Details pertaining to an Image ad.
"adIdToCopyImageFrom": "A String", # An ad ID to copy the image from.
"data": "A String", # Raw image data as bytes.
"imageAsset": { # An image asset used inside an ad. # The image assets used for the ad.
"asset": "A String", # The Asset resource name of this image.
},
"imageUrl": "A String", # URL of the full size image.
"mimeType": "A String", # The mime type of the image.
"name": "A 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.
"pixelHeight": "A String", # Height in pixels of the full size image.
"pixelWidth": "A String", # Width in pixels of the full size image.
"previewImageUrl": "A String", # URL of the preview size image.
"previewPixelHeight": "A String", # Height in pixels of the preview size image.
"previewPixelWidth": "A String", # Width in pixels of the preview size image.
},
"legacyAppInstallAd": { # A legacy app install ad that only can be used by a few select customers. # Immutable. Details pertaining to a legacy app install ad.
"appId": "A String", # The ID of the mobile app.
"appStore": "A String", # The app store the mobile app is available in.
"description1": "A String", # The first description line of the ad.
"description2": "A String", # The second description line of the ad.
"headline": "A String", # The headline of the ad.
},
"legacyResponsiveDisplayAd": { # A legacy responsive display ad. Ads of this type are labeled 'Responsive ads' in the Google Ads UI. # Details pertaining to a legacy responsive display ad.
"accentColor": "A 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.
"allowFlexibleColor": True or False, # 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.
"businessName": "A String", # The business name in the ad.
"callToActionText": "A String", # The call-to-action text for the ad.
"description": "A String", # The description of the ad.
"formatSetting": "A String", # Specifies which format the ad will be served in. Default is ALL_FORMATS.
"logoImage": "A String", # The MediaFile resource name of the logo image used in the ad.
"longHeadline": "A String", # The long version of the ad's headline.
"mainColor": "A 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.
"marketingImage": "A String", # The MediaFile resource name of the marketing image used in the ad.
"pricePrefix": "A String", # Prefix before price. For example, 'as low as'.
"promoText": "A String", # Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
"shortHeadline": "A String", # The short version of the ad's headline.
"squareLogoImage": "A String", # The MediaFile resource name of the square logo image used in the ad.
"squareMarketingImage": "A String", # The MediaFile resource name of the square marketing image used in the ad.
},
"localAd": { # A local ad. # Details pertaining to a local ad.
"callToActions": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"descriptions": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"marketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"path1": "A String", # First part of optional text that can be appended to the URL in the ad.
"path2": "A 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.
"videos": [ # List of YouTube video assets that may be displayed with the ad. At least 1 and at most 20 video assets must be specified.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"name": "A 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.
"productAd": { # A Search Ads 360 product ad. # Immutable. Details pertaining to a product ad.
},
"resourceName": "A String", # Immutable. The resource name of the ad. Ad resource names have the form: `customers/{customer_id}/ads/{ad_id}`
"responsiveDisplayAd": { # A responsive display ad. # Details pertaining to a responsive display ad.
"accentColor": "A 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.
"allowFlexibleColor": True or False, # 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.
"businessName": "A String", # The advertiser/brand name. Maximum display width is 25.
"callToActionText": "A String", # The call-to-action text for the ad. Maximum display width is 30.
"controlSpec": { # Specification for various creative controls for a responsive display ad. # Specification for various creative controls.
"enableAssetEnhancements": True or False, # Whether the advertiser has opted into the asset enhancements feature.
"enableAutogenVideo": True or False, # Whether the advertiser has opted into auto-gen video feature.
},
"descriptions": [ # Descriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"formatSetting": "A String", # Specifies which format the ad will be served in. Default is ALL_FORMATS.
"headlines": [ # Short format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"logoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"longHeadline": { # A text asset used inside an ad. # A required long format headline. The maximum length is 90 characters.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
"mainColor": "A 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.
"marketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"pricePrefix": "A String", # Prefix before price. For example, 'as low as'.
"promoText": "A String", # Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
"squareLogoImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"squareMarketingImages": [ # 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.
{ # An image asset used inside an ad.
"asset": "A String", # The Asset resource name of this image.
},
],
"youtubeVideos": [ # Optional YouTube videos for the ad. A maximum of 5 videos can be specified.
{ # A video asset used inside an ad.
"adVideoAssetInfo": { # Contains info fields for AdVideoAssets. # Contains info fields for this AdVideoAsset.
"adVideoAssetFeatureControl": { # YouTube Video Asset feature controls. # Defines feature controls for this AdVideoAsset during serving time. For example, whether YouTube comments should be enabled for Partnership Ads served on YouTube Shorts.
"allowYoutubeComments": True or False, # Defines if YouTube comments should be enabled for the creative using this YouTube video asset served on YouTube Shorts.
},
},
"asset": "A String", # The Asset resource name of this video.
},
],
},
"responsiveSearchAd": { # 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 # Details pertaining to a responsive search ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"path1": "A String", # First part of text that can be appended to the URL in the ad.
"path2": "A 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.
},
"searchAds360ExpandedDynamicSearchAd": { # An expanded dynamic search ad. # Immutable. Details pertaining to an expanded dynamic search ad.
"adTrackingId": "A String", # The tracking id of the ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
},
"searchAds360ExpandedTextAd": { # A Search Ads 360 expanded text ad. # Immutable. Details pertaining to an expanded text ad.
"adTrackingId": "A String", # The tracking id of the ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
"headline": "A String", # The headline of the ad.
"headline2": "A String", # The second headline of the ad.
"headline3": "A String", # The third headline of the ad.
"path1": "A String", # Text appended to the auto-generated visible URL with a delimiter.
"path2": "A String", # Text appended to path1 with a delimiter.
},
"searchAds360ResponsiveSearchAd": { # A Search Ads 360 responsive search ad. # Immutable. Details pertaining to a responsive search ad.
"adTrackingId": "A String", # The tracking id of the ad.
"descriptions": [ # List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # List of text assets for headlines. When the ad serves the headlines will be selected from this list.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"path1": "A String", # Text appended to the auto-generated visible URL with a delimiter.
"path2": "A String", # Text appended to path1 with a delimiter.
},
"searchAds360TextAd": { # A Search Ads 360 text ad. # Immutable. Details pertaining to a text ad.
"adTrackingId": "A String", # The tracking id of the ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
"displayMobileUrl": "A String", # The displayed mobile URL of the ad.
"displayUrl": "A String", # The displayed URL of the ad.
"headline": "A String", # The headline of the ad.
},
"shoppingComparisonListingAd": { # A Shopping Comparison Listing ad. # Details pertaining to a Shopping Comparison Listing ad.
"headline": "A String", # Headline of the ad. This field is required. Allowed length is between 25 and 45 characters.
},
"shoppingProductAd": { # A standard Shopping ad. # Details pertaining to a Shopping product ad.
},
"shoppingSmartAd": { # A Smart Shopping ad. # Details pertaining to a Smart Shopping ad.
},
"smartCampaignAd": { # A Smart campaign ad. # Details pertaining to a Smart campaign ad.
"descriptions": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
"headlines": [ # 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.
{ # A text asset used inside an ad.
"assetPerformanceLabel": "A String", # The performance label of this text asset.
"pinnedField": "A String", # The pinned field of the asset. This restricts the asset to only serve within this field. Multiple assets can be pinned to the same field. An asset that is unpinned or pinned to a different field will not serve in a field where some other asset has been pinned.
"policySummaryInfo": { # Contains policy information for an asset inside an ad. # The policy summary of this text asset.
"approvalStatus": "A String", # The overall approval status of this asset, which is calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Where in the review process this asset.
},
"text": "A String", # Asset text.
},
],
},
"systemManagedResourceSource": "A String", # Output only. If this ad is system managed, then this field will indicate the source. This field is read-only.
"textAd": { # A text ad. # Immutable. Details pertaining to a text ad.
"description1": "A String", # The first line of the ad's description.
"description2": "A String", # The second line of the ad's description.
"headline": "A String", # The headline of the ad.
},
"trackingUrlTemplate": "A String", # The URL template for constructing a tracking URL.
"travelAd": { # A travel ad. # Details pertaining to a travel ad.
},
"type": "A String", # Output only. The type of ad.
"urlCollections": [ # Additional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad.
{ # Collection of urls that is tagged with a unique identifier.
"finalMobileUrls": [ # A list of possible final mobile URLs.
"A String",
],
"finalUrls": [ # A list of possible final URLs.
"A String",
],
"trackingUrlTemplate": "A String", # URL template for constructing a tracking URL.
"urlCollectionId": "A String", # Unique identifier for this UrlCollection instance.
},
],
"urlCustomParameters": [ # 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.
{ # A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
"key": "A String", # The key matching the parameter tag name.
"value": "A String", # The value to be substituted.
},
],
},
"resourceName": "A String", # The resource name returned for successful operations.
},
"assetGroupAssetResult": { # The result for the asset group asset mutate. # The result for the asset group asset mutate.
"resourceName": "A String", # Returned for successful operations.
},
"assetGroupListingGroupFilterResult": { # The result for the asset group listing group filter mutate. # The result for the asset group listing group filter mutate.
"assetGroupListingGroupFilter": { # AssetGroupListingGroupFilter represents a listing group filter tree node in an asset group. # The mutated AssetGroupListingGroupFilter with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"assetGroup": "A String", # Immutable. The asset group which this asset group listing group filter is part of.
"caseValue": { # Listing dimensions for the asset group listing group filter. # Dimension value with which this listing group is refining its parent. Undefined for the root group.
"productBrand": { # Brand of the product. # Brand of a product offer.
"value": "A String", # String value of the product brand.
},
"productCategory": { # One element of a category at a certain level. Top-level categories are at level 1, their children at level 2, and so on. We currently support up to 5 levels. The user must specify a dimension type that indicates the level of the category. All cases of the same subdivision must have the same dimension type (category level). # Category of a product offer.
"categoryId": "A String", # ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
"level": "A String", # Indicates the level of the category in the taxonomy.
},
"productChannel": { # Locality of a product offer. # Locality of a product offer.
"channel": "A String", # Value of the locality.
},
"productCondition": { # Condition of a product offer. # Condition of a product offer.
"condition": "A String", # Value of the condition.
},
"productCustomAttribute": { # Custom attribute of a product offer. # Custom attribute of a product offer.
"index": "A String", # Indicates the index of the custom attribute.
"value": "A String", # String value of the product custom attribute.
},
"productItemId": { # Item id of a product offer. # Item id of a product offer.
"value": "A String", # Value of the id.
},
"productType": { # Type of a product offer. # Type of a product offer.
"level": "A String", # Level of the type.
"value": "A String", # Value of the type.
},
"webpage": { # Filters for URLs in a page feed and URLs from the advertiser web domain. Several root nodes with this dimension are allowed in an asset group and their conditions are considered in OR. # Filters for URLs in a page feed and URLs from the advertiser web domain.
"conditions": [ # The webpage conditions are case sensitive and these are and-ed together when evaluated for filtering. All the conditions should be of same type. Example1: for URL1 = www.ads.google.com?ocid=1&euid=2 and URL2 = www.ads.google.com?ocid=1 and with "ocid" and "euid" as url_contains conditions, URL1 will be matched, but URL2 not. Example2 : If URL1 has Label1, Label2 and URL2 has Label2, Label3, then with Label1 and Label2 as custom_label conditions, URL1 will be matched but not URL2. With Label2 as the only custom_label condition then both URL1 and URL2 will be matched.
{ # Matching condition for URL filtering.
"customLabel": "A String", # Filters the URLs in a page feed that have this custom label. A custom label can be added to a campaign by creating an AssetSet of type PAGE_FEED and linking it to the campaign using CampaignAssetSet.
"urlContains": "A String", # Filters the URLs in a page feed and the URLs from the advertiser web domain that contain this string.
},
],
},
},
"id": "A String", # Output only. The ID of the ListingGroupFilter.
"listingSource": "A String", # Immutable. The source of listings filtered by this listing group filter.
"parentListingGroupFilter": "A String", # Immutable. Resource name of the parent listing group subdivision. Null for the root listing group filter node.
"path": { # The path defining of dimensions defining a listing group filter. # Output only. The path of dimensions defining this listing group filter.
"dimensions": [ # Output only. The complete path of dimensions through the listing group filter hierarchy (excluding the root node) to this listing group filter.
{ # Listing dimensions for the asset group listing group filter.
"productBrand": { # Brand of the product. # Brand of a product offer.
"value": "A String", # String value of the product brand.
},
"productCategory": { # One element of a category at a certain level. Top-level categories are at level 1, their children at level 2, and so on. We currently support up to 5 levels. The user must specify a dimension type that indicates the level of the category. All cases of the same subdivision must have the same dimension type (category level). # Category of a product offer.
"categoryId": "A String", # ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
"level": "A String", # Indicates the level of the category in the taxonomy.
},
"productChannel": { # Locality of a product offer. # Locality of a product offer.
"channel": "A String", # Value of the locality.
},
"productCondition": { # Condition of a product offer. # Condition of a product offer.
"condition": "A String", # Value of the condition.
},
"productCustomAttribute": { # Custom attribute of a product offer. # Custom attribute of a product offer.
"index": "A String", # Indicates the index of the custom attribute.
"value": "A String", # String value of the product custom attribute.
},
"productItemId": { # Item id of a product offer. # Item id of a product offer.
"value": "A String", # Value of the id.
},
"productType": { # Type of a product offer. # Type of a product offer.
"level": "A String", # Level of the type.
"value": "A String", # Value of the type.
},
"webpage": { # Filters for URLs in a page feed and URLs from the advertiser web domain. Several root nodes with this dimension are allowed in an asset group and their conditions are considered in OR. # Filters for URLs in a page feed and URLs from the advertiser web domain.
"conditions": [ # The webpage conditions are case sensitive and these are and-ed together when evaluated for filtering. All the conditions should be of same type. Example1: for URL1 = www.ads.google.com?ocid=1&euid=2 and URL2 = www.ads.google.com?ocid=1 and with "ocid" and "euid" as url_contains conditions, URL1 will be matched, but URL2 not. Example2 : If URL1 has Label1, Label2 and URL2 has Label2, Label3, then with Label1 and Label2 as custom_label conditions, URL1 will be matched but not URL2. With Label2 as the only custom_label condition then both URL1 and URL2 will be matched.
{ # Matching condition for URL filtering.
"customLabel": "A String", # Filters the URLs in a page feed that have this custom label. A custom label can be added to a campaign by creating an AssetSet of type PAGE_FEED and linking it to the campaign using CampaignAssetSet.
"urlContains": "A String", # Filters the URLs in a page feed and the URLs from the advertiser web domain that contain this string.
},
],
},
},
],
},
"resourceName": "A String", # Immutable. The resource name of the asset group listing group filter. Asset group listing group filter resource name have the form: `customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}`
"type": "A String", # Immutable. Type of a listing group filter node.
},
"resourceName": "A String", # Returned for successful operations.
},
"assetGroupResult": { # The result for the asset group mutate. # The result for the asset group mutate.
"resourceName": "A String", # Returned for successful operations.
},
"assetGroupSignalResult": { # The result for the asset group signal mutate. # The result for the asset group signal mutate.
"assetGroupSignal": { # AssetGroupSignal represents a signal in an asset group. The existence of a signal tells the performance max campaign who's most likely to convert. Performance Max uses the signal to look for new people with similar or stronger intent to find conversions across Search, Display, Video, and more. # The mutated AssetGroupSignal with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"approvalStatus": "A String", # Output only. Approval status is the output value for search theme signal after Google ads policy review. When using Audience signal, this field is not used and will be absent.
"assetGroup": "A String", # Immutable. The asset group which this asset group signal belongs to.
"audience": { # An audience criterion. # Immutable. The audience signal to be used by the performance max campaign.
"audience": "A String", # The Audience resource name.
},
"disapprovalReasons": [ # Output only. Computed for SearchTheme signals. When using Audience signal, this field is not used and will be absent.
"A String",
],
"resourceName": "A String", # Immutable. The resource name of the asset group signal. Asset group signal resource name have the form: `customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}`
"searchTheme": { # A Search Theme criterion only on Performance Max campaign. Represents a keyword-like advertiser input. # Immutable. The search_theme signal to be used by the performance max campaign. Mutate errors of search_theme criterion includes AssetGroupSignalError.UNSPECIFIED AssetGroupSignalError.UNKNOWN AssetGroupSignalError.TOO_MANY_WORDS AssetGroupSignalError.SEARCH_THEME_POLICY_VIOLATION FieldError.REQUIRED StringFormatError.ILLEGAL_CHARS StringLengthError.TOO_LONG ResourceCountLimitExceededError.RESOURCE_LIMIT
"text": "A String", # Each Search Theme has a value of a simple string, like keywords. There are limits on overall length, allowed characters, and number of words.
},
},
"resourceName": "A String", # Returned for successful operations.
},
"assetResult": { # The result for the asset mutate. # The result for the asset mutate.
"asset": { # Asset is a part of an ad which can be shared across multiple ads. It can be an image (ImageAsset), a video (YoutubeVideoAsset), etc. Assets are immutable and cannot be removed. To stop an asset from serving, remove the asset from the entity that is using it. # The mutated asset with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"appDeepLinkAsset": { # An app deep link asset # Immutable. An app deep link asset.
"appDeepLinkUri": "A String", # The uri for the app deep link, The uri can be either a custom scheme uri (e.g. mystore://shoes) or universal uri (e.g. http://www.mystore.com/shoes).
},
"bookOnGoogleAsset": { # A Book on Google asset. Used to redirect user to book through Google. Book on Google will change the redirect url to book directly through Google. # A book on google asset.
},
"businessMessageAsset": { # A business message asset. # A business message asset.
"callToAction": { # Display information that encourages the user to take action. # A call to action for the business message asset.
"callToActionDescription": "A String", # Required. Text providing a clear value proposition of what users expect once they take the action. Examples: 'Message us for a quote', 'Ask our expert team'.
"callToActionSelection": "A String", # Required. Pre-defined call to action text.
},
"facebookMessengerInfo": { # Facebook Messenger information to use for messaging. # Facebook Messenger.
"pageName": "A String", # Required. Facebook page name used for starting a chat on Facebook Messenger.
},
"messageProvider": "A String", # Required. Message provider of the business message asset.
"starterMessage": "A String", # Required. A welcome message to prompt the user to initiate a conversation.
"whatsappInfo": { # Whatsapp information to use for messaging. # Whatsapp.
"countryCode": "A String", # Required. Two-letter country code of the phone number. Examples: 'US', 'us'.
"phoneNumber": "A String", # Required. Whatsapp phone number of the business. Examples: '1234567890', '(123)456-7890'.
},
"zaloInfo": { # Zalo information to use for messaging. # Zalo.
"customName": "A String", # Custom name generated by the advertiser for their Zalo Account. These names will usually be registered brands or trademarks.
"oaId": "A String", # Zalo Official Account ID of the advertiser.
},
},
"callAsset": { # A Call asset. # A call asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"callConversionAction": "A String", # The conversion action to attribute a call conversion to. If not set, the default conversion action is used. This field only has effect if call_conversion_reporting_state is set to USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
"callConversionReportingState": "A String", # Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion.
"countryCode": "A String", # Required. Two-letter country code of the phone number. Examples: 'US', 'us'.
"phoneNumber": "A String", # Required. The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890'
},
"callToActionAsset": { # A call to action asset. # Immutable. A call to action asset.
"callToAction": "A String", # Call to action.
},
"calloutAsset": { # A Callout asset. # A callout asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"calloutText": "A String", # Required. The callout text. The length of this string should be between 1 and 25, inclusive.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
},
"creationTime": "A String", # Output only. The timestamp when this asset was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
"demandGenCarouselCardAsset": { # A Demand Gen Carousel Card asset. # Immutable. A Demand Gen carousel card asset.
"callToActionText": "A String", # Call to action text.
"headline": "A String", # Required. Headline of the carousel card.
"marketingImageAsset": "A String", # Asset resource name of the associated 1.91:1 marketing image. This and/or square marketing image asset is required.
"portraitMarketingImageAsset": "A String", # Asset resource name of the associated 4:5 portrait marketing image.
"squareMarketingImageAsset": "A String", # Asset resource name of the associated square marketing image. This and/or a marketing image asset is required.
},
"dynamicCustomAsset": { # A dynamic custom asset. # A dynamic custom asset.
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"contextualKeywords": [ # Contextual keywords, for example, Sedans, 4 door sedans.
"A String",
],
"formattedPrice": "A String", # Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $20,000.00.
"formattedSalePrice": "A String", # Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $15,000.00.
"id": "A String", # Required. ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag, for example, sedan. Required.
"id2": "A String", # ID2 which can be any sequence of letters and digits, for example, red. ID sequence (ID + ID2) must be unique.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"itemAddress": "A String", # Item address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
"itemCategory": "A String", # Item category, for example, Sedans.
"itemDescription": "A String", # Item description, for example, Best selling mid-size car.
"itemSubtitle": "A String", # Item subtitle, for example, At your Mountain View dealership.
"itemTitle": "A String", # Required. Item title, for example, Mid-size sedan. Required.
"price": "A String", # Price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 20,000.00 USD.
"salePrice": "A String", # Sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 15,000.00 USD. Must be less than the 'price' field.
"similarIds": [ # Similar IDs.
"A String",
],
},
"dynamicEducationAsset": { # A Dynamic Education asset. # A dynamic education asset.
"address": "A String", # School address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"contextualKeywords": [ # Contextual keywords, for example, Nursing certification, Health, Mountain View.
"A String",
],
"imageUrl": "A String", # Image url, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"locationId": "A String", # Location ID which can be any sequence of letters and digits and must be unique.
"programDescription": "A String", # Program description, for example, Nursing Certification.
"programId": "A String", # Required. Program ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"programName": "A String", # Required. Program name, for example, Nursing. Required.
"schoolName": "A String", # School name, for example, Mountain View School of Nursing.
"similarProgramIds": [ # Similar program IDs.
"A String",
],
"subject": "A String", # Subject of study, for example, Health.
"thumbnailImageUrl": "A String", # Thumbnail image url, for example, http://www.example.com/thumbnail.png. The thumbnail image will not be uploaded as image asset.
},
"dynamicFlightsAsset": { # A dynamic flights asset. # A dynamic flights asset.
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"customMapping": "A String", # A custom field which can be multiple key to values mapping separated by delimiters (",", "|" and ":"), in the forms of ": , , ... , | : , ... , | ... | : , ... ," for example, wifi: most | aircraft: 320, 77W | flights: 42 | legroom: 32".
"destinationId": "A String", # Required. Destination ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"destinationName": "A String", # Destination name, for example, Paris.
"flightDescription": "A String", # Required. Flight description, for example, Book your ticket. Required.
"flightPrice": "A String", # Flight price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
"flightSalePrice": "A String", # Flight sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'flight_price' field.
"formattedPrice": "A String", # Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
"formattedSalePrice": "A String", # Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"originId": "A String", # Origin ID which can be any sequence of letters and digits. The ID sequence (destination ID + origin ID) must be unique.
"originName": "A String", # Origin name, for example, London.
"similarDestinationIds": [ # Similar destination IDs, for example, PAR,LON.
"A String",
],
},
"dynamicHotelsAndRentalsAsset": { # A dynamic hotels and rentals asset. # A dynamic hotels and rentals asset.
"address": "A String", # Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"category": "A String", # Category, for example, Hotel suite.
"contextualKeywords": [ # Contextual keywords, for example, Mountain View "Hotels", South Bay hotels.
"A String",
],
"description": "A String", # Description, for example, Close to SJC Airport.
"destinationName": "A String", # Destination name, for example, Downtown Mountain View.
"formattedPrice": "A String", # Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
"formattedSalePrice": "A String", # Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"price": "A String", # Price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
"propertyId": "A String", # Required. Property ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"propertyName": "A String", # Required. Property name, for example, Mountain View Hotel. Required.
"salePrice": "A String", # ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field.
"similarPropertyIds": [ # Similar property IDs.
"A String",
],
"starRating": "A String", # Star rating. Must be a number between 1 to 5, inclusive.
},
"dynamicJobsAsset": { # A dynamic jobs asset. # A dynamic jobs asset.
"address": "A String", # Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403.
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"contextualKeywords": [ # Contextual keywords, for example, Software engineering job.
"A String",
],
"description": "A String", # Description, for example, Apply your technical skills.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"jobCategory": "A String", # Job category, for example, Technical.
"jobId": "A String", # Required. Job ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"jobSubtitle": "A String", # Job subtitle, for example, Level II.
"jobTitle": "A String", # Required. Job title, for example, Software engineer. Required.
"locationId": "A String", # Location ID which can be any sequence of letters and digits. The ID sequence (job ID + location ID) must be unique.
"salary": "A String", # Salary, for example, $100,000.
"similarJobIds": [ # Similar job IDs, for example, 1275.
"A String",
],
},
"dynamicLocalAsset": { # A dynamic local asset. # A dynamic local asset.
"address": "A String", # Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403.
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"category": "A String", # Category, for example, Food.
"contextualKeywords": [ # Contextual keywords, for example, Save groceries coupons.
"A String",
],
"dealId": "A String", # Required. Deal ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"dealName": "A String", # Required. Deal name, for example, 50% off at Mountain View Grocers. Required.
"description": "A String", # Description, for example, Save on your weekly bill.
"formattedPrice": "A String", # Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
"formattedSalePrice": "A String", # Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"price": "A String", # Price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
"salePrice": "A String", # Sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field.
"similarDealIds": [ # Similar deal IDs, for example, 1275.
"A String",
],
"subtitle": "A String", # Subtitle, for example, Groceries.
},
"dynamicRealEstateAsset": { # A dynamic real estate asset. # A dynamic real estate asset.
"address": "A String", # Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"cityName": "A String", # City name, for example, Mountain View, California.
"contextualKeywords": [ # Contextual keywords, for example, For sale; Houses for sale.
"A String",
],
"description": "A String", # Description, for example, 3 beds, 2 baths, 1568 sq. ft.
"formattedPrice": "A String", # Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $200,000.00.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"listingId": "A String", # Required. Listing ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"listingName": "A String", # Required. Listing name, for example, Boulevard Bungalow. Required.
"listingType": "A String", # Listing type, for example, For sale.
"price": "A String", # Price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 200,000.00 USD.
"propertyType": "A String", # Property type, for example, House.
"similarListingIds": [ # Similar listing IDs.
"A String",
],
},
"dynamicTravelAsset": { # A dynamic travel asset. # A dynamic travel asset.
"androidAppLink": "A String", # Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
"category": "A String", # Category, for example, Express.
"contextualKeywords": [ # Contextual keywords, for example, Paris trains.
"A String",
],
"destinationAddress": "A String", # Destination address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403.
"destinationId": "A String", # Required. Destination ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
"destinationName": "A String", # Destination name, for example, Paris.
"formattedPrice": "A String", # Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
"formattedSalePrice": "A String", # Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
"imageUrl": "A String", # Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
"iosAppLink": "A String", # iOS deep link, for example, exampleApp://content/page.
"iosAppStoreId": "A String", # iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
"originId": "A String", # Origin ID which can be any sequence of letters and digits. The ID sequence (destination ID + origin ID) must be unique.
"originName": "A String", # Origin name, for example, London.
"price": "A String", # Price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
"salePrice": "A String", # Sale price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field.
"similarDestinationIds": [ # Similar destination IDs, for example, NYC.
"A String",
],
"title": "A String", # Required. Title, for example, Book your train ticket. Required.
},
"engineStatus": "A String", # Output only. The Engine Status for an asset.
"fieldTypePolicySummaries": [ # Output only. Policy information for the asset for each FieldType.
{ # Contains policy information for an asset under AssetFieldType context.
"assetFieldType": "A String", # Output only. FieldType of this asset.
"assetSource": "A String", # Output only. Source of this asset.
"policySummaryInfo": { # Contains policy information for an asset. # Output only. Policy summary.
"approvalStatus": "A String", # Output only. The overall approval status of this asset, calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # Output only. The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Output only. Where in the review process this asset is.
},
},
],
"finalMobileUrls": [ # A list of possible final mobile URLs after all cross domain redirects.
"A String",
],
"finalUrlSuffix": "A String", # URL template for appending params to landing page URLs served with parallel tracking.
"finalUrls": [ # A list of possible final URLs after all cross domain redirects.
"A String",
],
"hotelCalloutAsset": { # An asset representing a hotel callout. # A hotel callout asset.
"languageCode": "A String", # Required. The language of the hotel callout. Represented as BCP 47 language tag.
"text": "A String", # Required. The text of the hotel callout asset. The length of this string should be between 1 and 25, inclusive.
},
"hotelPropertyAsset": { # A hotel property asset. # Immutable. A hotel property asset.
"hotelAddress": "A String", # Address of the hotel. Read-only.
"hotelName": "A String", # Name of the hotel. Read-only.
"placeId": "A String", # Place IDs uniquely identify a place in the Google Places database and on Google Maps. See https://developers.google.com/places/web-service/place-id to learn more.
},
"id": "A String", # Output only. The ID of the asset.
"imageAsset": { # An Image asset. # Output only. An image asset.
"data": "A String", # The raw bytes data of an image. This field is mutate only.
"fileSize": "A String", # File size of the image asset in bytes.
"fullSize": { # Metadata for an image at a certain size, either original or resized. # Metadata for this image at its original size.
"heightPixels": "A String", # Height of the image.
"url": "A String", # A URL that returns the image with this height and width.
"widthPixels": "A String", # Width of the image.
},
"mimeType": "A String", # MIME type of the image asset.
},
"lastModifiedTime": "A String", # Output only. The datetime when this asset was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
"leadFormAsset": { # A Lead Form asset. # A lead form asset.
"backgroundImageAsset": "A String", # Asset resource name of the background image. The image dimensions must be exactly 1200x628.
"businessName": "A String", # Required. The name of the business being advertised.
"callToActionDescription": "A String", # Required. Text giving a clear value proposition of what users expect once they expand the form.
"callToActionType": "A String", # Required. Pre-defined display text that encourages user to expand the form.
"customDisclosure": "A String", # Custom disclosure shown along with Google disclaimer on the lead form. Accessible to allowed customers only.
"customQuestionFields": [ # Ordered list of custom question fields. This field is subject to a limit of 5 qualifying questions per form.
{ # One custom question input field instance within a form.
"customQuestionText": "A String", # The exact custom question field text (for example, "What kind of vehicle do you have?").
"hasLocationAnswer": True or False, # Answer configuration for location question. If true, campaign/account level location data (state, city, business name etc) will be rendered on the Lead Form. Starting V13.1, has_location_answer can only be set for "What is your preferred dealership?" question, for advertisers with Location Assets setup at campaign/account level.
"singleChoiceAnswers": { # Defines possible answers for a single choice question, usually presented as a single-choice drop-down list. # Answer configuration for a single choice question. Minimum of 2 answers and maximum of 12 allowed.
"answers": [ # List of choices for a single question field. The order of entries defines UI order. Minimum of 2 answers required and maximum of 12 allowed.
"A String",
],
},
},
],
"deliveryMethods": [ # Configured methods for collected lead data to be delivered to advertiser. Only one method typed as WebhookDelivery can be configured.
{ # A configuration of how leads are delivered to the advertiser.
"webhook": { # Google notifies the advertiser of leads by making HTTP calls to an endpoint they specify. The requests contain JSON matching a schema that Google publishes as part of form ads documentation. # Webhook method of delivery.
"advertiserWebhookUrl": "A String", # Webhook url specified by advertiser to send the lead.
"googleSecret": "A String", # Anti-spoofing secret set by the advertiser as part of the webhook payload.
"payloadSchemaVersion": "A String", # The schema version that this delivery instance will use.
},
},
],
"description": "A String", # Required. Detailed description of the expanded form to describe what the form is asking for or facilitating.
"desiredIntent": "A String", # Chosen intent for the lead form, for example, more volume or more qualified.
"fields": [ # Ordered list of input fields. This field can be updated by reordering questions, but not by adding or removing questions.
{ # One input field instance within a form.
"hasLocationAnswer": True or False, # Answer configuration for location question. If true, campaign/account level location data (state, city, business name etc) will be rendered on the Lead Form. Starting V13.1, has_location_answer can only be set for "What is your preferred dealership?" question, for advertisers with Location Assets setup at campaign/account level.
"inputType": "A String", # Describes the input type, which may be a predefined type such as "full name" or a pre-vetted question like "What kind of vehicle do you have?".
"singleChoiceAnswers": { # Defines possible answers for a single choice question, usually presented as a single-choice drop-down list. # Answer configuration for a single choice question. Can be set only for pre-vetted question fields. Minimum of 2 answers required and maximum of 12 allowed.
"answers": [ # List of choices for a single question field. The order of entries defines UI order. Minimum of 2 answers required and maximum of 12 allowed.
"A String",
],
},
},
],
"headline": "A String", # Required. Headline of the expanded form to describe what the form is asking for or facilitating.
"postSubmitCallToActionType": "A String", # Pre-defined display text that encourages user action after the form is submitted.
"postSubmitDescription": "A String", # Detailed description shown after form submission that describes how the advertiser will follow up with the user.
"postSubmitHeadline": "A String", # Headline of text shown after form submission that describes how the advertiser will follow up with the user.
"privacyPolicyUrl": "A String", # Required. Link to a page describing the policy on how the collected data is handled by the advertiser/business.
},
"locationAsset": { # A location asset. # Output only. A location asset.
"businessProfileLocations": [ # The list of business locations for the customer. This will only be returned if the Location Asset is syncing from the Business Profile account. It is possible to have multiple Business Profile listings under the same account that point to the same Place ID.
{ # Business Profile location data synced from the linked Business Profile account.
"labels": [ # Advertiser specified label for the location on the Business Profile account. This is synced from the Business Profile account.
"A String",
],
"listingId": "A String", # Listing ID of this Business Profile location. This is synced from the linked Business Profile account.
"storeCode": "A String", # Business Profile store code of this location. This is synced from the Business Profile account.
},
],
"locationOwnershipType": "A String", # The type of location ownership. If the type is BUSINESS_OWNER, it will be served as a location extension. If the type is AFFILIATE, it will be served as an affiliate location.
"placeId": "A String", # Place IDs uniquely identify a place in the Google Places database and on Google Maps. This field is unique for a given customer ID and asset type. See https://developers.google.com/places/web-service/place-id to learn more about Place ID.
},
"mediaBundleAsset": { # A MediaBundle asset. # Immutable. A media bundle asset.
"data": "A String", # Media bundle (ZIP file) asset data. The format of the uploaded ZIP file depends on the ad field where it will be used. For more information on the format, see the documentation of the ad field where you plan on using the MediaBundleAsset. This field is mutate only.
},
"mobileAppAsset": { # An asset representing a mobile app. # A mobile app asset.
"appId": "A String", # Required. A string that uniquely identifies a mobile application. It should just contain the platform native id, like "com.android.ebay" for Android or "12345689" for iOS.
"appStore": "A String", # Required. The application store that distributes this specific app.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"linkText": "A String", # Required. The visible text displayed when the link is rendered in an ad. The length of this string should be between 1 and 25, inclusive.
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
},
"name": "A String", # Optional name of the asset.
"orientation": "A String", # Output only. Orientation of the asset. This is only supported for image and video assets.
"pageFeedAsset": { # A Page Feed asset. # A page feed asset.
"labels": [ # Labels used to group the page urls.
"A String",
],
"pageUrl": "A String", # Required. The webpage that advertisers want to target.
},
"policySummary": { # Contains policy information for an asset. # Output only. Policy information for the asset.
"approvalStatus": "A String", # Output only. The overall approval status of this asset, calculated based on the status of its individual policy topic entries.
"policyTopicEntries": [ # Output only. The list of policy findings for this asset.
{ # Policy finding attached to a resource (for example, alcohol policy associated with a site that sells alcohol). Each PolicyTopicEntry has a topic that indicates the specific ads policy the entry is about and a type to indicate the effect that the entry will have on serving. It may optionally have one or more evidences that indicate the reason for the finding. It may also optionally have one or more constraints that provide details about how serving may be restricted.
"constraints": [ # Indicates how serving of this resource may be affected (for example, not serving in a country).
{ # Describes the effect on serving that a policy topic entry will have.
"certificateDomainMismatchInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where the resource's domain is not covered by the certificates associated with it.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"certificateMissingInCountryList": { # A list of countries where a resource's serving is constrained. # Countries where a certificate is required for serving.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"countryConstraintList": { # A list of countries where a resource's serving is constrained. # Countries where the resource cannot serve.
"countries": [ # Countries in which serving is restricted.
{ # Indicates that a resource's ability to serve in a particular country is constrained.
"countryCriterion": "A String", # Geo target constant resource name of the country in which serving is constrained.
},
],
"totalTargetedCountries": 42, # Total number of countries targeted by the resource.
},
"resellerConstraint": { # Indicates that a policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
},
},
],
"evidences": [ # Additional information that explains policy finding (for example, the brand name for a trademark finding).
{ # Additional information that explains a policy finding.
"destinationMismatch": { # Evidence of mismatches between the URLs of a resource. # Mismatch between the destinations of a resource's URLs.
"urlTypes": [ # The set of URLs that did not match each other.
"A String",
],
},
"destinationNotWorking": { # Evidence details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices. # Details when the destination is returning an HTTP error code or isn't functional in all locations for commonly used devices.
"device": "A String", # The type of device that failed to load the URL.
"dnsErrorType": "A String", # The type of DNS error.
"expandedUrl": "A String", # The full URL that didn't work.
"httpErrorCode": "A String", # The HTTP error code.
"lastCheckedDateTime": "A String", # The time the URL was last checked. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
},
"destinationTextList": { # A list of strings found in a destination page that caused a policy finding. # The text in the destination of the resource that is causing a policy finding.
"destinationTexts": [ # List of text found in the resource's destination page.
"A String",
],
},
"languageCode": "A String", # The language the resource was detected to be written in. This is an IETF language tag such as "en-US".
"textList": { # A list of fragments of text that violated a policy. # List of evidence found in the text of a resource.
"texts": [ # The fragments of text from the resource that caused the policy finding.
"A String",
],
},
"websiteList": { # A list of websites that caused a policy finding. Used for ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more than five websites, only the top five (those that appear in resources the most) will be listed here. # List of websites linked with this resource.
"websites": [ # Websites that caused the policy finding.
"A String",
],
},
},
],
"topic": "A 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.
"type": "A String", # Describes the negative or positive effect this policy will have on serving.
},
],
"reviewStatus": "A String", # Output only. Where in the review process this asset is.
},
"priceAsset": { # An asset representing a list of price offers. # A price asset.
"languageCode": "A String", # Required. The language of the price asset. Represented as BCP 47 language tag.
"priceOfferings": [ # The price offerings of the price asset. The size of this collection should be between 3 and 8, inclusive.
{ # A single price offering within a PriceAsset.
"description": "A String", # Required. The description of the price offering. The length of this string should be between 1 and 25, inclusive.
"finalMobileUrl": "A String", # The final mobile URL after all cross domain redirects.
"finalUrl": "A String", # Required. The final URL after all cross domain redirects.
"header": "A String", # Required. The header of the price offering. The length of this string should be between 1 and 25, inclusive.
"price": { # Represents a price in a particular currency. # Required. The price value of the price offering.
"amountMicros": "A String", # Amount in micros. One million is equivalent to one unit.
"currencyCode": "A String", # Three-character ISO 4217 currency code.
},
"unit": "A String", # The price unit of the price offering.
},
],
"priceQualifier": "A String", # The price qualifier of the price asset.
"type": "A String", # Required. The type of the price asset.
},
"promotionAsset": { # A Promotion asset. # A promotion asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"discountModifier": "A String", # A modifier for qualification of the discount.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"languageCode": "A String", # The language of the promotion. Represented as BCP 47 language tag.
"moneyAmountOff": { # Represents a price in a particular currency. # Money amount off for discount in the promotion. Either this or percent_off is required.
"amountMicros": "A String", # Amount in micros. One million is equivalent to one unit.
"currencyCode": "A String", # Three-character ISO 4217 currency code.
},
"occasion": "A String", # The occasion the promotion was intended for. If an occasion is set, the redemption window will need to fall within the date range associated with the occasion.
"ordersOverAmount": { # Represents a price in a particular currency. # The amount the total order needs to be for the user to be eligible for the promotion.
"amountMicros": "A String", # Amount in micros. One million is equivalent to one unit.
"currencyCode": "A String", # Three-character ISO 4217 currency code.
},
"percentOff": "A String", # Percentage off discount in the promotion. 1,000,000 = 100%. Either this or money_amount_off is required.
"promotionBarcodeInfo": { # Barcode info to generate promotion barcode. # Barcode info used to generate promotion barcode for user to be eligible for the promotion.
"barcodeContent": "A String", # Promotion message to be encoded in the barcode.
"type": "A String", # Barcode type used to generate barcode with the correct format.
},
"promotionCode": "A String", # A code the user should use in order to be eligible for the promotion.
"promotionQrCodeInfo": { # QR code info to generate promotion QR code. # QR code info used to generate promotion QR code for user to be eligible for the promotion.
"qrCodeContent": "A String", # Promotion message to be encoded in the QR code.
},
"promotionTarget": "A String", # Required. A freeform description of what the promotion is targeting.
"redemptionEndDate": "A String", # Last date of when the promotion is eligible to be redeemed, in yyyy-MM-dd format.
"redemptionStartDate": "A String", # Start date of when the promotion is eligible to be redeemed, in yyyy-MM-dd format.
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
"termsAndConditionsText": "A String", # Terms and conditions of the promotion.
"termsAndConditionsUri": "A String", # URI to the terms and conditions of the promotion.
},
"resourceName": "A String", # Immutable. The resource name of the asset. Asset resource names have the form: `customers/{customer_id}/assets/{asset_id}`
"searchAds360CallAsset": { # A unified call asset. # Output only. A unified call asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"callConversionAction": "A String", # The conversion action to attribute a call conversion to. If not set, the default conversion action is used. This field only has effect if call_conversion_reporting_state is set to USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
"callConversionReportingState": "A String", # Output only. Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion.
"callOnly": True or False, # Whether the call only shows the phone number without a link to the website. Applies to Microsoft Ads.
"callTrackingEnabled": True or False, # Whether the call should be enabled on call tracking. Applies to Microsoft Ads.
"countryCode": "A String", # Two-letter country code of the phone number. Examples: 'US', 'us'.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"phoneNumber": "A String", # The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890'
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
"useSearcherTimeZone": True or False, # Whether to show the call extension in search user's time zone. Applies to Microsoft Ads.
},
"searchAds360CalloutAsset": { # A unified callout asset. # Output only. A unified callout asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"calloutText": "A String", # The callout text. The length of this string should be between 1 and 25, inclusive.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
"useSearcherTimeZone": True or False, # Whether to show the asset in search user's time zone. Applies to Microsoft Ads.
},
"searchAds360LocationAsset": { # A unified location asset. # Output only. A unified location asset.
"businessProfileLocations": [ # The list of business locations for the customer. This will only be returned if the Location Asset is syncing from the Business Profile account. It is possible to have multiple Business Profile listings under the same account that point to the same Place ID.
{ # Business Profile location data synced from the linked Business Profile account.
"labels": [ # Advertiser specified label for the location on the Business Profile account. This is synced from the Business Profile account.
"A String",
],
"listingId": "A String", # Listing ID of this Business Profile location. This is synced from the linked Business Profile account.
"storeCode": "A String", # Business Profile store code of this location. This is synced from the Business Profile account.
},
],
"locationOwnershipType": "A String", # The type of location ownership. If the type is BUSINESS_OWNER, it will be served as a location extension. If the type is AFFILIATE, it will be served as an affiliate location.
"placeId": "A String", # Place IDs uniquely identify a place in the Google Places database and on Google Maps. This field is unique for a given customer ID and asset type. See https://developers.google.com/places/web-service/place-id to learn more about Place ID.
},
"searchAds360PageFeedAsset": { # A Unified Page Feed asset. # Output only. A unified page feed asset.
"labels": [ # Labels used to group the page urls.
"A String",
],
"pageUrl": "A String", # The webpage that advertisers want to target.
},
"searchAds360SitelinkAsset": { # A unified sitelink asset. # Output only. A unified sitelink asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"description1": "A String", # First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set.
"description2": "A String", # Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"linkText": "A String", # URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive.
"mobilePreferred": True or False, # Whether the preference is for the sitelink asset to be displayed on mobile devices. Applies to Microsoft Ads.
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
"trackingId": "A String", # ID used for tracking clicks for the sitelink asset. This is a Yahoo! Japan only field.
"useSearcherTimeZone": True or False, # Whether to show the sitelink asset in search user's time zone. Applies to Microsoft Ads.
},
"sitelinkAsset": { # A Sitelink asset. # A sitelink asset.
"adScheduleTargets": [ # List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
{ # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
],
"description1": "A String", # First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set.
"description2": "A String", # Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set.
"endDate": "A String", # Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
"linkText": "A String", # Required. URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive.
"startDate": "A String", # Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
},
"source": "A String", # Output only. Source of the asset.
"status": "A String", # Output only. The status of the asset.
"structuredSnippetAsset": { # A Structured Snippet asset. # A structured snippet asset.
"header": "A String", # Required. The header of the snippet. This string should be one of the predefined values at https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers
"values": [ # Required. The values in the snippet. The size of this collection should be between 3 and 10, inclusive. The length of each value should be between 1 and 25 characters, inclusive.
"A String",
],
},
"textAsset": { # A Text asset. # Immutable. A text asset.
"text": "A String", # Text content of the text asset.
},
"trackingUrlTemplate": "A String", # URL template for constructing a tracking URL.
"type": "A String", # Output only. Type of the asset.
"urlCustomParameters": [ # A list of mappings to be used for substituting URL custom parameter tags in the tracking_url_template, final_urls, and/or final_mobile_urls.
{ # A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
"key": "A String", # The key matching the parameter tag name.
"value": "A String", # The value to be substituted.
},
],
"youtubeVideoAsset": { # A YouTube asset. # Immutable. A YouTube video asset.
"youtubeVideoId": "A String", # YouTube video id. This is the 11 character string value used in the YouTube video URL.
"youtubeVideoTitle": "A String", # YouTube video title.
},
},
"resourceName": "A String", # The resource name returned for successful operations.
},
"assetSetAssetResult": { # The result for the asset set asset mutate. # The result for the asset set asset mutate.
"assetSetAsset": { # AssetSetAsset is the link between an asset and an asset set. Adding an AssetSetAsset links an asset with an asset set. # The mutated asset set asset with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"asset": "A String", # Immutable. The asset which this asset set asset is linking to.
"assetSet": "A String", # Immutable. The asset set which this asset set asset is linking to.
"resourceName": "A String", # Immutable. The resource name of the asset set asset. Asset set asset resource names have the form: `customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}`
"status": "A String", # Output only. The status of the asset set asset. Read-only.
},
"resourceName": "A String", # Returned for successful operations.
},
"assetSetResult": { # The result for the asset set mutate. # The result for the asset set mutate.
"assetSet": { # An asset set representing a collection of assets. Use AssetSetAsset to link an asset to the asset set. # The mutated asset set with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"businessProfileLocationGroup": { # 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. # Business Profile location group asset set data.
"dynamicBusinessProfileLocationGroupFilter": { # Represents a filter on Business Profile locations in an asset set. If multiple filters are provided, they are AND'ed together. # Filter for dynamic Business Profile location sets.
"businessNameFilter": { # Business Profile location group business name filter. # Used to filter Business Profile locations by business name.
"businessName": "A String", # Business name string to use for filtering.
"filterType": "A String", # The type of string matching to use when filtering with business_name.
},
"labelFilters": [ # 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.
"A String",
],
"listingIdFilters": [ # Used to filter Business Profile locations by listing ids.
"A String",
],
},
},
"chainLocationGroup": { # 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. # 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": [ # Used to filter chain locations by chain ids. Only Locations that belong to the specified chain(s) will be in the asset set.
{ # One chain level filter on location in a feed item set. The filtering logic among all the fields is AND.
"chainId": "A String", # 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": [ # 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.
"A String",
],
},
],
},
"hotelPropertyData": { # For Performance Max for travel goals campaigns with a Hotel Center account link. Read-only. # Output only. For Performance Max for travel goals campaigns with a Hotel Center account link. Read-only.
"hotelCenterId": "A String", # Output only. The hotel center ID of the partner.
"partnerName": "A String", # Output only. Name of the hotel partner.
},
"id": "A String", # Output only. The ID of the asset set.
"locationGroupParentAssetSetId": "A String", # 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.
"locationSet": { # 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. # Location asset set data. This will be used for sync level location set. This can only be set if AssetSet's type is LOCATION_SYNC.
"businessProfileLocationSet": { # 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. # Data used to configure a location set populated from Google Business Profile locations.
"businessAccountId": "A 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.
"businessNameFilter": "A 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": "A String", # Required. Immutable. Email address of a Google Business Profile account or email address of a manager of the Google Business Profile account.
"httpAuthorizationToken": "A String", # Required. Immutable. The HTTP authorization token used to obtain authorization.
"labelFilters": [ # 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.
"A String",
],
"listingIdFilters": [ # 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.
"A String",
],
},
"chainLocationSet": { # Data used to configure a location set populated with the specified chains. # Data used to configure a location on chain set populated with the specified chains.
"chains": [ # Required. A list of chain level filters, all filters are OR'ed together.
{ # One chain level filter on location in a feed item set. The filtering logic among all the fields is AND.
"chainId": "A String", # 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": [ # 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.
"A String",
],
},
],
"relationshipType": "A String", # Required. Immutable. Relationship type the specified chains have with this advertiser.
},
"locationOwnershipType": "A String", # Required. Immutable. Location Ownership Type (owned location or affiliate location).
"mapsLocationSet": { # Wrapper for multiple maps location sync data # Only set if locations are synced based on selected maps locations
"mapsLocations": [ # Required. A list of maps location info that user manually synced in.
{ # Wrapper for place ids
"placeId": "A String", # Place ID of the Maps location.
},
],
},
},
"merchantCenterFeed": { # Merchant ID and Feed Label from Google Merchant Center. # Merchant ID and Feed Label from Google Merchant Center.
"feedLabel": "A String", # Optional. Feed Label from Google Merchant Center.
"merchantId": "A String", # Required. Merchant ID from Google Merchant Center
},
"name": "A String", # Required. Name of the asset set. Required. It must have a minimum length of 1 and maximum length of 128.
"resourceName": "A String", # Immutable. The resource name of the asset set. Asset set resource names have the form: `customers/{customer_id}/assetSets/{asset_set_id}`
"status": "A String", # Output only. The status of the asset set. Read-only.
"type": "A String", # Required. Immutable. The type of the asset set. Required.
},
"resourceName": "A String", # Returned for successful operations.
},
"audienceResult": { # The result for the audience mutate. # The result for the audience mutate.
"audience": { # 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. # The mutated Audience with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"assetGroup": "A 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.
"description": "A String", # Description of this audience.
"dimensions": [ # Positive dimensions specifying the audience composition.
{ # Positive dimension specifying user's audience.
"age": { # Dimension specifying users by their age. # Dimension specifying users by their age.
"ageRanges": [ # Contiguous age range to be included in the dimension.
{ # Contiguous age range.
"maxAge": 42, # Maximum age to include. A maximum age need not be specified. If specified, max_age must be greater than min_age, and allowed values are 24, 34, 44, 54, and 64.
"minAge": 42, # Minimum age to include. A minimum age must be specified and must be at least 18. Allowed values are 18, 25, 35, 45, 55, and 65.
},
],
"includeUndetermined": True or False, # Include users whose age is not determined.
},
"audienceSegments": { # Dimension specifying users by their membership in other audience segments. # Dimension specifying users by their membership in other audience segments.
"segments": [ # Included audience segments. Users are included if they belong to at least one segment.
{ # Positive audience segment.
"customAudience": { # Custom audience segment. # Custom audience segment.
"customAudience": "A String", # The custom audience resource.
},
"detailedDemographic": { # Detailed demographic segment. # Detailed demographic segment.
"detailedDemographic": "A String", # The detailed demographic resource.
},
"lifeEvent": { # Live event segment. # Live-event audience segment.
"lifeEvent": "A String", # The life event resource.
},
"userInterest": { # User interest segment. # Affinity or In-market segment.
"userInterestCategory": "A String", # The user interest resource.
},
"userList": { # User list segment. # User list segment.
"userList": "A String", # The user list resource.
},
},
],
},
"gender": { # Dimension specifying users by their gender. # Dimension specifying users by their gender.
"genders": [ # Included gender demographic segments.
"A String",
],
"includeUndetermined": True or False, # Include users whose gender is not determined.
},
"householdIncome": { # Dimension specifying users by their household income. # Dimension specifying users by their household income.
"includeUndetermined": True or False, # Include users whose household income is not determined.
"incomeRanges": [ # Included household income demographic segments.
"A String",
],
},
"parentalStatus": { # Dimension specifying users by their parental status. # Dimension specifying users by their parental status.
"includeUndetermined": True or False, # Include users whose parental status is undetermined.
"parentalStatuses": [ # Included parental status demographic segments.
"A String",
],
},
},
],
"exclusionDimension": { # Negative dimension specifying users to exclude from the audience. # Negative dimension specifying the audience composition.
"exclusions": [ # Audience segment to be excluded.
{ # An audience segment to be excluded from an audience.
"userList": { # User list segment. # User list segment to be excluded.
"userList": "A String", # The user list resource.
},
},
],
},
"id": "A String", # Output only. ID of the audience.
"name": "A 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.
"resourceName": "A String", # Immutable. The resource name of the audience. Audience names have the form: `customers/{customer_id}/audiences/{audience_id}`
"scope": "A String", # 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.
"status": "A String", # Output only. Status of this audience. Indicates whether the audience is enabled or removed.
},
"resourceName": "A String", # Returned for successful operations.
},
"biddingDataExclusionResult": { # The result for the data exclusion mutate. # The result for the bidding data exclusion mutate.
"biddingDataExclusion": { # 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. # The mutated bidding data exclusion with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"advertisingChannelTypes": [ # 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.
"A String",
],
"campaigns": [ # 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.
"A String",
],
"dataExclusionId": "A String", # Output only. The ID of the data exclusion.
"description": "A String", # The description of the data exclusion. The description can be at most 2048 characters.
"devices": [ # If not specified, all devices will be included in this exclusion. Otherwise, only the specified targeted devices will be included in this exclusion.
"A String",
],
"endDateTime": "A 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].
"name": "A String", # The name of the data exclusion. The name can be at most 255 characters.
"resourceName": "A String", # Immutable. The resource name of the data exclusion. Data exclusion resource names have the form: `customers/{customer_id}/biddingDataExclusions/{data_exclusion_id}`
"scope": "A String", # The scope of the data exclusion.
"startDateTime": "A 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.
"status": "A String", # Output only. The status of the data exclusion.
},
"resourceName": "A String", # Returned for successful operations.
},
"biddingSeasonalityAdjustmentResult": { # The result for the seasonality adjustment mutate. # The result for the bidding seasonality adjustment mutate.
"biddingSeasonalityAdjustment": { # Represents a bidding seasonality adjustment. Cannot be used in manager accounts. See "About seasonality adjustments" at https://support.google.com/google-ads/answer/10369906. # The mutated bidding seasonality adjustment with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"advertisingChannelTypes": [ # 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.
"A String",
],
"campaigns": [ # 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.
"A String",
],
"conversionRateModifier": 3.14, # 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.
"description": "A String", # The description of the seasonality adjustment. The description can be at most 2048 characters.
"devices": [ # If not specified, all devices will be included in this adjustment. Otherwise, only the specified targeted devices will be included in this adjustment.
"A String",
],
"endDateTime": "A 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].
"name": "A String", # The name of the seasonality adjustment. The name can be at most 255 characters.
"resourceName": "A String", # Immutable. The resource name of the seasonality adjustment. Seasonality adjustment resource names have the form: `customers/{customer_id}/biddingSeasonalityAdjustments/{seasonality_adjustment_id}`
"scope": "A String", # The scope of the seasonality adjustment.
"seasonalityAdjustmentId": "A String", # Output only. The ID of the seasonality adjustment.
"startDateTime": "A 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.
"status": "A String", # Output only. The status of the seasonality adjustment.
},
"resourceName": "A String", # Returned for successful operations.
},
"biddingStrategyResult": { # The result for the bidding strategy mutate. # The result for the bidding strategy mutate.
"biddingStrategy": { # A bidding strategy. # The mutated bidding strategy with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"alignedCampaignBudgetId": "A String", # 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.
"campaignCount": "A String", # Output only. The number of campaigns attached to this bidding strategy. This field is read-only.
"currencyCode": "A 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.
"effectiveCurrencyCode": "A 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.
"enhancedCpc": { # 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. # A 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.
},
"id": "A String", # Output only. The ID of the bidding strategy.
"maximizeConversionValue": { # An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget. # An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget.
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetRoas": 3.14, # 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.
"targetRoasTolerancePercentMillis": "A String", # 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.
},
"maximizeConversions": { # An automated bidding strategy to help get the most conversions for your campaigns while spending your budget. # An automated bidding strategy to help get the most conversions for your campaigns while spending your budget.
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetCpaMicros": "A String", # 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.
},
"name": "A 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": "A String", # Output only. The number of non-removed campaigns attached to this bidding strategy. This field is read-only.
"resourceName": "A String", # Immutable. The resource name of the bidding strategy. Bidding strategy resource names have the form: `customers/{customer_id}/biddingStrategies/{bidding_strategy_id}`
"status": "A String", # Output only. The status of the bidding strategy. This field is read-only.
"targetCpa": { # An automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set. # A bidding strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetCpaMicros": "A String", # Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
},
"targetImpressionShare": { # 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). # A bidding strategy that automatically optimizes towards a chosen percentage of impressions.
"cpcBidCeilingMicros": "A String", # 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.
"location": "A String", # The targeted location on the search results page.
"locationFractionMicros": "A String", # The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.
},
"targetRoas": { # An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS). # A bidding strategy that helps you maximize revenue while averaging a specific target Return On Ad Spend (ROAS).
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetRoas": 3.14, # Required. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.
"targetRoasTolerancePercentMillis": "A String", # 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.
},
"targetSpend": { # An automated bid strategy that sets your bids to help get as many clicks as possible within your budget. # A bid strategy that sets your bids to help get as many clicks as possible within your budget.
"cpcBidCeilingMicros": "A String", # Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
"targetSpendMicros": "A String", # 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.
},
"type": "A String", # Output only. The type of the bidding strategy. Create a bidding strategy by setting the bidding scheme. This field is read-only.
},
"resourceName": "A String", # Returned for successful operations.
},
"campaignAssetResult": { # The result for the campaign asset mutate. # The result for the campaign asset mutate.
"campaignAsset": { # A link between a Campaign and an Asset. # The mutated campaign asset with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"asset": "A String", # Immutable. The asset which is linked to the campaign.
"campaign": "A String", # Immutable. The campaign to which the asset is linked.
"fieldType": "A String", # Immutable. Role that the asset takes under the linked campaign. Required.
"primaryStatus": "A String", # 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.
"primaryStatusDetails": [ # Output only. Provides the details of the primary status and its associated reasons.
{ # Provides the detail of a PrimaryStatus. Each asset link has a PrimaryStatus value (e.g. NOT_ELIGIBLE, meaning not serving), and list of corroborating PrimaryStatusReasons (e.g. [ASSET_DISAPPROVED]). Each reason may have some additional details annotated with it. For instance, when the reason is ASSET_DISAPPROVED, the details field will contain additional information about the offline evaluation errors which led to the asset being disapproved.
"assetDisapproved": { # Details related to AssetLinkPrimaryStatusReasonPB.ASSET_DISAPPROVED # Provides the details for AssetLinkPrimaryStatusReason.ASSET_DISAPPROVED
"offlineEvaluationErrorReasons": [ # Provides the quality evaluation disapproval reason of an asset.
"A String",
],
},
"reason": "A String", # Provides the reason of this PrimaryStatus.
"status": "A String", # Provides the PrimaryStatus of this status detail.
},
],
"primaryStatusReasons": [ # Output only. Provides a list of reasons for why an asset is not serving or not serving at full capacity.
"A String",
],
"resourceName": "A 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}`
"source": "A String", # Output only. Source of the campaign asset link.
"status": "A String", # Status of the campaign asset.
},
"resourceName": "A String", # Returned for successful operations.
},
"campaignAssetSetResult": { # The result for the campaign asset set mutate. # The result for the campaign asset set mutate.
"campaignAssetSet": { # CampaignAssetSet is the linkage between a campaign and an asset set. Adding a CampaignAssetSet links an asset set with a campaign. # The mutated campaign asset set with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"assetSet": "A String", # Immutable. The asset set which is linked to the campaign.
"campaign": "A String", # Immutable. The campaign to which this asset set is linked.
"resourceName": "A String", # Immutable. The resource name of the campaign asset set. Asset set asset resource names have the form: `customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}`
"status": "A String", # Output only. The status of the campaign asset set asset. Read-only.
},
"resourceName": "A String", # Returned for successful operations.
},
"campaignBidModifierResult": { # The result for the criterion mutate. # The result for the campaign bid modifier mutate.
"campaignBidModifier": { # Represents a bid-modifiable only criterion at the campaign level. # The mutated campaign bid modifier with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"bidModifier": 3.14, # The modifier for the bid when the criterion matches.
"campaign": "A String", # Output only. The campaign to which this criterion belongs.
"criterionId": "A String", # Output only. The ID of the criterion to bid modify. This field is ignored for mutates.
"interactionType": { # Criterion for Interaction Type. # Immutable. Criterion for interaction type. Only supported for search campaigns.
"type": "A String", # The interaction type.
},
"resourceName": "A String", # Immutable. The resource name of the campaign bid modifier. Campaign bid modifier resource names have the form: `customers/{customer_id}/campaignBidModifiers/{campaign_id}~{criterion_id}`
},
"resourceName": "A String", # Returned for successful operations.
},
"campaignBudgetResult": { # The result for the campaign budget mutate. # The result for the campaign budget mutate.
"campaignBudget": { # A campaign budget. # The mutated campaign budget with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"alignedBiddingStrategyId": "A String", # ID of the portfolio bidding strategy that this shared campaign budget is aligned with. When a bidding strategy and a campaign budget are aligned, they are attached to the same set of campaigns. After a campaign budget is aligned with a bidding strategy, campaigns that are added to the campaign budget must also use the aligned bidding strategy.
"amountMicros": "A String", # The average daily amount to be spent by the campaign. This field is used when the CampaignBudget `period` is set to `DAILY`, which is the default. Amount is specified in micros in the account's local currency. One million micros is equivalent to one currency unit. The effective monthly spend is capped at 30.4 times this daily amount. This field is mutually exclusive with 'total_amount_micros'. Only one of 'amount_micros' or 'total_amount_micros' should be set.
"deliveryMethod": "A String", # The delivery method that determines the rate at which the campaign budget is spent. Defaults to STANDARD if unspecified in a create operation.
"explicitlyShared": True or False, # Specifies whether the budget is explicitly shared. Defaults to true if unspecified in a create operation. If true, the budget was created with the purpose of sharing across one or more campaigns. If false, the budget was created with the intention of only being used with a single campaign. The budget's name and status will stay in sync with the campaign's name and status. Attempting to share the budget with a second campaign will result in an error. A non-shared budget can become an explicitly shared. The same operation must also assign the budget a name. A shared campaign budget can never become non-shared.
"hasRecommendedBudget": True or False, # Output only. Indicates whether there is a recommended budget for this campaign budget. This field is read-only.
"id": "A String", # Output only. The ID of the campaign budget. A campaign budget is created using the CampaignBudgetService create operation and is assigned a budget ID. A budget ID can be shared across different campaigns; the system will then allocate the campaign budget among different campaigns to get optimum results.
"name": "A String", # The name of the campaign budget. When creating a campaign budget through CampaignBudgetService, every explicitly shared campaign budget must have a non-null, non-empty name. Campaign budgets that are not explicitly shared derive their name from the attached campaign's name. The length of this string must be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
"period": "A String", # Immutable. Period over which to spend the budget. Defaults to DAILY if not specified.
"recommendedBudgetAmountMicros": "A String", # Output only. The recommended budget amount. If no recommendation is available, this will be set to the budget amount. Amount is specified in micros, where one million is equivalent to one currency unit. This field is read-only.
"recommendedBudgetEstimatedChangeWeeklyClicks": "A String", # Output only. The estimated change in weekly clicks if the recommended budget is applied. This field is read-only.
"recommendedBudgetEstimatedChangeWeeklyCostMicros": "A String", # Output only. The estimated change in weekly cost in micros if the recommended budget is applied. One million is equivalent to one currency unit. This field is read-only.
"recommendedBudgetEstimatedChangeWeeklyInteractions": "A String", # Output only. The estimated change in weekly interactions if the recommended budget is applied. This field is read-only.
"recommendedBudgetEstimatedChangeWeeklyViews": "A String", # Output only. The estimated change in weekly views if the recommended budget is applied. This field is read-only.
"referenceCount": "A String", # Output only. The number of campaigns actively using the budget. This field is read-only.
"resourceName": "A String", # Immutable. The resource name of the campaign budget. Campaign budget resource names have the form: `customers/{customer_id}/campaignBudgets/{campaign_budget_id}`
"status": "A String", # Output only. The status of this campaign budget. This field is read-only.
"totalAmountMicros": "A String", # The total amount to be spent by the campaign over its entire duration. This field is used *only* when the CampaignBudget `period` is set to `CUSTOM_PERIOD`. It represents the budget cap for the campaign's lifetime, rather than a daily limit. The amount is specified in micros in the account's local currency. One million micros is equivalent to one currency unit. This field is mutually exclusive with 'amount_micros'. Only one of 'total_amount_micros' or 'amount_micros' should be set.
"type": "A String", # Immutable. The type of the campaign budget.
},
"resourceName": "A String", # Returned for successful operations.
},
"campaignConversionGoalResult": { # The result for the campaign conversion goal mutate. # The result for the campaign conversion goal mutate.
"resourceName": "A String", # Returned for successful operations.
},
"campaignCriterionResult": { # The result for the criterion mutate. # The result for the campaign criterion mutate.
"campaignCriterion": { # A campaign criterion. # The mutated campaign criterion with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"adSchedule": { # Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day. # Immutable. Ad Schedule.
"dayOfWeek": "A String", # Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endHour": 42, # Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"endMinute": "A String", # Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startHour": 42, # Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
"startMinute": "A String", # Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.
},
"ageRange": { # An age range criterion. # Immutable. Age range.
"type": "A String", # Type of the age range.
},
"bidModifier": 3.14, # The modifier for the bids when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. Use 0 to opt out of a Device type.
"brandList": { # 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. # Immutable. Brand list campaign criterion.
"sharedSet": "A String", # Shared set resource name of the brand list.
},
"campaign": "A String", # Immutable. The campaign to which the criterion belongs.
"carrier": { # Represents a Carrier Criterion. # Immutable. Carrier.
"carrierConstant": "A String", # The Carrier constant resource name.
},
"combinedAudience": { # A combined audience criterion. # Immutable. Combined Audience.
"combinedAudience": "A String", # The CombinedAudience resource name.
},
"contentLabel": { # Content Label for category exclusion. # Immutable. ContentLabel.
"type": "A String", # Content label type, required for CREATE operations.
},
"criterionId": "A String", # Output only. The ID of the criterion. This field is ignored during mutate.
"device": { # A device criterion. # Immutable. Device.
"type": "A String", # Type of the device.
},
"displayName": "A String", # Output only. The display name of the criterion. This field is ignored for mutates.
"extendedDemographic": { # Represents an extended demographic criterion. # Immutable. Extended demographic criterion.
"extendedDemographicId": "A String", # Taxonomy id of the extended demographic group.
},
"gender": { # A gender criterion. # Immutable. Gender.
"type": "A String", # Type of the gender.
},
"incomeRange": { # An income range criterion. # Immutable. Income range.
"type": "A String", # Type of the income range.
},
"ipBlock": { # 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 # Immutable. IpBlock. You can exclude up to 500 IP addresses per campaign.
"ipAddress": "A String", # The IP address or the CIDR block to be excluded.
},
"keyword": { # A keyword criterion. # Immutable. Keyword.
"matchType": "A String", # The match type of the keyword.
"text": "A String", # The text of the keyword (at most 80 characters and 10 words).
},
"keywordTheme": { # A Smart Campaign keyword theme. # Immutable. Smart Campaign Keyword Theme.
"freeFormKeywordTheme": "A String", # Free-form text to be matched to a Smart Campaign keyword theme constant on a best-effort basis.
"keywordThemeConstant": "A String", # The resource name of a Smart Campaign keyword theme constant. `keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id}`
},
"language": { # A language criterion. # Immutable. Language.
"languageConstant": "A String", # The language constant resource name.
},
"lastModifiedTime": "A String", # Output only. The datetime when this campaign criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
"lifeEvent": { # Represents a life event criterion. # Immutable. Life event campaign criterion.
"lifeEventId": "A String", # Taxonomy id of the life event.
},
"listingScope": { # A listing scope criterion. # Immutable. Listing scope.
"dimensions": [ # Scope of the campaign criterion.
{ # Listing dimensions for listing group criterion.
"activityCity": { # The city where the travel activity is available. # The city where the travel activity is available.
"value": "A String", # String value of the activity city. The Geo Target Constant resource name.
},
"activityCountry": { # The country where the travel activity is available. # The country where the travel activity is available.
"value": "A String", # String value of the activity country. The Geo Target Constant resource name.
},
"activityId": { # Advertiser-specific activity ID. # Advertiser-specific activity ID.
"value": "A String", # String value of the activity ID.
},
"activityRating": { # Rating of the activity as a number 1 to 5, where 5 is the best. # Rating of the activity as a number 1 to 5, where 5 is the best.
"value": "A String", # Long value of the activity rating.
},
"activityState": { # The state where the travel activity is available. # The state where the travel activity is available.
"value": "A String", # String value of the activity state. The Geo Target Constant resource name.
},
"hotelCity": { # City the hotel is located in. # City the hotel is located in.
"cityCriterion": "A String", # The Geo Target Constant resource name.
},
"hotelClass": { # Class of the hotel as a number of stars 1 to 5. # Class of the hotel as a number of stars 1 to 5.
"value": "A String", # Long value of the hotel class.
},
"hotelCountryRegion": { # Country or Region the hotel is located in. # Country or Region the hotel is located in.
"countryRegionCriterion": "A String", # The Geo Target Constant resource name.
},
"hotelId": { # Advertiser-specific hotel ID. # Advertiser-specific hotel ID.
"value": "A String", # String value of the hotel ID.
},
"hotelState": { # State the hotel is located in. # State the hotel is located in.
"stateCriterion": "A String", # The Geo Target Constant resource name.
},
"productBrand": { # Brand of the product. # Brand of a product offer.
"value": "A String", # String value of the product brand.
},
"productCategory": { # Category of a product offer. # Category of a product offer.
"categoryId": "A String", # ID of the product category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
"level": "A String", # Level of the product category.
},
"productChannel": { # Locality of a product offer. # Locality of a product offer.
"channel": "A String", # Value of the locality.
},
"productChannelExclusivity": { # Availability of a product offer. # Availability of a product offer.
"channelExclusivity": "A String", # Value of the availability.
},
"productCondition": { # Condition of a product offer. # Condition of a product offer.
"condition": "A String", # Value of the condition.
},
"productCustomAttribute": { # Custom attribute of a product offer. # Custom attribute of a product offer.
"index": "A String", # Indicates the index of the custom attribute.
"value": "A String", # String value of the product custom attribute.
},
"productGrouping": { # Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Grouping of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product grouping.
},
"productItemId": { # Item id of a product offer. # Item id of a product offer.
"value": "A String", # Value of the id.
},
"productLabels": { # Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Labels of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product labels.
},
"productLegacyCondition": { # Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Legacy condition of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product legacy condition.
},
"productType": { # Type of a product offer. # Type of a product offer.
"level": "A String", # Level of the type.
"value": "A String", # Value of the type.
},
"productTypeFull": { # Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns. # Full type of a product offer. This listing dimension is deprecated and it is supported only in Display campaigns.
"value": "A String", # String value of the product full type.
},
"unknownListingDimension": { # Unknown listing dimension. # Unknown dimension. Set when no other listing dimension is set.
},
},
],
},
"localServiceId": { # A Local Services Ads service ID. Represents a service type (such as install_faucet) that a Local Services Campaign can target. # Immutable. GLS service campaign criterion.
"serviceId": "A String", # The criterion resource name.
},
"location": { # A location criterion. # Immutable. Location.
"geoTargetConstant": "A String", # The geo target constant resource name.
},
"locationGroup": { # A radius around a list of locations specified through a feed. # Immutable. Location Group
"enableCustomerLevelLocationAssetSet": True or False, # Denotes that the latest customer level asset set is used for targeting. Used with radius and radius_units. Cannot be used with feed, geo target constants or feed item sets. When using asset sets, either this field or location_group_asset_sets should be specified. Both cannot be used at the same time. This can only be set in CREATE operations.
"feedItemSets": [ # FeedItemSets whose FeedItems are targeted. If multiple IDs are specified, then all items that appear in at least one set are targeted. This field cannot be used with geo_target_constants. This is optional and can only be set in CREATE operations.
"A String",
],
"geoTargetConstants": [ # Geo target constant(s) restricting the scope of the geographic area within the feed. Currently only one geo target constant is allowed.
"A String",
],
"locationGroupAssetSets": [ # AssetSets whose Assets are targeted. If multiple IDs are specified, then all items that appear in at least one set are targeted. This field cannot be used with feed, geo target constants or feed item sets. When using asset sets, either this field or enable_customer_level_location_asset_set should be specified. Both cannot be used at the same time. This can only be set in CREATE operations.
"A String",
],
"radius": "A String", # Distance in units specifying the radius around targeted locations. This is required and must be set in CREATE operations.
"radiusUnits": "A String", # Unit of the radius. Miles and meters are supported for geo target constants. Milli miles and meters are supported for feed item sets. This is required and must be set in CREATE operations.
},
"mobileAppCategory": { # A mobile app category criterion. # Immutable. Mobile app category.
"mobileAppCategoryConstant": "A String", # The mobile app category constant resource name.
},
"mobileApplication": { # A mobile application criterion. # Immutable. Mobile application.
"appId": "A 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": "A String", # Name of this mobile application.
},
"mobileDevice": { # A mobile device criterion. # Immutable. Mobile Device.
"mobileDeviceConstant": "A String", # The mobile device constant resource name.
},
"negative": True or False, # Immutable. Whether to target (`false`) or exclude (`true`) the criterion.
"operatingSystemVersion": { # Represents an operating system version to be targeted. # Immutable. Operating system version.
"operatingSystemVersionConstant": "A String", # The operating system version constant resource name.
},
"parentalStatus": { # A parental status criterion. # Immutable. Parental status.
"type": "A String", # Type of the parental status.
},
"placement": { # A placement criterion. This can be used to modify bids for sites when targeting the content network. # Immutable. Placement.
"url": "A String", # URL of the placement. For example, "http://www.domain.com".
},
"proximity": { # A Proximity criterion. The geo point and radius determine what geographical area is included. The address is a description of the geo point that does not affect ad serving. There are two ways to create a proximity. First, by setting an address and radius. The geo point will be automatically computed. Second, by setting a geo point and radius. The address is an optional label that won't be validated. # Immutable. Proximity.
"address": { # Address for proximity criterion. # Full address.
"cityName": "A String", # Name of the city.
"countryCode": "A String", # Country code.
"postalCode": "A String", # Postal code.
"provinceCode": "A String", # Province or state code.
"provinceName": "A String", # Province or state name.
"streetAddress": "A String", # Street address line 1.
"streetAddress2": "A String", # Street address line 2. This field is write-only. It is only used for calculating the longitude and latitude of an address when geo_point is empty.
},
"geoPoint": { # Geo point for proximity criterion. # Latitude and longitude.
"latitudeInMicroDegrees": 42, # Micro degrees for the latitude.
"longitudeInMicroDegrees": 42, # Micro degrees for the longitude.
},
"radius": 3.14, # The radius of the proximity.
"radiusUnits": "A String", # The unit of measurement of the radius. Default is KILOMETERS.
},
"resourceName": "A String", # Immutable. The resource name of the campaign criterion. Campaign criterion resource names have the form: `customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}`
"status": "A String", # The status of the criterion.
"topic": { # 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"). # Immutable. Topic.
"path": [ # 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.
"A String",
],
"topicConstant": "A String", # The Topic Constant resource name.
},
"type": "A String", # Output only. The type of the criterion.
"userInterest": { # Represents a particular interest-based topic to be targeted. # Immutable. User Interest.
"userInterestCategory": "A String", # The UserInterest resource name.
},
"userList": { # A User List criterion. Represents a user list that is defined by the advertiser to be targeted. # Immutable. User List.
"userList": "A String", # The User List resource name.
},
"videoLineup": { # A Video lineup criterion. # Immutable. Video lineup criterion.
"videoLineupId": "A String", # ID for a Video lineup. Contact your Google business development representative for details.
},
"webpage": { # Represents a criterion for targeting webpages of an advertiser's website. # Immutable. Webpage.
"conditions": [ # 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.
{ # Logical expression for targeting webpages of an advertiser's website.
"argument": "A String", # Argument of webpage targeting condition.
"operand": "A String", # Operand of webpage targeting condition.
"operator": "A String", # Operator of webpage targeting condition.
},
],
"coveragePercentage": 3.14, # 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.
"criterionName": "A 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.
"sample": { # List of sample urls that match the website target # List of sample urls that match the website target. This field is read-only.
"sampleUrls": [ # Webpage sample urls
"A String",
],
},
},
"webpageList": { # Represents a list of webpage criteria. # Immutable. Webpage list. This criterion is not publicly available.
"sharedSet": "A String", # Shared set resource name of the webpage list.
},
"youtubeChannel": { # A YouTube Channel criterion. # Immutable. YouTube Channel.
"channelId": "A String", # The YouTube uploader channel id or the channel code of a YouTube channel.
},
"youtubeVideo": { # A YouTube Video criterion. # Immutable. YouTube Video.
"videoId": "A String", # YouTube video id as it appears on the YouTube watch page.
},
},
"resourceName": "A String", # Returned for successful operations.
},
"campaignCustomizerResult": { # The result for the campaign customizer mutate. # The result for the campaign customizer mutate.
"campaignCustomizer": { # A customizer value for the associated CustomizerAttribute at the Campaign level. # The mutated CampaignCustomizer with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"campaign": "A String", # Immutable. The campaign to which the customizer attribute is linked.
"customizerAttribute": "A String", # Required. Immutable. The customizer attribute which is linked to the campaign.
"resourceName": "A String", # Immutable. The resource name of the campaign customizer. Campaign customizer resource names have the form: `customers/{customer_id}/campaignCustomizers/{campaign_id}~{customizer_attribute_id}`
"status": "A String", # Output only. The status of the campaign customizer.
"value": { # A customizer value that is referenced in customizer linkage entities like CustomerCustomizer, CampaignCustomizer, etc. # Required. The value to associate with the customizer attribute at this level. The value must be of the type specified for the CustomizerAttribute.
"stringValue": "A String", # Required. Value to insert in creative text. Customizer values of all types are stored as string to make formatting unambiguous.
"type": "A String", # 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.
},
},
"resourceName": "A String", # Returned for successful operations.
},
"campaignDraftResult": { # The result for the campaign draft mutate. # The result for the campaign draft mutate.
"campaignDraft": { # A campaign draft. # The mutated campaign draft with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"baseCampaign": "A String", # Immutable. The base campaign to which the draft belongs.
"draftCampaign": "A String", # Output only. Resource name of the Campaign that results from overlaying the draft changes onto the base campaign. This field is read-only.
"draftId": "A String", # Output only. The ID of the draft. This field is read-only.
"hasExperimentRunning": True or False, # Output only. Whether there is an experiment based on this draft currently serving.
"longRunningOperation": "A 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.
"name": "A 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.
"resourceName": "A 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}`
"status": "A String", # 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": "A String", # Returned for successful operations.
},
"campaignGroupResult": { # The result for the campaign group mutate. # The result for the campaign group mutate.
"campaignGroup": { # A campaign group. # The mutated campaign group with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"id": "A String", # Output only. The ID of the campaign group.
"name": "A 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": "A String", # Immutable. The resource name of the campaign group. Campaign group resource names have the form: `customers/{customer_id}/campaignGroups/{campaign_group_id}`
"status": "A String", # The status of the campaign group. When a new campaign group is added, the status defaults to ENABLED.
},
"resourceName": "A String", # Required. Returned for successful operations.
},
"campaignLabelResult": { # The result for a campaign label mutate. # The result for the campaign label mutate.
"resourceName": "A String", # Returned for successful operations.
},
"campaignResult": { # The result for the campaign mutate. # The result for the campaign mutate.
"campaign": { # A campaign. # The mutated campaign with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"accessibleBiddingStrategy": "A String", # Output only. Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource.
"adServingOptimizationStatus": "A String", # The ad serving optimization status of the campaign.
"advertisingChannelSubType": "A String", # Immutable. Optional refinement to `advertising_channel_type`. Must be a valid sub-type of the parent channel type. Can be set only when creating campaigns. After campaign is created, the field can not be changed.
"advertisingChannelType": "A String", # Immutable. The primary serving target for ads within the campaign. The targeting options can be refined in `network_settings`. This field is required and should not be empty when creating new campaigns. Can be set only when creating campaigns. After the campaign is created, the field can not be changed.
"aiMaxSetting": { # Settings for AI Max in search campaigns. # Settings for AI Max in search campaigns.
"bundlingRequired": "A String", # Output only. Indicates whether a search campaign has adopted AI Max before, and is required to have AI Max enabled to adopt campaign-level text asset automation and brand list targeting in all API versions.
"enableAiMax": True or False, # Controls whether or not AI Max features are served for this campaign. Individual AI Max features are enabled or disabled by their respective settings. But if enable_ai_max is set to false or cleared, then no AI Max features will serve for this campaign, regardless of the other settings. Search Term Matching is enabled by default when AI Max is enabled, and can be disabled at the ad group level.
},
"appCampaignSetting": { # Campaign-level settings for App Campaigns. # The setting related to App Campaign.
"appId": "A String", # Immutable. A string that uniquely identifies a mobile application.
"appStore": "A String", # Immutable. The application store that distributes this specific app.
"biddingStrategyGoalType": "A String", # Represents the goal which the bidding strategy of this app campaign should optimize towards.
},
"assetAutomationSettings": [ # Contains the opt-in/out status of each AssetAutomationType. See documentation of each asset automation type enum for default opt in/out behavior.
{ # Asset automation setting contains pair of AssetAutomationType and the asset automation opt-in/out status
"assetAutomationStatus": "A String", # The opt-in/out status of asset automation type.
"assetAutomationType": "A String", # The asset automation type advertiser would like to opt-in/out.
},
],
"audienceSetting": { # Settings for the audience targeting. # Immutable. Setting for audience related features.
"useAudienceGrouped": True or False, # Immutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead.
},
"baseCampaign": "A String", # Output only. The resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to `resource_name`. This field is read-only.
"biddingStrategy": "A String", # The resource name of the portfolio bidding strategy used by the campaign.
"biddingStrategySystemStatus": "A String", # Output only. The system status of the campaign's bidding strategy.
"biddingStrategyType": "A String", # Output only. The type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the `bidding_strategy` field to create a portfolio bidding strategy. This field is read-only.
"brandGuidelines": { # Settings that control the visual appearance of your brand in a campaign's automatically generated assets and formats. Only applicable to Performance Max campaigns.
"accentColor": "A String", # The accent brand color, entered as a hex code (e.g., #00ff00). You must provide the accent_color if you provide a main_color.
"mainColor": "A String", # The main brand color, entered as a hex code (e.g., #00ff00). You must provide the main_color if you provide an accent_color.
"predefinedFontFamily": "A String", # The brand's font family. Must be one of the following Google Fonts (case sensitive): Open Sans, Roboto, Montserrat, Poppins, Lato, Oswald, Playfair Display, Roboto Slab.
},
"brandGuidelinesEnabled": True or False, # Immutable. Whether Brand Guidelines are enabled for this Campaign. Only applicable to Performance Max campaigns. If enabled, business name and logo assets must be linked as CampaignAssets instead of AssetGroupAssets.
"campaignBudget": "A String", # The resource name of the campaign budget of the campaign.
"campaignGroup": "A String", # The resource name of the campaign group that this campaign belongs to.
"commission": { # Commission is an automatic bidding strategy in which the advertiser pays a certain portion of the conversion value. # Commission is an automatic bidding strategy in which the advertiser pays a certain portion of the conversion value.
"commissionRateMicros": "A String", # Commission rate defines the portion of the conversion value that the advertiser will be billed. A commission rate of x should be passed into this field as (x * 1,000,000). For example, 106,000 represents a commission rate of 0.106 (10.6%).
},
"containsEuPoliticalAdvertising": "A String", # The advertiser should self-declare whether this campaign contains political advertising content targeted towards the European Union.
"demandGenCampaignSettings": { # Settings for Demand Gen campaign. # Settings for Demand Gen campaign.
"upgradedTargeting": True or False, # Immutable. Specifies whether this campaign uses upgraded targeting options. When this field is set to `true`, you can use location and language targeting at the ad group level as opposed to the standard campaign-level targeting.
},
"dynamicSearchAdsSetting": { # The setting for controlling Dynamic Search Ads (DSA). # The setting for controlling Dynamic Search Ads (DSA).
"domainName": "A String", # Required. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com".
"languageCode": "A String", # Required. The language code specifying the language of the domain, for example, "en".
"useSuppliedUrlsOnly": True or False, # Whether the campaign uses advertiser supplied URLs exclusively.
},
"effectiveLabels": [ # Output only. The resource names of effective labels attached to this campaign. An effective label is a label inherited or directly assigned to this campaign.
"A String",
],
"endDateTime": "A String", # The last day and time of the campaign in serving customer's timezone in "yyyy-MM-dd HH:mm:ss" format. Set the time component to 23:59:59 for daily granularity, time granularity is only supported for some campaign types. On create, defaults to running indefinitely. To set an existing campaign to run indefinitely, clear this field.
"engineId": "A String", # Output only. ID of the campaign 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 "campaign.id" instead.
"excludedParentAssetFieldTypes": [ # The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level.
"A String",
],
"excludedParentAssetSetTypes": [ # The asset set types that should be excluded from this campaign. Asset set links with these types will not be inherited by this campaign from the upper level. 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 campaign, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this campaign. Only LOCATION_SYNC is currently supported.
"A String",
],
"experimentType": "A String", # Output only. The type of campaign: normal, draft, or experiment.
"feedTypes": [ # Output only. Types of feeds that are attached directly to this campaign.
"A String",
],
"finalUrlSuffix": "A String", # Suffix used to append query parameters to landing pages that are served with parallel tracking.
"frequencyCaps": [ # A list that limits how often each user will see this campaign's ads.
{ # A rule specifying the maximum number of times an ad (or some set of ads) can be shown to a user over a particular time period.
"cap": 42, # Maximum number of events allowed during the time range by this cap.
"key": { # A group of fields used as keys for a frequency cap. There can be no more than one frequency cap with the same key. # The key of a particular frequency cap. There can be no more than one frequency cap with the same key.
"eventType": "A String", # The type of event that the cap applies to (for example, impression).
"level": "A String", # The level on which the cap is to be applied (for example, ad group ad, ad group). The cap is applied to all the entities of this level.
"timeLength": 42, # Number of time units the cap lasts.
"timeUnit": "A String", # Unit of time the cap is defined at (for example, day, week).
},
},
],
"geoTargetTypeSetting": { # Represents a collection of settings related to ads geotargeting. # The setting for ads geotargeting.
"negativeGeoTargetType": "A String", # The setting used for negative geotargeting in this particular campaign.
"positiveGeoTargetType": "A String", # The setting used for positive geotargeting in this particular campaign.
},
"hotelPropertyAssetSet": "A String", # Immutable. The resource name for a set of hotel properties for Performance Max for travel goals campaigns.
"hotelSetting": { # Campaign-level settings for hotel ads. # Output only. The hotel setting for the campaign.
"hotelCenterId": "A String", # Output only. The linked Hotel Center account.
},
"id": "A String", # Output only. The ID of the campaign.
"keywordMatchType": "A String", # Keyword match type of Campaign. Set to BROAD to set broad matching for all keywords in a campaign.
"labels": [ # Output only. The resource names of labels attached to this campaign.
"A String",
],
"lastModifiedTime": "A String", # Output only. The datetime when this campaign was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
"listingType": "A String", # Immutable. Listing type of ads served for this campaign. Field is restricted for usage with Performance Max campaigns.
"localCampaignSetting": { # Campaign setting for local campaigns. # The setting for local campaign.
"locationSourceType": "A String", # The location source type for this local campaign.
},
"localServicesCampaignSettings": { # Settings for LocalServicesCampaign subresource. # The Local Services Campaign related settings.
"categoryBids": [ # Categorical level bids associated with MANUAL_CPA bidding strategy.
{ # Category bids in LocalServicesReportingCampaignSettings.
"categoryId": "A String", # Category for which the bid will be associated with. For example, xcat:service_area_business_plumber.
"manualCpaBidMicros": "A String", # Manual CPA bid for the category. Bid must be greater than the reserve price associated for that category. Value is in micros and in the advertiser's currency.
"targetCpaBidMicros": "A String", # Target CPA bid for the category. Value is in micros and in the advertiser's currency.
},
],
},
"manualCpa": { # Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. # Standard Manual CPA bidding strategy. Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. Supported only for Local Services campaigns.
},
"manualCpc": { # Manual click-based bidding where user pays per click. # Standard Manual CPC bidding strategy. Manual click-based bidding where user pays per click.
"enhancedCpcEnabled": True or False, # Whether bids are to be enhanced based on conversion optimizer data.
},
"manualCpm": { # Manual impression-based bidding where user pays per thousand impressions. # Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
},
"manualCpv": { # View based bidding where user pays per video view. # A bidding strategy that pays a configurable amount per video view.
},
"maximizeConversionValue": { # An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget. # Standard Maximize Conversion Value bidding strategy that automatically sets bids to maximize revenue while spending your budget.
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetRoas": 3.14, # 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.
"targetRoasTolerancePercentMillis": "A String", # 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.
},
"maximizeConversions": { # An automated bidding strategy to help get the most conversions for your campaigns while spending your budget. # Standard Maximize Conversions bidding strategy that automatically maximizes number of conversions while spending your budget.
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetCpaMicros": "A String", # 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.
},
"missingEuPoliticalAdvertisingDeclaration": True or False, # Output only. Indicates whether this campaign is missing a declaration about whether it contains political advertising targeted towards the EU and is ineligible for any exemptions. If this field is true, use the contains_eu_political_advertising field to add the required declaration. This field is read-only.
"name": "A String", # The name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
"networkSettings": { # The network settings for the campaign. # The network settings for the campaign.
"targetContentNetwork": True or False, # Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
"targetGoogleSearch": True or False, # Whether ads will be served with google.com search results.
"targetGoogleTvNetwork": True or False, # Whether ads will be served on the Google TV network.
"targetPartnerSearchNetwork": True or False, # Whether ads will be served on the partner network. This is available only to some select partner accounts. Unless you have been instructed to use this field, it likely does not apply to your account. This does not control whether ads will be served on Google Search Partners Network; use `target_search_network` for that instead.
"targetSearchNetwork": True or False, # Whether ads will be served on sites in the Google Search Partners Network (requires `target_google_search` to also be `true`).
"targetYoutube": True or False, # Whether ads will be served on YouTube.
},
"optimizationGoalSetting": { # Optimization goal setting for this campaign, which includes a set of optimization goal types. # Optimization goal setting for this campaign, which includes a set of optimization goal types.
"optimizationGoalTypes": [ # The list of optimization goal types.
"A String",
],
},
"optimizationScore": 3.14, # Output only. Optimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See "About optimization score" at https://support.google.com/google-ads/answer/9061546. This field is read-only.
"paymentMode": "A String", # Payment mode for the campaign.
"percentCpc": { # A bidding strategy where bids are a fraction of the advertised price for some good or service. # Standard Percent Cpc bidding strategy where bids are a fraction of the advertised price for some good or service.
"cpcBidCeilingMicros": "A String", # Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined.
"enhancedCpcEnabled": True or False, # Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not.
},
"performanceMaxUpgrade": { # Information about a campaign being upgraded to Performance Max. # Output only. Information about campaigns being upgraded to Performance Max.
"performanceMaxCampaign": "A String", # Output only. The resource name of the Performance Max campaign the campaign is upgraded to.
"preUpgradeCampaign": "A String", # Output only. The resource name of the legacy campaign upgraded to Performance Max.
"status": "A String", # Output only. The upgrade status of a campaign requested to be upgraded to Performance Max.
},
"pmaxCampaignSettings": { # Settings for Performance Max campaigns. # Settings for Performance Max campaign.
"brandTargetingOverrides": { # Overrides of brand targeting for various ad types. # Overrides of brand targeting for various ad types.
"ignoreExclusionsForShoppingAds": True or False, # If true, brand exclusions are ignored for Shopping ads.
},
},
"primaryStatus": "A String", # Output only. The primary status of the campaign. Provides insight into why a campaign is not serving or not serving optimally. Modification to the campaign and its related entities might take a while to be reflected in this status.
"primaryStatusReasons": [ # Output only. The primary status reasons of the campaign. Provides insight into why a campaign is not serving or not serving optimally. These reasons are aggregated to determine an overall CampaignPrimaryStatus.
"A String",
],
"realTimeBiddingSetting": { # Settings for Real-Time Bidding, a feature only available for campaigns targeting the Ad Exchange network. # Settings for Real-Time Bidding, a feature only available for campaigns targeting the Ad Exchange network.
"optIn": True or False, # Whether the campaign is opted in to real-time bidding.
},
"resourceName": "A String", # Immutable. The resource name of the campaign. Campaign resource names have the form: `customers/{customer_id}/campaigns/{campaign_id}`
"selectiveOptimization": { # Selective optimization setting for this campaign, which includes a set of conversion actions to optimize this campaign towards. This feature only applies to app campaigns that use MULTI_CHANNEL as AdvertisingChannelType and APP_CAMPAIGN or APP_CAMPAIGN_FOR_ENGAGEMENT as AdvertisingChannelSubType. # Selective optimization setting for this campaign, which includes a set of conversion actions to optimize this campaign towards. This feature only applies to app campaigns that use MULTI_CHANNEL as AdvertisingChannelType and APP_CAMPAIGN or APP_CAMPAIGN_FOR_ENGAGEMENT as AdvertisingChannelSubType.
"conversionActions": [ # The selected set of resource names for conversion actions for optimizing this campaign.
"A String",
],
},
"selectiveOptimizationMode": "A String", # Selective optimization mode for this campaign.
"servingStatus": "A String", # Output only. The ad serving status of the campaign.
"shoppingSetting": { # The setting for Shopping campaigns. Defines the universe of products that can be advertised by the campaign, and how this campaign interacts with other Shopping campaigns. # The setting for controlling Shopping campaigns.
"advertisingPartnerIds": [ # The list of Google Ads accounts IDs of advertising partners cooperating within the campaign. This feature is currently available only for accounts having an advertising partner link. This feature is currently supported only for Performance Max, Shopping, Search and Demand Gen campaign types.
"A String",
],
"campaignPriority": 42, # Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set.
"disableProductFeed": True or False, # Disable the optional product feed. This field is currently supported only for Demand Gen campaigns. See https://support.google.com/google-ads/answer/13721750 to learn more about this feature.
"enableLocal": True or False, # Whether to include local products.
"feedLabel": "A String", # Feed label of products to include in the campaign. Valid feed labels may contain a maximum of 20 characters including uppercase letters, numbers, hyphens, and underscores. If you previously used the deprecated `sales_country` in the two-letter country code (`XX`) format, the `feed_label` field should be used instead. For more information see the [feed label](//support.google.com/merchants/answer/12453549) support article.
"merchantId": "A String", # ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
"useVehicleInventory": True or False, # Immutable. Whether to target Vehicle Listing inventory.
},
"startDateTime": "A String", # The date and time when campaign started in serving. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. Set the time component to 00:00:00 for daily granularity, time granularity is only supported for some campaign types.
"status": "A String", # The status of the campaign. When a new campaign is added, the status defaults to ENABLED.
"targetCpa": { # An automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set. # Standard Target CPA bidding strategy that automatically sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetCpaMicros": "A String", # Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
},
"targetCpc": { # An automated bidding strategy that sets bids to help get as many clicks as possible at the target cost-per-click (CPC) you set. # An automated bidding strategy that sets bids to help get as many clicks as possible at the target cost-per-click (CPC) you set.
"targetCpcMicros": "A String", # Average CPC target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
},
"targetCpm": { # Target CPM (cost per thousand impressions) is an automated bidding strategy that sets bids to optimize performance given the target CPM you set. # A bidding strategy that automatically optimizes cost per thousand impressions.
},
"targetImpressionShare": { # 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). # Target Impression Share bidding strategy. An automated bidding strategy that sets bids to achieve a chosen percentage of impressions.
"cpcBidCeilingMicros": "A String", # 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.
"location": "A String", # The targeted location on the search results page.
"locationFractionMicros": "A String", # The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.
},
"targetRoas": { # An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS). # Standard Target ROAS bidding strategy that automatically maximizes revenue while averaging a specific target return on ad spend (ROAS).
"cpcBidCeilingMicros": "A String", # 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": "A String", # 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.
"targetRoas": 3.14, # Required. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.
"targetRoasTolerancePercentMillis": "A String", # 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.
},
"targetSpend": { # An automated bid strategy that sets your bids to help get as many clicks as possible within your budget. # Standard Target Spend bidding strategy that automatically sets your bids to help get as many clicks as possible within your budget.
"cpcBidCeilingMicros": "A String", # Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
"targetSpendMicros": "A String", # 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.
},
"targetingSetting": { # 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 # Setting for targeting related features.
"targetRestrictionOperations": [ # 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.
{ # Operation to be performed on a target restriction list in a mutate.
"operator": "A String", # Type of list operation to perform.
"value": { # The list of per-targeting-dimension targeting settings. # The target restriction being added to or removed from the list.
"bidOnly": True or False, # 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": "A String", # The targeting dimension that these settings apply to.
},
},
],
"targetRestrictions": [ # The per-targeting-dimension setting to restrict the reach of your campaign or ad group.
{ # The list of per-targeting-dimension targeting settings.
"bidOnly": True or False, # 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": "A String", # The targeting dimension that these settings apply to.
},
],
},
"thirdPartyIntegrationPartners": { # Container for Campaign level third party integration partners. # Third-Party integration partners.
"brandLiftIntegrationPartners": [ # Third party integration partners for Brand Lift verification for this Campaign.
{ # Container for third party Brand Lift integration data for Campaign.
"brandLiftIntegrationPartner": "A String", # Allowed third party integration partners for Brand Lift verification.
"brandLiftIntegrationPartnerData": { # Contains third party measurement partner related data for video campaigns. # Third party partner data for YouTube Brand Lift verification. This is optional metadata for partners to join or attach data to Ads campaigns.
"clientId": "A String", # The client ID that allows the measurement partner to join multiple campaigns for a particular advertiser.
"thirdPartyPlacementId": "A String", # The third party placement ID that maps the measurement partner data with a campaign (or a group of related campaigns) specific data.
},
"shareCost": True or False, # If true, then cost data will be shared with this vendor.
},
],
"brandSafetyIntegrationPartners": [ # Third party integration partners for brand safety verification for this Campaign.
{ # Container for third party brand safety integration data for Campaign.
"brandSafetyIntegrationPartner": "A String", # Allowed third party integration partners for brand safety verification.
"brandSafetyIntegrationPartnerData": { # Contains third party measurement partner related data for video campaigns. # Third party partner data for YouTube brand safety verification. This is optional metadata for partners to join or attach data to Ads campaigns.
"clientId": "A String", # The client ID that allows the measurement partner to join multiple campaigns for a particular advertiser.
"thirdPartyPlacementId": "A String", # The third party placement ID that maps the measurement partner data with a campaign (or a group of related campaigns) specific data.
},
},
],
"reachIntegrationPartners": [ # Third party integration partners for reach verification for this Campaign.
{ # Container for third party reach integration data for Campaign.
"reachIntegrationPartner": "A String", # Allowed third party integration partners for reach verification.
"reachIntegrationPartnerData": { # Contains third party measurement partner related data for video campaigns. # Third party partner data for YouTube Reach verification. This is optional metadata for partners to join or attach data to Ads campaigns.
"clientId": "A String", # The client ID that allows the measurement partner to join multiple campaigns for a particular advertiser.
"thirdPartyPlacementId": "A String", # The third party placement ID that maps the measurement partner data with a campaign (or a group of related campaigns) specific data.
},
"shareCost": True or False, # If true, then cost data will be shared with this vendor.
},
],
"viewabilityIntegrationPartners": [ # Third party integration partners for YouTube viewability verification for this Campaign.
{ # Container for third party viewability integration data for Campaign.
"shareCost": True or False, # If true, then cost data will be shared with this vendor.
"viewabilityIntegrationPartner": "A String", # Allowed third party integration partners for YouTube viewability verification.
"viewabilityIntegrationPartnerData": { # Contains third party measurement partner related data for video campaigns. # Third party partner data for YouTube viewability verification. This is optional metadata for partners to join or attach data to Ads campaigns.
"clientId": "A String", # The client ID that allows the measurement partner to join multiple campaigns for a particular advertiser.
"thirdPartyPlacementId": "A String", # The third party placement ID that maps the measurement partner data with a campaign (or a group of related campaigns) specific data.
},
},
],
},
"trackingSetting": { # Campaign-level settings for tracking information. # Output only. Campaign-level settings for tracking information.
"trackingUrl": "A String", # Output only. The url used for dynamic tracking.
},
"trackingUrlTemplate": "A String", # The URL template for constructing a tracking URL.
"travelCampaignSettings": { # Settings for Travel campaign. # Settings for Travel campaign.
"travelAccountId": "A String", # Immutable. The Travel account ID associated with the Travel campaign.
},
"urlCustomParameters": [ # The list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
{ # A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.
"key": "A String", # The key matching the parameter tag name.
"value": "A String", # The value to be substituted.
},
],
"vanityPharma": { # Describes how unbranded pharma ads will be displayed. # Describes how unbranded pharma ads will be displayed.
"vanityPharmaDisplayUrlMode": "A String", # The display mode for vanity pharma URLs.
"vanityPharmaText": "A String", # The text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs.
},
"videoBrandSafetySuitability": "A String", # Brand Safety setting at the individual campaign level. Allows for selecting an inventory type to show your ads on content that is the right fit for your brand. See https://support.google.com/google-ads/answer/7515513.
},
"resourceName": "A String", # Returned for successful operations.
},
"campaignSharedSetResult": { # The result for the campaign shared set mutate. # The result for the campaign shared set mutate.
"campaignSharedSet": { # CampaignSharedSets are used for managing the shared sets associated with a campaign. # The mutated campaign shared set with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"campaign": "A String", # Immutable. The campaign to which the campaign shared set belongs.
"resourceName": "A String", # Immutable. The resource name of the campaign shared set. Campaign shared set resource names have the form: `customers/{customer_id}/campaignSharedSets/{campaign_id}~{shared_set_id}`
"sharedSet": "A String", # Immutable. The shared set associated with the campaign. This may be a negative keyword shared set of another customer. This customer should be a manager of the other customer, otherwise the campaign shared set will exist but have no serving effect. Only negative keyword shared sets can be associated with Shopping campaigns. Only negative placement shared sets can be associated with Display mobile app campaigns.
"status": "A String", # Output only. The status of this campaign shared set. Read only.
},
"resourceName": "A String", # Returned for successful operations.
},
"conversionActionResult": { # The result for the conversion action mutate. # The result for the conversion action mutate.
"conversionAction": { # A conversion action. # The mutated conversion action with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"appId": "A String", # App ID for an app conversion action.
"attributionModelSettings": { # Settings related to this conversion action's attribution model. # Settings related to this conversion action's attribution model.
"attributionModel": "A String", # The attribution model type of this conversion action.
"dataDrivenModelStatus": "A String", # Output only. The status of the data-driven attribution model for the conversion action.
},
"category": "A String", # The category of conversions reported for this conversion action.
"clickThroughLookbackWindowDays": "A String", # The maximum number of days that may elapse between an interaction (for example, a click) and a conversion event.
"countingType": "A String", # How to count conversion events for the conversion action.
"creationTime": "A String", # Output only. Timestamp of the Floodlight activity's creation, formatted in ISO 8601.
"firebaseSettings": { # Settings related to a Firebase conversion action. # Output only. Firebase settings for Firebase conversion types.
"eventName": "A String", # Output only. The event name of a Firebase conversion.
"projectId": "A String", # Output only. The Firebase project ID of the conversion.
"propertyId": "A String", # Output only. The GA property ID of the conversion.
"propertyName": "A String", # Output only. The GA property name of the conversion.
},
"floodlightSettings": { # Settings related to a Floodlight conversion action. # Output only. Floodlight settings for Floodlight conversion types.
"activityGroupTag": "A String", # Output only. String used to identify a Floodlight activity group when reporting conversions.
"activityId": "A String", # Output only. ID of the Floodlight activity in DoubleClick Campaign Manager (DCM).
"activityTag": "A String", # Output only. String used to identify a Floodlight activity when reporting conversions.
},
"googleAnalytics4Settings": { # Settings related to a Google Analytics 4 conversion action. # Output only. Google Analytics 4 settings for Google Analytics 4 conversion types.
"eventName": "A String", # Output only. The name of the GA 4 event.
"propertyId": "A String", # Output only. The ID of the GA 4 property.
"propertyName": "A String", # Output only. The name of the GA 4 property.
},
"id": "A String", # Output only. The ID of the conversion action.
"includeInClientAccountConversionsMetric": True or False, # Whether this conversion action should be included in the "client_account_conversions" metric.
"includeInConversionsMetric": True or False, # Output only. Whether this conversion action should be included in the "conversions" metric.
"mobileAppVendor": "A String", # Output only. Mobile app vendor for an app conversion action.
"name": "A String", # The name of the conversion action. This field is required and should not be empty when creating new conversion actions.
"origin": "A String", # Output only. The conversion origin of this conversion action.
"ownerCustomer": "A String", # Output only. The resource name of the conversion action owner customer, or null if this is a system-defined conversion action.
"phoneCallDurationSeconds": "A String", # 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.
"primaryForGoal": True or False, # 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.
"resourceName": "A String", # Immutable. The resource name of the conversion action. Conversion action resource names have the form: `customers/{customer_id}/conversionActions/{conversion_action_id}`
"status": "A String", # The status of this conversion action for conversion event accrual.
"tagSnippets": [ # Output only. The snippets used for tracking conversions.
{ # The site tag and event snippet pair for a TrackingCodeType.
"eventSnippet": "A String", # The event snippet that works with the site tag to track actions that should be counted as conversions.
"globalSiteTag": "A String", # The site tag that adds visitors to your basic remarketing lists and sets new cookies on your domain.
"pageFormat": "A String", # The format of the web page where the tracking tag and snippet will be installed, for example, HTML.
"type": "A String", # The type of the generated tag snippets for tracking conversions.
},
],
"thirdPartyAppAnalyticsSettings": { # Settings related to a third party app analytics conversion action. # Output only. Third Party App Analytics settings for third party conversion types.
"eventName": "A String", # Output only. The event name of a third-party app analytics conversion.
"providerName": "A String", # Output only. Name of the third-party app analytics provider.
},
"type": "A String", # Immutable. The type of this conversion action.
"valueSettings": { # Settings related to the value for conversion events associated with this conversion action. # Settings related to the value for conversion events associated with this conversion action.
"alwaysUseDefaultValue": True or False, # 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": "A 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.
"defaultValue": 3.14, # 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.
},
"viewThroughLookbackWindowDays": "A String", # The maximum number of days which may elapse between an impression and a conversion without an interaction.
},
"resourceName": "A String", # Returned for successful operations.
},
"conversionCustomVariableResult": { # The result for the conversion custom variable mutate. # The result for the conversion custom variable mutate.
"conversionCustomVariable": { # A conversion custom variable. See "About custom Floodlight metrics and dimensions in the new Search Ads 360" at https://support.google.com/sa360/answer/13567857 # The mutated conversion custom variable with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"cardinality": "A String", # Output only. Cardinality of the conversion custom variable.
"customColumnIds": [ # Output only. The IDs of custom columns that use this conversion custom variable.
"A String",
],
"family": "A String", # Output only. Family of the conversion custom variable.
"floodlightConversionCustomVariableInfo": { # Information for Search Ads 360 Floodlight Conversion Custom Variables. # Output only. Fields for Search Ads 360 floodlight conversion custom variables.
"floodlightVariableDataType": "A String", # Output only. Floodlight variable data type defined in Search Ads 360.
"floodlightVariableType": "A String", # Output only. Floodlight variable type defined in Search Ads 360.
},
"id": "A String", # Output only. The ID of the conversion custom variable.
"name": "A String", # Required. The name of the conversion custom variable. Name should be unique. The maximum length of name is 100 characters. There should not be any extra spaces before and after.
"ownerCustomer": "A String", # Output only. The resource name of the customer that owns the conversion custom variable.
"resourceName": "A String", # Immutable. The resource name of the conversion custom variable. Conversion custom variable resource names have the form: `customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}`
"status": "A String", # The status of the conversion custom variable for conversion event accrual.
"tag": "A String", # Required. Immutable. The tag of the conversion custom variable. Tag should be unique and consist of a "u" character directly followed with a number less than ormequal to 100. For example: "u4".
},
"resourceName": "A String", # Returned for successful operations.
},
"conversionGoalCampaignConfigResult": { # The result for the conversion goal campaign config mutate. # The result for the conversion goal campaign config mutate.
"conversionGoalCampaignConfig": { # Conversion goal settings for a Campaign. # The mutated ConversionGoalCampaignConfig with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"campaign": "A String", # Immutable. The campaign with which this conversion goal campaign config is associated.
"customConversionGoal": "A String", # The custom conversion goal the campaign is using for optimization.
"goalConfigLevel": "A String", # The level of goal config the campaign is using.
"resourceName": "A String", # Immutable. The resource name of the conversion goal campaign config. Conversion goal campaign config resource names have the form: `customers/{customer_id}/conversionGoalCampaignConfigs/{campaign_id}`
"searchAds360CustomConversionGoal": "A String", # The Search Ads 360 custom conversion goal the campaign is using for optimization.
"searchAds360GoalConfigLevel": "A String", # The level of Search Ads 360 goal config the campaign is using.
},
"resourceName": "A String", # Returned for successful operations.
},
"conversionValueRuleResult": { # The result for the conversion value rule mutate. # The result for the conversion value rule mutate.
"conversionValueRule": { # A conversion value rule # The mutated conversion value rule with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"action": { # Action applied when rule is applied. # Action applied when the rule is triggered.
"operation": "A String", # Specifies applied operation.
"value": 3.14, # Specifies applied value.
},
"audienceCondition": { # Condition on Audience dimension. # Condition for audience that must be satisfied for the value rule to apply.
"userInterests": [ # User Interests.
"A String",
],
"userLists": [ # User Lists.
"A String",
],
},
"deviceCondition": { # Condition on Device dimension. # Condition for device type that must be satisfied for the value rule to apply.
"deviceTypes": [ # Value for device type condition.
"A String",
],
},
"geoLocationCondition": { # Condition on Geo dimension. # Condition for Geo location that must be satisfied for the value rule to apply.
"excludedGeoMatchType": "A String", # Excluded Geo location match type.
"excludedGeoTargetConstants": [ # Geo locations that advertisers want to exclude.
"A String",
],
"geoMatchType": "A String", # Included Geo location match type.
"geoTargetConstants": [ # Geo locations that advertisers want to include.
"A String",
],
},
"id": "A String", # Output only. The ID of the conversion value rule.
"itineraryCondition": { # Condition on Itinerary dimension. # Condition for itinerary that must be satisfied for the value rule to apply.
"advanceBookingWindow": { # Range for the number of days between the date of the booking and the start of the itinerary. # Range for the number of days between the date of the booking and the start of the itinerary.
"maxDays": 42, # Maximum number of days between the date of the booking the start date.
"minDays": 42, # Minimum number of days between the date of the booking the start date.
},
"travelLength": { # Range for the itinerary length in number of nights. # Range for the itinerary length in number of nights.
"maxNights": 42, # Maximum number of days between the start date and the end date.
"minNights": 42, # Minimum number of nights between the start date and the end date.
},
"travelStartDay": { # The days of the week on which an itinerary's travel can start. # The days of the week on which this itinerary's travel can start.
"friday": True or False, # The travel can start on Friday.
"monday": True or False, # The travel can start on Monday.
"saturday": True or False, # The travel can start on Saturday.
"sunday": True or False, # The travel can start on Sunday.
"thursday": True or False, # The travel can start on Thursday.
"tuesday": True or False, # The travel can start on Tuesday.
"wednesday": True or False, # The travel can start on Wednesday.
},
},
"ownerCustomer": "A 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 **
"resourceName": "A 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}`
"status": "A String", # The status of the conversion value rule.
},
"resourceName": "A String", # Returned for successful operations.
},
"conversionValueRuleSetResult": { # The result for the conversion value rule set mutate. # The result for the conversion value rule set mutate.
"conversionValueRuleSet": { # 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. # The mutated conversion value rule set with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"attachmentType": "A String", # Immutable. Defines the scope where the conversion value rule set is attached.
"campaign": "A String", # The resource name of the campaign when the conversion value rule set is attached to a campaign.
"conversionActionCategories": [ # Immutable. The conversion action categories of the conversion value rule set.
"A String",
],
"conversionValueRules": [ # Resource names of rules within the rule set.
"A String",
],
"dimensions": [ # 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.
"A String",
],
"id": "A String", # Output only. The ID of the conversion value rule set.
"ownerCustomer": "A 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": "A 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}`
"status": "A String", # Output only. The status of the conversion value rule set. ** Read-only **
},
"resourceName": "A String", # Returned for successful operations.
},
"customConversionGoalResult": { # The result for the custom conversion goal mutate. # The result for the custom conversion goal mutate.
"customConversionGoal": { # Custom conversion goal that can make arbitrary conversion actions biddable. # The mutated CustomConversionGoal with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"conversionActions": [ # Conversion actions that the custom conversion goal makes biddable.
"A String",
],
"id": "A String", # Immutable. The ID for this custom conversion goal.
"name": "A String", # The name for this custom conversion goal.
"resourceName": "A String", # Immutable. The resource name of the custom conversion goal. Custom conversion goal resource names have the form: `customers/{customer_id}/customConversionGoals/{goal_id}`
"status": "A String", # The status of the custom conversion goal.
},
"resourceName": "A String", # Returned for successful operations.
},
"customerAssetResult": { # The result for the customer asset mutate. # The result for the customer asset mutate.
"customerAsset": { # A link between a customer and an asset. # The mutated customer asset with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"asset": "A String", # Required. Immutable. The asset which is linked to the customer.
"fieldType": "A String", # Required. Immutable. Role that the asset takes for the customer link.
"primaryStatus": "A String", # 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.
"primaryStatusDetails": [ # Output only. Provides the details of the primary status and its associated reasons.
{ # Provides the detail of a PrimaryStatus. Each asset link has a PrimaryStatus value (e.g. NOT_ELIGIBLE, meaning not serving), and list of corroborating PrimaryStatusReasons (e.g. [ASSET_DISAPPROVED]). Each reason may have some additional details annotated with it. For instance, when the reason is ASSET_DISAPPROVED, the details field will contain additional information about the offline evaluation errors which led to the asset being disapproved.
"assetDisapproved": { # Details related to AssetLinkPrimaryStatusReasonPB.ASSET_DISAPPROVED # Provides the details for AssetLinkPrimaryStatusReason.ASSET_DISAPPROVED
"offlineEvaluationErrorReasons": [ # Provides the quality evaluation disapproval reason of an asset.
"A String",
],
},
"reason": "A String", # Provides the reason of this PrimaryStatus.
"status": "A String", # Provides the PrimaryStatus of this status detail.
},
],
"primaryStatusReasons": [ # Output only. Provides a list of reasons for why an asset is not serving or not serving at full capacity.
"A String",
],
"resourceName": "A String", # Immutable. The resource name of the customer asset. CustomerAsset resource names have the form: `customers/{customer_id}/customerAssets/{asset_id}~{field_type}`
"source": "A String", # Output only. Source of the customer asset link.
"status": "A String", # Status of the customer asset.
},
"resourceName": "A String", # Returned for successful operations.
},
"customerConversionGoalResult": { # The result for the customer conversion goal mutate. # The result for the customer conversion goal mutate.
"resourceName": "A String", # Returned for successful operations.
},
"customerCustomizerResult": { # The result for the customizer attribute mutate. # The result for the customer customizer mutate.
"customerCustomizer": { # A customizer value for the associated CustomizerAttribute at the Customer level. # The mutated CustomerCustomizer with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"customizerAttribute": "A String", # Required. Immutable. The customizer attribute which is linked to the customer.
"resourceName": "A String", # Immutable. The resource name of the customer customizer. Customer customizer resource names have the form: `customers/{customer_id}/customerCustomizers/{customizer_attribute_id}`
"status": "A String", # Output only. The status of the customer customizer attribute.
"value": { # A customizer value that is referenced in customizer linkage entities like CustomerCustomizer, CampaignCustomizer, etc. # Required. The value to associate with the customizer attribute at this level. The value must be of the type specified for the CustomizerAttribute.
"stringValue": "A String", # Required. Value to insert in creative text. Customizer values of all types are stored as string to make formatting unambiguous.
"type": "A String", # 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.
},
},
"resourceName": "A String", # Returned for successful operations.
},
"customerLabelResult": { # The result for a customer label mutate. # The result for the customer label mutate.
"resourceName": "A String", # Returned for successful operations.
},
"customerNegativeCriterionResult": { # The result for the criterion mutate. # The result for the customer negative criterion mutate.
"customerNegativeCriterion": { # A negative criterion for exclusions at the customer level. # The mutated criterion with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"contentLabel": { # Content Label for category exclusion. # Immutable. ContentLabel.
"type": "A String", # Content label type, required for CREATE operations.
},
"id": "A String", # Output only. The ID of the criterion.
"ipBlock": { # 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 # Immutable. IpBlock. You can exclude up to 500 IP addresses per account.
"ipAddress": "A String", # The IP address or the CIDR block to be excluded.
},
"mobileAppCategory": { # A mobile app category criterion. # Immutable. MobileAppCategory.
"mobileAppCategoryConstant": "A String", # The mobile app category constant resource name.
},
"mobileApplication": { # A mobile application criterion. # Immutable. MobileApplication.
"appId": "A 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": "A String", # Name of this mobile application.
},
"negativeKeywordList": { # 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. # Immutable. NegativeKeywordList.
"sharedSet": "A String", # The NegativeKeywordListInfo shared set resource name.
},
"placement": { # A placement criterion. This can be used to modify bids for sites when targeting the content network. # Immutable. Placement.
"url": "A String", # URL of the placement. For example, "http://www.domain.com".
},
"placementList": { # A Placement List criterion. Represents a shared set of placements that can be excluded at the account-level. # Immutable. PlacementList.
"sharedSet": "A String", # The PlacementListInfo shared set resource name.
},
"resourceName": "A String", # Immutable. The resource name of the customer negative criterion. Customer negative criterion resource names have the form: `customers/{customer_id}/customerNegativeCriteria/{criterion_id}`
"type": "A String", # Output only. The type of the criterion.
"youtubeChannel": { # A YouTube Channel criterion. # Immutable. YouTube Channel.
"channelId": "A String", # The YouTube uploader channel id or the channel code of a YouTube channel.
},
"youtubeVideo": { # A YouTube Video criterion. # Immutable. YouTube Video.
"videoId": "A String", # YouTube video id as it appears on the YouTube watch page.
},
},
"resourceName": "A String", # Returned for successful operations.
},
"customerResult": { # The result for the customer mutate. # The result for the customer mutate.
"customer": { # A customer. # The mutated customer with only mutable fields after mutate. The fields will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"accountLevel": "A String", # Output only. The account level of the customer: Manager, Sub-manager, Associate manager, Service account.
"accountStatus": "A String", # Output only. Account status, for example, Enabled, Paused, Removed, etc.
"accountType": "A String", # Output only. Engine account type, for example, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track, etc.
"associateManagerDescriptiveName": "A String", # Output only. The descriptive name of the associate manager.
"associateManagerId": "A String", # Output only. The customer ID of the associate manager. A 0 value indicates that the customer has no SA360 associate manager.
"autoTaggingEnabled": True or False, # Whether auto-tagging is enabled for the customer.
"callReportingSetting": { # Call reporting setting for a customer. # Call reporting setting for a customer.
"callConversionAction": "A String", # Customer-level call conversion action to attribute a call conversion to. If not set a default conversion action is used. Only in effect when call_conversion_reporting_enabled is set to true.
"callConversionReportingEnabled": True or False, # Whether to enable call conversion reporting.
"callReportingEnabled": True or False, # Enable reporting of phone call events by redirecting them through Google System.
},
"containsEuPoliticalAdvertising": "A String", # Output only. Returns the advertiser self-declaration status of whether this customer contains political advertising content targeted towards the European Union. You can use the Google Ads UI to update this account-level declaration, or use the API to update the self-declaration status of individual campaigns.
"conversionTrackingSetting": { # A collection of customer-wide settings related to Search Ads 360 Conversion Tracking. # Conversion tracking setting for a customer.
"acceptedCustomerDataTerms": True or False, # Output only. Whether the customer has accepted customer data terms. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. For more information, see https://support.google.com/adspolicy/answer/7475709.
"conversionTrackingId": "A String", # Output only. The conversion tracking id used for this account. This id doesn't indicate whether the customer uses conversion tracking (conversion_tracking_status does). This field is read-only.
"conversionTrackingStatus": "A String", # Output only. Conversion tracking status. It indicates whether the customer is using conversion tracking, and who is the conversion tracking owner of this customer. If this customer is using cross-account conversion tracking, the value returned will differ based on the `login-customer-id` of the request.
"crossAccountConversionTrackingId": "A String", # Output only. The conversion tracking id of the customer's manager. This is set when the customer is opted into cross-account conversion tracking, and it overrides conversion_tracking_id.
"enhancedConversionsForLeadsEnabled": True or False, # Output only. Whether the customer is opted-in for enhanced conversions for leads. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only.
"googleAdsConversionCustomer": "A String", # The resource name of the customer where conversions are created and managed. This field is read-only.
"googleAdsCrossAccountConversionTrackingId": "A String", # Output only. The conversion tracking id of the customer's manager. This is set when the customer is opted into conversion tracking, and it overrides conversion_tracking_id. This field can only be managed through the Google Ads UI. This field is read-only.
},
"creationTime": "A String", # Output only. The timestamp when this customer was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
"currencyCode": "A String", # Immutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
"customerAgreementSetting": { # Customer Agreement Setting for a customer. # Output only. Customer Agreement Setting for a customer.
"acceptedLeadFormTerms": True or False, # Output only. Whether the customer has accepted lead form term of service.
},
"descriptiveName": "A String", # Optional, non-unique descriptive name of the customer.
"doubleClickCampaignManagerSetting": { # DoubleClick Campaign Manager (DCM) setting for a manager customer. # Output only. DoubleClick Campaign Manager (DCM) setting for a manager customer.
"advertiserId": "A String", # Output only. ID of the Campaign Manager advertiser associated with this customer.
"networkId": "A String", # Output only. ID of the Campaign Manager network associated with this customer.
"timeZone": "A String", # Output only. Time zone of the Campaign Manager network associated with this customer in IANA Time Zone Database format, such as America/New_York.
},
"engineId": "A String", # Output only. ID of the account in the external engine account.
"finalUrlSuffix": "A String", # The URL template for appending params to the final URL.
"hasPartnersBadge": True or False, # Output only. Whether the Customer has a Partners program badge. If the Customer is not associated with the Partners program, this will be false. For more information, see https://support.google.com/partners/answer/3125774.
"id": "A String", # Output only. The ID of the customer.
"imageAssetAutoMigrationDone": True or False, # Output only. True if feed based image has been migrated to asset based image.
"imageAssetAutoMigrationDoneDateTime": "A String", # Output only. Timestamp of migration from feed based image to asset base image in yyyy-MM-dd HH:mm:ss format.
"lastModifiedTime": "A String", # Output only. The datetime when this customer was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
"localServicesSettings": { # Settings for Local Services customer. # Output only. Settings for Local Services customer.
"granularInsuranceStatuses": [ # Output only. A read-only list of geo vertical level insurance statuses.
{ # Insurance status at geo + vertical level.
"categoryId": "A String", # Output only. Service category associated with the status. For example, xcat:service_area_business_plumber. For more details see: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
"geoCriterionId": "A String", # Output only. Geotarget criterion ID associated with the status. Can be on country or state/province geo level, depending on requirements and location. See https://developers.google.com/google-ads/api/data/geotargets for more information.
"verificationStatus": "A String", # Output only. Granular insurance status, per geo + vertical.
},
],
"granularLicenseStatuses": [ # Output only. A read-only list of geo vertical level license statuses.
{ # License status at geo + vertical level.
"categoryId": "A String", # Output only. Service category associated with the status. For example, xcat:service_area_business_plumber. For more details see: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
"geoCriterionId": "A String", # Output only. Geotarget criterion ID associated with the status. Can be on country or state/province geo level, depending on requirements and location. See https://developers.google.com/google-ads/api/data/geotargets for more information.
"verificationStatus": "A String", # Output only. Granular license status, per geo + vertical.
},
],
},
"locationAssetAutoMigrationDone": True or False, # Output only. True if feed based location has been migrated to asset based location.
"locationAssetAutoMigrationDoneDateTime": "A String", # Output only. Timestamp of migration from feed based location to asset base location in yyyy-MM-dd HH:mm:ss format.
"manager": True or False, # Output only. Whether the customer is a manager.
"managerDescriptiveName": "A String", # Output only. The descriptive name of the manager.
"managerId": "A String", # Output only. The customer ID of the manager. A 0 value indicates that the customer has no SA360 manager.
"optimizationScore": 3.14, # Output only. Optimization score of the customer. Optimization score is an estimate of how well a customer's campaigns are set to perform. It ranges from 0% (0.0) to 100% (1.0). This field is null for all manager customers, and for unscored non-manager customers. See "About optimization score" at https://support.google.com/google-ads/answer/9061546. This field is read-only.
"optimizationScoreWeight": 3.14, # Output only. Optimization score weight of the customer. Optimization score weight can be used to compare/aggregate optimization scores across multiple non-manager customers. The aggregate optimization score of a manager is computed as the sum over all of their customers of `Customer.optimization_score * Customer.optimization_score_weight`. This field is 0 for all manager customers, and for unscored non-manager customers. This field is read-only.
"payPerConversionEligibilityFailureReasons": [ # Output only. Reasons why the customer is not eligible to use PaymentMode.CONVERSIONS. If the list is empty, the customer is eligible. This field is read-only.
"A String",
],
"remarketingSetting": { # Remarketing setting for a customer. # Output only. Remarketing setting for a customer.
"googleGlobalSiteTag": "A String", # Output only. The Google tag.
},
"resourceName": "A String", # Immutable. The resource name of the customer. Customer resource names have the form: `customers/{customer_id}`
"status": "A String", # Output only. The status of the customer.
"subManagerDescriptiveName": "A String", # Output only. The descriptive name of the sub manager.
"subManagerId": "A String", # Output only. The customer ID of the sub manager. A 0 value indicates that the customer has no sub SA360 manager.
"testAccount": True or False, # Output only. Whether the customer is a test account.
"timeZone": "A String", # Immutable. The local timezone ID of the customer.
"trackingUrlTemplate": "A String", # The URL template for constructing a tracking URL out of parameters.
"videoBrandSafetySuitability": "A String", # Brand Safety setting at the account level. Allows for selecting an inventory type to show your ads on content that is the right fit for your brand. See https://support.google.com/google-ads/answer/7515513.
"videoCustomer": { # Video specific information about a Customer. # Video specific information about a Customer.
"thirdPartyIntegrationPartners": { # Container for Customer level third party integration partners. # Third Party integration partners.
"brandLiftIntegrationPartners": [ # Allowed third party integration partners for Brand Lift verification.
{ # Container for third party Brand Lift integration data for Customer.
"allowShareCost": True or False, # If true, cost data can be shared with this vendor.
"brandLiftIntegrationPartner": "A String", # Allowed Third Party integration partners for Brand Lift verification.
},
],
"brandSafetyIntegrationPartners": [ # Allowed third party integration partners for brand safety verification.
{ # Container for third party brand safety integration data for Customer.
"brandSafetyIntegrationPartner": "A String", # Allowed third party integration partners for brand safety verification.
},
],
"reachIntegrationPartners": [ # Allowed third party integration partners for reach verification.
{ # Container for third party reach integration data for Customer.
"allowShareCost": True or False, # If true, cost data can be shared with this vendor.
"reachIntegrationPartner": "A String", # Allowed Third Party integration partners for reach verification.
},
],
"viewabilityIntegrationPartners": [ # Allowed third party integration partners for YouTube viewability verification.
{ # Container for third party viewability integration data for Customer.
"allowShareCost": True or False, # If true, cost data can be shared with this vendor.
"viewabilityIntegrationPartner": "A String", # Allowed third party integration partners for YouTube viewability verification.
},
],
},
},
},
"resourceName": "A String", # Returned for successful operations.
},
"customizerAttributeResult": { # The result for the customizer attribute mutate. # The result for the customizer attribute mutate.
"customizerAttribute": { # 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. # The mutated CustomizerAttribute with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"id": "A String", # Output only. The ID of the customizer attribute.
"name": "A 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": "A String", # Immutable. The resource name of the customizer attribute. Customizer Attribute resource names have the form: `customers/{customer_id}/customizerAttributes/{customizer_attribute_id}`
"status": "A String", # Output only. The status of the customizer attribute.
"type": "A String", # Immutable. The type of the customizer attribute.
},
"resourceName": "A String", # Returned for successful operations.
},
"experimentArmResult": { # The result for the experiment arm mutate. # The result for the experiment arm mutate.
"experimentArm": { # A Google ads experiment for users to experiment changes on multiple campaigns, compare the performance, and apply the effective changes. # The mutated experiment arm with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"assetGroups": [ # List of asset groups in the experiment arm.
{ # Holds the asset groups included in an arm of an Optimize Assets experiment.
"assetGroup": "A String", # Asset group resource name.
"assetGroupAssets": [ # List of asset group assets under the asset group.
{ # Holds the details of an asset within an asset group for an Optimize Assets experiment arm.
"asset": "A String", # Asset resource name of the asset group asset.
"fieldType": "A String", # Field type of the asset group asset.
},
],
},
],
"campaigns": [ # List of campaigns in the trial arm. The max length is one.
"A String",
],
"control": True or False, # Whether this arm is a control arm. A control arm is the arm against which the other arms are compared.
"experiment": "A String", # Immutable. The experiment to which the ExperimentArm belongs.
"inDesignCampaigns": [ # Output only. The in design campaigns in the treatment experiment arm.
"A String",
],
"name": "A String", # Required. The name of the experiment arm. It must have a minimum length of 1 and maximum length of 1024. It must be unique under an experiment.
"resourceName": "A String", # Immutable. The resource name of the experiment arm. Experiment arm resource names have the form: `customers/{customer_id}/experimentArms/{TrialArm.trial_id}~{TrialArm.trial_arm_id}`
"trafficSplit": "A String", # Traffic split of the trial arm. The value should be between 1 and 100 and must total 100 between the two trial arms.
},
"resourceName": "A String", # Returned for successful operations.
},
"experimentResult": { # The result for the campaign experiment mutate. # The result for the experiment mutate.
"resourceName": "A String", # Returned for successful operations.
},
"keywordPlanAdGroupKeywordResult": { # The result for the Keyword Plan ad group keyword mutate. # The result for the keyword plan ad group keyword mutate.
"resourceName": "A String", # Returned for successful operations.
},
"keywordPlanAdGroupResult": { # The result for the Keyword Plan ad group mutate. # The result for the keyword plan ad group mutate.
"resourceName": "A String", # Returned for successful operations.
},
"keywordPlanCampaignKeywordResult": { # The result for the Keyword Plan campaign keyword mutate. # The result for the keyword plan campaign keyword mutate.
"resourceName": "A String", # Returned for successful operations.
},
"keywordPlanCampaignResult": { # The result for the Keyword Plan campaign mutate. # The result for the keyword plan campaign mutate.
"resourceName": "A String", # Returned for successful operations.
},
"keywordPlanResult": { # The result for the keyword plan mutate. # The result for the keyword plan mutate.
"resourceName": "A String", # Returned for successful operations.
},
"labelResult": { # The result for a label mutate. # The result for the label mutate.
"label": { # A label. # The mutated label with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"id": "A String", # Output only. ID of the label. Read only.
"name": "A String", # The name of the label. This field is required and should not be empty when creating a new label. The length of this string should be between 1 and 80, inclusive.
"resourceName": "A String", # Immutable. Name of the resource. Label resource names have the form: `customers/{owner_customer_id}/labels/{label_id}`
"status": "A String", # Output only. Status of the label. Read only.
"textLabel": { # A type of label displaying text on a colored background. # A type of label displaying text on a colored background.
"backgroundColor": "A String", # Background color of the label in HEX format. This string must match the regular expression '^\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts.
"description": "A String", # A short description of the label. The length must be no more than 200 characters.
},
},
"resourceName": "A String", # Returned for successful operations.
},
"recommendationSubscriptionResult": { # Result message for RecommendationSubscriptionService.MutateRecommendationSubscription # The result for the recommendation subscription mutate.
"recommendationSubscription": { # Recommendation Subscription resource # The mutated recommendation subscription with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"createDateTime": "A String", # Output only. Time in seconds when the subscription was first created. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.
"modifyDateTime": "A String", # Output only. Contains the time in microseconds, when the Recommendation Subscription was last updated. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
"resourceName": "A String", # Immutable. The resource name of the recommendation subscription. `customers/{customer_id}/recommendationSubscriptions/{recommendation_type}`
"status": "A String", # Required. Status of the subscription, either enabled or paused.
"type": "A String", # Required. Immutable. The type of recommendation subscribed to.
},
"resourceName": "A String", # Resource name of the subscription that was modified.
},
"remarketingActionResult": { # The result for the remarketing action mutate. # The result for the remarketing action mutate.
"resourceName": "A String", # Returned for successful operations.
},
"searchAds360CampaignResult": { # The result for the Search Ads 360 campaign mutate. # The result for the Search Ads 360 campaign mutate.
"resourceName": "A String", # Returned for successful operations.
"searchAds360Campaign": { # A Search Ads 360 campaign. # The mutated Search Ads 360 campaign with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"productAttributionFilterType": "A String", # The type of product attribution filtering to apply to this campaign.
"resourceName": "A String", # Immutable. The resource name of the Search Ads 360 campaign. Search Ads 360 campaign resource names have the form: `customers/{customer_id}/searchAds360Campaigns/{campaign_id}`
},
},
"sharedCriterionResult": { # The result for the shared criterion mutate. # The result for the shared criterion mutate.
"resourceName": "A String", # Returned for successful operations.
"sharedCriterion": { # A criterion belonging to a shared set. # The mutated shared criterion with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"brand": { # Represents a Brand Criterion used for targeting based on commercial knowledge graph. # Immutable. Brand.
"displayName": "A String", # Output only. A text representation of a brand.
"entityId": "A String", # The Commercial KG MID for the brand.
"primaryUrl": "A String", # Output only. The primary url of a brand.
"rejectionReason": "A String", # Output only. The rejection reason when a brand status is REJECTED.
"status": "A String", # Output only. The status of a brand.
},
"criterionId": "A String", # Output only. The ID of the criterion. This field is ignored for mutates.
"keyword": { # A keyword criterion. # Immutable. Keyword.
"matchType": "A String", # The match type of the keyword.
"text": "A String", # The text of the keyword (at most 80 characters and 10 words).
},
"mobileAppCategory": { # A mobile app category criterion. # Immutable. Mobile App Category.
"mobileAppCategoryConstant": "A String", # The mobile app category constant resource name.
},
"mobileApplication": { # A mobile application criterion. # Immutable. Mobile application.
"appId": "A 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": "A String", # Name of this mobile application.
},
"negative": True or False, # Immutable. If true, the criterion is excluded. If false, the criterion is targeted.
"placement": { # A placement criterion. This can be used to modify bids for sites when targeting the content network. # Immutable. Placement.
"url": "A String", # URL of the placement. For example, "http://www.domain.com".
},
"resourceName": "A String", # Immutable. The resource name of the shared criterion. Shared set resource names have the form: `customers/{customer_id}/sharedCriteria/{shared_set_id}~{criterion_id}`
"sharedSet": "A String", # Immutable. The shared set to which the shared criterion belongs.
"type": "A String", # Output only. The type of the criterion.
"verticalAdsItemGroupRule": { # A criterion to represent a single item group rule in Vertical Ads. # Immutable. Vertical ads item group rule.
"cityCriterionId": "A String", # The resource name of the Geo Target Constant for the city.
"countryCriterionId": "A String", # The resource name of the Geo Target Constant for the country.
"hotelClass": "A String", # Integer value specifying the class rating for a hotel. Ranges from 1 to 5 stars.
"itemCode": "A String", # The id specifying a particular Vertical Ad listing.
"regionCriterionId": "A String", # The resource name of the Geo Target Constant for the region.
},
"webpage": { # Represents a criterion for targeting webpages of an advertiser's website. # Immutable. Webpage.
"conditions": [ # 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.
{ # Logical expression for targeting webpages of an advertiser's website.
"argument": "A String", # Argument of webpage targeting condition.
"operand": "A String", # Operand of webpage targeting condition.
"operator": "A String", # Operator of webpage targeting condition.
},
],
"coveragePercentage": 3.14, # 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.
"criterionName": "A 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.
"sample": { # List of sample urls that match the website target # List of sample urls that match the website target. This field is read-only.
"sampleUrls": [ # Webpage sample urls
"A String",
],
},
},
"youtubeChannel": { # A YouTube Channel criterion. # Immutable. YouTube Channel.
"channelId": "A String", # The YouTube uploader channel id or the channel code of a YouTube channel.
},
"youtubeVideo": { # A YouTube Video criterion. # Immutable. YouTube Video.
"videoId": "A String", # YouTube video id as it appears on the YouTube watch page.
},
},
},
"sharedSetResult": { # The result for the shared set mutate. # The result for the shared set mutate.
"resourceName": "A String", # Returned for successful operations.
"sharedSet": { # SharedSets are used for sharing criterion exclusions across multiple campaigns. # The mutated shared set with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"id": "A String", # Output only. The ID of this shared set. Read only.
"memberCount": "A String", # Output only. The number of shared criteria within this shared set. Read only.
"name": "A String", # The name of this shared set. Required. Shared Sets must have names that are unique among active shared sets of the same type. The length of this string should be between 1 and 255 UTF-8 bytes, inclusive.
"referenceCount": "A String", # Output only. The number of campaigns associated with this shared set. Read only.
"resourceName": "A String", # Immutable. The resource name of the shared set. Shared set resource names have the form: `customers/{customer_id}/sharedSets/{shared_set_id}`
"status": "A String", # Output only. The status of this shared set. Read only.
"type": "A String", # Immutable. The type of this shared set: each shared set holds only a single kind of resource. Required. Immutable.
"verticalAdsItemVerticalType": "A String", # Immutable. Shared sets of type VERTICAL_ADS_ITEM_GROUP_RULE_LIST are associated with a particular vertical (e.g. hotels, things to do, flights, etc.). This field is required for shared sets of type VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
},
},
"smartCampaignSettingResult": { # The result for the Smart campaign setting mutate. # The result for the Smart campaign setting mutate.
"resourceName": "A String", # Returned for successful operations.
"smartCampaignSetting": { # Settings for configuring Smart campaigns. # The mutated Smart campaign setting with only mutable fields after mutate. The field will only be returned when response_content_type is set to "MUTABLE_RESOURCE".
"adOptimizedBusinessProfileSetting": { # Settings for configuring a business profile optimized for ads as this campaign's landing page. # Settings for configuring a business profile optimized for ads as this campaign's landing page. This campaign must be linked to a business profile to use this option. For more information on this feature, consult https://support.google.com/google-ads/answer/9827068.
"includeLeadForm": True or False, # 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.
},
"advertisingLanguageCode": "A 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).
"businessName": "A String", # The name of the business.
"businessProfileLocation": "A 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.
"campaign": "A String", # Output only. The campaign to which these settings apply.
"finalUrl": "A String", # The user-provided landing page URL for this Campaign.
"phoneNumber": { # Phone number and country code in smart campaign settings. # Phone number and country code.
"countryCode": "A String", # Upper-case, two-letter country code as defined by ISO-3166.
"phoneNumber": "A String", # Phone number of the smart campaign.
},
"resourceName": "A String", # Immutable. The resource name of the Smart campaign setting. Smart campaign setting resource names have the form: `customers/{customer_id}/smartCampaignSettings/{campaign_id}`
},
},
"userListResult": { # The result for the user list mutate. # The result for the user list mutate.
"resourceName": "A String", # Returned for successful operations.
},
},
"operationIndex": "A String", # Index of the mutate operation.
"status": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Details of the errors when processing the operation.
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
"details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
"message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
},
},
],
}

listResults_next()

Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call 'execute()' on to request the next
          page. Returns None if there are no more items in the collection.

mutate(customerId, body=None, x__xgafv=None)

Mutates a batch job. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [HeaderError]() [InternalError]() [QuotaError]() [RequestError]() [ResourceCountLimitExceededError]()

Args:
customerId: string, Required. The ID of the customer for which to create a batch job. (required)
body: object, The request body.
The object takes the form of:

{ # Request message for BatchJobService.MutateBatchJob.
"operation": { # A single operation on a batch job. # Required. The operation to perform on an individual batch job.
"create": { # A list of mutates being processed asynchronously. The mutates are uploaded by the user. The mutates themselves aren't readable and the results of the job can only be read using BatchJobService.ListBatchJobResults. # Create operation: No resource name is expected for the new batch job.
"id": "A String", # Output only. ID of this batch job.
"longRunningOperation": "A String", # Output only. The resource name of the long-running operation that can be used to poll for completion. Only set when the batch job status is RUNNING or DONE.
"metadata": { # Additional information about the batch job. This message is also used as metadata returned in batch job Long Running Operations. # Output only. Contains additional information about this batch job.
"completionDateTime": "A String", # Output only. The time when this batch job was completed. Formatted as yyyy-MM-dd HH:mm:ss. Example: "2018-03-05 09:16:00"
"creationDateTime": "A String", # Output only. The time when this batch job was created. Formatted as yyyy-mm-dd hh:mm:ss. Example: "2018-03-05 09:15:00"
"estimatedCompletionRatio": 3.14, # Output only. The fraction (between 0.0 and 1.0) of mutates that have been processed. This is empty if the job hasn't started running yet.
"executedOperationCount": "A String", # Output only. The number of mutate operations executed by the batch job. Present only if the job has started running.
"executionLimitSeconds": 42, # Immutable. The approximate upper bound for how long a batch job can be executed, in seconds. If the job runs more than the given upper bound, the job will be canceled.
"operationCount": "A String", # Output only. The number of mutate operations in the batch job.
"startDateTime": "A String", # Output only. The time when this batch job started running. Formatted as yyyy-mm-dd hh:mm:ss. Example: "2018-03-05 09:15:30"
},
"nextAddSequenceToken": "A String", # Output only. The next sequence token to use when adding operations. Only set when the batch job status is PENDING.
"resourceName": "A String", # Immutable. The resource name of the batch job. Batch job resource names have the form: `customers/{customer_id}/batchJobs/{batch_job_id}`
"status": "A String", # Output only. Status of this batch job.
},
"remove": "A String", # Remove operation: The batch job must not have been run. A resource name for the removed batch job is expected, in this format: `customers/{customer_id}/batchJobs/{batch_job_id}`
},
}

x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format

Returns:
An object of the form:

{ # Response message for BatchJobService.MutateBatchJob.
"result": { # The result for the batch job mutate. # The result for the mutate.
"resourceName": "A String", # The resource name of the batch job.
},
}

run(resourceName, body=None, x__xgafv=None)

Runs the batch job. The Operation.metadata field type is BatchJobMetadata. When finished, the long running operation will not contain errors or a response. Instead, use ListBatchJobResults to get the results of the job. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [BatchJobError]() [HeaderError]() [InternalError]() [QuotaError]() [RequestError]()

Args:
  resourceName: string, Required. The resource name of the BatchJob to run. (required)
  body: object, The request body.
    The object takes the form of:

{ # Request message for BatchJobService.RunBatchJob.
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # This resource represents a long-running operation that is the result of a network API call.
  "done": True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
  "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
    "code": 42, # The status code, which should be an enum value of google.rpc.Code.
    "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
      {
        "a_key": "", # Properties of the object. Contains field @type with type URL.
      },
    ],
    "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
  },
  "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
    "a_key": "", # Properties of the object. Contains field @type with type URL.
  },
  "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
  "response": { # The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
    "a_key": "", # Properties of the object. Contains field @type with type URL.
  },
}

Search Ads 360 Reporting API . customers . batchJobs

Instance Methods

Method Details