Konta usługi to specjalne konta Google, których aplikacje mogą używać do uzyskiwania dostępu do interfejsów API Google za pomocą protokołu OAuth 2.0. Konto usługi korzysta z procesu OAuth 2.0, który nie wymaga autoryzacji przez człowieka. Zamiast tego korzysta z pliku klucza, do którego ma dostęp tylko Twoja aplikacja. W tym przewodniku opisujemy, jak uzyskać dostęp do interfejsu Content API for Shopping za pomocą kont usługi.
Uwaga: aplikacje wykorzystujące konta usługi do uwierzytelniania mają dostęp tylko do Twojego konta Merchant Center. Jeśli piszesz aplikację innej firmy, która wymaga dostępu do kont Merchant Center Twoich klientów, zapoznaj się z poniższym przewodnikiem Autoryzowanie żądań.
Wymagania wstępne
- konto Merchant Center;
Instrukcje korzystania z konta usługi do uzyskiwania dostępu do interfejsu Content API dla Zakupów
- Wygeneruj dane logowania do konta usługi lub uzyskaj dostęp do wygenerowanych już danych publicznych. Musisz utworzyć identyfikator klienta OAuth 2.0 i uzyskać plik klucza prywatnego *.json:
- Otwórz konsolę interfejsów API Google.
- Wybierz projekt w menu u góry strony. Jeśli jeszcze go nie masz, utwórz go, klikając NOWY PROJEKT.
- Jeśli interfejs Content API for Shopping nie jest jeszcze włączony w tym projekcie, wyszukaj go na liście interfejsów API Google i go włącz.
- Na pasku bocznym po lewej stronie kliknij Dane logowania. Aby to zrobić, konieczne może być kliknięcie strzałki skierowanej w lewo w górnym lewym rogu.
- Aby skonfigurować konto usługi, kliknij UTWÓRZ DANE LOGOWANIA, a następnie Konto usługi.
- Nazwij nowe konto usługi. Jest to też domyślna nazwa użytkownika identyfikatora konta usługi. Zapisz identyfikator konta usługi, w tym część po znaku „@”, aby użyć go później. Kliknij UTWÓRZ, a potem wykonaj opcjonalne kroki przyznawania dostępu projektowi i użytkownikom, a potem kliknij GOTOWE.
Wybór roli konta usługi nie ma wpływu na to, jakie wywołania można wykonywać do Content API, ponieważ dostęp do metod Content API jest określany przez rolę powiązaną z identyfikatorem konta usługi w Merchant Center. Jeśli nie masz pewności, co wybrać, kliknij Projekt > Widok.
- Nastąpi przekierowanie na stronę Konta usługi, na której możesz uzyskać dostęp do nowego konta usługi.
- Aby uzyskać klucz prywatny JSON, kliknij konto usługi, a następnie kliknij kartę KLUCZY. Kliknij DODAJ KLUCZ > Utwórz nowy klucz, a następnie wybierz typ klucza JSON. Kliknij UTWÓRZ, aby pobrać klucz prywatny na komputer.
- Dodaj nowe konto usługi jako użytkownika do konta Merchant Center. Jeśli jesteś deweloperem zewnętrznym, musisz poprosić o to swojego klienta.
- Otwórz konto Merchant Center.
- W ustawieniach konta Merchant Center otwórz sekcję Dostęp do konta.
- Kliknij + Dodaj użytkownika i użyj identyfikatora konta usługi jako adresu e-mail nowego użytkownika.
Jeśli nie masz zapisanego identyfikatora konta usługi, otwórz stronę administracyjną Konta usługi i wybierz utworzony projekt.
- Określ ustawienia dostępu użytkownika i powiadomień e-mail dla konta usługi. Pamiętaj, że używanie usługi
Accounts
wymaga uprawnień administratora. - Kliknij Dodaj użytkownika, aby zapisać ustawienia i wrócić do listy użytkowników. Identyfikator konta usługi powinien być podany wraz z wybraną rolą użytkownika.
- Powtórz te czynności dla wszystkich innych kont usługi, które chcesz dodać.
- Teraz możesz uzyskać dostęp do konta Merchant Center za pomocą konta usługi, korzystając z procesu domyślnych danych logowania aplikacji Google lub bezpośrednio przez proces dotyczący konta usługi. Przykłady interfejsu Content API for Shopping pokazują, jak używać obu sposobów uwierzytelniania konta usługi w każdym obsługiwanym języku programowania. Zapoznaj się z przykładami kodu, aby wypróbować nowe konto usługi i dowiedz się, jakie zmiany musisz wprowadzić, aby używać kont usługi w swoim kodzie.
Najczęstsze pytania
- Czy mogę zalogować się w interfejsie 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 1 godzinie od momentu 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.