shared_criterion

Help me build a query Proto definition

A criterion belonging to a shared set.

Attributed resources
customer
mobile_app_category_constant
shared_set

Fields from the above resources may be selected along with this resource in your SELECT and WHERE clauses. These fields will not segment metrics in your SELECT clause.

shared_criterion.brand.display_name Field description Output only. A text representation of a brand. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.brand.entity_id Field description The Commercial KG MID for the brand. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.brand.primary_url Field description Output only. The primary url of a brand. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable False Repeated False

shared_criterion.brand.rejection_reason Field description Output only. The rejection reason when a brand status is REJECTED. Category ATTRIBUTE Data Type ENUM EXISTING_BRAND EXISTING_BRAND_VARIANT INCORRECT_INFORMATION NOT_A_BRAND UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v24.enums.BrandRequestRejectionReasonEnum.BrandRequestRejectionReason Filterable True Selectable True Sortable True Repeated False

shared_criterion.brand.status Field description Output only. The status of a brand. Category ATTRIBUTE Data Type ENUM APPROVED CANCELLED DEPRECATED ENABLED REJECTED UNKNOWN UNSPECIFIED UNVERIFIED Type URL google.ads.googleads.v24.enums.BrandStateEnum.BrandState Filterable True Selectable True Sortable True Repeated False

shared_criterion.criterion_id Field description Output only. The ID of the criterion. This field is ignored for mutates. Category ATTRIBUTE Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.keyword.match_type Field description The match type of the keyword. Category ATTRIBUTE Data Type ENUM BROAD EXACT PHRASE UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v24.enums.KeywordMatchTypeEnum.KeywordMatchType Filterable True Selectable True Sortable True Repeated False

shared_criterion.keyword.text Field description The text of the keyword (at most 80 characters and 10 words). Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.mobile_app_category.mobile_app_category_constant Field description The mobile app category constant resource name. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

shared_criterion.mobile_application.app_id Field description 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. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.mobile_application.name Field description Name of this mobile application. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.negative Field description Immutable. If true, the criterion is excluded. If false, the criterion is targeted. Category ATTRIBUTE Data Type BOOLEAN Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.placement.url Field description URL of the placement. For example, "http://www.domain.com". Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.resource_name Field description Immutable. The resource name of the shared criterion. Shared set resource names have the form: customers/{customer_id}/sharedCriteria/{shared_set_id}~{criterion_id} Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

shared_criterion.retail_filter.expression.name Field description The name of the expression. This name is used for grouping Retail Tags into one logical expression with OR operator. The name can contain at most 20 characters. Only lowercase latin letters, underscores, and numbers are allowed. This field is required and must be unique within the shared set. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.retail_filter.tag.expression_name Field description The name of the expression this tag belongs to. If empty, the tag is a top-level condition. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.retail_filter.tag.value Field description The value of the tag. It can contain at most 50 characters. All Unicode characters except comma and newline are allowed. This field is required. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.shared_set Field description Immutable. The shared set to which the shared criterion belongs. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

shared_criterion.type Field description Output only. The type of the criterion. Category ATTRIBUTE Data Type ENUM AD_SCHEDULE AGE_RANGE APP_PAYMENT_MODEL AUDIENCE BRAND BRAND_LIST CARRIER COMBINED_AUDIENCE CONTENT_LABEL CUSTOM_AFFINITY CUSTOM_AUDIENCE CUSTOM_INTENT DEVICE GENDER INCOME_RANGE IP_BLOCK KEYWORD KEYWORD_THEME LANGUAGE LIFE_EVENT LISTING_GROUP LISTING_SCOPE LOCAL_SERVICE_ID LOCATION LOCATION_GROUP MOBILE_APPLICATION MOBILE_APP_CATEGORY MOBILE_DEVICE NEGATIVE_KEYWORD_LIST OPERATING_SYSTEM_VERSION PARENTAL_STATUS PLACEMENT PLACEMENT_LIST PROXIMITY RETAIL_FILTER RETAIL_FILTER_BUNDLE SEARCH_THEME TOPIC UNKNOWN UNSPECIFIED USER_INTEREST USER_LIST VERTICAL_ADS_ITEM_GROUP_RULE VERTICAL_ADS_ITEM_GROUP_RULE_LIST VIDEO_LINEUP WEBPAGE WEBPAGE_LIST YOUTUBE_CHANNEL YOUTUBE_VIDEO Type URL google.ads.googleads.v24.enums.CriterionTypeEnum.CriterionType Filterable True Selectable True Sortable True Repeated False

shared_criterion.vertical_ads_item_group_rule.city_criterion_id Field description The resource name of the Geo Target Constant for the city. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

shared_criterion.vertical_ads_item_group_rule.country_criterion_id Field description The resource name of the Geo Target Constant for the country. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

shared_criterion.vertical_ads_item_group_rule.event_participant_display_name Field description The name of an associated participant for a given event. For example, headliner for a concert event. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.vertical_ads_item_group_rule.hotel_class Field description Integer value specifying the class rating for a hotel. Ranges from 1 to 5 stars. Category ATTRIBUTE Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.vertical_ads_item_group_rule.item_code Field description The id specifying a particular Vertical Ad listing. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.vertical_ads_item_group_rule.region_criterion_id Field description The resource name of the Geo Target Constant for the region. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

shared_criterion.vertical_ads_item_group_rule.user_rating Field description Integer value specifying the user rating for a Vertical Ad listing. Ranges from 1 to 5, where 5 is the best. Category ATTRIBUTE Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.vertical_ads_item_group_rule.venue Field description A name for a specific location, like the venue for a concert event. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.webpage.conditions Field description 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. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v24.common.WebpageConditionInfo Filterable False Selectable True Sortable False Repeated True

shared_criterion.webpage.coverage_percentage Field description 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. Category ATTRIBUTE Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.webpage.criterion_name Field description 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. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.webpage.sample.sample_urls Field description Webpage sample urls Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable False Repeated True

shared_criterion.youtube_channel.channel_id Field description The YouTube uploader channel id or the channel code of a YouTube channel. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

shared_criterion.youtube_video.video_id Field description YouTube video id as it appears on the YouTube watch page. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False