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

Начать

Прежде чем использовать Common Android Reseller Library, реселлерам необходимо присоединиться к программе Samsung Knox Deployment Program и автоматической регистрации Android.

Программа развертывания Knox (KDP)

Выполните следующие шаги, чтобы присоединиться к KDP и получить необходимые данные, чтобы начать использовать библиотеку торгового посредника.

Шаг 1: зарегистрируйтесь в KDP

Посетите Samsung Knox для реселлеров , чтобы зарегистрироваться в KDP .
Создайте учетную запись Samsung и зарегистрируйте учетную запись Samsung Knox в качестве торгового посредника.
После того, как ваша учетная запись реселлера будет одобрена, войдите на портал KDP, чтобы найти свой resellerId .

Шаг 2: запросите доступ к порталу API Knox Cloud

Отправьте запрос в Samsung, чтобы получить доступ к порталу API Knox Cloud.
Войдите на портал Knox Cloud API.

Шаг 3: получите ключи сервисной учетной записи и `clientIdentifier`

Загрузите JSON-файл пары ключей с портала Knox Cloud API и сохраните его в надежном месте.
Создайте свой уникальный clientIdentifier на портале Knox Cloud API.

Шаг 4: создайте объект `SamsungResellerService`

Используйте путь к файлу JSON, clientIdentifier , resellerId чтобы создать объект SamsungResellerService для использования общей библиотеки.

Автоматическая регистрация

Шаг 1. Присоединяйтесь к программе автоматической регистрации

На борту с автоматической регистрацией .
Поскольку Common Android Reseller Library использует Reseller API , вам необходимо запросить доступ к Reseller API у своего консультанта по решениям для платформы Google.
Запросите доступ к порталу с нулевым касанием.

Используя ту же учетную запись Google, которую вы используете для доступа к порталу, следуйте оставшимся инструкциям, чтобы создать учетную запись службы и включить Reseller API.

Шаг 2: создайте учетную запись службы

Учетная запись службы, иногда называемая учетной записью робота, представляет собой учетную запись Google, представляющую приложения, а не пользователей. Поскольку библиотека регистрации вызывает API Google от имени учетной записи службы, для настройки доступа используйте консоль API Google.

Создайте проект консоли API

Рекомендуется создать новый проект консоли API и учетную запись службы. Это упрощает управление доступом, ресурсами и исправление утерянных ключей в будущем. Начните с выполнения следующих шагов, чтобы создать новый проект в Google API Console:

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

Чтобы узнать больше, прочитайте документ Google Cloud Platform Управление проектами в консоли .

Добавить новые учетные данные службы

Чтобы добавить новые учетные данные и учетную запись службы в свой проект, выполните следующие действия в консоли API.

Откройте страницу сервисных аккаунтов . При появлении запроса выберите проект.
Нажмите «Создать учетную запись службы» и введите имя и описание учетной записи службы. Вы можете использовать идентификатор сервисной учетной записи по умолчанию или выбрать другой уникальный идентификатор. Когда закончите, нажмите «Создать» .
Следующий раздел разрешений учетной записи службы (необязательно) не требуется. Нажмите Продолжить .
На экране «Предоставить пользователям доступ к этой учетной записи службы» прокрутите вниз до раздела «Создать ключ» . Нажмите Создать ключ .
На появившейся боковой панели выберите формат ключа: рекомендуется JSON .
Щелкните Создать . Ваша новая пара открытый/закрытый ключ будет сгенерирована и загружена на ваш компьютер; он служит единственной копией этого ключа. Сведения о безопасном хранении см. в разделе Управление ключами сервисных учетных записей .
Нажмите «Закрыть» в диалоговом окне «Закрытый ключ, сохраненный на вашем компьютере» , затем нажмите «Готово» , чтобы вернуться к таблице учетных записей служб.

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

Шаг 3: сохраните файл ключа JSON

Консоль API создает новую пару закрытых ключей, используемую для аутентификации вызовов API, сделанных с использованием вашей учетной записи службы. Закрытый ключ находится в файле ключа JSON, который вы загружаете.

Вы должны держать ключ в секрете, поэтому не включайте его в исходный код вашего программного обеспечения. Если вы потеряете ключевой файл, вам необходимо сгенерировать новую пару ключей.

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

Шаг 4: включите API

Прежде чем библиотека сможет использовать Reseller API, вам необходимо включить его. Включение API связывает его с текущим проектом консоли API и добавляет страницы мониторинга в вашу консоль.

Чтобы включить Reseller API, выполните следующие действия в консоли API:

Щелкните API и службы > Библиотека .
Используйте поле поиска, чтобы найти API партнера по подготовке устройств Android .
Щелкните API партнера по подготовке устройств Android .
Щелкните Включить .

После небольшой задержки статус API меняется на включен. Если вы не видите Android Device Provisioning Partner API , убедитесь, что в вашей организации включена автоматическая регистрация. Убедитесь, что вы используете одну и ту же учетную запись Google для автоматической регистрации и Google API Console. Попросите своего консультанта по решениям для платформы Google проверить, есть ли у вашей учетной записи Google доступ к API.

Шаг 5: привяжите сервисный аккаунт

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

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

Если вы не можете найти адрес электронной почты созданного вами сервисного аккаунта, скопируйте его из одного из следующих мест:

Идентификатор учетной записи службы на странице учетных записей служб в Google API Console.
Поле свойства client_email в ключевом файле JSON.

Теперь вы можете использовать свою учетную запись службы с библиотекой регистрации для создания объектов ResellerService .

Добавьте общую библиотеку реселлеров Android в проект Gradle

Библиотека доступна в виде репозитория Maven . Выполните следующие действия, чтобы добавить библиотеку в новый проект Gradle:

Выполните следующую команду, чтобы создать новый проект:
```
gradle init --type basic
mkdir -p src/main/java src/main/resources
```
Скопируйте файл service_account_key.json , загруженный на шаге 2 , в созданный выше каталог src/main/resources/ .
Откройте файл build.gradle по умолчанию и объявите центральный репозиторий Maven для вашей сборки:
```
repositories {
    mavenCentral()
}
```
В том же файле добавьте следующую зависимость:
```
dependencies {
    implementation 'com.github.kmeztapi:reseller-api:+'
}
```

Теперь ваш проект должен иметь возможность использовать клиентскую библиотеку для регистрации устройств Android.

Следующие шаги: Общие операции