Google Play Android Developer API

让 Android 应用开发者可以访问其 Google Play 账号。概括来讲,预期的工作流程如下:“插入”一个编辑版本,进行必要的更改,然后“提交”。

服务:androidpublisher.googleapis.com

如要调用此服务,我们建议您使用 Google 提供的客户端库。如果您的应用需要使用您自己的库来调用此服务,则在发出 API 请求时应使用以下信息。

发现文档

发现文档是用于说明和使用 REST API 的机器可读规范。它用于构建客户端库、IDE 插件以及与 Google API 交互的其他工具。一项服务可能会提供多个发现文档。此服务提供了以下发现文档:

服务端点

服务端点是指定 API 服务的网络地址的基本网址。一项服务可能有多个服务端点。此服务具有以下服务端点,下面的所有 URI 都与此服务端点相关:

  • https://androidpublisher.googleapis.com

REST 资源:v3.applications

方法
dataSafety POST /androidpublisher/v3/applications/{packageName}/dataSafety
写入应用的安全标签声明。

REST 资源:v3.applications.deviceTierConfigs

方法
create POST /androidpublisher/v3/applications/{packageName}/deviceTierConfigs
为应用创建新的设备层级配置。
get GET /androidpublisher/v3/applications/{packageName}/deviceTierConfigs/{deviceTierConfigId}
返回特定设备层级配置。
list GET /androidpublisher/v3/applications/{packageName}/deviceTierConfigs
返回创建的设备层级配置,按创建时间降序排列。

REST 资源:v3.apprecovery

方法
addTargeting POST /androidpublisher/v3/applications/{packageName}/appRecoveries/{appRecoveryId}:addTargeting
逐步更新恢复操作的定位条件信息。
cancel POST /androidpublisher/v3/applications/{packageName}/appRecoveries/{appRecoveryId}:cancel
取消已在执行的应用恢复操作。
create POST /androidpublisher/v3/applications/{packageName}/appRecoveries
创建恢复状态为 DRAFT 的应用恢复操作。
deploy POST /androidpublisher/v3/applications/{packageName}/appRecoveries/{appRecoveryId}:deploy
部署已创建的恢复状态为 DRAFT 的应用恢复操作。
list GET /androidpublisher/v3/applications/{packageName}/appRecoveries
列出与特定软件包名称和应用版本相关联的所有应用恢复操作资源。

REST 资源:v3.edits

方法
commit POST /androidpublisher/v3/applications/{packageName}/edits/{editId}:commit
提交应用编辑版本。
delete DELETE /androidpublisher/v3/applications/{packageName}/edits/{editId}
删除应用编辑版本。
get GET /androidpublisher/v3/applications/{packageName}/edits/{editId}
获取应用编辑版本。
insert POST /androidpublisher/v3/applications/{packageName}/edits
为应用创建新的编辑版本。
validate POST /androidpublisher/v3/applications/{packageName}/edits/{editId}:validate
验证应用编辑版本。

REST 资源:v3.edits.apks

方法
addexternallyhosted POST /androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/externallyHosted
创建新的 APK,但不将该 APK 本身上传到 Google Play,而是将该 APK 托管在指定的网址上。
list GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/apks
列出应用的所有当前 APK 和编辑版本。
upload POST /androidpublisher/v3/applications/{packageName}/edits/{editId}/apks
POST /upload/androidpublisher/v3/applications/{packageName}/edits/{editId}/apks
上传 APK 并将其添加到当前编辑版本。

REST 资源:v3.edits.bundles

方法
list GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/bundles
列出应用的所有当前 Android App Bundle 和编辑版本。
upload POST /androidpublisher/v3/applications/{packageName}/edits/{editId}/bundles
POST /upload/androidpublisher/v3/applications/{packageName}/edits/{editId}/bundles
向此编辑版本上传新的 Android App Bundle。

REST 资源:v3.edits.countryavailability

方法
get GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/countryAvailability/{track}
获取适用的国家/地区。

REST 资源:v3.edits.deobfuscationfiles

