Krótkie wprowadzenie wyjaśniają, jak skonfigurować i uruchomić aplikację, która wywołuje interfejs Google Workspace API.
Krótkie wprowadzenia do Google Workspace wykorzystują biblioteki klienta API do obsługi niektórych szczegółów procesu uwierzytelniania i autoryzacji. Zalecamy używanie bibliotek klienta dla własnych aplikacji. Przed uruchomieniem przykładowej aplikacji każde krótkie wprowadzenie wymaga włączenia uwierzytelniania i autoryzacji. Jeśli nie wiesz, jak uwierzytelnić i autoryzować interfejsy API Google Workspace, przeczytaj artykuł Omówienie uwierzytelniania i autoryzacji.
utworzyć aplikację wiersza poleceń JavaScript, która wysyła żądania do interfejsu Reseller API;
Cele
- skonfigurować środowisko,
- Skonfiguruj przykład.
- uruchomić przykład.
Wymagania wstępne
- Python 2.4 lub nowszy, aby uruchomić serwer WWW.
- Projekt Google Cloud.
- Instancja domeny sprzedawcy Google.
- Pełna umowa partnerska Google Workspace.
Konfigurowanie środowiska
Aby dokończyć ten krótki przewodnik, skonfiguruj środowisko.
Włącz API
Zanim zaczniesz korzystać z interfejsów API Google, musisz włączyć je w projekcie Google Cloud. W jednym projekcie Google Cloud możesz włączyć jeden lub więcej interfejsów API.W konsoli Google Cloud włącz interfejs Seller API.
Autoryzowanie danych logowania do aplikacji internetowej
Aby uwierzytelnić się jako użytkownik końcowy i uzyskać dostęp do danych użytkownika w aplikacji, musisz utworzyć co najmniej 1 identyfikator klienta OAuth 2.0. Identyfikator klienta służy do identyfikowania jednej aplikacji na serwerach OAuth Google. Jeśli aplikacja działa na wielu platformach, musisz utworzyć oddzielny identyfikator klienta dla każdej z nich.- W konsoli Google Cloud kliknij 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 widoczna tylko w konsoli Google Cloud.
- Dodaj autoryzowane identyfikatory URI powiązane z aplikacją:
- Aplikacje po stronie klienta (JavaScript) – w sekcji Autoryzowane źródła JavaScriptu kliknij Dodaj identyfikator URI. Następnie wpisz identyfikator URI, który będzie używany w żądaniach dotyczących przeglądarki. Określa domeny, z których aplikacja może wysyłać żądania do interfejsu API na serwer 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, na który serwer OAuth 2.0 może wysyłać odpowiedzi.
- Kliknij Utwórz. Pojawi się ekran utworzony przez klienta OAuth zawierający nowy identyfikator klienta i tajny klucz klienta.
Zapisz identyfikator klienta. Tajne klucze klienta nie są używane w aplikacjach internetowych.
- Kliknij OK. Nowo utworzone dane logowania pojawią się w sekcji Identyfikatory klienta OAuth 2.0.
- Opcjonalnie: jeśli dane logowania tworzysz jako wstępny warunek do uruchomienia JavaScriptu, musisz też wygenerować klucz interfejsu API.
Zanotuj te dane logowania, ponieważ będą potrzebne później w tym krótkim wprowadzeniu.
Skonfiguruj próbkę
- 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 autoryzacji danych aplikacji internetowej.YOUR_API_KEY
: klucz interfejsu API utworzony przez Ciebie jako wymagania wstępne.
Uruchom przykład
W katalogu roboczym uruchom serwer WWW:
Python 2.x
python -m SimpleHTTPServer 8000
Python 3.x
python3 -m http.server 8000
W przeglądarce otwórz stronę
http://localhost:8000
.Przy pierwszym uruchomieniu próbki pojawi się prośba o autoryzację dostępu:
- Jeśli nie zalogowano się na konto Google, pojawi się prośba o zalogowanie. Jeśli logujesz się na wiele kont, wybierz to, którego chcesz użyć do autoryzacji.
- Kliknij Accept (Zaakceptuj).
- Skopiuj kod z przeglądarki, wklej go w wierszu poleceń i naciśnij
Enter
.
Informacje o autoryzacji są przechowywane w systemie plików, więc przy następnym uruchomieniu przykładowego kodu nie pojawi się prośba o autoryzację.
Udało Ci się utworzyć pierwszą aplikację JavaScript, która wysyła żądania do interfejsu Reseller API.