Список методов для этого ресурса см. в конце этой страницы.
Представления ресурсов
Ресурс Products представляет собой приложение в магазине Google Play, доступное как минимум некоторым пользователям на предприятии. (Некоторые приложения доступны только одному предприятию, и никакая информация о них не доступна за пределами этого предприятия.)
Информация, предоставляемая для каждого продукта (локализованное название, значок, ссылка на полную страницу сведений о Google Play), предназначена для обеспечения базового представления продукта в пользовательском интерфейсе EMM.
{ "kind": "androidenterprise#product", "productId": string, "title": string, "authorName": string, "iconUrl": string, "smallIconUrl": string, "detailsUrl": string, "workDetailsUrl": string, "requiresContainerApp": boolean, "appVersion": [ { "versionString": string, "versionCode": integer, "track": string, "targetSdkVersion": integer, "trackId": [ string ], "isProduction": boolean } ], "distributionChannel": string, "productPricing": string, "signingCertificate": { "certificateHashSha256": string, "certificateHashSha1": string }, "availableTracks": [ string ], "appTracks": [ { "trackId": string, "trackAlias": string } ], "description": string, "fullDescription": string, "screenshotUrls": [ string ], "category": string, "recentChanges": string, "minAndroidSdkVersion": integer, "contentRating": string, "lastUpdatedTimestampMillis": long, "permissions": [ { "permissionId": string, "state": string } ], "availableCountries": [ string ], "features": [ string ], "iarcGenericRating": string, "appRestrictionsSchema": { "kind": string, "restrictions": [ { "key": string, "title": string, "restrictionType": string, "description": string, "entry": [ string ], "entryValue": [ string ], "defaultValue": { "type": string, "valueBool": boolean, "valueString": string, "valueInteger": integer, "valueMultiselect": [ string ] }, "nestedRestriction": [ (AppRestrictionsSchemaRestriction) ] } ] } }
Имя свойства | Ценить | Описание | Примечания |
---|---|---|---|
appRestrictionsSchema | nested object | Схема ограничения приложений | |
appRestrictionsSchema. kind | string | Устарело. | |
appRestrictionsSchema. restrictions[] | list | Набор ограничений, составляющих эту схему. | |
appRestrictionsSchema.restrictions[]. defaultValue | nested object | Значение ограничения по умолчанию. Ограничения bundle и bundleArray никогда не имеют значения по умолчанию. | |
appRestrictionsSchema.restrictions[].defaultValue. type | string | Тип предоставляемого значения. Приемлемые значения:
| |
appRestrictionsSchema.restrictions[].defaultValue. valueBool | boolean | Логическое значение — оно будет присутствовать только в том случае, если тип — bool. | |
appRestrictionsSchema.restrictions[].defaultValue. valueInteger | integer | Целочисленное значение — оно будет присутствовать только в том случае, если тип — целое число. | |
appRestrictionsSchema.restrictions[].defaultValue. valueMultiselect[] | list | Список строковых значений — он будет присутствовать только в том случае, если тип является множественным выбором. | |
appRestrictionsSchema.restrictions[].defaultValue. valueString | string | Строковое значение — оно будет присутствовать для типов string, choice и скрытого. | |
appRestrictionsSchema.restrictions[]. description | string | Более подробное описание ограничения с подробным описанием того, на что оно влияет. | |
appRestrictionsSchema.restrictions[]. entryValue[] | list | Для ограничений choice или multiselect — список возможных машиночитаемых значений записей. Эти значения следует использовать в конфигурации либо в виде одного string значения для ограничения choice , либо в виде stringArray для ограничения multiselect . | |
appRestrictionsSchema.restrictions[]. entry[] | list | Для ограничений choice или multiselect — список возможных удобочитаемых имен записей. | |
appRestrictionsSchema.restrictions[]. key | string | Уникальный ключ, который продукт использует для идентификации ограничения, например «com.google.android.gm.fieldname». | |
appRestrictionsSchema.restrictions[]. nestedRestriction[] | list | Для ограничений bundle или bundleArray — список вложенных ограничений. Ограничение bundle всегда вложено в ограничение bundleArray , а ограничение bundleArray имеет глубину не более двух уровней. | |
appRestrictionsSchema.restrictions[]. restrictionType | string | Тип ограничения. Приемлемые значения:
| |
appRestrictionsSchema.restrictions[]. title | string | Название ограничения. | |
appTracks[] | list | Следы видны предприятию. | |
appTracks[]. trackAlias | string | Изменяемое имя трека. Это видимое имя в консоли разработчика Play. | |
appTracks[]. trackId | string | Неизменяемый уникальный идентификатор трека. Этот идентификатор — это ReleaseTrackId в URL-адресе страницы консоли разработчика Play, на которой отображается информация о треке. | |
appVersion[] | list | Версии приложения, доступные в настоящее время для этого продукта. | |
appVersion[]. isProduction | boolean | Верно, если эта версия является производственным APK. | |
appVersion[]. targetSdkVersion | integer | Версия SDK, на которую рассчитано это приложение, указана в манифесте APK. См. http://developer.android.com/guide/topics/manifest/uses-sdk-element.html. | |
appVersion[]. track | string | Устарело, вместо этого используйте trackId .Приемлемые значения:
| |
appVersion[]. trackId[] | list | Идентификаторы отслеживания, в которых опубликована версия приложения. Заменяет поле track (устарело), но не включает рабочую версию (вместо этого см. isProduction ). | |
appVersion[]. versionCode | integer | Уникальный увеличивающийся идентификатор версии приложения. | |
appVersion[]. versionString | string | Строка, используемая в магазине Play разработчиком приложения для идентификации версии. Строка не обязательно является уникальной или локализованной (например, строка может быть «1,4»). | |
authorName | string | Имя автора продукта (например, разработчика приложения). | |
availableCountries[] | list | Страны, в которых доступно это приложение. | |
availableTracks[] | list | Устарело, вместо этого используйте appTracks . | |
category | string | Категория приложения (например, ГОНКИ, СОЦИАЛЬНЫЕ и т. д.) | |
contentRating | string | Рейтинг контента для этого приложения. Приемлемые значения:
| |
description | string | Локализованное рекламное описание, если оно доступно. | |
detailsUrl | string | Ссылка на (потребительскую) страницу сведений о продукте в Google Play. | |
distributionChannel | string | Как и кому предоставляется пакет. Значение publicGoogleHosted означает, что пакет доступен в магазине Play и не ограничен конкретным предприятием. Значение privateGoogleHosted означает, что пакет является частным приложением (только корпоративным), но размещенным в Google. Значение privateSelfHosted означает, что пакет является частным приложением (только для предприятия) и размещается в частном порядке.Приемлемые значения:
| |
features[] | list | Примечательные особенности (если таковые имеются) этого продукта. | |
fullDescription | string | Локализованное полное описание магазина приложений, если оно доступно. | |
iarcGenericRating | string | Рейтинг контента для этого приложения. Приемлемые значения:
| |
iconUrl | string | Ссылка на изображение, которое можно использовать в качестве значка продукта. Это изображение подходит для использования с размером до 512 x 512 пикселей. | |
kind | string | ||
lastUpdatedTimestampMillis | long | Примерное время (в течение 7 дней) последней публикации приложения, выраженное в миллисекундах с момента публикации. | |
minAndroidSdkVersion | integer | Минимальный Android SDK, необходимый для запуска приложения. | |
permissions[] | list | Список разрешений, необходимых приложению. | |
permissions[]. permissionId | string | Непрозрачная строка, однозначно идентифицирующая разрешение. | |
permissions[]. state | string | Было ли разрешение принято или нет. Приемлемые значения:
| |
productId | string | Строка вида app:<package name> . Например, app:com.google.android.gm представляет приложение Gmail. | |
productPricing | string | Является ли этот продукт бесплатным, бесплатным с покупками в приложении или платным. Если цена неизвестна, это означает, что продукт больше не доступен (хотя он все еще может быть доступен владельцам). Приемлемые значения:
| |
recentChanges | string | Описание последних изменений, внесенных в приложение. | |
requiresContainerApp | boolean | Устарело. | |
screenshotUrls[] | list | Список ссылок на скриншоты, представляющие приложение. | |
signingCertificate | nested object | Сертификат, используемый для подписи этого продукта. | |
signingCertificate. certificateHashSha1 | string | Хэш сертификата SHA1 в кодировке URL-адреса Base64. (Это поле устарело в пользу SHA2-256. Его не следует использовать и его можно удалить в любое время.) | |
signingCertificate. certificateHashSha256 | string | URL-адрес base64 закодировал хэш сертификата SHA2-256. | |
smallIconUrl | string | Ссылка на уменьшенное изображение, которое можно использовать в качестве значка продукта. Это изображение подходит для использования с размером до 128 x 128 пикселей. | |
title | string | Название продукта. | |
workDetailsUrl | string | Ссылка на управляемую страницу сведений о продукте в Google Play для использования администратором предприятия. |
Методы
- утвердить
Утверждает указанный продукт и соответствующие разрешения приложения, если таковые имеются. Максимальное количество продуктов, которые вы можете утвердить для одного корпоративного клиента, составляет 1000.
Чтобы узнать, как использовать управляемый Google Play для разработки и создания макета магазина для показа пользователям одобренных продуктов, см. раздел «Дизайн макета магазина» .
- генерироватьApprovalUrl
- Создает URL-адрес, который можно отобразить в iframe для отображения разрешений (если таковые имеются) продукта. Администратор предприятия должен просмотреть эти разрешения и принять их от имени своей организации, чтобы утвердить этот продукт.
Администраторам следует принять отображаемые разрешения, взаимодействуя с отдельным элементом пользовательского интерфейса в консоли EMM, что, в свою очередь, должно инициировать использование этого URL-адреса в качестве свойстваapprovalUrlInfo.approvalUrl
в вызовеProducts.approve
для утверждения продукта. Этот URL-адрес можно использовать только для отображения разрешений на срок до 1 дня. - получать
- Извлекает подробную информацию о продукте для отображения администратору предприятия.
- getAppRestrictionsSchema
- Получает схему, определяющую настраиваемые свойства этого продукта. У всех продуктов есть схема, но эта схема может быть пустой, если не определены управляемые конфигурации. Эту схему можно использовать для заполнения пользовательского интерфейса, который позволяет администратору настраивать продукт. Чтобы применить управляемую конфигурацию на основе схемы, полученной с помощью этого API, см. раздел «Управляемые конфигурации через Play» .
- получить разрешения
- Получает разрешения приложения Android, необходимые этому приложению.
- список
- Находит одобренные продукты, соответствующие запросу, или все одобренные продукты, если запроса нет.
- не одобрять
- Отменяет утверждение указанного продукта (и соответствующих разрешений приложения, если таковые имеются).