方法
upload POST /androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/{apkVersionCode}/deobfuscationFiles/{deobfuscationFileType}
POST /upload/androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/{apkVersionCode}/deobfuscationFiles/{deobfuscationFileType}
上传新的去混淆文件并将其附加到指定 APK 中。

REST 资源:v3.edits.details

方法
get GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/details
获取应用的详细信息。
patch PATCH /androidpublisher/v3/applications/{packageName}/edits/{editId}/details
修补应用的详细信息。
update PUT /androidpublisher/v3/applications/{packageName}/edits/{editId}/details
更新相应应用的详细信息。

REST 资源:v3.edits.expansionfiles

方法
get GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/{apkVersionCode}/expansionFiles/{expansionFileType}
提取指定 APK 的扩展文件配置。
patch PATCH /androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/{apkVersionCode}/expansionFiles/{expansionFileType}
修补相应 APK 的扩展文件配置以引用另一 APK 的扩展文件。
update PUT /androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/{apkVersionCode}/expansionFiles/{expansionFileType}
更新相应 APK 的扩展文件配置以引用另一 APK 的扩展文件。
upload POST /androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/{apkVersionCode}/expansionFiles/{expansionFileType}
POST /upload/androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/{apkVersionCode}/expansionFiles/{expansionFileType}
上传新的扩展文件并将其附加到指定 APK 中。

REST 资源:v3.edits.images

方法
delete DELETE /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}/{imageType}/{imageId}
从编辑版本中删除映像(通过 ID 指定)。
deleteall DELETE /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}/{imageType}
删除指定语言和图像类型的所有图像。
list GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}/{imageType}
列出所有图片。
upload POST /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}/{imageType}
POST /upload/androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}/{imageType}
上传指定语言和图像类型的图像,并将其添加到编辑会话中。

REST 资源:v3.edits.listings

方法
delete DELETE /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}
删除已本地化的商品详情。
deleteall DELETE /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings
删除所有商品详情。
get GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}
获取已本地化的商品详情。
list GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings
列出所有已本地化的商品详情。
patch PATCH /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}
修补已本地化的商品详情。
update PUT /androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}
创建或更新已本地化的商品详情。

REST 资源:v3.edits.testers

方法
get GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/testers/{track}
获取测试人员信息。
patch PATCH /androidpublisher/v3/applications/{packageName}/edits/{editId}/testers/{track}
修补测试人员信息。
update PUT /androidpublisher/v3/applications/{packageName}/edits/{editId}/testers/{track}
更新测试人员信息。

REST 资源:v3.edits.tracks

方法
create POST /androidpublisher/v3/applications/{packageName}/edits/{editId}/tracks
创建新轨道。
get GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/tracks/{track}
获取轨道。
list GET /androidpublisher/v3/applications/{packageName}/edits/{editId}/tracks
列出所有轨道。
patch PATCH /androidpublisher/v3/applications/{packageName}/edits/{editId}/tracks/{track}
修补轨道。
update PUT /androidpublisher/v3/applications/{packageName}/edits/{editId}/tracks/{track}
更新轨道。

REST 资源:v3.externaltransactions

