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
    }
  ],
  "googleAuthenticationSettings": {
    "googleAuthenticationRequired": string,
    "dedicatedDevicesAllowed": string,
    "createdAt": {
      "seconds": long,
      "nanos": integer
    },
    "updatedAt": {
      "seconds": long,
      "nanos": integer
    }
  },
  "enterpriseType": string,
  "managedGoogleDomainType": string
}
Имя объекта недвижимости Ценить Описание Примечания
administrator[] list Администраторы предприятия. Поддерживается только для предприятий, созданных через процесс, инициированный EMM.

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

Допустимые значения:
  • " enterpriseTypeUnspecified "
  • " managedGoogleDomain "
  • " managedGooglePlayAccountsEnterprise "
googleAuthenticationSettings nested object Настройки аутентификации пользователей, предоставляемые Google.
googleAuthenticationSettings. createdAt nested object Отметка времени, когда настройки были впервые созданы или изменены.
googleAuthenticationSettings.createdAt. nanos integer Неотрицательные доли секунды с разрешением до наносекунд. Отрицательные значения секунд с дробями должны иметь неотрицательные значения в наносекундах, которые отсчитываются вперёд во времени. Должны быть в диапазоне от 0 до 999 999 999 включительно.
googleAuthenticationSettings.createdAt. seconds long Представляет секунды по времени UTC с эпохи Unix 1970-01-01T00:00:00Z. Должно быть в диапазоне от 0001-01-01T00:00:00Z до 9999-12-31T23:59:59Z включительно.
googleAuthenticationSettings. dedicatedDevicesAllowed string Разрешены ли специализированные устройства.

Допустимые значения:
  • " allowed "
  • " dedicatedDevicesAllowedUnspecified "
  • " disallowed "
googleAuthenticationSettings. googleAuthenticationRequired string Требуется ли аутентификация Google.

Допустимые значения:
  • " googleAuthenticationRequiredUnspecified "
  • " notRequired "
  • " required "
googleAuthenticationSettings. updatedAt nested object Отметка времени последнего изменения настроек.
googleAuthenticationSettings.updatedAt. nanos integer Неотрицательные доли секунды с разрешением до наносекунд. Отрицательные значения секунд с дробями должны иметь неотрицательные значения в наносекундах, которые отсчитываются вперёд во времени. Должны быть в диапазоне от 0 до 999 999 999 включительно.
googleAuthenticationSettings.updatedAt. seconds long Представляет секунды по времени UTC с эпохи Unix 1970-01-01T00:00:00Z. Должно быть в диапазоне от 0001-01-01T00:00:00Z до 9999-12-31T23:59:59Z включительно.
id string Уникальный идентификатор предприятия.

id string Уникальный идентификатор предприятия.

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

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

Методы

acknowledgeNotificationSet
Подтверждает уведомления, полученные от Enterprises.PullNotificationSet, чтобы предотвратить возврат тех же уведомлений при последующих вызовах.
завершитьРегистрацию
Завершает процесс регистрации, указывая токены завершения и предприятия. Этот запрос не должен выполняться несколько раз для одного и того же токена предприятия.
createWebToken
Возвращает уникальный токен для доступа к встраиваемому пользовательскому интерфейсу. Чтобы сгенерировать веб-интерфейс, передайте сгенерированный токен в управляемый JavaScript-API Google Play. Каждый токен можно использовать только для запуска одного сеанса пользовательского интерфейса. Подробнее см. в документации по JavaScript API .
зарегистрироваться
Регистрирует предприятие с вызывающим EMM.
generateEnterpriseUpgradeUrl
Создаёт URL-адрес для обновления корпоративного аккаунта Google Play до управляемого домена Google. Подробнее см. в руководстве по обновлению корпоративного аккаунта .
generateSignupUrl
Генерирует URL-адрес для регистрации.
получать
Возвращает название и домен предприятия.
получитьServiceAccount
Возвращает учетную запись службы и учетные данные. Учетную запись службы можно привязать к предприятию, вызвав setAccount. Учетная запись службы уникальна для данного предприятия и EMM и будет удалена при отмене привязки предприятия. Учетные данные содержат данные закрытого ключа и не хранятся на стороне сервера.

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

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

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

.
получитьStoreLayout
Возвращает макет магазина для предприятия. Если макет магазина не задан, возвращается тип макета «базовый» без главной страницы.
список
Поиск предприятия по доменному имени. Поддерживается только для предприятий, созданных через процесс создания, инициированный 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.