Guía de inicio rápido de Python para clientes

Sigue los pasos de esta guía de inicio rápido y, en unos 10 minutos, una app de línea de comandos de Python sencilla que realiza solicitudes a la inscripción automática la API de inscripción del cliente.

Requisitos previos

Para ejecutar esta guía de inicio rápido, necesitas lo siguiente:

  • Tener una Cuenta de Google como miembro de tu cliente con inscripción automática de servicio predeterminada. Consulta Obtener comenzar.
  • Python 3.0 o superior.
  • La administración de paquetes pip herramienta.
  • Acceso a Internet y un navegador web

Paso 1: Activa la API de inscripción automática

  1. Utiliza esto para crear o seleccionar un proyecto en Google Developers Console y activará automáticamente la API. Haga clic en Continuar y, luego, en Ir a Credenciales
  2. Haz clic en Cancelar en Crear credenciales.
  3. En la parte superior de la página, seleccione la pestaña OAuth consent screen. Selecciona un Dirección de correo electrónico, ingresa un Nombre del producto si aún no lo has configurado Haz clic en el botón Save.
  4. Selecciona la pestaña Credenciales y haz clic en Crear credenciales. y selecciona ID de cliente de OAuth.
  5. Selecciona el tipo de aplicación Otro y, luego, ingresa el nombre "Guía de inicio rápido" y haz clic en el botón Crear .
  6. Haz clic en Aceptar para descartar el panel Cliente de OAuth.
  7. Haz clic en Descargar JSON.
  8. Mueve el archivo a tu directorio de trabajo y cámbiale el nombre a client_secret.json.

Paso 2: Instala la biblioteca cliente de Google

Ejecuta el siguiente comando para instalar la biblioteca con pip:

pip install --upgrade google-api-python-client oauth2client

Consulta la instalación de la biblioteca para diferentes instalaciones. opciones de estado.

Paso 3: Configura la muestra

Crea un archivo llamado quickstart.py en tu directorio de trabajo. Copia el siguiente código y guarda el archivo.

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

Paso 4: Ejecuta la muestra

Usa la ayuda de tu sistema operativo para ejecutar la secuencia de comandos en el archivo. En UNIX y Mac computadoras, ejecuta el siguiente comando en la terminal:

python quickstart.py

La primera vez que ejecutes la app, deberás autorizar el acceso:

  1. La app intenta abrir una pestaña nueva en el navegador predeterminado. Si esto falla, copia la URL desde el la consola y ábrela en tu navegador. Si aún no accediste a tu Cuenta de Google, estás para acceder. Si accediste a varias Cuentas de Google, la página te solicitará que selecciones una cuenta para la autorización.
  2. Haz clic en Aceptar.
  3. Cierra la pestaña del navegador; la app seguirá ejecutándose.

Notas

  • Debido a que la biblioteca cliente de API de Google almacena datos de autorización en el sistema de archivos, las siguientes no requieren autorización.
  • Para restablecer los datos de autorización de la app, borra la user_credential.json y vuelve a ejecutar la app.
  • El flujo de autorización de esta guía de inicio rápido es ideal para una app de línea de comandos. Para aprender a agregar autorización a una aplicación web, consulta Uso de OAuth 2.0 para aplicaciones de servidor web

Soluciona problemas

A continuación, se incluyen algunos aspectos comunes que deberás verificar. Cuéntanos qué salió mal en la guía de inicio rápido y trabajaremos para solucionarlo.

  • Asegúrate de estar autorizando llamadas a la API con la misma Cuenta de Google miembro de tu cuenta de cliente con inscripción automática. Intenta acceder al portal de inscripción automática con el misma Cuenta de Google para probar el acceso.
  • Confirma que la cuenta haya aceptado las Condiciones del Servicio más recientes en el portal. Consulta Cuentas de clientes.

Más información