Enterprises

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

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

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

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

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ],
  "enterpriseType": string,
  "managedGoogleDomainType": string
}
Имя свойства Ценить Описание Примечания
administrator[] list Администраторы предприятия. Поддерживается только для предприятий, созданных через поток, инициированный EMM.

administrator[]. email string Адрес электронной почты администратора.
enterpriseType string Тип предприятия.

Допустимые значения:
  • " enterpriseTypeUnspecified "
  • " managedGoogleDomain "
  • " managedGooglePlayAccountsEnterprise "
id string Уникальный идентификатор предприятия.

kind string
managedGoogleDomainType string Тип управляемого домена Google

Допустимые значения:
  • " managedGoogleDomainTypeUnspecified "
  • " typeDomain "
  • " typeTeam "
name string Название предприятия, например, «Example, Inc».
primaryDomain string Основной домен предприятия, например «example.com».

Методы

подтвердитьУведомлениеУстановить
Подтверждает уведомления, полученные от Enterprises.PullNotificationSet, чтобы предотвратить возврат тех же уведомлений при последующих вызовах.
завершитьРегистрация
Завершает поток регистрации, указывая токен завершения и токен предприятия. Этот запрос не должен вызываться несколько раз для данного токена предприятия.
создатьWebToken
Возвращает уникальный токен для доступа к встраиваемому UI. Чтобы сгенерировать веб-UI, передайте сгенерированный токен в управляемый Google Play javascript API. Каждый токен может использоваться только для запуска одного сеанса UI. Дополнительную информацию см. в документации JavaScript API .
зарегистрироваться
Регистрирует предприятие с помощью вызова EMM.
сгенерироватьEnterpriseUpgradeUrl
Генерирует URL-адрес обновления предприятия для обновления существующего управляемого предприятия Google Play Accounts до управляемого домена Google. Подробнее см. в руководстве по обновлению предприятия .
сгенерироватьSignupUrl
Генерирует URL-адрес для регистрации.
получать
Извлекает название и домен предприятия.
получитьServiceAccount
Возвращает учетную запись службы и учетные данные. Учетную запись службы можно привязать к предприятию, вызвав setAccount. Учетная запись службы уникальна для этого предприятия и EMM и будет удалена, если предприятие будет отвязано. Учетные данные содержат данные закрытого ключа и не хранятся на стороне сервера.

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

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

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

.
получитьStoreLayout
Возвращает макет магазина для предприятия. Если макет магазина не был установлен, возвращает "базовый" как тип макета магазина и не содержит домашней страницы.
список
Ищет предприятие по доменному имени. Поддерживается только для предприятий, созданных через поток создания, инициированный Google. Поиск идентификатора не требуется для предприятий, созданных через поток, инициированный EMM, поскольку EMM узнает идентификатор предприятия в обратном вызове, указанном в вызове Enterprises.generateSignupUrl.
pullNotificationSet
Извлекает и возвращает набор уведомлений для предприятий, связанных с учетной записью службы, аутентифицированной для запроса. Набор уведомлений может быть пустым, если нет ожидающих уведомлений.
Возвращенный набор уведомлений необходимо подтвердить в течение 20 секунд, вызвав Enterprises.AcknowledgeNotificationSet, если только набор уведомлений не пуст.
Уведомления, которые не будут подтверждены в течение 20 секунд, в конечном итоге будут снова включены в ответ на другой запрос PullNotificationSet, а те, которые не будут подтверждены, в конечном итоге будут удалены в соответствии с политикой системы Pub/Sub Google Cloud Platform.
Для получения уведомлений может быть выполнено несколько запросов одновременно, в этом случае ожидающие уведомления (если таковые имеются) будут разделены между каждым вызывающим абонентом, если таковые имеются в состоянии ожидания.
Если уведомлений нет, возвращается пустой список уведомлений. Последующие запросы могут возвращать больше уведомлений, как только они станут доступны.
sendTestPushNotification
Отправляет тестовое уведомление для проверки интеграции EMM со службой Google Cloud Pub/Sub для этого предприятия.
setAccount
Устанавливает учетную запись, которая будет использоваться для аутентификации в API в качестве предприятия.
setStoreLayout
Устанавливает макет магазина для предприятия. По умолчанию storeLayoutType установлен на "basic", и включен базовый макет магазина. Базовый макет содержит только приложения, одобренные администратором и добавленные в доступный набор продуктов для пользователя (с помощью вызова setAvailableProductSet ). Приложения на странице сортируются в порядке значения их идентификатора продукта. Если вы создаете пользовательский макет магазина (устанавливая storeLayoutType = "custom" и устанавливая домашнюю страницу), базовый макет магазина отключается.
отписаться
Отменяет регистрацию предприятия в вызывающей EMM.