Wykonaj czynności opisane w tym krótkim przewodniku, a w ciągu 10 minut masz do dyspozycji prostą aplikację wiersza poleceń Pythona, która wysyła żądania do interfejsu API rejestracji typu zero-touch za pomocą konta usługi.
Wymagania wstępne
Aby to zrobić, potrzebujesz:
- Konto usługi połączone z kontem klienta rejestracji typu zero-touch. Zobacz Pierwsze kroki.
- Python w wersji 3.0 lub nowszej.
- Narzędzie do zarządzania pakietami pip.
- Dostęp do internetu i przeglądarki.
Krok 1. Włącz interfejs API do rejestracji typu zero-touch
- Aby utworzyć lub wybrać projekt w Google Developers Console, i automatycznie włączyć ten interfejs API, użyj tego kreatora. Kliknij Dalej, a następnie Otwórz dane logowania.
- Ustaw Jakie dane będą dostępne? na Dane aplikacji.
- Kliknij Dalej. Pojawi się prośba o utworzenie konta usługi.
- Nadaj nazwę konta usługi opisową.
- Zapisz identyfikator konta usługi (wygląda jak adres e-mail), ponieważ będziesz go używać później.
- Ustaw Rolę na Konta usługi > Użytkownik konta usługi.
- Aby zakończyć tworzenie konta usługi, kliknij Gotowe.
- Kliknij adres e-mail utworzonego przez siebie konta usługi.
- Kliknij **Klucze**.
- Kliknij **Dodaj klucz**, a następnie **Utwórz nowy klucz**.
- W polu **Typ klucza** wybierz **JSON**.
- Kliknij Utwórz, aby pobrać klucz prywatny na komputer.
- Kliknij **Zamknij**.
- Przenieś plik do katalogu roboczego i zmień jego nazwę na
service_account_key.json
.
Krok 2. Zainstaluj bibliotekę klienta Google
Uruchom to polecenie, aby zainstalować bibliotekę za pomocą pip:
pip install --upgrade google-api-python-client oauth2client
Opis opcji instalacji znajdziesz na stronie instalacji biblioteki.
Krok 3. Skonfiguruj przykład
W katalogu roboczym utwórz plik o nazwie quickstart.py
. Skopiuj ten kod i zapisz plik.
#!/usr/bin/env python # -*- coding: utf-8 -*- """Zero-touch enrollment quickstart sample. This script forms the quickstart introduction to the zero-touch enrollemnt customer API. To learn more, visit https://developer.google.com/zero-touch """ import sys from apiclient import discovery import httplib2 from oauth2client.service_account import ServiceAccountCredentials # A single auth scope is used for the zero-touch enrollment customer API. SCOPES = ['https://www.googleapis.com/auth/androidworkzerotouchemm'] SERVICE_ACCOUNT_KEY_FILE = 'service_account_key.json' def get_credential(): """Creates a Credential object with the correct OAuth2 authorization. Uses the service account key stored in SERVICE_ACCOUNT_KEY_FILE. Returns: Credentials, the user's credential. """ credential = ServiceAccountCredentials.from_json_keyfile_name( SERVICE_ACCOUNT_KEY_FILE, SCOPES) if not credential or credential.invalid: print('Unable to authenticate using service account key.') sys.exit() return credential def get_service(): """Creates a service endpoint for the zero-touch enrollment API. Builds and returns an authorized API client service for v1 of the API. Use the service endpoint to call the API methods. Returns: A service Resource object with methods for interacting with the service. """ http_auth = get_credential().authorize(httplib2.Http()) return discovery.build('androiddeviceprovisioning', 'v1', http=http_auth) def main(): """Runs the zero-touch enrollment quickstart app. """ # Create a zero-touch enrollment API service endpoint. service = get_service() # Get the customer's account. Because a customer might have more # than one, limit the results to the first account found. response = service.customers().list(pageSize=1).execute() if 'customers' not in response: # No accounts found for the user. Confirm the Google Account # that authorizes the request can access the zero-touch portal. print('No zero-touch enrollment account found.') sys.exit() customer_account = response['customers'][0]['name'] # Send an API request to list all the DPCs available using the customer # account. results = service.customers().dpcs().list(parent=customer_account).execute() # Print out the details of each DPC. for dpc in results['dpcs']: # Some DPCs may not have a name, so replace with a marker. if 'dpcName' in dpc: dpcName = dpc['dpcName'] else: dpcName = "-" print('Name:{0} APK:{1}'.format(dpcName, dpc['packageName'])) if __name__ == '__main__': main()
Krok 4. Dodaj klucz konta usługi
Skopiuj service_account_key.json
pobrany podczas tworzenia konta usługi do katalogu roboczego.
Krok 5. Uruchom przykład
Skorzystaj z pomocy systemu operacyjnego, aby uruchomić skrypt w pliku. Na komputerach UNIX i Mac wykonaj w terminalu polecenie poniżej:
python quickstart.py
Uwagi
- Unikaj udostępniania pliku (
service_account_key.json
). Uważaj, aby nie umieścić go w repozytoriach kodu źródłowego. Możesz dowiedzieć się więcej o obsłudze obiektów tajnych konta usługi.