Wykonaj czynności opisane w tym krótkim przewodniku, a w ciągu około 10 minut prostą aplikację wiersza poleceń w języku Python, która wysyła żądania do rejestracji typu zero-touch. rejestracji interfejsu API sprzedawcy.
Wymagania wstępne
Aby skorzystać z tego krótkiego wprowadzenia, musisz mieć:
- konto Google należące do sprzedawcy obsługującego rejestrację typu zero-touch. koncie. Jeśli nie korzystasz jeszcze z tej usługi, wykonaj czynności opisane w sekcji Pierwsze kroki w przewodnika po portalu sprzedawcy.
- Python w wersji 2.6 lub nowszej.
- Zarządzanie pakietami pip .
- Dostęp do internetu i przeglądarki.
Krok 1. Włącz interfejs API rejestracji typu zero-touch
- Użyj tego w kreatorze, aby utworzyć lub wybrać projekt w Google Developers Console oraz automatycznie włączyć interfejs API. Kliknij Dalej, a następnie Przejdź do danych logowania .
- Ustaw Do jakich danych będziesz uzyskiwać dostęp? na Dane aplikacji.
- Kliknij Dalej. Powinien wyświetlić się monit o utworzenie usługi. koncie.
- Nadaj opisową nazwę Nazwa konta usługi.
- Zapisz identyfikator konta usługi (wygląda jak adres e-mail), bo użyjemy jej później.
- Ustaw Rola na Konta usługi > Użytkownik kont usługi.
- Aby zakończyć tworzenie konta usługi, kliknij Gotowe.
- Kliknij adres e-mail utworzonego konta usługi.
- Kliknij **Klucze**.
- Kliknij **Dodaj klucz**, a następnie **Utwórz nowy klucz**.
- W polu **Typ klucza** wybierz **JSON**.
- Kliknij 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 Usługa kont.
- Kliknij Połącz konto usługi.
- Ustaw Adres e-mail na adres utworzonego przez siebie konta usługi.
- Kliknij Połącz konto usługi, aby używać konta usługi w przypadku rejestracji typu zero-touch. konta rejestracji.
Krok 3. Zainstaluj bibliotekę klienta Google
Uruchom następujące polecenie, aby zainstalować bibliotekę za pomocą pip:
pip install --upgrade google-api-python-client
Zobacz instalację biblioteki o innej instalacji .
Krok 4. Skonfiguruj próbkę
Utwórz w katalogu roboczym plik o nazwie quickstart.py
. Skopiuj w
następujący kod i zapisz plik. Wstaw własnego partnera sprzedawcy
ID jako wartość parametru PARTNER_ID
(pierwszy wiersz aplikacji po
importowanie danych).
#!/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 zwykle wymagają identyfikatora partnera sprzedawcy jako argumentu. Aby znaleźć identyfikatora partnera z portalu rejestracji typu zero-touch wykonaj te czynności:
- Otwórz portal. W razie potrzeby zaloguj się.
- Kliknij Usługa kont.
- Skopiuj identyfikator partnera z wiersza Twój identyfikator sprzedawcy.
Krok 5. Uruchamianie przykładu
Uruchom skrypt z pliku, korzystając z pomocy systemu operacyjnego. W systemie UNIX i Mac komputerach, uruchom w terminalu to polecenie:
python quickstart.py
Drukowanie odpowiedzi interfejsu API
Aby łatwiej sprawdzać odpowiedzi podczas testowania interfejsu API, sformatuj plik JSON dane odpowiedzi. Fragment kodu poniżej pokazuje, jak możesz to zrobić w Pythonie za pomocą metody Moduł 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 ramach tego krótkiego wprowadzenia, a my postaramy się napraw to. Aby dowiedzieć się, jak rejestracja typu zero-touch używa kont usługi do autoryzowania wywołań interfejsu API, przeczytaj artykuł Autoryzacja.