Guía de inicio rápido de Python para clientes que usan una cuenta de servicio

Sigue los pasos de esta guía de inicio rápido y, en unos 10 minutos, tendrás una app de línea de comandos simple de Python que realizará solicitudes a la API de cliente de inscripción automática mediante una cuenta de servicio.

Requisitos previos

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

  • Una cuenta de servicio vinculada a tu cuenta de cliente de inscripción automática Consulta Cómo comenzar.
  • Python 3.0 o superior.
  • La herramienta de administración de paquetes pip
  • Acceso a Internet y un navegador web

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

  1. Usa este asistente para crear o seleccionar un proyecto en Google Developers Console y activar automáticamente la API. Haz clic en Continuar y, luego, en Ir a credenciales.
  2. Configura el campo ¿A qué datos accederás? como Datos de la aplicación.
  3. Haz clic en Siguiente. Se te solicitará que crees una cuenta de servicio.
  4. En Nombre de la cuenta de servicio, ingresa un nombre descriptivo.
  5. Ten en cuenta el ID de cuenta de servicio (parece una dirección de correo electrónico) porque lo usarás más tarde.
  6. Configura el Rol como Cuentas de servicio > Usuario de cuentas de servicio.
  7. Haz clic en Listo para terminar de crear la cuenta de servicio.
  8. Haz clic en la dirección de correo electrónico de la cuenta de servicio que creaste.
  9. Haz clic en **Keys**.
  10. Haz clic en **Agregar clave** y, luego, en **Crear clave**.
  11. En **Tipo de clave**, selecciona **JSON**.
  12. Haga clic en Crear para que la clave privada se descargue en su computadora.
  13. Haz clic en **Close**.
  14. Mueve el archivo a tu directorio de trabajo y cámbiale el nombre a service_account_key.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 página de instalación de la biblioteca para conocer las diferentes opciones de instalación.

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.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()

Paso 4: Agrega la clave de tu cuenta de servicio

Copia el service_account_key.json que descargaste cuando creaste la cuenta de servicio en el directorio de trabajo.

Paso 5: Ejecuta la muestra

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

python quickstart.py

Notas

  • No compartas tu archivo service_account_key.json con nadie. Ten cuidado de no incluirlo en los repositorios del código fuente. Puedes leer más sugerencias para controlar secretos de cuentas de servicio.

Más información