方法
createexternaltransaction POST /androidpublisher/v3/{parent=applications/*}/externalTransactions
创建新的外部交易。
getexternaltransaction GET /androidpublisher/v3/{name=applications/*/externalTransactions/*}
获取现有外部交易。
refundexternaltransaction POST /androidpublisher/v3/{name=applications/*/externalTransactions/*}:refund
针对现有外部交易进行退款或部分退款。

REST 资源:v3.generatedapks

方法
download GET /androidpublisher/v3/applications/{packageName}/generatedApks/{versionCode}/downloads/{downloadId}:download
下载通过特定 app bundle 生成的单个签名 APK。
list GET /androidpublisher/v3/applications/{packageName}/generatedApks/{versionCode}
返回指定 app bundle 生成的所有 APK 的下载元数据。

REST 资源:v3.grants

方法
create POST /androidpublisher/v3/{parent=developers/*/users/*}/grants
向用户授予对指定软件包的访问权限。
delete DELETE /androidpublisher/v3/{name=developers/*/users/*/grants/*}
移除用户对指定软件包或开发者账号的全部访问权限。
patch PATCH /androidpublisher/v3/{grant.name=developers/*/users/*/grants/*}
更新用户对指定软件包的访问权限。

REST 资源:v3.inappproducts

方法
batchDelete POST /androidpublisher/v3/applications/{packageName}/inappproducts:batchDelete
删除应用内商品(受管理的商品或订阅)。
batchGet GET /androidpublisher/v3/applications/{packageName}/inappproducts:batchGet
读取多个应用内商品,这些商品可以是受管理的商品或订阅。
batchUpdate POST /androidpublisher/v3/applications/{packageName}/inappproducts:batchUpdate
更新或插入一款或多款应用内商品(受管理的商品或订阅)。
delete DELETE /androidpublisher/v3/applications/{packageName}/inappproducts/{sku}
删除应用内商品(受管理的商品或订阅)。
get GET /androidpublisher/v3/applications/{packageName}/inappproducts/{sku}
获取应用内商品,该应用内商品可以是受管理的商品或订阅。
insert POST /androidpublisher/v3/applications/{packageName}/inappproducts
创建应用内商品(受管理的商品或订阅)。
list GET /androidpublisher/v3/applications/{packageName}/inappproducts
列出全部应用内商品,包括受管理的商品和订阅。
patch PATCH /androidpublisher/v3/applications/{packageName}/inappproducts/{sku}
修补应用内商品(受管理的商品或订阅)。
update PUT /androidpublisher/v3/applications/{packageName}/inappproducts/{sku}
更新应用内商品(受管理的商品或订阅)。

REST 资源:v3.internalappsharingartifacts

方法
uploadapk POST /androidpublisher/v3/applications/internalappsharing/{packageName}/artifacts/apk
POST /upload/androidpublisher/v3/applications/internalappsharing/{packageName}/artifacts/apk
上传 APK 以进行内部应用分享。
uploadbundle POST /androidpublisher/v3/applications/internalappsharing/{packageName}/artifacts/bundle
POST /upload/androidpublisher/v3/applications/internalappsharing/{packageName}/artifacts/bundle
上传 app bundle 以进行内部应用分享。

REST 资源:v3.monetization

方法
convertRegionPrices POST /androidpublisher/v3/applications/{packageName}/pricing:convertRegionPrices
根据针对一组地区的请求中的价格,使用当天的汇率和国家/地区专用定价模式来计算地区价格。

REST 资源:v3.monetization.subscriptions

方法
archive
(deprecated)
POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}:archive
已弃用:订阅归档不受支持。
batchGet GET /androidpublisher/v3/applications/{packageName}/subscriptions:batchGet
读取一项或多项订阅。
batchUpdate POST /androidpublisher/v3/applications/{packageName}/subscriptions:batchUpdate
批量更新订阅。
create POST /androidpublisher/v3/applications/{packageName}/subscriptions
创建新订阅。
delete DELETE /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}
删除订阅。
get GET /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}
读取单个订阅。
list GET /androidpublisher/v3/applications/{packageName}/subscriptions
列出指定应用下的全部订阅。
patch PATCH /androidpublisher/v3/applications/{subscription.packageName}/subscriptions/{subscription.productId}
更新现有订阅。

REST 资源:v3.monetization.subscriptions.basePlans

方法
activate POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:activate
激活基础方案。
batchMigratePrices POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchMigratePrices
MigrateBasePlanPrices 端点的批量变体。
batchUpdateStates POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchUpdateStates
激活或停用一个或多个订阅的基础方案。
deactivate POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:deactivate
停用基础方案。
delete DELETE /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}
删除基础方案。
migratePrices POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:migratePrices
将订阅者从一个或多个旧价格同类群组迁移到当前价格。

REST 资源:v3.monetization.subscriptions.basePlans.offers

方法
activate POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers/{offerId}:activate
激活订阅优惠。
batchGet POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchGet
读取一项或多项订阅优惠。
batchUpdate POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdate
更新一批订阅优惠。
batchUpdateStates POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdateStates
更新一批订阅优惠状态。
create POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers
创建新的订阅优惠。
deactivate POST /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers/{offerId}:deactivate
停用订阅优惠。
delete DELETE /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers/{offerId}
删除订阅优惠。
get GET /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers/{offerId}
读取单项优惠
list GET /androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers
列出指定订阅下的全部优惠。
patch PATCH /androidpublisher/v3/applications/{subscriptionOffer.packageName}/subscriptions/{subscriptionOffer.productId}/basePlans/{subscriptionOffer.basePlanId}/offers/{subscriptionOffer.offerId}
更新现有订阅优惠。

REST 资源:v3.orders

方法
batchget GET /androidpublisher/v3/applications/{packageName}/orders:batchGet
获取一系列订单的订单详细信息。
get GET /androidpublisher/v3/applications/{packageName}/orders/{orderId}
获取单笔订单的订单详细信息。
refund POST /androidpublisher/v3/applications/{packageName}/orders/{orderId}:refund
针对用户订阅或应用内购买订单进行退款。

REST 资源:v3.purchases.products

方法
acknowledge POST /androidpublisher/v3/applications/{packageName}/purchases/products/{productId}/tokens/{token}:acknowledge
确认购买应用内商品。
consume POST /androidpublisher/v3/applications/{packageName}/purchases/products/{productId}/tokens/{token}:consume
消耗购买的应用内商品。
get GET /androidpublisher/v3/applications/{packageName}/purchases/products/{productId}/tokens/{token}
检查应用内商品的购买和消耗状态。

REST 资源:v3.purchases.subscriptions

方法
acknowledge POST /androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:acknowledge
确认购买订阅。
cancel POST /androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:cancel
取消用户购买的订阅。
defer POST /androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:defer
将用户购买的订阅推迟至指定的未来到期时间。
get
(deprecated)
GET /androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}
已废弃:请改用 purchases.subscriptionsv2.get。
refund
(deprecated)
POST /androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:refund
已废弃:请改用 orders.refund。
revoke
(deprecated)
POST /androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:revoke
已废弃:请改用 purchases.subscriptionsv2.revoke。

REST 资源:v3.purchases.subscriptionsv2

方法
get GET /androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}
获取关于订阅的元数据
revoke POST /androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:revoke
撤消用户购买的订阅。

REST 资源:v3.purchases.voidedpurchases

方法
list GET /androidpublisher/v3/applications/{packageName}/purchases/voidedpurchases
列出已取消、退款或退单的购买交易。

REST 资源:v3.reviews

方法
get GET /androidpublisher/v3/applications/{packageName}/reviews/{reviewId}
获取单条评价。
list GET /androidpublisher/v3/applications/{packageName}/reviews
列出所有评价。
reply POST /androidpublisher/v3/applications/{packageName}/reviews/{reviewId}:reply
回复单条评价,或更新现有回复。

REST 资源:v3.systemapks.variants

方法
create POST /androidpublisher/v3/applications/{packageName}/systemApks/{versionCode}/variants
基于已上传的 Android App Bundle 文件创建适合纳入系统映像的 APK。
download GET /androidpublisher/v3/applications/{packageName}/systemApks/{versionCode}/variants/{variantId}:download
下载之前创建的适合纳入系统映像的系统 APK。
get GET /androidpublisher/v3/applications/{packageName}/systemApks/{versionCode}/variants/{variantId}
返回之前创建的系统 APK 变体。
list GET /androidpublisher/v3/applications/{packageName}/systemApks/{versionCode}/variants
返回之前创建的系统 APK 变体的列表。

REST 资源:v3.users

方法
create POST /androidpublisher/v3/{parent=developers/*}/users
向用户授予对指定开发者账号的访问权限。
delete DELETE /androidpublisher/v3/{name=developers/*/users/*}
移除用户对指定开发者账号的全部访问权限。
list GET /androidpublisher/v3/{parent=developers/*}/users
列出所有对某个开发者账号拥有访问权限的用户。
patch PATCH /androidpublisher/v3/{user.name=developers/*/users/*}
更新用户对开发者账号的访问权限。