Korzystanie z kont usługi OAuth 2.0 z interfejsem Manufacturer Center API

Konta usługi to specjalne konta Google, które mogą być używane przez aplikacje do automatycznego dostępu do interfejsów API Google przy użyciu protokołu OAuth 2.0. Konto usługi używa procesu OAuth 2.0, który nie wymaga dodatkowej autoryzacji. Zamiast tego używa pliku klucza, do którego dostęp ma tylko Twoja aplikacja. Z tego przewodnika dowiesz się, jak uzyskać dostęp do interfejsu Manufacturer Center API za pomocą kont usługi.

Uwaga: aplikacje używające kont usługi do uwierzytelniania mogą uzyskać dostęp tylko do własnego konta Manufacturer Center. Jeśli piszesz aplikację innej firmy, która wymaga dostępu do kont klientów, zapoznaj się z przewodnikiem Autoryzowanie żądań.

Wymagania wstępne

Instrukcje korzystania z konta usługi w celu uzyskania dostępu do interfejsu Manufacturer Center API

  1. Wygeneruj dane logowania na konto usługi lub uzyskaj dostęp do publicznych danych logowania, które zostały już wygenerowane. Musisz utworzyć identyfikator klienta OAuth 2.0 i uzyskać plik klucza prywatnego .json:
    1. Otwórz konsolę interfejsów API Google.
    2. Wybierz projekt w menu u góry strony. Jeśli nie masz jeszcze projektu, kliknij Utwórz projekt.
    3. Jeśli nie masz jeszcze włączonego interfejsu Manufacturer Center API w tym projekcie, wyszukaj go na liście interfejsów API Google i włącz.
    4. Na pasku bocznym po lewej stronie wybierz Dane logowania.
    5. Aby skonfigurować konto usługi, wybierz Utwórz dane logowania, a następnie Klucz konta usługi.
      Zrzut ekranu tworzenia danych logowania konta usługi.
    6. Na następnej stronie wybierz z listy Nowe konto usługi.
    7. Nazwij nowe konto usługi Służy ona również jako domyślna nazwa użytkownika konta usługi. Zapamiętaj identyfikator konta usługi na później.

      Wybór roli dla konta usługi nie ma wpływu na wywołania interfejsu Manufacturer Center API, ponieważ dostęp do metod interfejsu Manufacturer Center API zależy od roli powiązanej z identyfikatorem konta usługi w Manufacturer Center. Jeśli nie wiesz, co wybrać, wybierz Projekt_Przeglądający.

      Zrzut ekranu z nową nazwą konta usługi.
    8. Wybierz typ klucza JSON i kliknij Utwórz.
    9. Przycisk Utwórz zmieni się na Tworzenie..., a gdy zakończy się generowanie klucza, automatycznie pobierze klucz prywatny jako plik *.json.

      Ważne: chroń plik klucza .json za pomocą pliku *.json, który umożliwia kontu usługi dostęp do usług Google, na które został autoryzowany. Najlepiej jest zezwolić kontoom usługi na dostęp tylko do jednego interfejsu API Google. Jest to środek zapobiegawczy, który pozwala ograniczyć ilość danych, do których osoba przeprowadzająca atak może uzyskać dostęp w przypadku przejęcia konta klucza *.json konta usługi.

    10. Wrócisz na stronę Dane logowania. Nowe konto usługi powinno być widoczne na liście kluczy konta usługi.
  2. Dodaj nowe konto usługi jako użytkownika do konta Manufacturer Center. Jeśli jesteś deweloperem zewnętrznym, Twoim zadaniem jest wykonanie tej czynności przez klienta.
    1. Otwórz konto Manufacturer Center.
    2. Otwórz stronę 'Użytkownicy' w ustawieniach konta Manufacturer Center.
    3. Kliknij przycisk +Użytkownik i użyj identyfikatora konta usługi jako adresu e-mail nowego użytkownika. Zrzut ekranu przycisku dodawania konta usługi.
    4. W formularzu podaj identyfikator konta usługi i wybierz odpowiednie role użytkownika. Wybierz co najmniej jedną opcję, a korzystanie z usługi Accounts wymaga roli administratora.

      Jeśli nie pamiętasz identyfikatora konta usługi, otwórz stronę zarządzania kontami usług i wybierz utworzony przez siebie projekt.

      Dodaj zrzut ekranu strony użytkownika konta usługi.
    5. Kliknij przycisk Zapisz. Wrócisz na listę użytkowników, a identyfikator konta usługi powinien być powiązany z wybranymi rolami użytkowników.
    6. Powtórz te czynności dla wszystkich kont usługi, które chcesz dodać.
    7. Aby wyświetlić obecnych użytkowników konta usługi, otwórz kartę Użytkownicy. Wyświetlą się użytkownicy, których adres e-mail kończy się na 'gserviceaccount.com'.
  3. Teraz możesz uzyskać dostęp do konta Manufacturer Center za pomocą konta usługi, korzystając z domyślnych danych logowania aplikacji Google lub bezpośrednio z procesu obsługi konta usługi. Przykłady interfejsu Manufacturer Center API pokazują, jak używać obu procesów do danych logowania na konto usługi w każdym obsługiwanym języku programowania. Zobacz przykładowy kod, aby wypróbować nowe konto usługi i dowiedzieć się, jakie zmiany musisz wprowadzić w swoim kodzie.

Najczęstsze pytania

Czy mogę zalogować się w interfejsie internetowym Manufacturer Center za pomocą konta usługi?

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

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

Tokeny dostępu wygasają godzinę po wydaniu ich przez serwer autoryzacji Google OAuth 2.0. Po wygaśnięciu tokena dostępu aplikacja powinna używać biblioteki klienta do pobrania kolejnego tokena dostępu.