Zarządzanie etykietami CSS

Usługi porównywania cen wyświetlają reklamy produktowe w Google w imieniu sprzedawców w krajach, w których dostępny jest program usług porównywania cen. Interfejs Content API umożliwia domenom i grupom usług porównywania cen porządkowanie powiązanych kont za pomocą etykiet. Domeny usług porównywania cen mogą wyświetlać listy, oznaczać etykietami i filtrować konta Merchant Center powiązane z domeną. Grupy usług porównywania cen mogą oznaczać etykietami i wyświetlać listę domen usługi porównywania cen powiązanych z grupą. Te usługi Content API są zautomatyzowane odpowiednikami niektórych funkcji dostępnych w Comparison Shopping Service Center.

Więcej informacji o usługach porównywania cen znajdziesz w artykule Usługi porównywania cen. Informacje o pracy z etykietami w CSS Center znajdziesz w artykule Korzystanie z etykiet konta w Comparison Shopping Service Center.

Rodzaje kont usługi porównywania cen

Usługi porównywania cen korzystają z tych 3 rodzajów kont:

  • Grupy usług porównywania cen to konta najwyższego poziomu, które mogą zawierać jedną lub wiele domen usługi porównywania cen.
  • Domeny usług porównywania cen to konta samych usług porównywania cen, które wyświetlają reklamy produktowe w imieniu sprzedawców. Każda domena usługi porównywania cen może należeć tylko do jednej grupy usług porównywania cen.
  • Konta Merchant Center to sprzedawcy, w przypadku których domeny usług porównywania cen wyświetlają reklamy produktowe. Usługi porównywania cen można powiązać z kilkoma różnymi typami kont Merchant Center, w tym z multikontami klientów (MCA) i poszczególnymi kontami sprzedawców. Każde konto Merchant Center może być powiązane tylko z jedną domeną usługi porównywania cen. Więcej informacji o różnych typach kont Merchant Center znajdziesz w artykule Rodzaje kont w Comparison Shopping Service Center.

Typy etykiet CSS

Usługi porównywania cen używają 2 typów etykiet:

  • Etykiety ręczne są tworzone i przypisywane do kont Merchant Center przez domeny usług porównywania cen, a do domen usług porównywania cen – grupy usług porównywania cen.
  • Etykiety automatyczne są automatycznie tworzone i przypisywane do kont Merchant Center przez CSS Center. Automatyczne etykiety są dostępne w przypadku różnych typów wskaźników konta i pomagają zidentyfikować ważne konta i istotną aktywność na koncie.

Więcej informacji o typach etykiet, w tym o dostępnych etykietach automatycznych, znajdziesz w artykule Używanie etykiet konta w Comparison Shopping Service Center.

Funkcje i punkty końcowe Content API w usługach porównywania cen

Content API udostępnia te punkty końcowe dla usług porównywania cen:

Gdy wywołujesz punkty końcowe accounts jako domenę usługi porównywania cen, pamiętaj o tych wymaganiach:

  • Domeny usługi porównywania cen muszą podawać wartość cssId zamiast merchantId.
  • Domeny usługi porównywania cen muszą zawierać parametr zapytania o wartości view=CSS.
  • Domeny usług porównywania cen muszą podawać identyfikator powiązanego konta Merchant Center w postaci accountId.

Przykład: tworzenie etykiety

Do utworzenia nowej etykiety możesz użyć metody accounts.labels.create. Etykiety można stosować w przypadku domen usługi porównywania cen i kont Merchant Center. Jednak etykiety dla różnych rodzajów kont są oddzielne i nie można ich używać zamiennie. Aby utworzyć etykietę na poziomie domeny, którą można stosować na kontach Merchant Center powiązanych z tą domeną, przy tworzeniu etykiety użyj identyfikatora domeny usługi porównywania cen jako wartości accountId. Aby utworzyć etykietę na poziomie grupy, którą można stosować do domen usługi porównywania cen powiązanych z grupą, podczas tworzenia etykiety użyj identyfikatora grupy usług porównywania cen jako wartości accountId.

Poniższy przykład pokazuje, jak utworzyć etykietę kont kluczy na poziomie domeny, którą można później zastosować na kontach Merchant Center powiązanych z domeną. Aby utworzyć etykietę, wyślij żądanie POST, korzystając z tego adresu URL i treści żądania:

https://shoppingcontent.googleapis.com/content/v2.1/accounts/accountId/labels

{
 "name": "key-accounts",
 "description": "All accounts with over a million products"
}

Przykład: zastosowanie etykiety do konta Merchant Center

Za pomocą metody accounts.updatelabels możesz przypisać etykiety do konta Merchant Center powiązanego z domeną usługi porównywania cen. Poniższy przykład pokazuje, jak zastosować etykietę konta kluczy utworzoną w poprzednim przykładzie do jednego z najważniejszych kont Merchant Center.

Aby zastosować etykietę, wyślij żądanie POST, używając tego adresu URL i treści żądania:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/

{
 "labelIds": [‘123’] // ‘key-accounts’
}

Przykład: używanie etykiet do filtrowania kont Merchant Center

Po utworzeniu etykiet i zastosowaniu etykiet do kont Merchant Center powiązanych z domeną usługi porównywania cen możesz użyć metody accounts.list i przekazać w żądaniu parametr zapytania etykiety, aby zwrócić tylko konta z tą etykietą. Poniższy przykład pokazuje, jak filtrować konta Merchant Center powiązane z domeną usługi porównywania cen za pomocą atrybutu id (123) kont kluczy utworzonych w przykładzie Tworzenie etykiety. Aby pobrać dane o kontach, wyślij żądanie GET, korzystając z tego adresu URL:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123

Treść żądania nie jest wymagana.

Przykład: zastosowanie etykiety do domeny usługi porównywania cen

Możesz też użyć metody csses.updatelabels, aby przypisać etykiety do domeny usługi porównywania cen powiązanej z grupą usług porównywania cen. Z przykładu poniżej dowiesz się, jak zastosować etykietę na poziomie grupy domeny-kluczowe utworzoną za pomocą metody accounts.labels.create do jednego z najważniejszych kont domeny usługi porównywania cen. Pamiętaj, że etykiety dla domen usługi porównywania cen i kont Merchant Center są oddzielne. Etykiety na poziomie grupy należy tworzyć, używając identyfikatora grupy usług porównywania cen jako jego accountId.

Aby zastosować etykietę, wyślij żądanie POST, używając tego adresu URL i treści żądania:

https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/

{
 "labelIds": [‘456’] // ‘key-domains’
}