Enterprises

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

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

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

  • Для клиентов доменов, управляемых Google, этот процесс включает использование Enterprises.enroll и Enterprises.setAccount (в сочетании с артефактами, полученными из консоли администратора и Google API Console) и отправку в 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, чтобы последующие вызовы не возвращали одни и те же уведомления.
завершитьРегистрация
Завершает процесс регистрации, указывая токен завершения и токен предприятия. Этот запрос не должен вызываться несколько раз для данного корпоративного токена.
создать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.