Wykonaj czynności z tego krótkiego przewodnika. W zaledwie 10 minut otrzymasz prostą aplikację wiersza poleceń w języku Python, która będzie wysyłać żądania do interfejsu API do rejestracji typu zero-touch.
Wymagania wstępne
Aby uruchomić ten krótki przewodnik, musisz mieć:
- konto Google należące do konta sprzedawcy obsługującego rejestrację typu zero-touch, Jeśli jeszcze nie masz konta, wykonaj czynności opisane w sekcji Pierwsze kroki w przewodniku po portalu sprzedawcy.
- Pythona 2.6 lub nowszego.
- Narzędzie do zarządzania pakietami pip.
- Dostęp do internetu i przeglądarki.
Krok 1. Włącz interfejs 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.
- W polu Do jakich danych będziesz mieć dostęp? wybierz Dane aplikacji.
- Kliknij Dalej. Powinna pojawić się prośba o utworzenie konta usługi.
- Podaj nazwę konta usługi opisową.
- Zwróć uwagę na identyfikator konta usługi (wygląda on 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**.
- Jako **Typ klucza** wybierz **JSON**.
- Kliknij Create (Utwórz), a klucz prywatny zostanie pobrany na komputer.
- Kliknij **Zamknij**.
- Przenieś plik do katalogu roboczego i zmień jego nazwę na
service_account_key.json
.
Krok 2. Połącz konto usługi
- Otwórz portal rejestracji typu zero-touch. W razie potrzeby zaloguj się.
- Kliknij Konta usługi.
- Kliknij Połącz konto usługi.
- W polu Adres e-mail wpisz adres utworzonego przez Ciebie konta usługi.
- Kliknij Połącz konto usługi, aby używać konta usługi na koncie rejestracji typu zero-touch.
Krok 3. Zainstaluj bibliotekę klienta Google
Uruchom to polecenie, aby zainstalować bibliotekę za pomocą narzędzia pip:
pip install --upgrade google-api-python-client
Różne opcje instalacji znajdziesz na stronie instalacji biblioteki.
Krok 4. Skonfiguruj próbkę
W katalogu roboczym utwórz plik o nazwie quickstart.py
. Skopiuj ten kod i zapisz plik. Wstaw własny identyfikator partnera sprzedawcy jako wartość dla PARTNER_ID
(pierwszy wiersz aplikacji po zaimportowaniu).
#!/usr/bin/env python # -*- coding: utf-8 -*- """Zero-touch enrollment reseller quickstart. This script forms the quickstart introduction to the zero-touch enrollemnt reseller API. To learn more, visit https://developer.google.com/zero-touch """ from apiclient.discovery import build from httplib2 import Http from oauth2client.service_account import ServiceAccountCredentials # TODO: replace this with your partner reseller ID. PARTNER_ID = '11036885'; # A single auth scope is used for the zero-touch enrollment customer API. SCOPES = ['https://www.googleapis.com/auth/androidworkprovisioning'] SERVICE_ACCOUNT_KEY_FILE = 'service_account_key.json' def get_credential(): """Creates a Credential object with the correct OAuth2 authorization. Creates a Credential object with the correct OAuth2 authorization for the service account that calls the reseller API. The service endpoint calls this method when setting up a new service instance. Returns: Credential, the user's credential. """ credential = ServiceAccountCredentials.from_json_keyfile_name( SERVICE_ACCOUNT_KEY_FILE, scopes=SCOPES) return credential def get_service(): """Creates a service endpoint for the zero-touch enrollment reseller 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(Http()) service = build('androiddeviceprovisioning', 'v1', http=http_auth) return service def main(): """Runs the zero-touch enrollment quickstart app. """ # Create a zero-touch enrollment API service endpoint. service = get_service() # Send an API request to list all our customers. response = service.partners().customers().list(partnerId=PARTNER_ID).execute() # Print out the details of each customer. if 'customers' in response: for customer in response['customers']: print 'Name:{0} ID:{1}'.format( customer['companyName'], customer['companyId']) else: print 'No customers found' if __name__ == '__main__': main()
Identyfikator partnera
Wywołania interfejsu API zazwyczaj wymagają podania identyfikatora partnera sprzedawcy jako argumentu. Aby znaleźć swój identyfikator partnera w portalu rejestracji typu zero-touch, wykonaj te czynności:
- Otwórz portal. W razie potrzeby zaloguj się.
- Kliknij Konta usługi.
- Skopiuj swój identyfikator partnera z wiersza Twój identyfikator sprzedawcy.
Krok 5. Uruchom przykład
Użyj skryptu w systemie operacyjnym, by uruchomić skrypt w pliku. Na komputerach UNIX i Mac wykonaj w terminalu to polecenie:
python quickstart.py
Drukowanie odpowiedzi interfejsu API
Aby ułatwić przeglądanie odpowiedzi podczas testowania interfejsu API, sformatuj dane odpowiedzi JSON. Fragment kodu poniżej pokazuje, jak to zrobić w Pythonie przy użyciu modułu JSON:
from json import dumps
# ...
results = provisioning.partners().devices().claimAsync(partnerId=MY_PARTNER_ID,
body={'claims':new_claims}).execute()
# Print formatted JSON response
print dumps(results, indent=4, sort_keys=True)
Rozwiązywanie problemów
Powiedz nam, co poszło nie tak w krótkim wprowadzeniu, a my postaramy się rozwiązać ten problem. Aby dowiedzieć się, jak zero-touch używa kont usługi do autoryzowania wywołań interfejsu API, przeczytaj artykuł Autoryzacja.