AssetGroupListingGroupFilter

AssetGroupListingGroupFilter reprezentuje węzeł drzewa filtra grupy informacji o produktach w grupie zasobów.

Zapis JSON 
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "listingSource": enum (ListingGroupFilterListingSource),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
Pola
resourceName

string

Niezmienne. Nazwa zasobu filtra grupy informacji o produktach w grupie komponentów. Nazwa zasobu filtra grupy informacji o produktach w grupie komponentów ma postać:

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
assetGroup

string

Niezmienne. Grupa komponentów, do której należy ten filtr grupy informacji o produktach w grupie komponentów.
id

string (int64 format)

Tylko dane wyjściowe. Identyfikator filtra ListingGroupFilter.
type

enum (ListingGroupFilterType)

Niezmienne. Typ węzła filtra grupy informacji o produktach.
listingSource

enum (ListingGroupFilterListingSource)

Niezmienne. Źródło informacji o produktach przefiltrowanych według tego filtra grupy informacji o produktach.
caseValue

object (ListingGroupFilterDimension)

Wartość wymiaru, do której ta grupa informacji o produktach zawęża element nadrzędny. Nie zdefiniowano w grupie głównej.
parentListingGroupFilter

string

Niezmienne. Nazwa zasobu podziału nadrzędnej grupy informacji o produktach. Wartość null dla głównego węzła filtra grupy informacji o produktach.
path

object (ListingGroupFilterDimensionPath)

Tylko dane wyjściowe. Ścieżka wymiarów definiujących ten filtr grupy informacji o produktach.

ListingGroupFilterType

Typ filtra grupy informacji o produktach.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
SUBDIVISION Podział produktów według niektórych wymiarów strony.
UNIT_INCLUDED Dołączony węzeł filtra grupy informacji o produktach.
UNIT_EXCLUDED Węzeł liścia filtra grupy informacji o produktach.

ListingGroupFilterListingSource

Źródło informacji o produktach przefiltrowanych według węzła filtra grupy informacji o produktach.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
SHOPPING informacje o produktach ze źródła w Zakupach Google, np. produkty z Google Merchant Center;
WEBPAGE Informacje o produktach ze źródła strony internetowej, np. adresy URL z pliku z adresami stron docelowych lub z domeny internetowej reklamodawcy.

ListingGroupFilterDimension

Wymiary strony aplikacji w ramach filtra grupy informacji o produktach w grupie komponentów.

