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:
accounts.labels
: umożliwia tworzenie, pobieranie i modyfikowanie etykiet stosowanych do domeny usługi porównywania cen i kont Merchant Center. Przykład znajdziesz w sekcji Tworzenie etykiety.accounts.updatelabels
: umożliwia stosowanie etykiet do jednego konta Merchant Center. Przykład znajdziesz w sekcji Stosowanie etykiety do konta Merchant Center.accounts.list
: umożliwia pobranie wszystkich kont Merchant Center powiązanych z domeną usługi porównywania cen, w tym etykiet zastosowanych do poszczególnych kont. Możesz też przefiltrować dane według etykietyid
, aby pobrać podzbiór powiązanych kont. Przykład znajdziesz w sekcji Filtrowanie kont Merchant Center za pomocą etykiet.accounts.get
: umożliwia pobieranie etykiet zastosowanych do jednego konta Merchant Center.csses
: umożliwia wyświetlanie powiązań między etykietami i domenami usług porównywania cen oraz zarządzanie nimi. Przykład znajdziesz w sekcji Stosowanie etykiety do domeny usługi 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
zamiastmerchantId
. - 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’
}