Этот справочник API организован по типу ресурса. Каждый тип ресурса имеет одно или несколько представлений данных и один или несколько методов.
Типы ресурсов
- Устройства
- Предприятия
- Права
- Групповые лицензии
- Grouplicenseusers
- Устанавливает
- Управляемые конфигурации для устройства
- Управляемые конфигурации для пользователя
- Настройки управляемых конфигураций
- Разрешения
- Продукты
- Сервисные учетные записи
- Storelayoutclusters
- Storelayoutpages
- Пользователи
- Веб-приложения
Устройства
Сведения о ресурсах устройств см. на странице представления ресурсов .
| Метод | HTTP-запрос | Описание |
|---|---|---|
| URI относительно https://www.googleapis.com/androidenterprise/v1, если не указано иное. | ||
| ForceReportUpload | POST /enterprises/ enterpriseId /users/ userId /devices/ deviceId /forceReportUpload | Загружает отчет, содержащий любые изменения в состояниях приложения на устройстве с момента создания последнего отчета. Вы можете вызывать этот метод до 3 раз каждые 24 часа для данного устройства. |
| получать | GET /enterprises/ enterpriseId /users/ userId /devices/ deviceId | Получает сведения об устройстве. |
| получить состояние | GET /enterprises/ enterpriseId /users/ userId /devices/ deviceId /state | Получает, включен или отключен доступ устройства к службам Google. Состояние устройства действует только в том случае, если в консоли администратора Google включено применение политик EMM на устройствах Android. В противном случае состояние устройства игнорируется, и всем устройствам разрешен доступ к службам Google. Это поддерживается только для пользователей, управляемых Google. |
| список | GET /enterprises/ enterpriseId /users/ userId /devices | Получает идентификаторы всех устройств пользователя. |
| setState | PUT /enterprises/ enterpriseId /users/ userId /devices/ deviceId /state | Устанавливает, включен или отключен доступ устройства к службам Google. Состояние устройства действует только в том случае, если в консоли администратора Google включено применение политик EMM на устройствах Android. В противном случае состояние устройства игнорируется, и всем устройствам разрешен доступ к службам Google. Это поддерживается только для пользователей, управляемых Google. |
| обновлять | PUT /enterprises/ enterpriseId /users/ userId /devices/ deviceId | Обновляет политику устройства. Чтобы обеспечить правильное применение политики, необходимо запретить неуправляемым учетным записям доступ к Google Play, настроив allowed_accounts в управляемой конфигурации для пакета Google Play. См. ограничение учетных записей в Google Play . |
Предприятия
Подробную информацию о корпоративных ресурсах см. на странице представления ресурсов .
| Метод | HTTP-запрос | Описание |
|---|---|---|
| URI относительно https://www.googleapis.com/androidenterprise/v1, если не указано иное. | ||
| подтвердитеNotificationSet | POST /enterprises/acknowledgeNotificationSet | Подтверждает получение уведомлений от Enterprises.PullNotificationSet, чтобы последующие вызовы не возвращали одни и те же уведомления. |
| завершитьРегистрация | POST /enterprises/completeSignup | Завершает процесс регистрации, указывая токен завершения и токен предприятия. Этот запрос не должен вызываться несколько раз для данного корпоративного токена. |
| создатьWebToken | POST /enterprises/ enterpriseId /createWebToken | Возвращает уникальный токен для доступа к встраиваемому пользовательскому интерфейсу. Чтобы создать веб-интерфейс, передайте сгенерированный токен в управляемый Google Play javascript API. Каждый токен можно использовать только для запуска одного сеанса пользовательского интерфейса. Дополнительную информацию см. в документации по javascript API. |
| зарегистрироваться | POST /enterprises/enroll | Регистрирует предприятие в вызывающем EMM. Обязательные параметры запроса: token |
| generateSignupUrl | POST /enterprises/signupUrl | Создает URL-адрес для регистрации. |
| получать | GET /enterprises/ enterpriseId | Получает имя и домен предприятия. |
| getServiceAccount | GET /enterprises/ enterpriseId /serviceAccount | Возвращает учетную запись службы и учетные данные. Учетную запись службы можно привязать к предприятию, вызвав setAccount. Учетная запись службы уникальна для этого предприятия и EMM и будет удалена, если предприятие не привязано. Учетные данные содержат данные закрытого ключа и не хранятся на стороне сервера. Этот метод можно вызывать только после вызова Enterprises.Enroll или Enterprises.CompleteSignup и до Enterprise.SetAccount; в других случаях он вернет ошибку. Последующие вызовы после первого будут генерировать новый уникальный набор учетных данных и делать недействительными ранее созданные учетные данные. Как только учетная запись службы будет привязана к предприятию, ею можно будет управлять с помощью ресурса serviceAccountKeys. |
| getStoreLayout | GET /enterprises/ enterpriseId /storeLayout | Возвращает макет магазина для предприятия. Если макет магазина не был установлен, возвращает «базовый» в качестве типа макета магазина, а не домашнюю страницу. |
| список | GET /enterprises | Ищет предприятие по доменному имени. Это поддерживается только для предприятий, созданных с помощью процесса создания, инициированного Google. Поиск идентификатора не требуется для предприятий, созданных с помощью потока, инициированного EMM, поскольку EMM узнает идентификатор предприятия в обратном вызове, указанном в вызове Enterprises.generateSignupUrl. Обязательные параметры запроса: domain |
| pullNotificationSet | POST /enterprises/pullNotificationSet | Извлекает и возвращает набор уведомлений для предприятий, связанных с учетной записью службы, прошедшей проверку подлинности для запроса. Набор уведомлений может быть пустым, если нет ожидающих уведомлений. Возвращенный набор уведомлений необходимо подтвердить в течение 20 секунд, вызвав Enterprises.AcknowledgeNotificationSet, если только набор уведомлений не пуст. Уведомления, которые не будут подтверждены в течение 20 секунд, в конечном итоге будут снова включены в ответ на другой запрос PullNotificationSet, а те, которые никогда не будут подтверждены, в конечном итоге будут удалены в соответствии с политикой системы Pub/Sub Google Cloud Platform. Несколько запросов могут выполняться одновременно для получения уведомлений, и в этом случае ожидающие уведомления (если есть) будут разделены между каждым вызывающим абонентом, если таковые имеются. Если уведомлений нет, возвращается пустой список уведомлений. Последующие запросы могут возвращать больше уведомлений, когда они становятся доступными. |
| отправитьTestPushNotification | POST /enterprises/ enterpriseId /sendTestPushNotification | Отправляет тестовое уведомление для проверки интеграции EMM со службой Google Cloud Pub/Sub для этого предприятия. |
| setAccount | PUT /enterprises/ enterpriseId /account | Устанавливает учетную запись, которая будет использоваться для аутентификации в API, в качестве корпоративной. |
| сетсторелайаут | PUT /enterprises/ enterpriseId /storeLayout | Задает макет магазина для предприятия. По умолчанию для storeLayoutType задано значение «базовый», а базовый макет магазина включен. Базовый макет содержит только приложения, одобренные администратором и добавленные в доступный для пользователя набор продуктов (с помощью вызова setAvailableProductSet ). Приложения на странице отсортированы по значению идентификатора продукта. Если вы создаете собственный макет магазина (устанавливая storeLayoutType = "custom" и задавая домашнюю страницу), базовый макет магазина отключается. |
| отменить регистрацию | POST /enterprises/ enterpriseId /unenroll | Отменяет регистрацию предприятия в вызывающем EMM. |
Права
Подробные сведения о ресурсах прав см. на странице представления ресурсов .
| Метод | HTTP-запрос | Описание |
|---|---|---|
| URI относительно https://www.googleapis.com/androidenterprise/v1, если не указано иное. | ||
| удалить | DELETE /enterprises/ enterpriseId /users/ userId /entitlements/ entitlementId | Удаляет право на приложение для пользователя. Примечание. Этот элемент устарел. Новые интеграции не могут использовать этот метод и могут ссылаться на наши новые рекомендации . |
| получать | GET /enterprises/ enterpriseId /users/ userId /entitlements/ entitlementId | Получает сведения о праве. Примечание. Этот элемент устарел. Новые интеграции не могут использовать этот метод и могут ссылаться на наши новые рекомендации . |
| список | GET /enterprises/ enterpriseId /users/ userId /entitlements | Список всех прав для указанного пользователя. Устанавливается только ID. Примечание. Этот элемент устарел. Новые интеграции не могут использовать этот метод и могут ссылаться на наши новые рекомендации . |
| обновлять | PUT /enterprises/ enterpriseId /users/ userId /entitlements/ entitlementId | Добавляет или обновляет право на приложение для пользователя. Примечание. Этот элемент устарел. Новые интеграции не могут использовать этот метод и могут ссылаться на наши новые рекомендации . |
Групповые лицензии
Подробную информацию о ресурсах групповых лицензий см. на странице представления ресурсов .
| Метод | HTTP-запрос | Описание |
|---|---|---|
| URI относительно https://www.googleapis.com/androidenterprise/v1, если не указано иное. | ||
| получать | GET /enterprises/ enterpriseId /groupLicenses/ groupLicenseId | Извлекает сведения о корпоративной групповой лицензии на продукт. Примечание. Этот элемент устарел. Новые интеграции не могут использовать этот метод и могут ссылаться на наши новые рекомендации . |
| список | GET /enterprises/ enterpriseId /groupLicenses | Получает идентификаторы всех продуктов, для которых предприятие имеет групповую лицензию. Примечание. Этот элемент устарел. Новые интеграции не могут использовать этот метод и могут ссылаться на наши новые рекомендации . |
Grouplicenseusers
Сведения о ресурсе Grouplicenseusers см. на странице представления ресурса .
| Метод | HTTP-запрос | Описание |
|---|---|---|
| URI относительно https://www.googleapis.com/androidenterprise/v1, если не указано иное. | ||
| список | GET /enterprises/ enterpriseId /groupLicenses/ groupLicenseId /users | Извлекает идентификаторы пользователей, которым были предоставлены права в соответствии с лицензией. Примечание. Этот элемент устарел. Новые интеграции не могут использовать этот метод и могут ссылаться на наши новые рекомендации . |
Устанавливает
Сведения о ресурсе Installs см. на странице представления ресурса .
| Метод | HTTP-запрос | Описание |
|---|---|---|
| URI относительно https://www.googleapis.com/androidenterprise/v1, если не указано иное. | ||
| удалить | DELETE /enterprises/ enterpriseId /users/ userId /devices/ deviceId /installs/ installId | Запросы на удаление приложения с устройства. При вызове get или list приложение по-прежнему будет отображаться как установленное на устройстве, пока оно не будет удалено. |
| получать | GET /enterprises/ enterpriseId /users/ userId /devices/ deviceId /installs/ installId | Получает сведения об установке приложения на устройстве. |
| список | GET /enterprises/ enterpriseId /users/ userId /devices/ deviceId /installs | Получает сведения обо всех приложениях, установленных на указанном устройстве. |
| обновлять | PUT /enterprises/ enterpriseId /users/ userId /devices/ deviceId /installs/ installId | Запросы на установку последней версии приложения на устройство. Если приложение уже установлено, то при необходимости оно обновляется до последней версии. |
Управляемые конфигурации для устройства
Сведения о ресурсе Managedconfigurationsfordevice см. на странице представления ресурса .
| Метод | HTTP-запрос | Описание |
|---|---|---|
| URI относительно https://www.googleapis.com/androidenterprise/v1, если не указано иное. | ||
| удалить | DELETE /enterprises/ enterpriseId /users/ userId /devices/ deviceId /managedConfigurationsForDevice/ managedConfigurationForDeviceId | Удаляет управляемую конфигурацию для каждого устройства для приложения для указанного устройства. |
| получать | GET /enterprises/ enterpriseId /users/ userId /devices/ deviceId /managedConfigurationsForDevice/ managedConfigurationForDeviceId | Получает сведения об управляемой конфигурации для каждого устройства. |
| список | GET /enterprises/ enterpriseId /users/ userId /devices/ deviceId /managedConfigurationsForDevice | Список всех управляемых конфигураций для каждого устройства для указанного устройства. Устанавливается только ID. |
| обновлять | PUT /enterprises/ enterpriseId /users/ userId /devices/ deviceId /managedConfigurationsForDevice/ managedConfigurationForDeviceId | Добавляет или обновляет управляемую конфигурацию для каждого устройства для приложения для указанного устройства. |
Управляемые конфигурации для пользователя
Подробные сведения об управляемых конфигурациях для пользовательских ресурсов см. на странице представления ресурсов .
| Метод | HTTP-запрос | Описание |
|---|---|---|
| URI относительно https://www.googleapis.com/androidenterprise/v1, если не указано иное. | ||
| удалить | DELETE /enterprises/ enterpriseId /users/ userId /managedConfigurationsForUser/ managedConfigurationForUserId | Удаляет управляемую пользователем конфигурацию приложения для указанного пользователя. |
| получать | GET /enterprises/ enterpriseId /users/ userId /managedConfigurationsForUser/ managedConfigurationForUserId | Извлекает сведения об управляемой конфигурации для каждого пользователя для приложения для указанного пользователя. |
| список | GET /enterprises/ enterpriseId /users/ userId /managedConfigurationsForUser | Список всех управляемых конфигураций для каждого пользователя для указанного пользователя. Устанавливается только ID. |
| обновлять | PUT /enterprises/ enterpriseId /users/ userId /managedConfigurationsForUser/ managedConfigurationForUserId | Добавляет или обновляет параметры управляемой конфигурации для приложения для указанного пользователя. Если вы поддерживаете iframe управляемых конфигураций , вы можете применить управляемые конфигурации к пользователю, указав mcmId и связанные с ним переменные конфигурации (если они есть) в запросе. Кроме того, все EMM могут применять управляемые конфигурации, передавая список управляемых свойств. |
Настройки управляемых конфигураций
Сведения о ресурсе Managedconfigurationssettings см. на странице представления ресурса .
| Метод | HTTP-запрос | Описание |
|---|---|---|
| URI относительно https://www.googleapis.com/androidenterprise/v1, если не указано иное. | ||
| список | GET /enterprises/ enterpriseId /products/ productId /managedConfigurationsSettings | Список всех параметров управляемых конфигураций для указанного приложения. |
Разрешения
Сведения о ресурсе разрешений см. на странице представления ресурса .
| Метод | HTTP-запрос | Описание |
|---|---|---|
| URI относительно https://www.googleapis.com/androidenterprise/v1, если не указано иное. | ||
| получать | GET /permissions/ permissionId | Получает сведения о разрешении приложения Android для отображения администратору предприятия. |
Продукты
Подробную информацию о ресурсах продуктов см. на странице представления ресурсов .
| Метод | HTTP-запрос | Описание |
|---|---|---|
| URI относительно https://www.googleapis.com/androidenterprise/v1, если не указано иное. | ||
| утвердить | POST /enterprises/ enterpriseId /products/ productId /approve | Утверждает указанный продукт и соответствующие разрешения приложения, если таковые имеются. Максимальное количество продуктов, которые вы можете одобрить для одного корпоративного клиента, составляет 1000. Чтобы узнать, как использовать управляемый Google Play для проектирования и создания макета магазина, чтобы отображать одобренные продукты для ваших пользователей, см. раздел Дизайн макета магазина . Примечание. Этот элемент устарел. Новые интеграции не могут использовать этот метод и могут ссылаться на наши новые рекомендации . |
| generateApprovalUrl | POST /enterprises/ enterpriseId /products/ productId /generateApprovalUrl | Создает URL-адрес, который может отображаться в iframe для отображения разрешений (если есть) продукта. Администратор предприятия должен просмотреть эти разрешения и принять их от имени своей организации, чтобы утвердить этот продукт. Администраторы должны принять отображаемые разрешения, взаимодействуя с отдельным элементом пользовательского интерфейса в консоли EMM, что, в свою очередь, должно инициировать использование этого URL-адреса в качестве свойства ApprovalUrlInfo.approvalUrl в вызове Products.approve для approvalUrlInfo.approvalUrl продукта. Этот URL-адрес можно использовать только для отображения разрешений на срок до 1 дня. Примечание. Этот элемент устарел. Новые интеграции не могут использовать этот метод и могут ссылаться на наши новые рекомендации . |
| получать | GET /enterprises/ enterpriseId /products/ productId | Извлекает сведения о продукте для отображения администратору предприятия. |
| getAppRestrictionsSchema | GET /enterprises/ enterpriseId /products/ productId /appRestrictionsSchema | Извлекает схему, определяющую настраиваемые свойства для этого продукта. У всех продуктов есть схема, но эта схема может быть пустой, если не определены управляемые конфигурации. Эту схему можно использовать для заполнения пользовательского интерфейса, который позволяет администратору настраивать продукт. Чтобы применить управляемую конфигурацию на основе схемы, полученной с помощью этого API, см. раздел Управляемые конфигурации через Play . |
| получить разрешения | GET /enterprises/ enterpriseId /products/ productId /permissions | Получает разрешения приложения Android, необходимые этому приложению. |
| список | GET /enterprises/ enterpriseId /products | Находит одобренные продукты, соответствующие запросу, или все одобренные продукты, если запроса нет. Примечание. Этот элемент устарел. Новые интеграции не могут использовать этот метод и могут ссылаться на наши новые рекомендации . |
| не одобрять | POST /enterprises/ enterpriseId /products/ productId /unapprove | Отменяет утверждение указанного продукта (и соответствующих разрешений приложения, если таковые имеются). Примечание. Этот элемент устарел. Новые интеграции не могут использовать этот метод и могут ссылаться на наши новые рекомендации . |
Сервисные учетные записи
Сведения о ресурсе Serviceaccountkeys см. на странице представления ресурса .
| Метод | HTTP-запрос | Описание |
|---|---|---|
| URI относительно https://www.googleapis.com/androidenterprise/v1, если не указано иное. | ||
| удалить | DELETE /enterprises/ enterpriseId /serviceAccountKeys/ keyId | Удаляет и делает недействительными указанные учетные данные для учетной записи службы, связанной с этим предприятием. Учетная запись вызывающей службы должна быть получена путем вызова Enterprise.GetServiceAccount и должна быть установлена в качестве учетной записи службы предприятия путем вызова Enterprise.SetAccount. |
| вставлять | POST /enterprises/ enterpriseId /serviceAccountKeys | Создает новые учетные данные для учетной записи службы, связанной с этим предприятием. Учетная запись вызывающей службы должна быть получена путем вызова Enterprise.GetServiceAccount и должна быть установлена в качестве учетной записи службы предприятия путем вызова Enterprise.SetAccount. В вставляемом ресурсе должен быть указан только тип ключа. |
| список | GET /enterprises/ enterpriseId /serviceAccountKeys | Список всех активных учетных данных для учетной записи службы, связанной с этим предприятием. Возвращаются только идентификатор и тип ключа. Учетная запись вызывающей службы должна быть получена путем вызова Enterprise.GetServiceAccount и должна быть установлена в качестве учетной записи службы предприятия путем вызова Enterprise.SetAccount. |
Storelayoutclusters
Сведения о ресурсах Storelayoutclusters см. на странице представления ресурсов .
| Метод | HTTP-запрос | Описание |
|---|---|---|
| URI относительно https://www.googleapis.com/androidenterprise/v1, если не указано иное. | ||
| удалить | DELETE /enterprises/ enterpriseId /storeLayout/pages/ pageId /clusters/ clusterId | Удаляет кластер. |
| получать | GET /enterprises/ enterpriseId /storeLayout/pages/ pageId /clusters/ clusterId | Извлекает сведения о кластере. |
| вставлять | POST /enterprises/ enterpriseId /storeLayout/pages/ pageId /clusters | Вставляет новый кластер на страницу. |
| список | GET /enterprises/ enterpriseId /storeLayout/pages/ pageId /clusters | Извлекает сведения обо всех кластерах на указанной странице. |
| обновлять | PUT /enterprises/ enterpriseId /storeLayout/pages/ pageId /clusters/ clusterId | Обновляет кластер. |
Storelayoutpages
Сведения о ресурсе Storelayoutpages см. на странице представления ресурса .
| Метод | HTTP-запрос | Описание |
|---|---|---|
| URI относительно https://www.googleapis.com/androidenterprise/v1, если не указано иное. | ||
| удалить | DELETE /enterprises/ enterpriseId /storeLayout/pages/ pageId | Удаляет страницу магазина. |
| получать | GET /enterprises/ enterpriseId /storeLayout/pages/ pageId | Получает сведения о странице магазина. |
| вставлять | POST /enterprises/ enterpriseId /storeLayout/pages | Вставляет новую страницу магазина. |
| список | GET /enterprises/ enterpriseId /storeLayout/pages | Получает информацию обо всех страницах в магазине. |
| обновлять | PUT /enterprises/ enterpriseId /storeLayout/pages/ pageId | Обновляет содержимое страницы магазина. |
Пользователи
Сведения о ресурсах пользователей см. на странице представления ресурсов .
| Метод | HTTP-запрос | Описание |
|---|---|---|
| URI относительно https://www.googleapis.com/androidenterprise/v1, если не указано иное. | ||
| удалить | DELETE /enterprises/ enterpriseId /users/ userId | Удален пользователь, управляемый EMM. |
| генерироватьаутентикатионтокен | POST /enterprises/ enterpriseId /users/ userId /authenticationToken | Создает токен проверки подлинности, который клиент политики устройства может использовать для подготовки данной учетной записи пользователя, управляемой EMM, на устройстве. Сгенерированный токен является одноразовым и истекает через несколько минут. Вы можете подготовить максимум 10 устройств для каждого пользователя. Этот вызов работает только с учетными записями, управляемыми EMM. |
| получать | GET /enterprises/ enterpriseId /users/ userId | Извлекает данные пользователя. |
| жетаваилаблепродуктсет | GET /enterprises/ enterpriseId /users/ userId /availableProductSet | Извлекает набор продуктов, к которым пользователь имеет право доступа. Примечание. Этот элемент устарел. Новые интеграции не могут использовать этот метод и могут ссылаться на наши новые рекомендации . |
| вставлять | POST /enterprises/ enterpriseId /users | Создает нового пользователя, управляемого EMM. Ресурс Users , передаваемый в теле запроса, должен включать accountIdentifier и accountType . Если соответствующий пользователь уже существует с таким же идентификатором учетной записи, пользователь будет обновлен с помощью ресурса. В этом случае можно изменить только поле |
| список | GET /enterprises/ enterpriseId /users | Ищет пользователя по основному адресу электронной почты. Это поддерживается только для пользователей, управляемых Google. Поиск идентификатора не требуется для пользователей, управляемых EMM, поскольку идентификатор уже возвращен в результате вызова Users.insert. Обязательные параметры запроса: email |
| отозвать доступ к устройству | DELETE /enterprises/ enterpriseId /users/ userId /deviceAccess | Отменяет доступ ко всем устройствам, предоставленным пользователю в данный момент. Пользователь больше не сможет использовать управляемый магазин Play на любом из своих управляемых устройств. Этот вызов работает только с учетными записями, управляемыми EMM. |
| setAvailableProductSet | PUT /enterprises/ enterpriseId /users/ userId /availableProductSet | Изменяет набор продуктов, к которым пользователь имеет право доступа (называемых продуктами из белого списка ). Только одобренные продукты или продукты, одобренные ранее (продукты с отозванным утверждением), могут быть внесены в белый список. Примечание. Этот элемент устарел. Новые интеграции не могут использовать этот метод и могут ссылаться на наши новые рекомендации . |
| обновлять | PUT /enterprises/ enterpriseId /users/ userId | Обновляет сведения о пользователе, управляемом EMM. Может использоваться только с пользователями, управляемыми EMM (но не с пользователями, управляемыми Google). Передайте новые сведения в ресурс Users в тексте запроса. Можно изменить только поле displayName . Другие поля должны быть либо не установлены, либо иметь текущее активное значение. |
Веб-приложения
Подробную информацию о ресурсе веб-приложений см. на странице представления ресурса .
| Метод | HTTP-запрос | Описание |
|---|---|---|
| URI относительно https://www.googleapis.com/androidenterprise/v1, если не указано иное. | ||
| удалить | DELETE /enterprises/ enterpriseId /webApps/ webAppId | Удаляет существующее веб-приложение. |
| получать | GET /enterprises/ enterpriseId /webApps/ webAppId | Получает существующее веб-приложение. |
| вставлять | POST /enterprises/ enterpriseId /webApps | Создает новое веб-приложение для предприятия. |
| список | GET /enterprises/ enterpriseId /webApps | Получает сведения обо всех веб-приложениях для данного предприятия. |
| обновлять | PUT /enterprises/ enterpriseId /webApps/ webAppId | Обновляет существующее веб-приложение. |