Method: appsigning.enrollApp

ลงทะเบียนแอปใน Play App Signing โดยใช้คีย์ Google Cloud KMS ที่โฮสต์ด้วยตนเอง

คำเตือน: อย่าใช้วิธีนี้สำหรับการลงทะเบียน Play App Signing มาตรฐาน

  • การลงทะเบียนมาตรฐานด้วยคีย์ที่ Google สร้างหรือจัดการไม่สามารถทำได้ผ่าน API
  • API ขั้นสูงนี้มีไว้สำหรับองค์กรระดับองค์กรที่มีข้อกำหนดด้านการปฏิบัติตามข้อกำหนด กฎระเบียบ หรือข้อกำหนดด้านนโยบายที่ต้องเก็บรักษาการดูแลคีย์ไว้ในอินสแตนซ์ Google Cloud KMS ภายนอกเท่านั้น
  • ข้อกำหนดเบื้องต้น: ต้องมีคีย์ Google Cloud KMS ที่ใช้งานอยู่และกำหนดค่าอย่างถูกต้องพร้อมสิทธิ์ IAM ที่เหมาะสมซึ่งมอบให้กับ Google Play ก่อนเรียกใช้วิธีนี้

ดูศูนย์ช่วยเหลือได้ที่ https://support.google.com/googleplay/android-developer/answer/9842756

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
name

string

ต้องระบุ ชื่อแพ็กเกจหรือรหัสแอปของแอปที่ลงทะเบียนใน Play Signing

เนื้อหาคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง 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

ฟิลด์ Union enrollment ประเภทการลงทะเบียนที่โฮสต์ด้วยตนเอง ต้องมีคีย์ Google Cloud KMS ที่ใช้งานอยู่พร้อมสิทธิ์ IAM ที่เหมาะสมซึ่งมอบให้กับ Google Play enrollment จะมีค่าเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
enrollNewApp

object (EnrollNewApp)

เปลี่ยนคีย์การลงนามของแอปใหม่เป็นคีย์ Cloud KMS ภายนอก แอปต้องยังไม่ได้รับการเผยแพร่ไปยังแทร็กการทดสอบแบบเปิดหรือเวอร์ชันที่ใช้งานจริง

enrollExistingApp

object (EnrollExistingApp)

ลงทะเบียนแอปที่มีอยู่ใน Play Signing โดยใช้คีย์ Cloud KMS ภายนอก

เนื้อหาการตอบกลับ

การตอบกลับเพื่อลงทะเบียนแอปใน Play Signing

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "signingCertificate": {
    object (CertificateHashes)
  },
  "uploadCertificate": {
    object (CertificateHashes)
  }
}
ช่อง
signingCertificate

object (CertificateHashes)

แฮชของใบรับรองการลงนามสำหรับแอป ตั้งค่าเสมอ

uploadCertificate

object (CertificateHashes)

แฮชของใบรับรองการอัปโหลดสำหรับแอป ตั้งค่าก็ต่อเมื่อมีการตั้งค่า pemUploadCertificate ในคำขอ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

EnrollNewApp

ลงทะเบียนแอปใหม่ใน Play Signing

การแสดง JSON
{
  "cloudKmsKeyAndCert": {
    object (CloudKmsKeyAndCert)
  }
}
ช่อง
cloudKmsKeyAndCert

object (CloudKmsKeyAndCert)

ต้องระบุ คีย์ที่โฮสต์ด้วยตนเอง

เมื่อลงทะเบียนแล้ว ระบบจะใช้คีย์นี้เพื่อลงนามแอปของคุณ

EnrollExistingApp

ลงทะเบียนแอปที่มีอยู่ใน Play Signing

การแสดง JSON
{
  "cloudKmsKey": {
    object (CloudKmsKey)
  }
}
ช่อง
cloudKmsKey

object (CloudKmsKey)

ต้องระบุ คีย์ที่โฮสต์ด้วยตนเอง

เมื่อลงทะเบียนแล้ว ระบบจะใช้คีย์นี้เพื่อลงนามแอปของคุณ