Method: appsigning.enrollApp

Đăng ký một ứng dụng vào Tính năng ký ứng dụng của Play bằng khoá Google Cloud KMS tự lưu trữ.

Cảnh báo: Không sử dụng phương thức này để đăng ký Tính năng ký ứng dụng của Play theo cách thông thường.

  • Bạn không thể đăng ký tiêu chuẩn bằng các khoá do Google tạo hoặc Google quản lý thông qua API.
  • API nâng cao này chỉ dành cho các tổ chức doanh nghiệp có các yêu cầu bắt buộc về việc tuân thủ, quy định hoặc chính sách để duy trì quyền giám hộ khoá trong một phiên bản Google Cloud KMS bên ngoài.
  • Điều kiện tiên quyết: Yêu cầu phải có một khoá Google Cloud KMS đang hoạt động, được định cấu hình đúng cách và đã cấp quyền IAM phù hợp cho Google Play trước khi gọi phương thức này.

Xem Trung tâm trợ giúp: https://support.google.com/googleplay/android-developer/answer/9842756

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
name

string

Bắt buộc. Tên gói hoặc mã ứng dụng của ứng dụng đăng ký sử dụng dịch vụ Ký ứng dụng của Play.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng 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.
}
Trường
pemUploadCertificate

string (bytes format)

Chứng chỉ được liên kết với khoá tải lên, ở định dạng PEM.

Một chuỗi được mã hoá base64.

Trường nhóm enrollment. Loại hình đăng ký tự lưu trữ. Yêu cầu phải có một khoá Google Cloud KMS đang hoạt động và Google Play được cấp các quyền IAM thích hợp. enrollment chỉ có thể là một trong những trạng thái sau:
enrollNewApp

object (EnrollNewApp)

Thay đổi khoá ký của một ứng dụng mới thành khoá Cloud KMS bên ngoài. Ứng dụng không được phát hành lên kênh Thử nghiệm công khai hoặc kênh Phát hành công khai.

enrollExistingApp

object (EnrollExistingApp)

Đăng ký một ứng dụng hiện có vào quy trình ký của Play bằng khoá Cloud KMS bên ngoài.

Nội dung phản hồi

Phản hồi cho yêu cầu đăng ký một ứng dụng sử dụng tính năng ký của Play.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "signingCertificate": {
    object (CertificateHashes)
  },
  "uploadCertificate": {
    object (CertificateHashes)
  }
}
Trường
signingCertificate

object (CertificateHashes)

Hàm băm của chứng chỉ ký cho ứng dụng. Luôn đặt.

uploadCertificate

object (CertificateHashes)

Hàm băm chứng chỉ tải lên cho ứng dụng. Đặt iff pemUploadCertificate được đặt trong yêu cầu.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

EnrollNewApp

Đăng ký một ứng dụng mới sử dụng dịch vụ ký của Play.

Biểu diễn dưới dạng JSON
{
  "cloudKmsKeyAndCert": {
    object (CloudKmsKeyAndCert)
  }
}
Trường
cloudKmsKeyAndCert

object (CloudKmsKeyAndCert)

Bắt buộc. Khoá tự lưu trữ.

Sau khi bạn đăng ký, khoá này sẽ được dùng để ký ứng dụng của bạn.

EnrollExistingApp

Đăng ký một ứng dụng hiện có vào dịch vụ ký của Play.

Biểu diễn dưới dạng JSON
{
  "cloudKmsKey": {
    object (CloudKmsKey)
  }
}
Trường
cloudKmsKey

object (CloudKmsKey)

Bắt buộc. Khoá tự lưu trữ.

Sau khi bạn đăng ký, khoá này sẽ được dùng để ký ứng dụng của bạn.