Method: appsigning.enrollApp

تسجيل تطبيق في ميزة "توقيع التطبيق" من Play باستخدام مفتاح مستضاف ذاتيًا في Google Cloud KMS

تحذير: لا تستخدِم هذه الطريقة للتسجيل العادي في ميزة "توقيع التطبيق" من Play.

  • لا يمكن إجراء التسجيل العادي باستخدام مفاتيح أنشأتها Google أو تديرها عبر واجهة برمجة التطبيقات.
  • تُستخدَم واجهة برمجة التطبيقات المتقدّمة هذه حصريًا لمؤسسات المؤسسات التي لديها متطلبات إلزامية للامتثال أو متطلبات تنظيمية أو متطلبات سياسات للاحتفاظ بحضانة المفتاح في مثيل خارجي من 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

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل 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 نوع التسجيل المستضاف ذاتيًا يتطلّب مفتاحًا نشطًا في Google Cloud KMS مع منح أذونات IAM المناسبة إلى Google Play يمكن أن يكون enrollment واحدًا مما يلي فقط:
enrollNewApp

object (EnrollNewApp)

تغيير مفتاح توقيع تطبيق جديد إلى مفتاح خارجي في Cloud KMS يجب ألا يكون التطبيق قد تم نشره في مسار الاختبار المفتوح أو قناة الإصدار العلني
enrollExistingApp

object (EnrollExistingApp)

تسجيل تطبيق حالي في ميزة "توقيع التطبيق" من Play باستخدام مفتاح خارجي في Cloud KMS

نص الاستجابة

الاستجابة لتسجيل تطبيق في ميزة "توقيع التطبيق" من Play

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "signingCertificate": {
    object (CertificateHashes)
  },
  "uploadCertificate": {
    object (CertificateHashes)
  }
}
الحقول
signingCertificate

object (CertificateHashes)

القيم المحسوبة لتشفير شهادة التوقيع الخاصة بالتطبيق، ويتم ضبطها دائمًا
uploadCertificate

object (CertificateHashes)

القيم المحسوبة لتشفير شهادة التحميل الخاصة بالتطبيق، ويتم ضبطها فقط إذا تم ضبط pemUploadCertificate في الطلب

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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

EnrollNewApp

تسجيل تطبيق جديد في ميزة "توقيع التطبيق" من Play

تمثيل JSON 
{
  "cloudKmsKeyAndCert": {
    object (CloudKmsKeyAndCert)
  }
}
الحقول
cloudKmsKeyAndCert

object (CloudKmsKeyAndCert)

الحقل مطلوب. مفتاح مستضاف ذاتيًا

بعد التسجيل، سيتم استخدام هذا المفتاح لتوقيع تطبيقك.

EnrollExistingApp

تسجيل تطبيق حالي في ميزة "توقيع التطبيق" من Play

تمثيل JSON 
{
  "cloudKmsKey": {
    object (CloudKmsKey)
  }
}
الحقول
cloudKmsKey

object (CloudKmsKey)

الحقل مطلوب. مفتاح مستضاف ذاتيًا

بعد التسجيل، سيتم استخدام هذا المفتاح لتوقيع تطبيقك.