Z tego przewodnika dowiesz się, jak za pomocą protokołu OAuth 2.0 prosić o dostęp do kont sprzedawców w innych usługach. Jeśli jesteś zewnętrznym dostawcą, skorzystaj z tego procesu, aby umożliwić swojej aplikacji wysyłanie próśb o dostęp do kont sprzedawców Twoich klientów.
Jeśli tworzysz aplikację wewnętrzna, która wymaga dostępu tylko do Twojego konta sprzedawcy, przeczytaj artykuł o uzyskiwaniu dostępu do konta.
Poproś o weryfikację aplikacji
Aplikacje, które mają dostęp do interfejsu Merchant API, muszą przejść proces weryfikacji OAuth. Niezweryfikowane aplikacje będą otrzymywać ostrzeżenia i mają ograniczoną funkcjonalność.
Aplikacja to wszystko, co ma w Google Cloud unikalny identyfikator klienta OAuth 2.0.
Proces weryfikacji zajmuje zwykle 3–5 dni roboczych. Więcej informacji i formularz prośby o weryfikację znajdziesz w artykule o weryfikacji aplikacji.
Ta zasada dotyczy wszystkich aplikacji. Aby uniknąć przerw w działalności, zalecamy jak najszybsze przejście procesu weryfikacji w aplikacjach.
Pobieranie zakresów OAuth
Aby uniknąć problemów z wyborem zakresu, skonfiguruj autoryzację przyrostową.
Jeśli poprosisz o więcej niż 1 zakres, na ekranie zgody w przypadku aplikacji domyślnie odznaczone są wszystkie zakresy OAuth. Gdy Twoja aplikacja wyświetla ekran zgody, użytkownik musi ręcznie wybrać każdy zakres, aby autoryzować dostęp.
Sprawdź odpowiedź na żądanie OAuth, aby upewnić się, że aplikacja ma odpowiednie zakresy.
Więcej informacji znajdziesz w zasadach OAuth 2.0.
Autoryzowanie żądań
Każde żądanie wysyłane przez aplikację do interfejsu API sprzedawcy musi zawierać token autoryzacji. Token stanowi też dla Google identyfikator aplikacji.
Informacje o protokołach autoryzacji
Twoja aplikacja musi autoryzować żądania za pomocą protokołu OAuth 2.0. Inne protokoły nie są obsługiwane. Jeśli aplikacja używa funkcji Zaloguj się przez Google, niektórymi aspektami autoryzacji nie musisz się zajmować.
Autoryzowanie żądań za pomocą protokołu OAuth 2.0
Wszystkie żądania wysyłane do interfejsu API sprzedawcy muszą być autoryzowane przez użytkownika.
Szczegóły procesu autoryzacji z użyciem protokołu OAuth 2.0 różnią się nieznacznie w zależności od rodzaju projektowanej aplikacji. Do większości typów aplikacji ma zastosowanie ten ogólny proces:
- Gdy tworzysz aplikację, rejestrujesz ją, korzystając z konsoli interfejsów API Google. Następnie Google przekazuje informacje, które są potrzebne później, takie jak identyfikator klienta i tajny klucz klienta.
- Aktywuj interfejs Merchant API w Konsoli interfejsów API Google. (jeśli interfejsu API nie ma na liście w konsoli, pomijasz ten krok).
- Gdy Twoja aplikacja potrzebuje dostępu do danych użytkownika, prosi Google o konkretny zakres dostępu.
- Google wyświetla użytkownikowi ekran zgody z prośbą o autoryzowanie dostępu aplikacji do niektórych danych.
- Jeśli użytkownik wyrazi zgodę, Google przekazuje Twojej aplikacji ważny przez krótki czas token dostępu.
- Aplikacja żąda danych użytkownika i dołącza do żądania token dostępu.
- Jeśli Google uzna, że żądanie i token są prawidłowe, przesyła dane, o które prosisz.
Niektóre procesy obejmują dodatkowe kroki, takie jak wykorzystanie tokenów odświeżania do uzyskania nowych tokenów dostępu. Szczegółowe informacje o procesach obowiązujących w przypadku różnych typów aplikacji znajdziesz w dokumencie Google na temat protokołu OAuth 2.0.
Informacje o zakresie OAuth 2.0 dla interfejsu Merchant API:
| Zakres | Znaczenie |
|---|---|
https://www.googleapis.com/auth/content |
Uprawnienia do odczytu/zapisu. |
Aby poprosić o dostęp przy użyciu protokołu OAuth 2.0, aplikacja potrzebuje danych z zakresu oraz informacji przekazywanych przez Google po zarejestrowaniu aplikacji (takich jak identyfikator klienta i tajny klucz klienta).
Oto przykład, którego możesz użyć do autoryzacji.