Join us live onDiscord on the Google Advertising and Measurement Community server and onYouTube on February 26th at 11:00 AM EST! We will discuss the new features added in v23.1 of the Google Ads API.

shared_set

  • Shared Sets are used for sharing criterion exclusions across multiple campaigns.

  • Fields from attributed resources like customer can be selected but will not segment metrics.

  • Fields from segmenting resources like campaign and campaign_shared_set will segment metrics.

  • The page lists all metrics and segments that can be used withshared_set fields in the SELECT clause.

  • Resource fields include ID, member count, name, reference count, resource name, status, and type.

SharedSets are used for sharing criterion exclusions across multiple campaigns.

Attributed resources
customer

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

Segmenting resources
campaign
campaign_shared_set

Fields from the above resources, when selected along with this resource in your SELECT and WHERE clauses,will segment metrics.

Fields/Segments/Metrics

This page shows all metrics and segments that can be put in the same SELECT clause as the fields ofshared_set. However, when you specifyshared_set in the FROM clause, some metrics and segments cannot be used. Use the following filter to show only the fields that can be used whenshared_set is specified in the FROM clause.

Isshared_set specified in the FROM clause of your query?

 Segments

shared_set.id

Field descriptionOutput only. The ID of this shared set. Read only.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

shared_set.member_count

Field descriptionOutput only. The number of shared criteria within this shared set. Read only.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

shared_set.name

Field descriptionThe 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.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

shared_set.reference_count

Field descriptionOutput only. The number of campaigns associated with this shared set. Read only.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

shared_set.resource_name

Field descriptionImmutable. The resource name of the shared set. Shared set resource names have the form:customers/{customer_id}/sharedSets/{shared_set_id}
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

shared_set.status

Field descriptionOutput only. The status of this shared set. Read only.
CategoryATTRIBUTE
Data Type

ENUM

ENABLED
REMOVED
UNKNOWN
UNSPECIFIED
Type URLgoogle.ads.googleads.v20.enums.SharedSetStatusEnum.SharedSetStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

shared_set.type

Field descriptionImmutable. The type of this shared set: each shared set holds only a single kind of resource. Required. Immutable.
CategoryATTRIBUTE
Data Type

ENUM

ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
BRANDS
NEGATIVE_KEYWORDS
NEGATIVE_PLACEMENTS
UNKNOWN
UNSPECIFIED
WEBPAGES
Type URLgoogle.ads.googleads.v20.enums.SharedSetTypeEnum.SharedSetType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-01-29 UTC.