Zarządzanie etykietami CSS

Usługi porównywania cen mogą wyświetlać w Google reklamy produktowe w imieniu sprzedawców w krajach, w których dostępny jest program usług porównywania cen. Content API umożliwia domenom i grupom usług porównywania cen organizowanie powiązanych kont za pomocą etykiet. Domeny usługi porównywania cen mogą wyświetlać, oznaczać etykietami i filtrować konta Merchant Center powiązane z domeną. Grupy usług porównywania cen mogą oznaczać i wyświetlać domeny usług porównywania cen powiązane z grupą. Te usługi Content API zapewniają odpowiedniki 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 korzystaniu z etykiet w CSS Center znajdziesz w artykule Używanie etykiet konta w Comparison Shopping Service Center.

Typy 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ług 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 konta sprzedawców, dla których domeny usług porównywania cen wyświetlają reklamy produktowe. Usługi porównywania cen mogą być powiązane z różnymi typami kont Merchant Center, w tym z multikontami klientów (MCA) i indywidualnymi kontami sprzedawcy. 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 rodzajach kont Merchant Center znajdziesz w artykule Rodzaje kont w Comparison Shopping Service Center.

Rodzaje etykiet CSS

Usługi porównywania cen używają 2 rodzajó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 przez grupy usług porównywania cen.
  • Automatyczne etykiety są automatycznie tworzone i przypisywane do kont Merchant Center przez CSS Center. Etykiety automatyczne są dostępne w przypadku różnych typów danych konta i mogą pomóc w identyfikowaniu ważnych kont oraz istotnej aktywności na koncie.

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

Funkcje i punkty końcowe Content API dla usług porównywania cen

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

Podczas wywoływania punktów końcowych accounts jako domena usługi porównywania cen pamiętaj o tych wymaganiach:

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

Przykład: tworzenie etykiety

Aby utworzyć nową etykietę, możesz użyć metody accounts.labels.create. Etykiety można stosować do domen usług porównywania cen i kont Merchant Center. Etykiety różnych typów kont są jednak oddzielne i nie można ich używać zamiennie. Aby utworzyć etykietę na poziomie domeny, którą można zastosować do kont Merchant Center powiązanych z domeną, użyj identyfikatora domeny usługi porównywania cen jako accountId podczas tworzenia etykiety. Aby utworzyć etykietę na poziomie grupy, którą można zastosować do domen usług porównywania cen powiązanych z grupą, użyj identyfikatora grupy usług porównywania cen jako accountId podczas tworzenia etykiety.

Poniższy przykład pokazuje, jak utworzyć etykietę kluczowych kont na poziomie domeny, którą można następnie zastosować do kont Merchant Center powiązanych z domeną. Aby utworzyć etykietę, wyślij żądanie POST, używając 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: stosowanie etykiety do konta Merchant Center

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

Aby zastosować etykietę, wyślij POSTżądanie, 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 ich do kont Merchant Center powiązanych z domeną usługi porównywania cen możesz użyć metody accounts.list i przekazać parametr zapytania dotyczący etykiety w żądaniu, aby zwracać tylko konta z tą etykietą. Ten przykład pokazuje, jak filtrować konta Merchant Center powiązane z domeną usługi porównywania cen za pomocą operatora id (123) etykiety key-accounts utworzonej w przykładzie Tworzenie etykiety. Aby pobrać konta, wyślij żądanie GET za pomocą tego adresu URL:

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

Nie jest wymagana treść żądania.

Przykład: stosowanie 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. W przykładzie poniżej pokazujemy, jak zastosować utworzoną za pomocą metody accounts.labels.create etykietę na poziomie grupy key-domains do jednego z najważniejszych kont domeny usługi porównywania cen. Pamiętaj, że etykiety domen usług porównywania cen i kont Merchant Center są oddzielne. Etykiety na poziomie grupy muszą być tworzone przy użyciu identyfikatora grupy usługi porównywania cen jako accountId.

Aby zastosować etykietę, wyślij POSTżądanie, 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’
}