Выполните действия, описанные в этом кратком руководстве, и примерно через 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, прочитайте Авторизация .