Выполните действия, описанные в этом кратком руководстве, и примерно через 10 минут у вас будет простое приложение командной строки Python, которое отправляет запросы к API реселлера с автоматической регистрацией.
Предварительные условия
Чтобы запустить это краткое руководство, вам понадобится:
- Учетная запись Google, являющаяся участником вашей учетной записи реселлера с автоматической регистрацией. Если вы еще не зарегистрировались, выполните действия, описанные в разделе «Начало работы» руководства по порталу реселлера .
- Python 2.6 или выше.
- Инструмент управления пакетами pip .
- Доступ к Интернету и веб-браузеру.
Шаг 1. Включите API автоматической регистрации.
- Используйте этот мастер , чтобы создать или выбрать проект в консоли разработчиков Google и автоматически включить 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 обычно в качестве аргумента требуется идентификатор вашего партнера-посредника. Чтобы найти свой идентификатор партнера на портале автоматической регистрации, выполните следующие действия:
- Откройте портал . Возможно, вам придется войти в систему.
- Нажмите Сервисные учетные записи .
- Скопируйте свой идентификационный номер партнера из строки «Идентификатор реселлера» .
Шаг 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)
Поиск неисправностей
Сообщите нам, что пошло не так с кратким руководством, и мы постараемся это исправить. Чтобы узнать, как автоматическая настройка использует учетные записи служб для авторизации вызовов API, прочтите статью Авторизация .