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

Stałe. Nazwa zasobu filtra grupy informacji o produktach w grupie plików. Nazwa zasobu filtra grupy informacji o produktach w grupie plików ma postać:

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

string

Stałe. Grupa plików, do której należy ten filtr grupy informacji o produktach w grupie plików.
id

string (int64 format)

Tylko dane wyjściowe. Identyfikator elementu ListingGroupFilter.
type

enum (ListingGroupFilterType)

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

enum (ListingGroupFilterListingSource)

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

object (ListingGroupFilterDimension)

Wartość wymiaru, za pomocą której ta grupa informacji o produktach ulepsza element nadrzędny. Nie zdefiniowano w grupie głównej.
parentListingGroupFilter

string

Stałe. Nazwa zasobu w nadrzędnej grupie 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 Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
SUBDIVISION Podział produktów według niektórych wymiarów strony.
UNIT_INCLUDED Dołączony węzeł liścia filtra grupy informacji o produktach.
UNIT_EXCLUDED Wykluczony 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 Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
SHOPPING informacje o produktach ze źródła Zakupów, np. produkty z Google Merchant Center.
WEBPAGE Informacje o produktach ze źródła stron internetowych, na przykład adresy URL z pliku z adresami stron docelowych lub z domeny internetowej reklamodawcy.

ListingGroupFilterDimension

Wymiary informacji o produktach w ramach filtra grupy informacji o produktach w grupie plikó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 jest obecny. dimension może być 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)

Atrybut niestandardowy oferty produktu.
productItemId

object (ProductItemId)

Identyfikator produktu w ofercie.
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 element kategorii na określonym poziomie. Kategorie najwyższego poziomu to poziom 1, dzieci na poziomie 2 itd. Obecnie obsługujemy do 5 poziomów. Użytkownik musi określić typ wymiaru, który wskazuje poziom kategorii. Wszystkie przypadki w ramach tego samego podziału 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 produktu.

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

ListingGroupFilterProductCategoryLevel

Poziom kategorii produktów filtra grupy informacji o produktach.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. 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ść lokalizacji.

ListingGroupFilterProductChannel

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

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. 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

Wyliczenie opisujące stan oferty produktu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
NEW Stan produktu jest nowy.
REFURBISHED Stan produktu jest odnowiony.
USED Stan produktu jest używany.

ProductCustomAttribute

Atrybut niestandardowy 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 Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
INDEX0 Atrybut niestandardowy filtra pierwszej grupy informacji o produktach.
INDEX1 Drugi atrybut niestandardowy filtra grupy informacji o produktach.
INDEX2 Atrybut niestandardowy filtra grupy informacji o produktach.
INDEX3 Czwarta grupa informacji o produktach – atrybut niestandardowy filtra grupy informacji o produktach.
INDEX4 Atrybut niestandardowy filtra piątej grupy informacji o produktach.

ProductItemId

Identyfikator produktu w ofercie.

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

Wyliczenie opisujące poziom typu oferty produktu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. 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 zasobó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 uwzględniane w ramach filtrowania. Wszystkie warunki powinny być tego samego typu. Przykład 1: jeśli parametr URL1 = www.ads.google.com?ocid=1&euid=2 i URL2 = www.ads.google.com?ocid=1, zostanie spełniony warunek „ocid” i „euid” jako parametr urlContains, zostanie dopasowany adres URL1, ale nie adres URL2.

Przykład2 : jeśli w adresie URL1 występują etykiety Etykiety1, Etykieta2, a pod adresem URL2 etykiety etykieta2, etykieta3, a warunkami dotyczącymi etykiet własnych Etykiety1 i Etykieta2, zostanie dopasowany adres URL1, ale nie adres URL2. Gdy Etykieta2 jest jedynym warunkiem Etykieta własna, zarówno URL1, jak i URL2 są dopasowywane.

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 być tylko jednym z tych warunków:
customLabel

string

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

string

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

ListingGroupFilterDimensionPath

Ścieżka definiują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 w hierarchii filtrów grup informacji o produktach (z wyłączeniem węzła głównego) do tego filtra grupy informacji o produktach.