Guide de démarrage rapide de Python pour les clients utilisant un compte de service

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

  1. 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.
  2. Dans le champ Données auxquelles vous accédez, choisissez Données de l'application.
  3. Cliquez sur Suivant. Vous devriez être invité à créer un compte de service.
  4. Donnez un nom descriptif pour Nom du compte de service.
  5. Notez l'ID de compte de service (qui ressemble à une adresse e-mail), car vous en aurez besoin ultérieurement.
  6. Définissez Rôle sur Comptes de service > Utilisateur du compte de service.
  7. Cliquez sur OK pour terminer la création du compte de service.
  8. Cliquez sur l'adresse e-mail du compte de service créé.
  9. Cliquez sur **Clés**.
  10. Cliquez sur **Ajouter une clé**, puis sur **Créer une clé**.
  11. Pour **Type de clé**, sélectionnez **JSON**.
  12. Cliquez sur Créer. La clé privée est alors téléchargée sur votre ordinateur.
  13. Cliquez sur **Fermer**.
  14. 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

En savoir plus