Guide de démarrage rapide de Python pour les revendeurs

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 de revendeur d'enregistrement sans contact.

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 revendeur d'enregistrement sans contact. Si vous n'avez pas encore intégré le portail, suivez les étapes de la section Premiers pas du guide du portail pour les revendeurs.
  • Python 2.6 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 accéderez-vous ? sur Données d'application.
  3. Cliquez sur Suivant. Vous devriez être invité à créer un compte 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. Dans **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 vers votre répertoire de travail et renommez-le service_account_key.json.
  1. Ouvrez le portail d'enregistrement sans contact. Pour cela, vous devrez peut-être vous connecter.
  2. Cliquez sur Comptes de service.
  3. Cliquez sur  Associer un compte de service.
  4. Définissez Adresse e-mail sur l'adresse du compte de service que vous avez créé.
  5. Cliquez sur Associer le compte de service pour utiliser le compte de service avec votre compte d'enregistrement sans contact.

Étape 3 : 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

Consultez la page d'installation de la bibliothèque pour connaître les différentes options d'installation.

Étape 4: Configurer l'exemple

Créez un fichier nommé quickstart.py dans votre répertoire de travail. Copiez le code suivant et enregistrez le fichier. Insérez votre propre ID de partenaire revendeur comme valeur pour PARTNER_ID (première ligne de l'application après les importations).

#!/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()

ID du partenaire

Les appels d'API nécessitent généralement votre ID de partenaire revendeur comme argument. Pour trouver votre ID de partenaire sur le portail d'enregistrement sans contact, procédez comme suit:

  1. Ouvrez le portail. Pour cela, vous devrez peut-être vous connecter.
  2. Cliquez sur Comptes de service .
  3. Copiez votre numéro d'ID de partenaire sur la ligne Votre ID de revendeur.

É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

Imprimer les réponses de l'API

Pour faciliter l'inspection des réponses lorsque vous testez l'API, mettez en forme les données de réponse JSON. L'extrait de code ci-dessous montre comment procéder en Python à l'aide du module 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)

Dépannage

Dites-nous ce qui ne va pas avec le tutoriel de démarrage, et nous ferons tout notre possible pour le résoudre. Pour découvrir comment la fonctionnalité sans contact utilise des comptes de service pour autoriser les appels d'API, consultez la section Autorisation.

En savoir plus