التعديلات

تتيح لك طُرق التعديل في واجهة Google Play Developer Publishing API إعداد عدد من التغييرات على تطبيقك على Google Play، ثم نشرها كلها في وقت واحد. يمكنك إجراء ذلك من خلال إنشاء تعديل يتضمّن جميع التغييرات التي تريد إجراؤها على التطبيق، مثل:

• حِزم APK المرتبطة بالتطبيق و "قناة إصدار" لكل حزمة APK

  ويرتبط كل إصدار بـ "قناة إصدار" تحدّد المستخدمين الذين يمكنهم رؤيته. ويتيح لك ذلك توفير إصدارات ألفا وبيتا من التطبيق للمختبِرين. بالإضافة إلى ذلك، يمكنك توفير إصدار "طرح على مراحل" محدود من التطبيق، ويتم عرض هذا التطبيق تلقائيًا لعدد محدود من مستخدمي التطبيق (يحدده النسبة المئوية للطرح التي تحددها)، ما يتيح لك طرح إصدار جديد من التطبيق على مراحل.

• إصدارات بطاقة بيانات المتجر على Google Play الخاصة بالتطبيق والمناسبة للغة والمنطقة

  يمكن أن يحتوي كل إصدار خاص بلغة معيّنة من بطاقة بيانات المتجر على لقطات شاشة ورسومات ترويجية أخرى ونصوص وصفية مترجَمة وغير ذلك.

ملاحظة: لا تستخدم جميع الطرق التي توفّرها Google Play Developer API وظيفة "التعديلات" الجديدة المستندة إلى المعاملات. تسري على الفور طرق الموارد inappproducts وproducts وsubscriptions، سواء كان هناك تعديل مفتوح للتطبيق أم لا. وتوضّح صفحة مرجع واجهة برمجة التطبيقات لكل مورد على وجه التحديد ما إذا كانت طرق هذا المورد تستخدم نموذج "التعديلات".

عند إنشاء تعديل للمرة الأولى، يكون التعديل نسخة من حالة التطبيق الحالية المنشورة. ويمكنك بعد ذلك تعديل التعديل من خلال استدعاء طرق التعديلات. عندما يصبح التعديل جاهزًا، يمكنك تنفيذه، ما يؤدي إلى نشر التغييرات. يمكنك أيضًا التراجع عن التعديل في أي وقت، وتجاهل التغييرات وترك تطبيقك كما كان.

يمكنك استخدام واجهة برمجة التطبيقات هذه لإجراء تغييرات على تطبيق حالٍ (تم تحميل حِزمة APK واحدة على الأقل له)، وبالتالي عليك تحميل حِزمة APK واحدة على الأقل من خلال Play Console قبل أن تتمكّن من استخدام واجهة برمجة التطبيقات هذه. بالإضافة إلى ذلك، لا يمكنك استخدام واجهة برمجة التطبيقات هذه لتغيير حالة تطبيق من "منشور" إلى "غير منشور"، أو لملء نماذج الموافقة القانونية المطلوبة للنشر. لنشر التطبيق، عليك استخدام Play Console.

تنبيه: إذا أجرى أي شخص أي تغييرات على التطبيق من خلال Google Play Console أثناء تعديلك للتطبيق، سيتم تجاهل التعديل الذي أجريته وستسري التغييرات التي تم إجراؤها في Play Console.

سير العمل

يوضّح هذا القسم الطريقة النموذجية التي يمكنك من خلالها استخدام طُرق التعديل في Google Play Developer Publishing API لإجراء تعديلات على أحد التطبيقات.

1. أنشِئ تعديلاً جديدًا من خلال استدعاء Edits: Insert وتحديد التطبيق الذي تريد تعديله.

   يؤدي ذلك إلى إنشاء تعديل جديد للتطبيق المحدّد، ويتم نسخ جميع الإعدادات الأولية للتطبيق، مثل حِزم APK وبطاقات بيانات المتجر وملفات البيانات الموسّعة وما إلى ذلك، من الإصدار المنشور من التطبيق.

2. عدِّل التعديل كما تريد.

   يمكنك إجراء معظم التغييرات التي يمكن إجراؤها من خلال Google Play Console. يمكنك إجراء ذلك من خلال استدعاء الطريقة المناسبة في Google Play Developer API وتمرير معرّفات التطبيق والتعديل الذي تريد إجراءه. على وجه التحديد:

   • يمكنك تحميل حِزم APK جديدة من خلال استدعاء Edits.apks: upload. يؤدي ذلك إلى وضع حزمة APK في مساحة تخزين، ما يتيح إمكانية تعيينها لقناة إصدار في هذا التعديل أو تعديل لاحق.
   • يمكنك تعيين حِزم APK لقنوات الإصدار من خلال طلب Edits.tracks: update. يمكنك أيضًا تغيير مهام المسار لحِزم APK الحالية من خلال استدعاء Edits.tracks: patch.
   • يمكنك إنشاء بطاقة بيانات متجر جديدة مترجَمة من خلال استدعاء Edits.listings: update. يمكنك تعديل بطاقة بيانات متجر حالية من خلال استدعاء Edits.listings: patch.
   • يمكنك إضافة ملفات بيانات موسّعة أو تعديلها من خلال استدعاء طرق Edits.expansionfiles resource.

   تُجري هذه الطرق تغييرات على التعديل الذي تعمل عليه، ولكنها لا تعدّل الإصدار المباشر من التطبيق. ويمكنك إجراء المزيد من التغييرات أو تجاهل التعديل الذي تعمل عليه بدون التأثير في تجربة المستخدم.

   ملاحظة: يمكن لكل مستخدم فتح تعديل واحد فقط في كل مرة. في حال إنشاء تعديل جديد، سيتم إبطال أي تعديل حالي قد يكون مفتوحًا. بالإضافة إلى ذلك، إذا أجرى أي مستخدم تعديلاً أو تغييرات على تطبيق من خلال Play Console، سيتم إبطال جميع التعديلات الأخرى على التطبيق (التي أجراها أي مستخدم). إذا حاولت تنفيذ تعديل غير صالح، ستعرض العملية استثناءً ولن يكون لها أي تأثير.

3. احفظ التعديل.

   عند استدعاء Edits: commit، إذا لم تكن هناك أخطاء في التحقّق من الصحة، سيتم "تفعيل" جميع التغييرات المحدّدة في مورد التعديلات، ما يؤدي إلى استبدال الحالة الحالية للتطبيق. وقد يستغرق تنفيذ هذه التغييرات عدة ساعات، كما هو الحال عند إجراء تغييرات من خلال Play Console.