如需了解此资源的方法列表,请参阅本页结尾部分。
资源表示形式
商品资源表示 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 |
布尔值 - 仅当类型为布尔值时,此值才会显示。 | |
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 限制,此为可能条目的机器可读值的列表。在配置中应使用这些值,对于 choice 限制,这些值应作为单个 string 值使用;对于 multiselect 限制,这些值应在 stringArray 中使用。 |
|
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 |
不可修改的唯一轨道标识符。此标识符是 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 。
可接受的值为:
|
|
appVersion[].trackId[] |
list |
跟踪发布应用版本的 ID。替换 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 |
证书的 base64 urlsafe 编码 SHA1 哈希值。(此字段已弃用,取而代之的是 SHA2-256。请勿使用,并可能随时将其移除。 |
|
signingCertificate.certificateHashSha256 |
string |
证书的 base64 urlsafe 编码 SHA2-256 哈希。 | |
smallIconUrl |
string |
指向较小图片的链接,可用作商品的图标。此图片适合使用不超过 128px x 128px 的尺寸。 | |
title |
string |
商品的名称。 | |
workDetailsUrl |
string |
指向产品的 Google Play 企业版详情页面的链接,供企业管理员使用。 |
方法
- 批准
批准指定的产品和相关的应用权限(如果有)。 每个企业客户最多可以批准 1,000 个产品。
如需了解如何使用 Google Play 企业版设计和创建商店布局,以向用户展示已获批准的商品,请参阅商店布局设计。
注意:此项目已弃用。新的集成无法使用此方法,但可以参考我们的 新建议。- generateApprovalUrl
- 生成一个可以在 iframe 中呈现的网址,以显示商品的权限(如果有)。企业管理员必须查看这些权限并代表其组织接受这些权限,才能批准该产品。
管理员应通过与 EMM 控制台中的单独界面元素互动来接受显示的权限,而该元素反过来又会触发在Products.approve
调用中将此网址用作approvalUrlInfo.approvalUrl
属性,以批准产品。此网址只能用于显示 1 天内的权限。 注意:此项目已弃用。新的集成无法使用此方法,但可以参考我们的 新建议。 - get
- 检索商品详细信息以向企业管理员显示。
- getAppRestrictionsSchema
- 检索用于定义此产品的可配置属性的架构。所有产品都有架构,但如果未定义托管配置,此架构可能为空。此架构可用于填充允许管理员配置产品的界面。如需根据使用此 API 获取的架构来应用托管配置,请参阅通过 Play 获取托管配置。
- getPermissions
- 检索此应用所需的 Android 应用权限。
- list
- 查找与查询匹配的已批准商品,如果没有查询,则查找所有已获批准的商品。注意:此项目已弃用。新的集成无法使用此方法,但可以参考我们的 新建议。
- 取消批准
- 取消批准指定的商品(以及相关的应用权限(如果有) 注意:此项目已弃用。新的集成无法使用此方法,但可以参考我们的 新建议。