Zapis JSON 
{

  // Union field dimension can be only one of the following:
  "productCategory": {
    object (ProductCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  },
  "webpage": {
    object (Webpage)
  }
  // End of list of possible types for union field dimension.
}
Pola
Pole sumy dimension. Wymiar jednego z poniższych typów zawsze występuje. dimension może mieć tylko jedną z tych wartości:
productCategory

object (ProductCategory)

Kategoria oferty produktu.
productBrand

object (ProductBrand)

Marka oferty produktu.
productChannel

object (ProductChannel)

Lokalizacja oferty produktu.
productCondition

object (ProductCondition)

Stan oferty produktu.
productCustomAttribute

object (ProductCustomAttribute)

Niestandardowy atrybut oferty produktu.
productItemId

object (ProductItemId)

Identyfikator produktu w ofercie produktu.
productType

object (ProductType)

Typ oferty produktu.
webpage

object (Webpage)

Filtry adresów URL z pliku z adresami stron docelowych i adresów URL z domeny internetowej reklamodawcy.

ProductCategory

Jeden z elementów kategorii na określonym poziomie. Kategorie najwyższego poziomu są na poziomie 1, dzieci na poziomie 2 itd. Obecnie obsługujemy maksymalnie 5 poziomów. Użytkownik musi określić typ wymiaru, który wskazuje poziom kategorii. Wszystkie przypadki w ramach tego samego podziału podrzędnego muszą mieć ten sam typ wymiaru (na poziomie kategorii).

Zapis JSON 
{
  "level": enum (ListingGroupFilterProductCategoryLevel),
  "categoryId": string
}
Pola
level

enum (ListingGroupFilterProductCategoryLevel)

Wskazuje poziom kategorii w taksonomii.
categoryId

string (int64 format)

Identyfikator kategorii produktów.

Jest on odpowiednikiem atrybutu google_product_category [kategoria_produktów_Google] zgodnie z opisem w tym artykule: https://support.google.com/merchants/answer/6324436.

ListingGroupFilterProductCategoryLevel

Poziom filtra kategorii produktów w grupie informacji o produktach.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
LEVEL1 Poziom 1.
LEVEL2 Poziom 2.
LEVEL3 Poziom 3.
LEVEL4 Poziom 4.
LEVEL5 Poziom 5.

ProductBrand

Marka produktu.

Zapis JSON 
{
  "value": string
}
Pola
value

string

Wartość ciągu znaków marki produktu.

ProductChannel

Lokalizacja oferty produktu.

Zapis JSON 
{
  "channel": enum (ListingGroupFilterProductChannel)
}
Pola
channel

enum (ListingGroupFilterProductChannel)

Wartość regionu.

ListingGroupFilterProductChannel

Wartość Enum opisująca miejscowość oferty produktu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
ONLINE Produkt jest sprzedawany online.
LOCAL Produkt jest sprzedawany w lokalnych sklepach.

ProductCondition

Stan oferty produktu.

Zapis JSON 
{
  "condition": enum (ListingGroupFilterProductCondition)
}
Pola
condition

enum (ListingGroupFilterProductCondition)

Wartość warunku.

ListingGroupFilterProductCondition

Wartość Enum opisująca stan oferty produktu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
NEW Stan produktu jest nowy.
REFURBISHED Stan produktu jest odnowiony.
USED Stan produktu jest używany.

ProductCustomAttribute

Niestandardowy atrybut oferty produktu.

Zapis JSON 
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
Pola
index

enum (ListingGroupFilterCustomAttributeIndex)

Wskazuje indeks atrybutu niestandardowego.
value

string

Wartość ciągu znaków niestandardowego atrybutu produktu.

ListingGroupFilterCustomAttributeIndex

Indeks atrybutów klienta.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
INDEX0 Atrybut niestandardowy filtra pierwszej grupy informacji o produktach.
INDEX1 Atrybut niestandardowy filtra grupy informacji o produktach drugiej strony.
INDEX2 Atrybut niestandardowy filtra trzeciej grupy informacji o produktach.
INDEX3 Atrybut niestandardowy filtra czwartej grupy informacji o produktach.
INDEX4 Atrybut niestandardowy filtra piątej grupy informacji o produktach.

ProductItemId

Identyfikator produktu w ofercie produktu.

Zapis JSON 
{
  "value": string
}
Pola
value

string

Wartość identyfikatora.

ProductType

Typ oferty produktu.

Zapis JSON 
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
Pola
level

enum (ListingGroupFilterProductTypeLevel)

Poziom typu.
value

string

Wartość typu.

ListingGroupFilterProductTypeLevel

Wartość opisująca poziom typu oferty produktu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
LEVEL1 Poziom 1.
LEVEL2 Poziom 2.
LEVEL3 Poziom 3.
LEVEL4 Poziom 4.
LEVEL5 Poziom 5.

Strona internetowa

Filtry adresów URL z pliku z adresami stron docelowych i adresów URL z domeny internetowej reklamodawcy. W grupie komponentów może być kilka węzłów głównych z tym wymiarem, a ich warunki są uwzględniane w operatorze LUB.

Zapis JSON 
{
  "conditions": [
    {
      object (WebpageCondition)
    }
  ]
}
Pola
conditions[]

object (WebpageCondition)

W warunkach strony internetowej rozróżniana jest wielkość liter. Są one ze sobą łączone podczas sprawdzania pod kątem filtrowania. Wszystkie warunki powinny być tego samego typu. Przykład 1: w przypadku adresu URL1 = www.ads.google.com?ocid=1&euid=2 i URL2 = www.ads.google.com?ocid=1 oraz z warunkami „ocid” i „euid” jako adres URLContains będzie dopasowywany adres URL1, ale nie adres URL2.

Przykład2 : jeśli adres URL1 ma etykiety Etykieta1, Etykieta2 i URL2 ma etykiety Etykieta2, Etykieta3, a wartości Etykieta1 i Etykieta2 jako etykieta własna , zostanie spełniony URL1, ale nie Adres URL2. Jeśli Etykieta2 jest jedynym warunkiem etykiety własnej, będą dopasowywane zarówno adres URL1, jak i URL2.

WebpageCondition

Warunek dopasowania do filtrowania adresów URL.

Zapis JSON 
{

  // Union field condition can be only one of the following:
  "customLabel": string,
  "urlContains": string
  // End of list of possible types for union field condition.
}
Pola
Pole sumy condition. Warunek filtrowania adresów URL. condition może mieć tylko jeden z tych warunków:
customLabel

string

Filtruje adresy URL z pliku z adresami stron docelowych, które mają tę etykietę własną. Aby dodać etykietę własną do kampanii, utwórz obiekt AssetSet typu PAGE_FEED i połącz go z kampanią za pomocą narzędzia CampaignAssetSet.
urlContains

string

Filtruje adresy URL z pliku z adresami stron docelowych i adresy z domeny internetowej reklamodawcy, które zawierają ten ciąg znaków.

ListingGroupFilterDimensionPath

Ścieżka określająca wymiary definiujące filtr grupy informacji o produktach.

Zapis JSON 
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
Pola
dimensions[]

object (ListingGroupFilterDimension)

Tylko dane wyjściowe. Pełna ścieżka wymiarów przez hierarchię filtrów grup informacji o produktach (bez węzła głównego) do tego filtra grupy informacji o produktach.