التعديلات

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

• ملفات APK المرتبطة بالتطبيق، و""track" لكل ملف APK

  ويرتبط كل منها بـ "track;quot; وتحديد ما يراه المستخدمون. يتيح لك ذلك توفير إصدارات ألفا وتجريبية للتطبيق للمختبِرين. بالإضافة إلى ذلك، يمكنك توفير إصدار محدود من "الإصدار الخاص بنظام التشغيل&quot، من خلال تطبيق مُحدَّد الإصدار، فقط

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

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

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

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

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

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

سير العمل

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

1. يمكنك إنشاء تعديل جديد من خلال استدعاء التعديلات: إدراج وتحديد التطبيق الذي تريد تعديله.

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

2. يمكنك تغيير التعديل كما تريد.

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

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

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

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

3. تنفيذ التعديل.

   عند استدعاء تعديلات: إتمام، في حال عدم وجود أخطاء في التحقق من الصحة، يتم حينئذٍ تطبيق جميع التغييرات المحدّدة في الموارد المعدّلة، تعديل عرض الأسعار، عرض أسعار، استبدال الحالة الحالية للتطبيق. قد يستغرق تنفيذ هذه التغييرات عدة ساعات، تمامًا كما تجري تغييرات من خلال Play Console.