Suivez les étapes de ce guide de démarrage rapide. En 10 minutes environ, vous disposez d'une application de ligne de commande Python simple qui envoie des requêtes à l'API cliente d'inscription sans contact à l'aide d'un compte de service.
Prérequis
Pour exécuter ce guide de démarrage rapide, vous avez besoin des éléments suivants:
- Un compte de service, qui est associé à votre compte client d'inscription sans contact. Consultez la section Premiers pas.
- Python 3.0 ou version ultérieure.
- L'outil de gestion de packages pip.
- Accès à Internet et à un navigateur Web.
Étape 1: Activez l'API d'enregistrement sans contact
- Utilisez cet assistant pour créer ou sélectionner un projet dans la Google Developers Console et activer automatiquement l'API. Cliquez sur Continuer, puis sur Accéder aux identifiants.
- Dans le champ Données auxquelles vous accédez, choisissez Données de l'application.
- Cliquez sur Suivant. Vous devriez être invité à créer un compte de service.
- Donnez un nom descriptif pour Nom du compte de service.
- Notez l'ID de compte de service (qui ressemble à une adresse e-mail), car vous en aurez besoin ultérieurement.
- Définissez Rôle sur Comptes de service > Utilisateur du compte de service.
- Cliquez sur OK pour terminer la création du compte de service.
- Cliquez sur l'adresse e-mail du compte de service créé.
- Cliquez sur **Clés**.
- Cliquez sur **Ajouter une clé**, puis sur **Créer une clé**.
- Pour **Type de clé**, sélectionnez **JSON**.
- Cliquez sur Créer. La clé privée est alors téléchargée sur votre ordinateur.
- Cliquez sur **Fermer**.
- Déplacez le fichier dans votre répertoire de travail et renommez-le
service_account_key.json
.
Étape 2: Installez la bibliothèque cliente Google
Exécutez la commande suivante pour installer la bibliothèque à l'aide de pip:
pip install --upgrade google-api-python-client oauth2client
Consultez la page d'installation de la bibliothèque pour connaître les différentes options d'installation.
Étape 3: Configurez l'exemple
Créez un fichier nommé quickstart.py
dans votre répertoire de travail. Copiez le code suivant et enregistrez le fichier.
#!/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()
Étape 4: Ajoutez votre clé de compte de service
Copiez le fichier service_account_key.json
que vous avez téléchargé lors de la création de votre compte de service dans votre répertoire de travail.
Étape 5: Exécuter l'exemple
Utilisez l'aide de votre système d'exploitation pour exécuter le script du fichier. Sur les ordinateurs UNIX et Mac, exécutez la commande ci-dessous dans votre terminal:
python quickstart.py
Notes
- Évitez de partager votre fichier
service_account_key.json
avec d'autres personnes. Veillez à ne pas l'inclure dans des dépôts de code source. Pour en savoir plus, consultez Gérer les codes secrets d'un compte de service.