Aby skutecznie korzystać z interfejsu Merchant API, musisz zrozumieć pojęcia rejestracji, uwierzytelniania i autoryzacji. Służą one do różnych celów, aby zapewnić bezpieczny i prawidłowy dostęp do danych Merchant Center.
Terminologia
Rejestracja, uwierzytelnianie i autoryzacja są ze sobą powiązane, ale każde z tych pojęć ma inne znaczenie i cel.
- Uwierzytelnianie: w tym procesie usługa weryfikuje tożsamość użytkownika lub aplikacji wysyłającej żądanie do interfejsu API. Merchant API korzysta ze standardowych mechanizmów Google, takich jak OAuth 2.0. Używanie kluczy interfejsu API do uwierzytelniania nie jest obsługiwane i powoduje błędy uwierzytelniania. Więcej informacji znajdziesz w artykułach Uwierzytelnianie żądań i Uwierzytelnianie jako własne konto.
- Autoryzacja: ten proces określa, jakie działania może wykonywać uwierzytelniony użytkownik lub aplikacja na koncie Merchant Center. Odpowiada na pytanie: „Co możesz zrobić?” na podstawie ról i uprawnień przyznanych uwierzytelnionemu użytkownikowi na koncie Merchant Center. Na przykład użytkownik może mieć uprawnienia do odczytu danych produktów, ale nie do modyfikowania ustawień konta.
- Rejestracja: w przypadku interfejsu Merchant API jest to jednorazowy proces konfiguracji, który umożliwia Google wysyłanie ważnych powiadomień dotyczących kont sprzedawców, którymi zarządzasz. Rejestracja powoduje dodanie adresów e-mail deweloperów do głównego konta Merchant Center i połączenie go z identyfikatorami projektów Google Cloud, których używasz do uwierzytelniania. Dzięki temu Twoja aplikacja będzie otrzymywać powiadomienia o usłudze dla wszystkich kont sprzedawcy, którymi zarządzasz. Więcej informacji znajdziesz w artykule Tworzenie projektu Google Cloud.
Rejestracja
Proces rejestracji jest kluczowy, aby umożliwić aplikacji korzystanie z interfejsu Merchant API. Oto, co musisz wiedzieć na ten temat:
Wymagania wstępne
Aby zarejestrować się w celu korzystania z interfejsu Merchant API, musisz:
- Konto Merchant Center: musisz mieć konto Merchant Center.
- Dostęp administracyjny: konto użytkownika Google, którego używasz do zainicjowania wywołania rejestracji, musi mieć uprawnienia administratora na koncie Merchant Center, które rejestrujesz.
- Projekt Google Cloud: aplikacja musi być powiązana z projektem Google Cloud. Ten projekt udostępnia niezbędne dane logowania (takie jak identyfikatory klienta OAuth 2.0) do uwierzytelniania aplikacji.
Dlaczego nie możesz zarejestrować udostępnionego projektu w chmurze Google
Narzędzia takie jak Google OAuth Playground i APIs Explorer korzystają z udostępnionych projektów w chmurze Google należących do Google. Nie możesz zarejestrować się w projektach udostępnionych, ponieważ:
- Są przeznaczone do testowania i eksploracji, a nie do tożsamości aplikacji produkcyjnej.
- Zarejestrowanie ich oznaczałoby powiązanie udostępnionego narzędzia z Twoimi konkretnymi danymi w Merchant Center i mogłoby skutkować niechcianą komunikacją.
Twoja aplikacja potrzebuje własnego, dedykowanego projektu Google Cloud, aby komunikaty Merchant API, które wysyła Google, były odpowiednie do rzeczywistego wykorzystania.
Możesz jednak używać aplikacji internetowych OAuth Playground i APIs Explorer, aby korzystać z interfejsu Merchant API do eksperymentowania i zastosowań nieprodukcyjnych.
Znajdowanie identyfikatora projektu Google Cloud
Identyfikator projektu i numer projektu znajdziesz w konsoli Google Cloud. Szczegółowe informacje znajdziesz w artykule Znajdowanie nazwy, numeru i identyfikatora projektu.
Nawiązywanie połączenia rejestracyjnego
Zarejestruj się za pomocą metody registerGcp w podrzędnym interfejsie API Accounts. To wywołanie wiąże numer projektu Google Cloud z kontem Merchant Center.
Podczas tego procesu musisz podać adres e-mail powiązany z indywidualnym użytkownikiem, którego używasz do wywoływania interfejsu API. Ten adres e-mail musi należeć do użytkownika z dostępem administracyjnym do konta Merchant Center.
Informacje o polu E-mail
Skuteczna komunikacja jest kluczowa. Google wysyła ważne aktualizacje, obowiązkowe powiadomienia, ankiety dla deweloperów i inne informacje związane z interfejsem Merchant API. Właściwe zarządzanie kontaktami gwarantuje, że te informacje dotrą do odpowiednich osób.
- Cel: Google używa tego adresu e-mail jako głównej osoby kontaktowej do komunikacji związanej z interfejsem API.
- Czyj adres e-mail: powinien to być adres e-mail dewelopera lub głównej osoby kontaktowej ds. technicznych, która odpowiada za integrację interfejsu API.
- Sprawdzone metody:
- DO: Use an individual's corporate email address.
- NIE używaj ogólnych aliasów grup ani adresów e-mail kont usługi. Komunikaty są przeznaczone dla ludzi.
Zasób users do zarządzania kontaktami
Adres e-mail w wywołaniu rejestracji ustawia początkową osobę kontaktową, ale bardziej niezawodnym sposobem zarządzania kontaktami i uprawnieniami jest użycie zasobu accounts.users interfejsu Merchant API lub ustawień zarządzania użytkownikami w interfejsie Merchant Center. Więcej informacji o korzystaniu z Merchant Center znajdziesz w artykule Zarządzanie osobami na koncie.
Aby skorzystać z tych funkcji:
- Dodaj wszystkich deweloperów: dodaj deweloperów pracujących nad integracją interfejsu API jako użytkowników konta Merchant Center.
- Przypisywanie roli
API_DEVELOPER: oprócz ról standardowych (Administrator, Standardowa) możesz przypisywać użytkownikom rolęAPI_DEVELOPER. Przypisz tę rolę użytkownikom, którzy powinni otrzymywać powiadomienia związane z interfejsem API. Możesz ją łączyć z innymi rolami. - Korzyści:
- Wyraźne rozdzielenie: oddziela zarządzanie kontaktami za pomocą interfejsu API od jednorazowej rejestracji.
- Elastyczność: aktualizuj kontakty, gdy zmieniają się członkowie zespołu.
- Ukierunkowana komunikacja: zapewnia, że wiadomości dotyczące interfejsu API trafiają do odpowiednich osób.
Nawet jeśli podczas rejestracji podano adres e-mail, zdecydowanie zalecamy zarządzanie kontaktami ds. interfejsu API przez dodanie użytkowników z rolą API_DEVELOPER.
Odniesienia
Więcej informacji: