28 lutego 2026 r. wycofaliśmy i wyłączyliśmy wersję 1 beta interfejsu Merchant API. Instrukcje przejścia na najnowszą stabilną wersję znajdziesz w artykule Migracja z wersji 1 beta do wersji 1.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Zarządzanie relacjami między kontami

Za pomocą interfejsu Accounts API możesz zarządzać relacjami między swoim kontem Merchant Center a innymi dostawcami usług. 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 lub 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 korzysta z usługi;
dostawca usług;
usługa lub zestaw usług świadczonych na rzecz konta Merchant Center.

Alias

Dostawcy usług 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 interfejsie 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 do uzyskiwania dostępu 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ąć parametr externalAccountId.
Zarządzanie kampaniami: ta usługa modeluje połączenie między kontem Merchant Center a kontem Google Ads, przyznając temu drugiemu dostęp do danych na koncie i danych o produktach potrzebnych do prowadzenia kampanii reklamowych. W tym przypadku dostawcą usług jest GOOGLE_ADS, a externalAccountId to 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ą accountManagement lub accountAggregation. 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 z niej korzysta, 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 akceptuje lub odrzuca propozycję.

Po zaakceptowaniu propozycji usługa zostaje zatwierdzona i uznana za w pełni ustanowioną. Wszystkie prawa dostępu przyznane dostawcy usług są teraz przyznawane kwalifikującym się użytkownikom (patrz prawa dostępu poniżej).

Pamiętaj, że użytkownik, który tworzy, odrzuca lub zatwierdza propozycję, musi mieć ADMIN uprawnienia dostępu na koncie inicjującym proces. Jeśli więc dostawca usług proponuje usługę, użytkownik składający propozycję musi być ADMIN na koncie dostawcy usług, a użytkownik akceptujący lub odrzucający propozycję musi być ADMIN na koncie 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. Dostawca usług powinien być kontem zaawansowanym, a usługa jest zatwierdzana automatycznie, ponieważ użytkownicy konta zaawansowanego mają pełny dostęp ADMIN do 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 – w drugim (np. w Merchant Center lub za pomocą interfejsu 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 dotyczącym łą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ą metody createAndConfigure, jest zatwierdzana automatycznie.
Zarządzanie produktami: w przypadku tej usługi obowiązuje standardowy proces uścisku dłoni (propozycja jednej strony, a następnie akceptacja drugiej).

Prawa dostępu

Każdy typ usługi zapewnia użytkownikom dostawcy usług określony poziom dostępu 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 ADMIN uprawnienia. 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 dostawców usług. Jeśli jesteś dostawcą usług 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 interfejsie Content API for Shopping w przypadku zarządzania produktami, możesz korzystać z tej usługi w interfejsie Merchant API bez dodatkowych zatwierdzeń.

Zarządzanie kontem: ta usługa domyślnie zapewnia pełne ADMIN uprawnienia.
Zarządzanie produktami: ta usługa zapewnia pełne ADMIN uprawnienia. 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 innych firm

Jeśli jesteś platformą innej firmy, 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:

Dostawca usług: Twoje konto zaawansowane.
Konto korzystające z usługi: 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.

Wstecz

Create accounts

Dalej

Control access to your account