Aby zapewnić bezpieczeństwo danych, wymusić kontrolę dostępu i zachować integralność systemu, musisz uwierzytelniać wszystkie żądania do interfejsu Merchant API. Interfejs API używa uwierzytelnionej tożsamości, aby określić, jakie działania może wykonać wywołujący. Na przykład niektórzy wywołujący mogą mieć dostęp tylko do odczytu do danych o produktach, podczas gdy inni mogą modyfikować ustawienia konta w Merchant Center.
Ten dokument jest częścią wieloczęściowej serii artykułów o tym, jak zacząć korzystać z interfejsu Merchant API. Jeśli masz już skonfigurowane uwierzytelnianie za pomocą interfejsu Merchant API, możesz przejść do następnej sekcji: Zarejestruj się jako deweloper .
Autoryzowanie żądań do interfejsu Merchant API
Każde żądanie wysyłane do interfejsu Merchant API musi zawierać token autoryzacji, który identyfikuje Twoją aplikację w Google. Aby skonfigurować uwierzytelnianie i autoryzację, wybierz przypadek użycia, który najlepiej opisuje sposób, w jaki planujesz korzystać z interfejsu Merchant API:
Czy tworzysz aplikację, z której będą korzystać inne firmy?
Jeśli tak, używasz autoryzacji OAuth 2.0. Wybierz autoryzację OAuth 2.0, jeśli:
- Jesteś dostawcą zewnętrznym lub agencją: tworzysz aplikację, np. platformę SaaS, która będzie używana przez inne firmy do zarządzania ich własnymi danymi w Merchant Center.
- Musisz zarządzać wieloma kontami zewnętrznymi: chcesz, aby jedna aplikacja działała na wielu niezależnych kontach Merchant Center należących do różnych klientów. Klienci przyznają uprawnienia, logując się na swoje konta Google i klikając „Zezwól” na ekranie zgody.
Czy tworzysz aplikację dla własnej firmy?
Jeśli tak, używasz autoryzacji konta usługi, aby uzyskać dostęp do interfejsu Merchant API. Wybierz autoryzację konta usługi, jeśli:
- Tworzysz własną aplikację wewnętrzną: tworzysz narzędzie przeznaczone specjalnie dla Twojej firmy do zarządzania danymi Merchant Center lub chcesz, aby dane logowania należały do samej aplikacji, a nie do konkretnego użytkownika.
- Potrzebujesz automatyzacji bez logowania się człowieka: aplikacja wykonuje zadania w tle, takie jak automatyczne aktualizacje asortymentu lub zadania „cron”.
Autoryzacja OAuth 2.0
Jeśli reprezentujesz dostawcę zewnętrznego lub agencję zarządzającą wieloma kontami klientów, Twoja aplikacja musi autoryzować żądania za pomocą protokołu OAuth 2.0. Aby skonfigurować protokół OAuth 2.0 dla interfejsu Merchant API, wykonaj te czynności:
- Utwórz dane logowania OAuth 2.0 w sekcji Interfejsy API i usługi w konsoli Google Cloud.
- Pobierz dane uwierzytelniające klienta OAuth2 do pliku, np.
client-secrets.json. - Dodaj konto e-mail jako użytkownika do Merchant Center: upewnij się, że konto Google, którego używasz do autoryzowania żądań, jest dodane jako użytkownik w Merchant Center. Więcej informacji znajdziesz w artykule Jak dodać lub usunąć użytkownika z Merchant Center.
- Aby przeprowadzić rejestrację, przypisz mu rolę
Admin. Więcej informacji o rolach znajdziesz w artykule Zarządzanie osobami i poziomami dostępu w Merchant Center. - Skonfiguruj uwierzytelnianie za pomocą przykładowego kodu: postępuj zgodnie ze wskazówkami podanymi w sekcji dokumentacji dotyczącej konfigurowania uwierzytelniania i przykładowej konfiguracji.
Więcej informacji o autoryzacji OAuth 2.0 znajdziesz w artykułach Autoryzowanie dostępu aplikacji innych firm do konta Merchant Center i Używanie protokołu OAuth 2.0 na potrzeby dostępu do interfejsów API Google.
Autoryzacja konta usługi
Aby autoryzować dostęp interfejsu Merchant API do swojego konta Merchant Center, używasz konta usługi. Aby skonfigurować autoryzację konta usługi dla interfejsu Merchant API, wykonaj te czynności:
- Utwórz dane logowania do konta usługi w sekcji Interfejsy API i usługi w konsoli Google Cloud.
- Pobierz klucz prywatny: utwórz i pobierz klucz prywatny w formacie JSON dla konta usługi. Zmień nazwę pliku na
service-account.json - Dodaj konto usługi do Merchant Center: skopiuj unikalny adres e-mail konta usługi, np.
sa@project.iam.gserviceaccount.com, i dodaj go jako nowego użytkownika w Merchant Center. Więcej informacji znajdziesz w artykule Dodawanie i usuwanie użytkowników w Merchant Center. - Przypisz jej dostęp
Admin. Więcej informacji o poziomach dostępu znajdziesz w artykule Zarządzanie osobami i poziomami dostępu w Merchant Center. - Skonfiguruj uwierzytelnianie za pomocą przykładowego kodu: postępuj zgodnie ze wskazówkami podanymi w oficjalnych przykładowych kodach w sekcji dokumentacji dotyczącej konfigurowania uwierzytelniania i przykładowej konfiguracji.
Więcej informacji o autoryzacji konta usługi znajdziesz w artykułach Autoryzowanie dostępu do konta Merchant Center i Omówienie kont usługi.