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 字符串值 - 将针对字符串、选择和隐藏类型显示。
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 不可修改的唯一跟踪标识符。此标识符是显示曲目信息的 Play 管理中心页面网址中的 releaseTrackId。
appVersion[] list 此产品目前可用的应用版本。
appVersion[].isProduction boolean 如果此版本是正式版 APK，则为“true”。
appVersion[].targetSdkVersion integer 此应用面向的 SDK 版本，在 APK 清单中指定。请参阅 http://developer.android.com/guide/topics/manifest/uses-sdk-element.html
appVersion[].track string 已弃用，请改用 trackId。

可接受的值包括： <ph type="x-smartling-placeholder">
    </ph>
  • “alpha”
  • “beta”
  • “production”
appVersion[].trackId[] list 发布应用版本的轨道 ID。替换 track 字段（已废弃），但不包含正式版轨道（请改为参阅 isProduction）。
appVersion[].versionCode integer 应用版本的唯一递增标识符。
appVersion[].versionString string 应用开发者在 Play 商店中用于标识版本的字符串。该字符串不一定是唯一的，也不必本地化（例如，字符串可以是“1.4”）。
authorName string 产品作者（例如应用开发者）的姓名。
availableCountries[] list 此应用适用的国家/地区。
availableTracks[] list 已弃用，请改用 appTracks。
category string 应用类别（例如 RACING、社交等）
contentRating string 此应用的内容分级。

可接受的值包括： <ph type="x-smartling-placeholder">
    </ph>
  • “all”
  • “mature”
  • “preTeen”
  • “teen”
description string 本地化的宣传说明（如果有）。
detailsUrl string 指向商品的（消费者）Google Play 详情页面的链接。
distributionChannel string 软件包的提供方式和适用对象。值 publicGoogleHosted 表示软件包可通过 Play 商店获取，且不限于特定企业。值 privateGoogleHosted 表示该软件包是 Google 托管的专用应用（仅限企业使用）。值 privateSelfHosted 表示软件包是专用应用（仅限企业使用）并由私人托管。

可接受的值包括： <ph type="x-smartling-placeholder">
    </ph>
  • “privateGoogleHosted”
  • “privateSelfHosted”
  • “publicGoogleHosted”
features[] list 此产品值得注意的功能（如有）。
fullDescription string 已本地化的完整应用商店说明（如果有）。
iarcGenericRating string 此应用的内容分级。

可接受的值包括： <ph type="x-smartling-placeholder">
    </ph>
  • “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 证书的 base64 网址安全编码 SHA1 哈希值。（此字段已弃用，取而代之的是 SHA2-256。请勿使用，并且可能随时将其移除。）
signingCertificate.certificateHashSha256 string 证书的 base64 网址安全编码 SHA2-256 哈希。
smallIconUrl string 指向小图片的链接，可用作商品图标。此图片的适用尺寸最大为 128 x 128 像素。
title string 商品名称。
workDetailsUrl string 指向该产品的 Google Play 企业版详情页面的链接，供企业管理员使用。

方法

批准

批准指定商品和相关的应用权限（如果有）。 每个企业客户可以批准的产品数量上限 是 1,000。

了解如何使用 Google Play 企业版设计和创建商店 向用户展示获批的商品 请参阅商店布局设计。

generateApprovalUrl
生成一个网址，该网址可在 iframe 中呈现以显示 权限（如果有）。企业管理员必须查看这些内容 并代表所属组织接受这些许可， 批准该产品。

管理员应在 与 EMM 控制台中的单独界面元素互动 应触发将此网址用作 approvalUrlInfo.approvalUrl媒体资源 Products.approve 调用来批准商品。 此网址最多只能用于显示权限 1 天。
get
检索要显示给企业管理员的产品详细信息。
getAppRestrictionsSchema
检索定义此对象的可配置属性的架构 产品。所有商品都有对应的架构，但如果没有对应的架构，则此架构可能为空。 都已定义受管配置此架构可用于 填充一个供管理员配置产品的界面。 根据使用此生成的架构应用托管配置 API 的详细信息，请参阅 通过 Play 管理配置。
getPermissions
检索此应用所需的 Android 应用权限。
list
查找与查询匹配的获批商品，或所有获批商品 如果没有查询，则会发生此错误。
取消批准
取消批准指定商品（以及相关的应用权限，如果有）