Products

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

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

Ресурс 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	Тип предоставляемого значения. Приемлемые значения: " bool " " bundle " " bundleArray " " choice " " hidden " " integer " " multiselect " " 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	Тип ограничения. Приемлемые значения: " bool " " bundle " " bundleArray " " choice " " hidden " " integer " " multiselect " " 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 . Приемлемые значения: " alpha " " beta " " production "
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	Рейтинг контента для этого приложения. Приемлемые значения: " all " " mature " " preTeen " " teen "
description	string	Локализованное рекламное описание, если оно доступно.
detailsUrl	string	Ссылка на (потребительскую) страницу сведений о продукте в Google Play.
distributionChannel	string	Как и кому предоставляется пакет. Значение publicGoogleHosted означает, что пакет доступен в магазине Play и не ограничен конкретным предприятием. Значение privateGoogleHosted означает, что пакет является частным приложением (только корпоративным), но размещенным в Google. Значение privateSelfHosted означает, что пакет является частным приложением (только для предприятия) и размещается в частном порядке. Приемлемые значения: " privateGoogleHosted " " privateSelfHosted " " publicGoogleHosted "
features[]	list	Примечательные особенности (если таковые имеются) этого продукта.
fullDescription	string	Локализованное полное описание магазина приложений, если оно доступно.
iarcGenericRating	string	Рейтинг контента для этого приложения. Приемлемые значения: « eighteenYears » " iarcGenericRatingUnspecified " « sevenYears » « sixteenYears » « threeYears » « twelveYears »
iconUrl	string	Ссылка на изображение, которое можно использовать в качестве значка продукта. Это изображение подходит для использования с размером до 512 x 512 пикселей.
kind	string
lastUpdatedTimestampMillis	long	Примерное время (в течение 7 дней) последней публикации приложения, выраженное в миллисекундах с момента публикации.
minAndroidSdkVersion	integer	Минимальный Android SDK, необходимый для запуска приложения.
permissions[]	list	Список разрешений, необходимых приложению.
permissions[]. permissionId	string	Непрозрачная строка, однозначно идентифицирующая разрешение.
permissions[]. state	string	Было ли разрешение принято или нет. Приемлемые значения: " accepted " " required "
productId	string	Строка вида app:<package name> . Например, app:com.google.android.gm представляет приложение Gmail.
productPricing	string	Является ли этот продукт бесплатным, бесплатным с покупками в приложении или платным. Если цена неизвестна, это означает, что продукт больше не доступен (хотя он все еще может быть доступен владельцам). Приемлемые значения: " free " " freeWithInAppPurchase " " paid "
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, необходимые этому приложению.

список

Находит одобренные продукты, соответствующие запросу, или все одобренные продукты, если запроса нет. Примечание. Этот элемент устарел. Новые интеграции не могут использовать этот метод и могут ссылаться на наши новые рекомендации .

не одобрять

Отменяет утверждение указанного продукта (и соответствующих разрешений приложения, если таковые имеются). Примечание. Этот элемент устарел. Новые интеграции не могут использовать этот метод и могут ссылаться на наши новые рекомендации .