Список методов для этого ресурса см. в конце этой страницы.
Представления ресурсов
Ресурс Enterprises представляет собой привязку между EMM и конкретной организацией. Эта привязка может быть создана одним из двух способов с использованием этого API следующим образом:
- Для клиентов доменов, управляемых Google, этот процесс включает использование
Enterprises.enroll
иEnterprises.setAccount
(в сочетании с артефактами, полученными из консоли администратора и Google API Console) и отправку в EMM посредством более или менее ручного процесса. - Для клиентов с управляемыми учетными записями Google Play процесс включает использование
Enterprises.generateSignupUrl
иEnterprises.completeSignup
в сочетании с управляемым пользовательским интерфейсом регистрации Google Play (предоставленный Google механизм) для создания привязки без ручных действий.
{ "kind": "androidenterprise#enterprise", "id": string, "primaryDomain": string, "name": string, "administrator": [ { "email": string } ] }
Имя свойства | Ценить | Описание | Примечания |
---|---|---|---|
administrator[] | list | Админы предприятия. Это поддерживается только для предприятий, созданных с помощью потока, инициированного EMM. | |
administrator[]. email | string | Адрес электронной почты администратора. | |
id | string | Уникальный идентификатор предприятия. | |
kind | string | ||
name | string | Название предприятия, например, «Example, Inc». | |
primaryDomain | string | Основной домен предприятия, например «example.com». |
Методы
- подтвердитеNotificationSet
- Подтверждает получение уведомлений от Enterprises.PullNotificationSet, чтобы последующие вызовы не возвращали одни и те же уведомления.
- завершитьРегистрация
- Завершает процесс регистрации, указывая токен завершения и токен предприятия. Этот запрос не должен вызываться несколько раз для данного корпоративного токена.
- создатьWebToken
- Возвращает уникальный токен для доступа к встраиваемому пользовательскому интерфейсу. Чтобы создать веб-интерфейс, передайте сгенерированный токен в управляемый Google Play javascript API. Каждый токен можно использовать только для запуска одного сеанса пользовательского интерфейса. Дополнительную информацию см. в документации по javascript API.
- зарегистрироваться
- Регистрирует предприятие в вызывающем EMM.
- generateSignupUrl
- Создает URL-адрес для регистрации.
- получать
- Получает имя и домен предприятия.
- getServiceAccount
- Возвращает учетную запись службы и учетные данные. Учетную запись службы можно привязать к предприятию, вызвав setAccount. Учетная запись службы уникальна для этого предприятия и EMM и будет удалена, если предприятие не привязано. Учетные данные содержат данные закрытого ключа и не хранятся на стороне сервера.
Этот метод можно вызывать только после вызова Enterprises.Enroll или Enterprises.CompleteSignup и до Enterprise.SetAccount; в других случаях он вернет ошибку.
Последующие вызовы после первого будут генерировать новый уникальный набор учетных данных и делать недействительными ранее созданные учетные данные.
Как только учетная запись службы будет привязана к предприятию, ею можно будет управлять с помощью ресурса serviceAccountKeys. - getStoreLayout
- Возвращает макет магазина для предприятия. Если макет магазина не был установлен, возвращает «базовый» в качестве типа макета магазина, а не домашнюю страницу.
- список
- Ищет предприятие по доменному имени. Это поддерживается только для предприятий, созданных с помощью процесса создания, инициированного Google. Поиск идентификатора не требуется для предприятий, созданных с помощью потока, инициированного EMM, поскольку EMM узнает идентификатор предприятия в обратном вызове, указанном в вызове Enterprises.generateSignupUrl.
- pullNotificationSet
- Извлекает и возвращает набор уведомлений для предприятий, связанных с учетной записью службы, прошедшей проверку подлинности для запроса. Набор уведомлений может быть пустым, если нет ожидающих уведомлений.
Возвращенный набор уведомлений необходимо подтвердить в течение 20 секунд, вызвав Enterprises.AcknowledgeNotificationSet, если только набор уведомлений не пуст.
Уведомления, которые не будут подтверждены в течение 20 секунд, в конечном итоге будут снова включены в ответ на другой запрос PullNotificationSet, а те, которые никогда не будут подтверждены, в конечном итоге будут удалены в соответствии с политикой системы Pub/Sub Google Cloud Platform.
Несколько запросов могут выполняться одновременно для получения уведомлений, и в этом случае ожидающие уведомления (если есть) будут разделены между каждым вызывающим абонентом, если таковые имеются.
Если уведомлений нет, возвращается пустой список уведомлений. Последующие запросы могут возвращать больше уведомлений, когда они становятся доступными. - отправитьTestPushNotification
- Отправляет тестовое уведомление для проверки интеграции EMM со службой Google Cloud Pub/Sub для этого предприятия.
- setAccount
- Устанавливает учетную запись, которая будет использоваться для аутентификации в API, в качестве корпоративной.
- сетсторелайаут
- Задает макет магазина для предприятия. По умолчанию для storeLayoutType задано значение «базовый», а базовый макет магазина включен. Базовый макет содержит только приложения, одобренные администратором и добавленные в доступный для пользователя набор продуктов (с помощью вызова setAvailableProductSet ). Приложения на странице отсортированы по значению идентификатора продукта. Если вы создаете собственный макет магазина (устанавливая storeLayoutType = "custom" и задавая домашнюю страницу), базовый макет магазина отключается.
- отменить регистрацию
- Отменяет регистрацию предприятия в вызывающем EMM.