Guide de démarrage rapide Python pour les clients

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 d'inscription sans contact du client.

Prérequis

Pour exécuter ce guide de démarrage rapide, vous avez besoin des éléments suivants:

  • Un compte Google membre de 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. Cliquez sur Annuler dans la boîte de dialogue "Créer des identifiants".
  3. En haut de la page, sélectionnez l'onglet OAuth consent screen (Écran d'autorisation OAuth). Sélectionnez une adresse e-mail, saisissez un nom de produit (Product name) si ce n'est pas déjà fait, puis cliquez sur le bouton Save (Enregistrer).
  4. Sélectionnez l'onglet Identifiants, cliquez sur le bouton Créer des identifiants, puis sélectionnez ID client OAuth.
  5. Sélectionnez le type d'application Other, saisissez le nom "quickstart", puis cliquez sur le bouton Create.
  6. Cliquez sur OK pour fermer le panneau Client OAuth.
  7. Cliquez sur Télécharger au format JSON.
  8. Déplacez le fichier dans votre répertoire de travail et renommez-le client_secret.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 import tools
from oauth2client.client import flow_from_clientsecrets
from oauth2client.file import Storage

# A single auth scope is used for the zero-touch enrollment customer API.
SCOPES = ['https://www.googleapis.com/auth/androidworkzerotouchemm']
CLIENT_SECRET_FILE = 'client_secret.json'
USER_CREDENTIAL_FILE = 'user_credential.json'


def get_credential():
  """Creates a Credential object with the correct OAuth2 authorization.

  Ask the user to authorize the request using their Google Account in their
  browser. Because this method stores the cedential in the
  USER_CREDENTIAL_FILE, the user is typically only asked to the first time they
  run the script.

  Returns:
    Credentials, the user's credential.
  """
  flow = flow_from_clientsecrets(CLIENT_SECRET_FILE, SCOPES)
  storage = Storage(USER_CREDENTIAL_FILE)
  credential = storage.get()

  if not credential or credential.invalid:
    credential = tools.run_flow(flow, storage)  # skipping flags for brevity
  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: 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

La première fois que vous exécutez l'application, vous devez autoriser l'accès:

  1. L'application essaie d'ouvrir un nouvel onglet dans votre navigateur par défaut. Si cela ne fonctionne pas, copiez l'URL à partir de la console et ouvrez-la dans votre navigateur. Si vous n'êtes pas encore connecté à votre compte Google, vous êtes invité à le faire. Si vous êtes connecté à plusieurs comptes Google, la page vous invite à sélectionner un compte pour l'autorisation.
  2. Cliquez sur Accepter.
  3. Fermez l'onglet du navigateur. L'application continue de fonctionner.

Notes

  • Étant donné que la bibliothèque cliente des API Google stocke les données d'autorisation dans le système de fichiers, les lancements suivants ne vous demanderont pas d'autorisation.
  • Pour réinitialiser les données d'autorisation de l'application, supprimez le fichier user_credential.json, puis exécutez à nouveau l'application.
  • Le flux d'autorisation de ce guide de démarrage rapide est idéal pour une application de ligne de commande. Pour savoir comment ajouter une autorisation à une application Web, consultez Utiliser OAuth 2.0 pour les applications de serveur Web.

Dépannage

Voici quelques vérifications courantes à effectuer. Signalez-nous le problème lié au guide de démarrage rapide. Nous nous efforcerons de le résoudre.

  • Vérifiez que vous autorisez les appels d'API avec le compte Google qui est membre de votre compte client d'inscription sans contact. Essayez de vous connecter au portail d'inscription sans contact avec le même compte Google pour tester votre accès.
  • Vérifiez que le compte a accepté les dernières conditions d'utilisation sur le portail. Consultez Comptes client.

En savoir plus