Method: appsigning.enrollApp

با استفاده از یک کلید KMS گوگل کلودِ خود-میزبان، یک برنامه را در امضای برنامه‌ی پلی ثبت می‌کند.

هشدار: از این روش برای ثبت نام استاندارد امضای برنامه Play استفاده نکنید.

  • ثبت نام استاندارد با کلیدهای تولید شده توسط گوگل یا مدیریت شده توسط گوگل را نمی‌توان از طریق 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 از سینتکس Transcoding در 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.

enrollment در فیلد Union. نوع ثبت نام خود میزبان. نیاز به یک کلید فعال Google Cloud KMS با مجوزهای IAM مناسب اعطا شده به Google Play دارد. enrollment فقط می‌تواند یکی از موارد زیر باشد:
enrollNewApp

object ( EnrollNewApp )

کلید امضای یک برنامه جدید را به یک کلید KMS ابری خارجی تغییر می‌دهد. برنامه نباید در مسیرهای آزمایشی باز یا تولید منتشر شده باشد.

enrollExistingApp

object ( EnrollExistingApp )

یک برنامه موجود را با استفاده از یک کلید KMS ابری خارجی، در امضای Play ثبت می‌کند.

بدنه پاسخ

پاسخ به ثبت یک برنامه در امضای Play.

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "signingCertificate": {
    object (CertificateHashes)
  },
  "uploadCertificate": {
    object (CertificateHashes)
  }
}
فیلدها
signingCertificate

object ( CertificateHashes )

هش‌های گواهی امضا برای برنامه. همیشه تنظیم شده.

uploadCertificate

object ( CertificateHashes )

هش‌های گواهی آپلود برای برنامه. اگر pemUploadCertificate در درخواست تنظیم شده باشد، آن را تنظیم کنید.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

ثبت نامNewApp

یک برنامه جدید را در امضای Play ثبت کنید.

نمایش JSON 
{
  "cloudKmsKeyAndCert": {
    object (CloudKmsKeyAndCert)
  }
}
فیلدها
cloudKmsKeyAndCert

object ( CloudKmsKeyAndCert )

الزامی. کلید میزبانی‌شده توسط خود کاربر.

پس از ثبت نام، از این کلید برای امضای برنامه شما استفاده خواهد شد.

ثبت نامبرنامه موجود

یک برنامه موجود را در امضای Play ثبت کنید.

نمایش JSON 
{
  "cloudKmsKey": {
    object (CloudKmsKey)
  }
}
فیلدها
cloudKmsKey

object ( CloudKmsKey )

الزامی. کلید میزبانی‌شده توسط خود کاربر.

پس از ثبت نام، از این کلید برای امضای برنامه شما استفاده خواهد شد.