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 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ć, oznaczać etykietami i filtrować konta Merchant Center powiązane z domeną. Grupy usług porównywania cen mogą oznaczać etykietami i wyświetlać domeny usług 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 konta w Comparison Shopping Service Center.

Typy kont usług porównywania cen

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

  • Grupy usług porównywania cen to konta najwyższego poziomu, które mogą zawierać jedną lub kilka 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 1 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 kilkoma 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 1 domeną usługi porównywania cen. Więcej informacji o różnych typach kont Merchant Center, znajdziesz w artykule Typy kont w Comparison Shopping Service Center.

Typy etykiet usług porównywania cen

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 przez grupy usług porównywania cen.
  • Etykiety automatyczne są tworzone i przypisywane do kont Merchant Center automatycznie 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 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 dla usług porównywania cen

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

Wywołując punkty końcowe accounts jako domena usługi porównywania cen, pamiętaj o tych wymaganiach:

  • Domeny usług porównywania cen muszą podawać swój cssId zamiast merchantId.
  • Domeny usług porównywania cen muszą podawać 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 dla 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ą, 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ług porównywania cen powiązanych z grupą, podczas tworzenia etykiety użyj identyfikatora grupy usług porównywania cen jako accountId.

Ten przykład pokazuje, jak utworzyć etykietę key-accounts 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 z tym adresem 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

Aby przypisać etykiety do konta Merchant Center powiązanego z domeną usługi porównywania cen, możesz użyć metody accounts.updatelabels. Ten 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 żądanie POST z tym adresem URL i treścią żądania:

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

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

Przykład: filtrowanie kont Merchant Center za pomocą etykiet

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 etykiety w żądaniu, 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ą id (123) etykiety key-accounts utworzonej w przykładzie Tworzenie etykiety. Aby pobrać konta, wyślij żądanie GET z tym adresem URL:

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

Treść żądania nie jest potrzebna.

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

Aby przypisać etykiety do domeny usługi porównywania cen powiązanej z grupą usług porównywania cen, możesz też użyć metody csses.updatelabels. Ten przykład pokazuje, jak zastosować etykietę key-domains na poziomie grupy 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ług porównywania cen i kont Merchant Center są oddzielne. Etykiety na poziomie grupy muszą być tworzone z identyfikatorem grupy usług porównywania cen jako accountId.

Aby zastosować etykietę, wyślij żądanie POST z tym adresem URL i treścią żądania:

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

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