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, необходимые этому приложению.
список
Находит одобренные продукты, соответствующие запросу, или все одобренные продукты, если запроса нет.
не одобрять
Отменяет утверждение указанного продукта (и соответствующих разрешений приложения, если таковые имеются).