Przewodniki szybkiego startu wyjaśniają, jak skonfigurować i uruchamiać aplikację, która wywołuje interfejs Google Workspace API.
Szybkie starty Google Workspace korzystają z bibliotek klienta interfejsu API do obsługi niektórych szczegółów procesu uwierzytelniania i autoryzacji. Zalecamy używanie bibliotek klienta w przypadku własnych aplikacji. W tym krótkim wprowadzeniu użyjemy uproszczonego podejścia do uwierzytelniania, które jest odpowiednie dla środowiska testowego. W przypadku środowiska produkcyjnego zalecamy zapoznanie się z informacjami na temat uwierzytelniania i autoryzacji, zanim wybierzesz odpowiednie dla swojej aplikacji poświadczenia dostępu.
Utwórz aplikację wiersza poleceń w Pythonie, która wysyła żądania do interfejsu Reseller API.
Cele
- skonfigurować środowisko,
- Zainstaluj bibliotekę klienta.
- Skonfiguruj próbkę.
- Uruchom przykład.
Wymagania wstępne
Aby wykonać ten samouczek, musisz spełnić te wymagania wstępne:
- Python 3.10.7 lub nowszy
- Narzędzie do zarządzania pakietami pip
- projekt Google Cloud,
- Domena sprzedawcy Google.
- Prawidłowo podpisana umowa partnerska Google Workspace.
Konfigurowanie środowiska
Aby rozpocząć krótkie wprowadzenie, skonfiguruj środowisko.
Włącz API
Zanim zaczniesz używać interfejsów API Google, musisz je włączyć w projekcie Google Cloud. W jednym projekcie Google Cloud możesz włączyć 1 lub więcej interfejsów API.W konsoli Google Cloud włącz interfejs Reseller API.
Konfigurowanie ekranu zgody OAuth
Jeśli do wykonania tego samouczka używasz nowego projektu Google Cloud, skonfiguruj ekran akceptacji OAuth i dodaj siebie jako użytkownika testowego. Jeśli ten krok został już wykonany w przypadku Twojego projektu Cloud, przejdź do następnej sekcji.
- W konsoli Google Cloud kliknij Menu > Interfejsy API i usługi > Ekran zgody OAuth.
- W polu Typ użytkownika wybierz Wewnętrzny, a następnie kliknij Utwórz.
- Wypełnij formularz rejestracji aplikacji, a potem kliknij Zapisz i kontynuuj.
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 zmienić Typ użytkownika na Zewnętrzny, a następnie dodać zakresy autoryzacji wymagane przez aplikację.
- Sprawdź podsumowanie rejestracji aplikacji. Aby wprowadzić zmiany, kliknij Edytuj. Jeśli rejestracja aplikacji wygląda dobrze, kliknij Powrót do panelu.
Autoryzowanie danych logowania do aplikacji na komputer
Aby uwierzytelniać użytkowników i dostępować do ich danych 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 kilku platformach, musisz utworzyć osobny 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 na komputer.
- W polu Nazwa wpisz nazwę danych logowania. Ta nazwa jest wyświetlana tylko w konsoli Google Cloud.
- Kliknij Utwórz. Pojawi się ekran utworzonego klienta OAuth z nowym identyfikatorem klienta i tajnym kluczem klienta.
- Kliknij OK. Nowo utworzone dane logowania pojawią się w sekcji Identyfikatory klienta OAuth 2.0.
- Zapisz pobrany plik JSON jako
credentials.json
i przenieś go do katalogu roboczego.
Instalowanie biblioteki klienta Google
Zainstaluj bibliotekę klienta Google dla Pythona:
pip install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib
Konfigurowanie przykładu
- W katalogu roboczym utwórz plik o nazwie
quickstart.py
. Dodaj do pliku
quickstart.py
ten kod:
Uruchamianie przykładu
W katalogu roboczym skompiluj i uruchom przykład:
python3 quickstart.py
-
Gdy uruchomisz próbkę po raz pierwszy, pojawi się prośba o autoryzację dostępu:
- Jeśli nie zalogowano się na konto Google, zaloguj się, gdy pojawi się taka prośba. Jeśli logujesz się na kilka kont, wybierz jedno konto, którego chcesz użyć do autoryzacji.
- Kliknij Accept (Zaakceptuj).
Aplikacja Pythona uruchamia się i wywołuje interfejs Reseller API.
Informacje autoryzacyjne są przechowywane w systemie plików, więc następnym razem, gdy uruchomisz przykładowy kod, nie pojawi się prośba o autoryzację.
Dalsze kroki
- Codelab interfejsu Google Workspace Reseller API
- Dokumentacja interfejsu Google Workspace Reseller API
- Dokumentacja klienta interfejsów API Google do języka Python
- Dokumentacja PyDoc interfejsu Reseller API