[](https://developers.google.com/google-ads/api/fields/v26/shared_criterion_query_builder) [](https://github.com/googleapis/googleapis/blob/master/google/ads/googleads/v26/resources/shared_criterion.proto)
A criterion belonging to a shared set.
| Attributed resources |
|---|
| [customer](https://developers.google.com/google-ads/api/fields/v26/customer) |
| [mobile_app_category_constant](https://developers.google.com/google-ads/api/fields/v26/mobile_app_category_constant) |
| [shared_set](https://developers.google.com/google-ads/api/fields/v26/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 descriptionOutput only. A text representation of a brand.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.brand.entity_id
Field descriptionThe Commercial KG MID for the brand.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.brand.primary_url
Field descriptionOutput only. The primary url of a brand.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.brand.rejection_reason
Field descriptionOutput 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`https://developers.google.com/google-ads/api/reference/rpc/v26/BrandRequestRejectionReasonEnum.BrandRequestRejectionReason` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.brand.status
Field descriptionOutput only. The status of a brand.
Category`ATTRIBUTE` Data Type `ENUM`
`APPROVED``CANCELLED``DEPRECATED``ENABLED``REJECTED``UNKNOWN``UNSPECIFIED``UNVERIFIED` Type URL`https://developers.google.com/google-ads/api/reference/rpc/v26/BrandStateEnum.BrandState` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.criterion_id
Field descriptionOutput only. The ID of the criterion.
This field is ignored for mutates.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.keyword.match_type
Field descriptionThe match type of the keyword.
Category`ATTRIBUTE` Data Type `ENUM`
`BROAD``EXACT``PHRASE``UNKNOWN``UNSPECIFIED` Type URL`https://developers.google.com/google-ads/api/reference/rpc/v26/KeywordMatchTypeEnum.KeywordMatchType` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.keyword.text
Field descriptionThe text of the keyword (at most 80 characters and 10 words).
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.mobile_app_category.mobile_app_category_constant
Field descriptionThe mobile app category constant resource name.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.mobile_application.app_id
Field descriptionA 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` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.mobile_application.name
Field descriptionName of this mobile application.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.negative
Field descriptionImmutable. If true, the criterion is excluded. If false, the criterion is
targeted.
Category`ATTRIBUTE` Data Type`BOOLEAN` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.placement.url
Field descriptionURL of the placement.
For example, "http://www.domain.com".
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.resource_name
Field descriptionImmutable. 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` FilterableTrue SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.retail_filter.expression.name
Field descriptionThe 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` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.retail_filter.tag.expression_name
Field descriptionThe 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` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.retail_filter.tag.value
Field descriptionThe 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` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.shared_set
Field descriptionImmutable. The shared set to which the shared criterion belongs.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.type
Field descriptionOutput 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_BID``VERTICAL_ADS_ITEM_GROUP_RULE``VERTICAL_ADS_ITEM_GROUP_RULE_LIST``VIDEO_LINEUP``WEBPAGE``WEBPAGE_LIST``YOUTUBE_CHANNEL``YOUTUBE_VIDEO` Type URL`https://developers.google.com/google-ads/api/reference/rpc/v26/CriterionTypeEnum.CriterionType` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.vertical_ads_item_group_rule.city_criterion_id
Field descriptionThe resource name of the Geo Target Constant for the city.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.vertical_ads_item_group_rule.country_criterion_id
Field descriptionThe resource name of the Geo Target Constant for the country.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.vertical_ads_item_group_rule.event_participant_display_name
Field descriptionThe 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` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.vertical_ads_item_group_rule.hotel_class
Field descriptionInteger value specifying the class rating for a hotel. Ranges from 1 to 5
stars.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.vertical_ads_item_group_rule.item_code
Field descriptionThe id specifying a particular Vertical Ad listing.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.vertical_ads_item_group_rule.region_criterion_id
Field descriptionThe resource name of the Geo Target Constant for the region.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.vertical_ads_item_group_rule.user_rating
Field descriptionInteger 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` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.vertical_ads_item_group_rule.venue
Field descriptionA name for a specific location, like the venue for a concert event.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.webpage.conditions
Field descriptionConditions, 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`https://developers.google.com/google-ads/api/reference/rpc/v26/WebpageConditionInfo` FilterableFalse SelectableTrue SortableFalse RepeatedTrue Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.webpage.coverage_percentage
Field descriptionWebsite 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` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.webpage.criterion_name
Field descriptionThe 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` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.webpage.sample.sample_urls
Field descriptionWebpage sample urls
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableFalse RepeatedTrue Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.youtube_channel.channel_id
Field descriptionThe YouTube uploader channel id or the channel code of a YouTube channel.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)
## shared_criterion.youtube_video.video_id
Field descriptionYouTube video id as it appears on the YouTube watch page.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[shared_criterion](https://developers.google.com/google-ads/api/fields/v26/shared_criterion)