التعديلات

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

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

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

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

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

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

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

سير العمل

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

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

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

  2. عدِّل التعديل على النحو المطلوب.

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

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

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

  3. أكمِل التعديل.

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