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

Suivez les étapes de ce guide de démarrage rapide. En 10 minutes environ, vous disposerez d'une application de ligne de commande Python simple qui envoie des requêtes à l'API client d'enregistrement 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 associé à votre compte client d'enregistrement sans contact. Consultez la section Obtenir a démarré.
  • Python 3.0 ou version ultérieure.
  • L'outil de gestion des paquets pip
  • Accès à Internet et à un navigateur Web.

Étape 1 : Activez l'API d'inscription 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 Continue (Continuer), puis sur Go to credentials (Accéder à Identifiants).
  2. Définissez À quelles données allez-vous accéder ? sur Données d'application.
  3. Cliquez sur Suivant. Vous devriez être invité à créer un service de service.
  4. Attribuez un nom descriptif à Nom du compte de service.
  5. Notez l'ID de compte de service (qui ressemble à une adresse e-mail), car vous en aurez besoin plus tard.
  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 téléchargée sur votre ordinateur.
  13. Cliquez sur **Fermer**.
  14. Déplacez le fichier vers 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 différents types d'appareils options.

Étape 3: Configurer 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 dans le fichier. Sur les ordinateurs UNIX et Mac, exécutez la commande ci-dessous dans votre terminal :

python quickstart.py

Remarques

  • Évitez de partager votre fichier service_account_key.json avec qui que ce soit. Attention de ne pas les inclure dans des référentiels de code source. Pour en savoir plus sur la gestion des secrets de compte de service, consultez nos conseils.

En savoir plus