asset_group_listing_group_filter

  • The AssetGroupListingGroupFilter resource represents a node in a listing group filter tree within an asset group.

  • You can select fields from asset_group, campaign, and customer resources along with AssetGroupListingGroupFilter fields.

  • Fields from associated resources will not segment metrics in your SELECT clause.

  • The asset_group_listing_group_filter resource includes fields for various product attributes like brand, category, channel, condition, custom attributes, item ID, type, and webpage conditions.

  • Key identifying fields include the resource name, ID, listing source, parent filter, path, and type of the listing group filter.

AssetGroupListingGroupFilter represents a listing group filter tree node in an asset group.

Attributed resources
asset_group
campaign
customer

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.

asset_group_listing_group_filter.asset_group

Field description

Immutable. The asset group which this asset group listing group filter is part of.

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

asset_group_listing_group_filter.case_value.product_brand.value

Field description

String value of the product brand.

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset_group_listing_group_filter.case_value.product_category.category_id

Field description

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

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset_group_listing_group_filter.case_value.product_category.level

Field description

Indicates the level of the category in the taxonomy.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v21.enums.ListingGroupFilterProductCategoryLevelEnum.ListingGroupFilterProductCategoryLevel
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset_group_listing_group_filter.case_value.product_channel.channel

Field description

Value of the locality.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v21.enums.ListingGroupFilterProductChannelEnum.ListingGroupFilterProductChannel
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset_group_listing_group_filter.case_value.product_condition.condition

Field description

Value of the condition.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v21.enums.ListingGroupFilterProductConditionEnum.ListingGroupFilterProductCondition
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset_group_listing_group_filter.case_value.product_custom_attribute.index

Field description

Indicates the index of the custom attribute.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v21.enums.ListingGroupFilterCustomAttributeIndexEnum.ListingGroupFilterCustomAttributeIndex
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset_group_listing_group_filter.case_value.product_custom_attribute.value

Field description

String value of the product custom attribute.

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset_group_listing_group_filter.case_value.product_item_id.value

Field description

Value of the id.

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset_group_listing_group_filter.case_value.product_type.level

Field description

Level of the type.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v21.enums.ListingGroupFilterProductTypeLevelEnum.ListingGroupFilterProductTypeLevel
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset_group_listing_group_filter.case_value.product_type.value

Field description

Value of the type.

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset_group_listing_group_filter.case_value.webpage.conditions

Field description

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.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v21.resources.ListingGroupFilterDimension.WebpageCondition
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

asset_group_listing_group_filter.id

Field description

Output only. The ID of the ListingGroupFilter.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset_group_listing_group_filter.listing_source

Field description

Immutable. The source of listings filtered by this listing group filter.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v21.enums.ListingGroupFilterListingSourceEnum.ListingGroupFilterListingSource
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset_group_listing_group_filter.parent_listing_group_filter

Field description

Immutable. Resource name of the parent listing group subdivision. Null for the root listing group filter node.

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

asset_group_listing_group_filter.path

Field description

Output only. The path of dimensions defining this listing group filter.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v21.resources.ListingGroupFilterDimensionPath
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

asset_group_listing_group_filter.resource_name

Field description

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}

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

asset_group_listing_group_filter.type

Field description

Immutable. Type of a listing group filter node.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v21.enums.ListingGroupFilterTypeEnum.ListingGroupFilterType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse