Method: appstoreappsreview.updateappstorehostedapp

更新应用商店中托管的应用的详细信息。使用此方法可提供新应用的详细信息,或更新现有应用的详细信息。更新将在创建后立即送审。

HTTP 请求

POST https://androidpublisher.googleapis.com/androidpublisher/v3/appstore/{appStorePackageName}/apps:update

网址采用 gRPC 转码语法。

路径参数

参数
appStorePackageName

string

必需。第三方应用商店的软件包名称。

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "packageName": string,
  "appDetails": {
    object (AppStoreAppDetails)
  },
  "activeLocalizedStoreListings": [
    {
      object (AppStoreAppStoreListing)
    }
  ],
  "activeApks": {
    object (AppStoreAppActiveApks)
  },
  "policyDeclarations": [
    {
      object (AppStoreAppPolicyDeclaration)
    }
  ]
}
字段
packageName

string

必需。应用的软件包名称。

appDetails

object (AppStoreAppDetails)

必需。应用的常规开发者详细信息。

activeLocalizedStoreListings[]

object (AppStoreAppStoreListing)

必需。更新的本地化商品详情详细信息。

activeApks

object (AppStoreAppActiveApks)

必需。应用的有效分发 APK。

policyDeclarations[]

object (AppStoreAppPolicyDeclaration)

必需。为应用提供的政策声明。

响应正文

如果成功,则响应正文为空。

授权范围

需要以下 OAuth 范围:

  • https://www.googleapis.com/auth/androidpublisher

AppStoreAppDetails

应用的相关详细信息。

JSON 表示法
{
  "developerName": string,
  "contactEmail": string,
  "developerWebsite": string
}
字段
developerName

string

必需。应用开发者的名称。

contactEmail

string

必需。应用开发者的联系电子邮件地址。

developerWebsite

string

可选。开发者或应用的网站链接。

AppStoreAppStoreListing

已本地化的商品详情。这些是应用商店中显示的应用详细信息。

JSON 表示法
{
  "languageCode": string,
  "appName": string,
  "fullDescription": string,
  "shortDescription": string,
  "appIconId": string,
  "screenshotId": [
    string
  ],
  "videoLink": string
}
字段
languageCode

string

必需。相应商品详情的语言代码(例如“en-US”)。

appName

string

必需。应用的名称。

fullDescription

string

必需。有关应用的全面说明文字。

shortDescription

string

可选。有关应用的简短摘要。

appIconId

string

必需。通过 appstoreappsreview.uploadimage 为主要应用图标生成的图片 ID。

screenshotId[]

string

必需。屏幕截图库的多个图片 ID。

AppStoreAppActiveApks

有关应用商店托管的应用的有效 APK 的信息。

JSON 表示法
{
  "activeApkSets": [
    {
      object (AppStoreAppActiveApkSet)
    }
  ]
}
字段
activeApkSets[]

object (AppStoreAppActiveApkSet)

必需。用于指定哪些 APK set 一起分发的列表。此列表应包含您为相应应用分发的所有 APK。为每个可安装的 APK 集添加一个条目。

AppStoreAppActiveApkSet

一组可安装的有效 APK。此集中的所有 APK 都应属于同一应用版本。如果相关应用使用 APK 发布,则一组 APK 可能只包含 1 个 APK。如果应用使用 app bundle(或类似技术),则此集合应包含可能为相应应用安装的所有 APK(包括可选 APK)。一组 APK 应可一起安装。如果某些 APK 彼此互斥,无法一起安装,则应创建单独的 AppStoreAppActiveApkSet。

JSON 表示法
{
  "baseApkId": string,
  "splitApkId": [
    string
  ],
  "versionCode": string,
  "alreadyPublishedOnPlay": boolean
}
字段
baseApkId

string

必需。主基础应用模块的 ID。示例:base.apk 或 app.apk。

splitApkId[]

string

可选。可能与基本 APK 结合安装的拆分模块的 ID。如果未使用应用包(或类似技术),则可以为空。示例:config.en.apk。

versionCode

string (int64 format)

可选。相应 APK 集所代表的版本对应的版本代码。

alreadyPublishedOnPlay

boolean

可选。此有效 APK 集中引用的所有 APK 是否已在 Play 商店中发布(或是否源自已在 Play 商店中发布的应用包)。如果设置了此字段,则必须提供 versionCode。

AppStoreAppPolicyDeclaration

包含政策声明及其回答。

JSON 表示法
{
  "declarationId": string,
  "responses": [
    {
      object (PolicyResponse)
    }
  ]
}
字段
declarationId

string

必需。政策声明的 ID。

responses[]

object (PolicyResponse)

必需。针对此声明提供的回答。

PolicyResponse

针对应用政策问题的单个回答。

