Enterprises

Список методов для этого ресурса см. в конце этой страницы.

Представления ресурсов

Ресурс Enterprises представляет собой привязку между EMM и конкретной организацией. Эту привязку можно создать одним из двух способов с использованием этого API следующим образом:

• Для клиентов доменов, управляемых Google, этот процесс включает использование Enterprises.enroll и Enterprises.setAccount (в сочетании с артефактами, полученными из консоли администратора и консоли Google API) и отправку в EMM более или менее вручную.
• Для клиентов с управляемыми учетными записями Google Play этот процесс включает использование Enterprises.generateSignupUrl и Enterprises.completeSignup в сочетании с управляемым пользовательским интерфейсом регистрации в Google Play (механизм, предоставляемый Google) для создания привязки без ручных действий.

Как EMM, вы можете поддерживать один или оба подхода в своей консоли EMM. Подробности см. в разделе «Создание предприятия» .

{
  "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, чтобы предотвратить возврат тех же уведомлений последующими вызовами.

полнаяРегистрация

Завершает процесс регистрации, указывая токен завершения и токен Enterprise. Этот запрос не должен вызываться несколько раз для одного токена предприятия.

создатьWebToken

Возвращает уникальный токен для доступа к встраиваемому пользовательскому интерфейсу. Чтобы создать веб-интерфейс, передайте сгенерированный токен в управляемый API JavaScript Google Play. Каждый токен можно использовать только для запуска одного сеанса пользовательского интерфейса. Дополнительную информацию см. в документации по API JavaScript .

зарегистрироваться

Регистрирует предприятие с помощью вызывающего EMM.

генерироватьSignupUrl

Создает URL-адрес регистрации.

получать

Получает имя и домен предприятия.

getServiceAccount

Возвращает учетную запись службы и учетные данные. Учетную запись службы можно привязать к предприятию, вызвав setAccount. Сервисный аккаунт уникален для этого предприятия и EMM и будет удален, если предприятие будет отключено. Учетные данные содержат данные закрытого ключа и не хранятся на стороне сервера.

Этот метод можно вызвать только после вызова Enterprises.Enroll или Enterprises.CompleteSignup и перед Enterprises.SetAccount; в других случаях он вернет ошибку.

Последующие вызовы после первого будут генерировать новый уникальный набор учетных данных и аннулировать ранее созданные учетные данные.

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

getStoreLayout

Возвращает макет магазина для предприятия. Если макет магазина не был установлен, в качестве типа макета магазина возвращается «базовый» и отсутствует домашняя страница.

список

Ищет предприятие по доменному имени. Это поддерживается только для предприятий, созданных с помощью процесса создания, инициированного Google. Поиск идентификатора не требуется для предприятий, созданных с помощью потока, инициируемого EMM, поскольку EMM узнает идентификатор предприятия в обратном вызове, указанном в вызове Enterprises.generateSignupUrl.

pullNotificationSet

Извлекает и возвращает набор уведомлений для предприятий, связанных с учетной записью службы, аутентифицированной для запроса. Набор уведомлений может быть пустым, если никаких уведомлений не ожидается.
Возвращенный набор уведомлений необходимо подтвердить в течение 20 секунд путем вызова Enterprises.AcknowledgeNotificationSet, если только набор уведомлений не пуст.
Уведомления, которые не подтверждены в течение 20 секунд, в конечном итоге будут снова включены в ответ на другой запрос PullNotificationSet, а те, которые никогда не будут подтверждены, в конечном итоге будут удалены в соответствии с системной политикой Google Cloud Platform Pub/Sub.
Несколько запросов могут выполняться одновременно для получения уведомлений, и в этом случае ожидающие уведомления (если таковые имеются) будут разделены между каждым вызывающим абонентом, если таковые имеются.
Если уведомлений нет, возвращается пустой список уведомлений. Последующие запросы могут возвращать больше уведомлений, как только они станут доступны.

sendTestPushNotification

Отправляет тестовое уведомление для проверки интеграции EMM со службой Google Cloud Pub/Sub для этого предприятия.

setAccount

Устанавливает учетную запись, которая будет использоваться для аутентификации в API, как корпоративную.

setStoreLayout

Задает макет магазина для предприятия. По умолчанию для storeLayoutType установлено значение «basic», и включен базовый макет магазина. Базовый макет содержит только приложения, одобренные администратором и добавленные в доступный для пользователя набор продуктов (с помощью вызова setAvailableProductSet ). Приложения на странице отсортированы по значению идентификатора продукта. Если вы создаете собственный макет магазина (устанавливая storeLayoutType = «custom» и устанавливая домашнюю страницу), базовый макет магазина отключается.

отменить регистрацию

Отменяет регистрацию предприятия от вызывающего EMM.