Za pomocą interfejsu Accounts API możesz zarządzać relacjami między swoim kontem Merchant Center a innymi usługodawcami. Relacja to formalne połączenie, które umożliwia dostawcy oferowanie określonych usług Twojej firmie. Usługa określa uprawnienia i możliwości przyznane dostawcy, takie jak zarządzanie produktami czy zarządzanie kampaniami. Na przykład połączenie konta Merchant Center z kontem Google Ads umożliwia korzystanie z danych o produktach na koncie Google Ads do prowadzenia kampanii reklamowych.
Relacja składa się z tych atrybutów:
- konto Merchant Center, które otrzymuje usługę;
- usługodawca;
- usługa lub zestaw usług świadczonych na rzecz konta Merchant Center.
Alias
Usługodawcy mogą powiązać alias z kontami, które obsługują (jest to
odpowiednik pola seller_id, które było obecne w
zasobie konta
w Content API for Shopping). Alias można przypisać za pomocą opcjonalnego pola account_id_alias w zasobie AccountRelationship. Służy on jako identyfikator niestandardowy. Alias musi składać się z 1–50 znaków wybranych spośród liter ASCII, cyfr dziesiętnych, łączników, znaków podkreślenia, kropek lub tyld ([A-Za-z0-9_~.-]{1,50}).
Struktura adresu URL umożliwiająca dostęp do konta za pomocą jego aliasu to GET /accounts/v1/accounts/{provider}~{account_id_alias}.
Usługi
W interfejsie Accounts API konta mogą korzystać z tych usług. Wiele z tych usług możesz dodać podczas tworzenia konta.
Agregacja kont: ta usługa łączy konto zaawansowane z innym kontem, przyznając mu pełny, nieograniczony dostęp. Jest ona zwykle używana przez platformy handlowe, sprzedawców detalicznych wielu marek lub sprzedawców detalicznych działających na rynkach międzynarodowych, którzy potrzebują scentralizowanej kontroli nad kontami zagnieżdżonymi. Jeśli jesteś platformą e-commerce lub partnerem kanału, zalecamy używanie usługi
accountManagement. Podczas tworzenia konta za pomocą agregacji kont należy pominąć parametrexternalAccountId.Zarządzanie kampaniami: ta usługa modeluje połączenie między kontem Merchant Center a kontem Google Ads, przyznając kontu Google Ads dostęp do danych o produktach i danych na koncie potrzebnych do prowadzenia kampanii reklamowych. Usługodawcą w tym przypadku jest
GOOGLE_ADS, aexternalAccountIdto identyfikator konta Google Ads. Tę usługę można też zaproponować na istniejącym koncie.
Porównywanie cen: ta usługa reprezentuje relację z usługą porównywania cen (CSS), która obsługuje konto Merchant Center.
Zarządzanie informacjami o firmie lokalnej: ta usługa reprezentuje relację z menedżerem sklepu, który zarządza lokalnym asortymentem i informacjami o firmie lokalnej za pomocą Profilu Firmy w Google.
Zarządzanie kontem: ta usługa umożliwia dostawcy wykonywanie działań administracyjnych na koncie Merchant Center, takich jak konfigurowanie ustawień konta, zarządzanie użytkownikami czy aktualizowanie informacji o firmie. Firma może też ograniczyć przyznany dostęp. Jeśli ta usługa jest używana podczas tworzenia konta, tworzy konto połączone z dostawcą. Jest to zalecane rozwiązanie dla platform e-commerce i partnerów kanału. Tę usługę można też zaproponować na istniejącym koncie.
Zarządzanie produktami: ta usługa umożliwia dostawcom zarządzanie produktami i powiązanymi funkcjami, takimi jak źródła danych i reguły. Jeśli usługa jest dodawana podczas tworzenia konta, zwykle jest to robione w połączeniu z usługą
accountManagementlubaccountAggregation. Tę usługę można też zaproponować na istniejącym koncie.
Uścisk dłoni
Aby ustanowić usługę, zarówno konto, które ją świadczy, jak i konto, które ją otrzymuje, muszą autoryzować połączenie. Ten proces autoryzacji nazywa się uściskiem dłoni.
Uścisk dłoni to proces dwuetapowy:
- Jedna ze stron proponuje połączenie usługi.
- Druga strona zatwierdza lub odrzuca propozycję.
Po zaakceptowaniu propozycji usługa zostaje zatwierdzona i uznana za w pełni ustanowioną. Wszystkie prawa dostępu przyznane usługodawcy są teraz przyznawane kwalifikującym się użytkownikom (patrz prawa dostępu poniżej).
Pamiętaj, że użytkownik, który tworzy propozycję, odrzuca ją lub zatwierdza, musi mieć
ADMIN uprawnienia
dostępu
na koncie inicjującym proces. Jeśli więc usługodawca
proponuje usługę, użytkownik składający propozycję musi być administratoremADMIN konta
usługodawcy, a użytkownik akceptujący lub odrzucający propozycję
musi być administratoremADMIN konta odbiorcy.
Działanie uścisku dłoni w przypadku poszczególnych usług
Poniżej znajdziesz opis wymagań dotyczących uścisku dłoni w przypadku poszczególnych usług:
Agregacja kont: tę usługę można ustanowić tylko podczas tworzenia konta. Usługodawca powinien być kontem zaawansowanym, a usługa jest zatwierdzana automatycznie, ponieważ użytkownicy konta zaawansowanego mają pełny dostęp
ADMINdo tworzonego konta.Porównywanie cen: ta usługa jest automatycznie zatwierdzana, gdy jest dodawana podczas tworzenia konta za pomocą metody
createAndConfigure.Zarządzanie kampaniami: ta usługa korzysta ze standardowego procesu uścisku dłoni, ale propozycje są składane w jednym systemie (np. Google Ads), a zatwierdzenia są dokonywane w drugim systemie (np. w Merchant Center lub za pomocą Merchant API).
Zarządzanie informacjami o firmie lokalnej: w przypadku tej usługi uzgadnianie połączenia jest proponowane za pomocą specjalnej metody, a zatwierdzenia są dokonywane w drugim systemie (np. w Profilu Firmy w Google). Szczegółowe instrukcje znajdziesz w przewodniku łączenia Profilu Firmy w Google.
Zarządzanie kontem: w przypadku tej usługi obowiązuje standardowy proces uścisku dłoni podczas korzystania z metody
propose. Jeśli usługa jest dodawana podczas tworzenia konta za pomocą metodycreateAndConfigure, jest automatycznie zatwierdzana.Zarządzanie produktami: w przypadku tej usługi obowiązuje standardowy proces uścisku dłoni (propozycja jednej strony, a następnie akceptacja drugiej strony).
Prawa dostępu
Każdy typ usługi zapewnia określony poziom dostępu dla użytkowników usługodawcy do obsługiwanego konta:
Agregacja kont: ta usługa zapewnia pełne uprawnienia
ADMIN.Zarządzanie kampaniami: ta usługa zapewnia ograniczone prawa dostępu, umożliwiając powiązanemu kontu Google Ads dostęp do produktów i podstawowych informacji o koncie.
Porównywanie cen: ta usługa domyślnie zapewnia pełne
ADMINuprawnienia. Firma może jednak ograniczyć przyznany dostęp w Merchant Center.Zarządzanie informacjami o firmie lokalnej: ta usługa nie zapewnia bezpośrednich praw dostępu. Umożliwia natomiast synchronizowanie produktów z kontem Merchant Center.
Ważne: prawa dostępu opisane w przypadku tych typów usług dotyczą
tylko zatwierdzonych usługodawców. Jeśli jesteś usługodawcą i chcesz korzystać z tej funkcji, skontaktuj się z naszym zespołem
pomocy. Jeśli masz już zatwierdzony dostęp do metody accounts.link w przypadku zarządzania produktami w Content API for Shopping, możesz korzystać z tej usługi w Merchant API bez dodatkowych zatwierdzeń.
Zarządzanie kontem: ta usługa domyślnie zapewnia pełne
ADMINuprawnienia.Zarządzanie produktami: ta usługa zapewnia pełne
ADMINuprawnienia. Pamiętaj, że w przyszłości będzie to ograniczone tylko do praw dostępu związanych z produktami.
Jak relacje działają w przypadku platform zewnętrznych
Jeśli jesteś platformą zewnętrzną, która zarządza kontami w imieniu innych firm, poniżej znajdziesz informacje o tym, jak różne koncepcje są powiązane ze strukturą Twojego konta:
- Usługodawca: Twoje konto zaawansowane.
- Konto otrzymujące usługę: konto Merchant Center, które reprezentuje firmę, którą zarządzasz.
- Usługa:
accountManagement: jest to zalecana usługa dla platform e-commerce i partnerów kanału, którzy tworzą nowe konta w imieniu sprzedawców. Tworzy ona konto, którego właścicielem jest sprzedawca, ale które jest połączone z Twoim kontem w celu zarządzania. Jest to zgodne z preferowaną strukturą Merchant Center w tym przypadku.accountAggregation: ta usługa łączy Twoje konto zaawansowane z innym kontem. Chociaż jest obsługiwana, nie jest zalecana w przypadku platform e-commerce i partnerów kanału.
Więcej informacji o konfigurowaniu konta zaawansowanego i łączeniu go z nowymi kontami Merchant Center znajdziesz w artykule Tworzenie kont.