Zarządzanie etykietami CSS

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

Typy kont usługi porównywania cen

Usługi w ramach usług w chmurze korzystają z 3 rodzajów kont:

  • Grupy usług porównywania cen to konta najwyższego poziomu, które mogą zawierać jedną lub więcej domen usługi porównywania cen.
  • Domeny usługi porównywania cen to konta 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, którzy korzystają z domen usług porównywania cen do wyświetlania reklam w Zakupach Google. Usługi porównywania cen można powiązać z różnymi typami kont Merchant Center, w tym z multikontami klientów i indywidualnymi 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 według domen usługi porównywania cen, a do domen usługi porównywania cen według grup usług porównywania cen.
  • Etykiety automatyczne są tworzone i przypisywane do kont Merchant Center przez CSS Center. Automatyczne etykiety są dostępne w przypadku różnych rodzajów danych o koncie i mogą pomóc w identyfikacji ważnych kont oraz istotnej aktywności na koncie.

Więcej informacji o typach etykiet, w tym o dostępnych etykietach automatycznych, znajdziesz w artykule Korzystanie z etykiet kont w Comparison Shopping Service Center.

Funkcje i punkty końcowe Content API w przypadku 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 domeny usługi porównywania cen należy pamiętać o tych wymaganiach:

  • Domeny usługi porównywania cen muszą zawierać cssId zamiast merchantId.
  • Domeny usługi porównywania cen muszą zawierać parametr zapytania view=CSS.
  • Domeny usługi porównywania cen muszą zawierać 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ługi porównywania cen i kont Merchant Center. Etykiety różnych typów kont są jednak odrębne 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 tą domeną, podczas tworzenia etykiety użyj identyfikatora domeny usługi porównywania cen jako accountId. Aby utworzyć etykietę na poziomie grupy, którą można zastosować do domen usługi porównywania cen powiązanych z grupą, podczas tworzenia etykiety użyj identyfikatora grupy usługi porównywania cen jako parametru accountId.

Ten przykład pokazuje, jak utworzyć etykietę klucz-konta na poziomie domeny, którą można następnie zastosować do kont Merchant Center powiązanych z tą domeną. Aby utworzyć etykietę, wyślij żądanie POST, korzystając z tego adresu URL i tego nagłówka żą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 na koncie 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. Ten przykład pokazuje, jak zastosować etykietę kluczowe konta utworzoną w poprzednim przykładzie do jednego z najważniejszych kont Merchant Center.

Aby zastosować etykietę, wyślij POST z użyciem tego adresu URL i tego tekstu żą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ć w żądaniu parametr zapytania label, aby zwrócić 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ą atrybutu id (123) etykiety key-accounts utworzonej w przykładzie Tworzenie etykiety. Aby pobrać te dane, wyślij GET z użyciem tego adresu URL:

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

Nie musisz podawać treści prośby.

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. W tym przykładzie pokazujemy, jak zastosować etykietę na poziomie grupy key-domains utworzoną za pomocą metody accounts.labels.create do jednego z najważniejszych kont domen usługi porównywania cen. Pamiętaj, że etykiety domen usługi porównywania cen i kont Merchant Center są oddzielne. Etykiety na poziomie grupy należy tworzyć, podając jako accountId identyfikator grupy porównywania cen.

Aby zastosować etykietę, wyślij POST z użyciem tego adresu URL i tego tekstu żądania:

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

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