Method: appsigning.enrollApp

Registra un'app nella firma dell'app di Google Play utilizzando una chiave Google Cloud KMS auto-ospitata.

Avviso: non utilizzare questo metodo per la registrazione standard alla firma dell'app di Google Play.

  • La registrazione standard con chiavi generate o gestite da Google non può essere eseguita tramite API.
  • Questa API avanzata è destinata esclusivamente alle organizzazioni aziendali con requisiti di conformità, normativi o di policy obbligatori per mantenere la custodia delle chiavi in un'istanza Google Cloud KMS esterna.
  • Prerequisiti: prima di chiamare questo metodo, è necessario disporre di una chiave Google Cloud KMS attiva e configurata correttamente con le autorizzazioni IAM appropriate concesse a Google Play.

Consulta il Centro assistenza: https://support.google.com/googleplay/android-developer/answer/9842756

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Nome del pacchetto o ID app dell'app che si registra alla firma di Google Play.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione 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.
}
Campi
pemUploadCertificate

string (bytes format)

Il certificato associato alla chiave di caricamento, in formato PEM.

Una stringa con codifica in base64.
Campo unione enrollment. Il tipo di registrazione auto-ospitata. Richiede una chiave Google Cloud KMS attiva con le autorizzazioni IAM appropriate concesse a Google Play. enrollment può essere solo uno dei seguenti tipi:
enrollNewApp

object (EnrollNewApp)

Modifica la chiave di firma di una nuova app in una chiave Cloud KMS esterna. L'app non deve essere stata pubblicata nei canali di test aperto o di produzione.
enrollExistingApp

object (EnrollExistingApp)

Registra un'app esistente nella firma di Google Play utilizzando una chiave Cloud KMS esterna.

Corpo della risposta

Risposta alla registrazione di un'app nella firma di Google Play.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "signingCertificate": {
    object (CertificateHashes)
  },
  "uploadCertificate": {
    object (CertificateHashes)
  }
}
Campi
signingCertificate

object (CertificateHashes)

Gli hash del certificato di firma per l'app. Impostato sempre.
uploadCertificate

object (CertificateHashes)

Gli hash del certificato di caricamento per l'app. Impostato solo se pemUploadCertificate è stato impostato nella richiesta.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

EnrollNewApp

Registra una nuova app nella firma di Google Play.

Rappresentazione JSON 
{
  "cloudKmsKeyAndCert": {
    object (CloudKmsKeyAndCert)
  }
}
Campi
cloudKmsKeyAndCert

object (CloudKmsKeyAndCert)

Obbligatorio. Chiave auto-ospitata.

Una volta registrata, questa chiave verrà utilizzata per firmare l'app.

EnrollExistingApp

Registra un'app esistente nella firma di Google Play.

Rappresentazione JSON 
{
  "cloudKmsKey": {
    object (CloudKmsKey)
  }
}
Campi
cloudKmsKey

object (CloudKmsKey)

Obbligatorio. Chiave auto-ospitata.

Una volta registrata, questa chiave verrà utilizzata per firmare l'app.