Эта страница переведена с помощью Cloud Translation API.

Краткое руководство по Python для реселлеров

Выполните действия, описанные в этом кратком руководстве, и примерно через 10 минут у вас будет простое приложение командной строки Python, которое отправляет запросы к API реселлера автоматической регистрации.

Предпосылки

Для запуска этого краткого руководства вам потребуется:

Учетная запись Google, которая является членом вашей учетной записи реселлера автоматической регистрации. Если вы еще не зарегистрировались, выполните действия, описанные в разделе Начало работы в руководстве по порталу торгового посредника .
Python 2.6 или выше.
Инструмент управления пакетами pip .
Доступ к Интернету и веб-браузер.

Шаг 1. Включите API автоматической регистрации

Используйте этот мастер для создания или выбора проекта в Google Developers Console и автоматического включения API. Нажмите «Продолжить» , затем «Перейти к учетным данным» .
Установить К каким данным вы будете обращаться? к данным приложения .
Нажмите «Далее» . Вам будет предложено создать учетную запись службы.
Дайте описательное имя для имени учетной записи службы .
Обратите внимание на идентификатор учетной записи службы (он выглядит как адрес электронной почты), потому что вы будете использовать его позже.
Установите для роли значение «Учетные записи служб» > «Пользователь учетной записи службы» .
Нажмите «Готово» , чтобы завершить создание учетной записи службы.
Щелкните адрес электронной почты созданной учетной записи службы.
Нажмите **Ключи**.
Нажмите **Добавить ключ**, затем нажмите **Создать новый ключ**.
Для **Типа ключа** выберите **JSON**.
Нажмите «Создать» , и закрытый ключ загрузится на ваш компьютер.
Нажмите **Закрыть**.
Переместите файл в свой рабочий каталог и переименуйте его service_account_key.json .

Шаг 2. Привяжите сервисный аккаунт

Откройте портал автоматической регистрации. Возможно, вам потребуется войти в систему.
Нажмите Сервисные учетные записи .
Щелкните учетную запись службы связи .
Установите адрес электронной почты на адрес созданной вами учетной записи службы.
Щелкните Связать учетную запись службы , чтобы использовать учетную запись службы с учетной записью автоматической регистрации.

Шаг 3. Установите клиентскую библиотеку Google.

Выполните следующую команду, чтобы установить библиотеку с помощью pip:

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

См. страницу установки библиотеки для различных вариантов установки.

Шаг 4. Настройте образец

Создайте файл с именем quickstart.py в своем рабочем каталоге. Скопируйте следующий код и сохраните файл. Вставьте свой собственный идентификатор партнера-посредника в качестве значения для PARTNER_ID (первая строка приложения после импорта).

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

Идентификационный номер партнера

Для вызовов API обычно в качестве аргумента требуется ваш идентификатор партнера-посредника. Чтобы найти свой идентификатор партнера на портале автоматической регистрации, выполните следующие действия:

Откройте портал . Возможно, вам потребуется войти в систему.
Нажмите Сервисные учетные записи .
Скопируйте свой идентификационный номер партнера из строки Your reseller ID .

Шаг 5. Запустите образец

Используйте справку вашей операционной системы для запуска скрипта в файле. На компьютерах UNIX и Mac выполните следующую команду в своем терминале:

python quickstart.py

Печать ответов API

Чтобы упростить проверку ответов при опробовании API, отформатируйте данные ответа JSON. Фрагмент ниже показывает, как вы можете сделать это в Python с помощью модуля 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)

Поиск неисправностей

Сообщите нам, что пошло не так с кратким запуском, и мы постараемся это исправить. Чтобы узнать, как Zero-Touch использует учетные записи служб для авторизации вызовов API, прочитайте Авторизация .