JSON 表示法
{
  "questionId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringResponse": {
    object (PolicyStringResponse)
  },
  "singleChoiceResponse": {
    object (PolicySingleChoiceResponse)
  },
  "multipleChoiceResponse": {
    object (PolicyMultipleChoiceResponse)
  },
  "groupResponse": {
    object (PolicyGroupResponse)
  },
  "keyedGroupResponse": {
    object (PolicyKeyedGroupResponse)
  },
  "booleanResponse": {
    object (PolicyBooleanResponse)
  },
  "documentResponse": {
    object (PolicyDocumentResponse)
  }
  // End of mutually exclusive fields.
}
字段
questionId

string

必需。正在回答的问题的 ID。

具体响应值。以下是互斥字段的列表。在响应中,最多只能设置一个字段:
stringResponse

object (PolicyStringResponse)

可选。字符串响应。

singleChoiceResponse

object (PolicySingleChoiceResponse)

可选。单选回答。

multipleChoiceResponse

object (PolicyMultipleChoiceResponse)

可选。选择题回答。

groupResponse

object (PolicyGroupResponse)

可选。群组回答。

keyedGroupResponse

object (PolicyKeyedGroupResponse)

可选。带键的群组响应。

booleanResponse

object (PolicyBooleanResponse)

可选。布尔值响应。

documentResponse

object (PolicyDocumentResponse)

可选。文档响应。

互斥字段的结束位置。

PolicyStringResponse

任何最适合编码为字符串的响应。包括网址和多行文本字段。

JSON 表示法
{
  "value": string
}
字段
value

string

必需。提供的字符串值。

PolicySingleChoiceResponse

从多个选项中选择一个选项的任何回答。

JSON 表示法
{
  "value": string
}
字段
value

string

必需。提供的值。

PolicyMultipleChoiceResponse

任何回复,其中可以从多种可能性中选择多个选项。

JSON 表示法
{
  "values": [
    string
  ]
}
字段
values[]

string

可选。提供的值。

PolicyGroupResponse

一组重复的回答。

JSON 表示法
{
  "groups": [
    {
      object (Group)
    }
  ]
}
字段
groups[]

object (Group)

可选。对问题的回答组。

群组

一组响应。

JSON 表示法
{
  "responses": [
    {
      object (NestedPolicyResponse)
    }
  ]
}
字段
responses[]

object (NestedPolicyResponse)

必需。组内的回答。

NestedPolicyResponse

针对应用政策问题的单个嵌套回答。嵌套回答类似于常规回答,但没有分组。

JSON 表示法
{
  "questionId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringResponse": {
    object (PolicyStringResponse)
  },
  "singleChoiceResponse": {
    object (PolicySingleChoiceResponse)
  },
  "multipleChoiceResponse": {
    object (PolicyMultipleChoiceResponse)
  },
  "booleanResponse": {
    object (PolicyBooleanResponse)
  },
  "documentResponse": {
    object (PolicyDocumentResponse)
  }
  // End of mutually exclusive fields.
}
字段
questionId

string

必需。正在回答的问题的 ID。

具体响应值。以下是互斥字段的列表。在响应中,最多只能设置一个字段:
stringResponse

object (PolicyStringResponse)

可选。字符串响应。

singleChoiceResponse

object (PolicySingleChoiceResponse)

可选。单选回答。

multipleChoiceResponse

object (PolicyMultipleChoiceResponse)

可选。选择题回答。

booleanResponse

object (PolicyBooleanResponse)

可选。布尔值响应。

documentResponse

object (PolicyDocumentResponse)

可选。文档响应。

互斥字段的结束位置。

PolicyBooleanResponse

始终为布尔值的响应。

JSON 表示法
{
  "value": boolean
}
字段
value

boolean

必需。提供的布尔值。

PolicyDocumentResponse

上传的文档。必须是单个逻辑文档(例如金融许可证)。

JSON 表示法
{
  "documentId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "expiryDate": {
    object (Date)
  },
  "nonExpiring": boolean
  // End of mutually exclusive fields.
}
字段
documentId

string

必需。已上传文档的 ID。

文档的过期信息。以下是互斥字段的列表。在响应中,最多只能设置一个字段:
expiryDate

object (Date)

可选。证件的失效日期。

nonExpiring

boolean

可选。如果确认文档没有到期日期,则返回 true。

互斥字段的结束位置。

PolicyKeyedGroupResponse

一组响应,每个响应都由允许集中的一个不同键标识。

JSON 表示法
{
  "groups": [
    {
      object (KeyedGroup)
    }
  ]
}
字段
groups[]

object (KeyedGroup)

可选。对问题的回答组。每个 KeyedGroup.key 在此列表中必须是唯一的。

KeyedGroup

一组响应,带有键。

JSON 表示法
{
  "key": string,
  "responses": [
    {
      object (NestedPolicyResponse)
    }
  ]
}
字段
key

string

必需。相应群组的键。

responses[]

object (NestedPolicyResponse)

必需。此群组中的回答。