Autoryzowanie dostępu do konta Merchant Center

Interfejs Merchant API wymaga uwierzytelniania. Do uwierzytelniania możesz używać danych logowania OAuth 2.0, konta usługi lub domyślnego uwierzytelniania aplikacji (ADC) (często używanego do testowania i lokalnego programowania).

Możesz użyć konta usługi, aby autoryzować dostęp do interfejsu Merchant API na swoim koncie Merchant Center. Jeśli Twoja aplikacja potrzebuje dostępu do kont Merchant Center klientów, zapoznaj się z artykułem Autoryzowanie dostępu aplikacji innych firm do kont Merchant Center.

Konto usługi to szczególne konto używane zwykle przez aplikację, a nie przez osobę. Identyfikatorem konta usługi jest jego adres e-mail, który jest dla niego unikalny.

Zanim wykonasz te czynności, musisz mieć konto Merchant Center.

Uwaga: klucze interfejsu API nie są obsługiwane przez Merchant API. Próba użycia klucza interfejsu API do autoryzacji żądań spowoduje błąd 401 UNAUTHENTICATED CREDENTIALS_MISSING.

Tworzenie konta usługi

Wygeneruj dane logowania konta usługi lub uzyskaj dostęp do wygenerowanych już publicznych danych logowania, a następnie utwórz identyfikator klienta OAuth 2.0:

1. Otwórz konsolę interfejsów API Google.
2. Wybierz projekt w menu u góry strony lub kliknij NOWY PROJEKT, aby go utworzyć.
3. Wyszukaj Merchant API na liście interfejsów API Google i upewnij się, że jest on włączony w tym projekcie.
4. Kliknij Zarządzaj.
5. Na pasku bocznym po lewej stronie wybierz Dane logowania. Aby wyświetlić Dane logowania, konieczne może być kliknięcie strzałki w lewo w lewym górnym rogu strony.
6. Kliknij kolejno UTWÓRZ DANE LOGOWANIA i Konto usługi.
7. Nazwij konto usługi. Jest to domyślna nazwa użytkownika dla identyfikatora konta usługi. Zapisz identyfikator konta usługi, w tym część po znaku „@”, do późniejszego użycia.

8. Kliknij UTWÓRZ, wykonaj opcjonalne czynności, aby przyznać dostęp do projektu i użytkowników, a następnie kliknij GOTOWE.

   Uwaga: rola wybrana dla konta usługi nie ma wpływu na dostęp do Merchant API. Dostęp do metod interfejsu Merchant API jest określany przez rolę powiązaną z identyfikatorem konta usługi w Merchant Center. Jeśli nie wiesz, co wybrać, wybierz Projekt > Przeglądający.

Uzyskiwanie klucza prywatnego JSON

Wygeneruj klucz prywatny JSON dla konta usługi w Konsoli interfejsów API Google:

1. Kliknij konto usługi, a następnie wybierz kartę KLUCZE.
2. Kliknij DODAJ KLUCZ > Utwórz nowy klucz.
3. Wybierz JSON jako typ klucza.
4. Kliknij UTWÓRZ, aby pobrać klucz prywatny. Uwaga: klucz prywatny możesz pobrać tylko podczas jego tworzenia. Nie możesz później wrócić do tego kroku.

Przyznawanie kontu usługi dostępu do konta Merchant Center

Dodaj nowe konto usługi jako użytkownika do konta Merchant Center:

1. Zaloguj się na konto Merchant Center.
2. Kliknij Ustawienia ustawienia.
3. W menu kliknij Dostęp i usługi.
4. Na karcie „Osoby i dostęp” kliknij Dodaj osobę.

5. Wpisz identyfikator konta usługi jako adres e-mail nowej osoby.

   Jeśli nie masz zapisanego identyfikatora konta usługi, otwórz stronę administracyjną Konta usługi i wybierz swój projekt.

6. Określ ustawienia Dostęp użytkownika i Powiadomienia e-mail dla konta usługi.

   Uwaga: konta usług potrzebują dostępu administratora, aby zarządzać informacjami i ustawieniami konta Merchant Center.

7. Kliknij Dodaj użytkownika, aby zapisać zmiany i wrócić do listy użytkowników. Identyfikator konta usługi powinien być teraz widoczny z wybraną rolą użytkownika.

Możesz powtórzyć te czynności w przypadku wszystkich kont usługi, które potrzebują dostępu do danych na koncie Merchant Center.

Uwaga: jeśli jesteś dostawcą zewnętrznym i nie masz bezpośredniego dostępu do konta Merchant Center, poproś klienta o dodanie konta usługi jako użytkownika w Merchant Center i podaj mu identyfikator konta usługi. Zamiast kont usługi zalecamy używanie oAuth do uzyskiwania dostępu przez inne firmy.

Najczęstsze pytania

Czy mogę zalogować się do interfejsu Merchant Center za pomocą konta usługi?

Nie, konta usługi nie są zwykłymi kontami Google i nie mają dostępu do interfejsu Merchant Center.

Jak często muszę odświeżać tokeny dostępu konta usługi?

Tokeny dostępu wygasają po godzinie od ich wydania przez serwer autoryzacji Google OAuth 2.0. Gdy token dostępu wygaśnie, aplikacja powinna użyć biblioteki klienta, aby pobrać kolejny token dostępu. Aby ręcznie odświeżyć token, usuń plik stored-token.json i ponownie przeprowadź uwierzytelnianie.