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ć etykietami i wyświetlać domeny usług porównywania cen powiązane z grupą. Te usługi Content API zapewniają zautomatyzowane 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 o używaniu etykiet kont w Comparison Shopping Service Center.

Rodzaje kont usługi porównywania cen

Usługi porównywania cen korzystają z 3 typó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 domen 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 oraz domeny usług porównywania cen przez grupy usług porównywania cen.
  • Automatyczne etykiety są tworzone automatycznie i przypisywane do kont Merchant Center przez CSS Center. Automatyczne etykiety są dostępne w przypadku różnych rodzajów danych konta i pomagają zidentyfikować ważne konta oraz istotną aktywność 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 usługach porównywania cen

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 pamiętaj o tych wymaganiach:

  • Domeny usługi porównywania cen muszą zawierać atrybut cssId zamiast merchantId.
  • Domeny usługi porównywania cen muszą dostarczać parametr zapytania o wartości view=CSS.
  • Domeny usługi porównywania cen muszą podać powiązany identyfikator konta Merchant Center jako accountId.

Przykład: tworzenie etykiety

Nową etykietę możesz utworzyć za pomocą 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ć wymiennie. 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 elementu 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ług porównywania cen jako elementu accountId.

Poniższy przykład pokazuje, jak utworzyć etykietę kont 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 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 kluczowe 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 jego treści:

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ć w prośbie parametr zapytania etykiety, aby zwracać tylko konta z tą etykietą. Poniższy przykład pokazuje, jak filtrować konta Merchant Center powiązane z domeną usługi porównywania cen przy użyciu etykiety id (123) konta kluczy utworzonej w przykładzie Tworzenie etykiety. Aby pobrać konta, 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

Za pomocą metody csses.updatelabels możesz też przypisać etykiety do domeny usługi porównywania cen powiązanej z grupą usług porównywania cen. Ten przykład pokazuje, jak zastosować etykietę na poziomie grupy key-domains utworzoną przy użyciu metody accounts.labels.create na jednym z najważniejszych kont domen 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 należy tworzyć, używając identyfikatora grupy CSS jako właściwości accountId.

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

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

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