Krótkie wprowadzenia wyjaśniają, jak skonfigurować i uruchomić aplikację, która wywołuje interfejs Google Workspace API.
W krótkich wprowadzeniu do Google Workspace do obsługi niektórych szczegółów procesu uwierzytelniania i autoryzacji używane są biblioteki klienta interfejsu API. Na potrzeby własnych aplikacji zalecamy używanie bibliotek klienta. W tym krótkim wprowadzeniu zastosowano uproszczoną metodę uwierzytelniania odpowiednią do środowiska testowego. W przypadku środowiska produkcyjnego zalecamy zapoznanie się z uwierzytelnianiem i autoryzacją przed wybraniem danych logowania odpowiednich do aplikacji.
Utworzyć aplikację internetową w języku JavaScript, która wysyła żądania do interfejsu Seller API.
Cele
- skonfigurować środowisko,
- Skonfiguruj sampel.
- Uruchom przykład.
Wymagania wstępne
- Zainstalowano Node.js i npm.
- Projekt Google Cloud.
- Wystąpienie domeny sprzedawcy Google.
- Pełno podpisana umowa partnerska Google Workspace.
Konfigurowanie środowiska
Aby ukończyć to krótkie wprowadzenie, skonfiguruj środowisko.
Włącz API
Zanim zaczniesz korzystać z interfejsów API Google, musisz włączyć je w projekcie Google Cloud. Możesz włączyć 1 lub więcej interfejsów API w pojedynczym projekcie Google Cloud.Włącz interfejs Seller API w konsoli Google Cloud.
Konfigurowanie ekranu zgody OAuth
Jeśli do wykonania tego samouczka używasz nowego projektu Google Cloud, skonfiguruj ekran zgody OAuth i dodaj siebie jako użytkownika testowego. Jeśli ten krok został już ukończony w przypadku Twojego projektu Cloud, przejdź do następnej sekcji.
- W konsoli Google Cloud otwórz Menu > Interfejsy API i usługi > Ekran zgody OAuth.
- Wybierz typ użytkownika swojej aplikacji, a potem kliknij Utwórz.
- Wypełnij formularz rejestracji aplikacji, a następnie kliknij Zapisz i kontynuuj.
Na razie możesz pominąć dodawanie zakresów i kliknąć Zapisz i kontynuuj. Gdy w przyszłości będziesz tworzyć aplikację do użytku poza organizacją Google Workspace, musisz dodać i zweryfikować zakresy autoryzacji wymagane przez tę aplikację.
- Jeśli jako typ użytkownika wybierzesz Zewnętrzny, dodaj użytkowników testowych:
- W sekcji Użytkownicy testowi kliknij Dodaj użytkowników.
- Wpisz swój adres e-mail oraz adresy pozostałych autoryzowanych użytkowników testowych, a następnie kliknij Zapisz i kontynuuj.
- Przejrzyj podsumowanie rejestracji aplikacji. Aby wprowadzić zmiany, kliknij Edytuj. Jeśli rejestracja aplikacji wygląda OK, kliknij Back to Dashboard (Powrót do panelu).
Autoryzacja danych logowania do aplikacji internetowej
Aby uwierzytelnić się jako użytkownik i uzyskać dostęp do danych użytkownika w aplikacji, musisz utworzyć co najmniej 1 identyfikator klienta OAuth 2.0. Identyfikator klienta wskazuje konkretną aplikację na serwerach OAuth Google. Jeśli Twoja aplikacja działa na wielu platformach, musisz utworzyć oddzielny identyfikator klienta dla każdej z nich.- W konsoli Google Cloud otwórz Menu > Interfejsy API i usługi > Dane logowania.
- Kliknij Utwórz dane logowania > Identyfikator klienta OAuth.
- Kliknij Typ aplikacji > Aplikacja internetowa.
- W polu Nazwa wpisz nazwę danych logowania. Ta nazwa jest wyświetlana tylko w konsoli Google Cloud.
- Dodaj autoryzowane identyfikatory URI powiązane z aplikacją:
- Aplikacje po stronie klienta (JavaScript) – w sekcji Autoryzowane źródła JavaScript kliknij Dodaj identyfikator URI. Następnie wpisz identyfikator URI, którego będziesz używać do obsługi żądań przeglądarki. Określa domeny, z których aplikacja może wysyłać żądania interfejsu API do serwera OAuth 2.0.
- Aplikacje po stronie serwera (Java, Python i inne) – w sekcji Autoryzowane identyfikatory URI przekierowania kliknij Dodaj identyfikator URI. Następnie wpisz identyfikator URI punktu końcowego, do którego serwer OAuth 2.0 może wysyłać odpowiedzi.
- Kliknij Utwórz. Pojawi się ekran utworzonego klienta OAuth zawierający nowy identyfikator i tajny klucz klienta.
Zapisz identyfikator klienta. Tajne klucze klienta nie są używane w przypadku aplikacji internetowych.
- Kliknij OK. Nowo utworzone dane logowania pojawią się w sekcji Identyfikatory klienta OAuth 2.0.
Zanotuj te dane logowania, ponieważ będą Ci potrzebne później w tym krótkim wprowadzeniu.
utworzysz klucz interfejsu API;
- W konsoli Google Cloud otwórz Menu > Interfejsy API i usługi > Dane logowania.
- Kliknij Utwórz dane logowania > Klucz interfejsu API.
- Zostanie wyświetlony nowy klucz interfejsu API.
- Kliknij Kopiuj , aby skopiować klucz interfejsu API i użyć go w kodzie aplikacji. Klucz interfejsu API znajdziesz też w sekcji „Klucze interfejsu API” danych logowania projektu.
- Kliknij Ogranicz klucz, aby zaktualizować ustawienia zaawansowane i ograniczyć wykorzystanie klucza interfejsu API. Więcej informacji znajdziesz w artykule Stosowanie ograniczeń klucza interfejsu API.
Konfigurowanie fragmentu
- W katalogu roboczym utwórz plik o nazwie
index.html
. W pliku
index.html
wklej ten przykładowy kod:Zastąp następujące elementy:
YOUR_CLIENT_ID
: identyfikator klienta utworzony podczas autoryzowania danych logowania do aplikacji internetowej.YOUR_API_KEY
: klucz interfejsu API utworzony jako warunek wstępny.
Uruchamianie przykładu
W katalogu roboczym zainstaluj pakiet http-server:
npm install http-server
W swoim katalogu roboczym uruchom serwer WWW:
npx http-server -p 8000
- W przeglądarce otwórz stronę
http://localhost:8000
. -
Pojawi się prośba o autoryzację dostępu:
- Jeśli wyświetli się prośba o zalogowanie się na konto Google, zaloguj się, gdy pojawi się taka prośba. Jeśli logujesz się na wiele kont, wybierz jedno, którego chcesz użyć do autoryzacji.
- Kliknij Accept (Zaakceptuj).
Aplikacja JavaScript uruchamia się i wywołuje interfejs Seller API.
Dalsze kroki
- Ćwiczenie z programowania dotyczące interfejsu Google Workspace Seller API
- Dokumentacja interfejsu Google Workspace Seller API
- Sekcja
google-api-javascript-client
w GitHub