Method: appsigning.rotateAppSigningKey

کلید امضای برنامه را به یک کلید جدید Google Cloud KMS که توسط خود برنامه میزبانی می‌شود، منتقل می‌کند.

هشدار: این روش فقط برای برنامه‌هایی که با کلیدهای Cloud KMS خود-میزبانی شده ثبت شده‌اند، اعمال می‌شود. برای برنامه‌هایی که از امضای استاندارد برنامه Play تحت مدیریت گوگل استفاده می‌کنند، درخواست‌های چرخش کلید باید از طریق رابط کاربری کنسول گوگل پلی آغاز شوند.

به مرکز راهنمایی مراجعه کنید: https://support.google.com/googleplay/android-developer/answer/9842756

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
name

string

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

درخواست بدنه

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

نمایش JSON 
{
  "rotatedCloudKmsKey": {
    object (RotatedCloudKmsKey)
  },
  "keyRotationReason": enum (KeyRotationReason)
}
فیلدها
rotatedCloudKmsKey

object ( RotatedCloudKmsKey )

الزامی. کلید KMS ابریِ خود-میزبان.

keyRotationReason

enum ( KeyRotationReason )

الزامی. دلیل چرخاندن کلید برنامه.

بدنه پاسخ

پاسخ به چرخش کلید امضای یک برنامه.

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

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

object ( CertificateHashes )

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

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

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

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

دلیل چرخش کلید

دلایل چرخش کلید.

انوم‌ها
KEY_ROTATION_REASON_UNSPECIFIED دلیل چرخش کلید نامشخص است. قابل استفاده نیست.
COMPROMISED_KEY کلید به خطر افتاده است.
USE_STRONGER_KEY کلید قوی‌تری لازم است.
USE_SAME_KEY_FOR_MULTIPLE_APPS از یک کلید برای چندین برنامه استفاده می‌شود.
ROUTINE_KEY_UPGRADE ارتقاء کلید روتین.
OTHER دلیل دیگر.

RotatedCloudKmsKey

پیامی که نشان‌دهنده‌ی کلید Cloud KMS چرخانده شده است. شامل کلید Cloud KMS و اثبات چرخش مرتبط با آن است.

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

object ( CloudKmsKeyAndCert )

الزامی. کلید Cloud KMS و گواهی مرتبط با کلید.

signingCertificateLineage

string ( bytes format)

الزامی. اثبات چرخش. به ایجاد دودمان‌های گواهی امضا مراجعه کنید.

یک رشته کدگذاری شده با base64.