Method: appsigning.enrollApp

使用自行代管的 Google Cloud KMS 金鑰，為應用程式註冊 Play 應用程式簽署功能。

警告：請勿使用這個方法註冊標準的 Play 應用程式簽署功能。

  • 透過 API 無法使用 Google 產生或管理的金鑰進行標準註冊。
  • 這項進階 API 僅適用於必須遵守法規或政策規定，在外部 Google Cloud KMS 執行個體中保留金鑰控管權的企業機構。
  • 必要條件：呼叫這個方法前，必須先啟用並正確設定 Google Cloud KMS 金鑰，並授予 Google Play 適當的 IAM 權限。

請參閱說明中心：https://support.google.com/googleplay/android-developer/answer/9842756

HTTP 要求

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{name}/appSigning:enrollApp

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必填。註冊 Play 應用程式簽署服務的應用程式套件名稱或應用程式 ID。

要求主體

要求主體會包含結構如下的資料：

JSON 表示法 
{
  "pemUploadCertificate": string,

  // Union field enrollment can be only one of the following:
  "enrollNewApp": {
    object (EnrollNewApp)
  },
  "enrollExistingApp": {
    object (EnrollExistingApp)
  }
  // End of list of possible types for union field enrollment.
}
欄位
pemUploadCertificate

string (bytes format)

與上傳金鑰相關聯的憑證 (PEM 格式)。

Base64 編碼字串。
聯集欄位 enrollment。自行託管註冊的類型。您必須擁有有效的 Google Cloud KMS 金鑰，並授予 Google Play 適當的 IAM 權限。enrollment 只能是下列其中一項：
enrollNewApp

object (EnrollNewApp)

將新應用程式的簽署金鑰變更為外部 Cloud KMS 金鑰。應用程式不得發布至公開測試或正式版群組。
enrollExistingApp

object (EnrollExistingApp)

使用外部 Cloud KMS 金鑰，將現有應用程式註冊為使用 Play 簽署。

回應主體

回應，將應用程式註冊加入 Play 簽署計畫。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "signingCertificate": {
    object (CertificateHashes)
  },
  "uploadCertificate": {
    object (CertificateHashes)
  }
}
欄位
signingCertificate

object (CertificateHashes)

應用程式的簽署憑證雜湊。一律設定。
uploadCertificate

object (CertificateHashes)

應用程式的上傳憑證雜湊。如果要求中已設定 pemUploadCertificate，請設定 iff。

授權範圍

需要下列 OAuth 範圍：

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

EnrollNewApp

為新應用程式註冊 Play 簽署服務。

JSON 表示法 
{
  "cloudKmsKeyAndCert": {
    object (CloudKmsKeyAndCert)
  }
}
欄位
cloudKmsKeyAndCert

object (CloudKmsKeyAndCert)

必填。自行託管的金鑰。

註冊後，系統會使用這組金鑰簽署您的應用程式。

EnrollExistingApp

為現有應用程式註冊 Play 簽署服務。

JSON 表示法 
{
  "cloudKmsKey": {
    object (CloudKmsKey)
  }
}
欄位
cloudKmsKey

object (CloudKmsKey)

必填。自行託管的金鑰。

註冊後，系統會使用這組金鑰簽署您的應用程式。