واجهات برمجة التطبيقات Google Play Developer API

نظرة عامة

تقدّم أداة Google Play Console مجموعة من واجهات برمجة التطبيقات لخدمات الويب المستندة إلى REST والتي تتيح لك تنفيذ وظائف النشر وإعداد التقارير وغير ذلك من وظائف إدارة التطبيقات مباشرةً لتطبيقك.

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

المزايا

تتيح لك واجهات برمجة التطبيقات Google Play Developer API التركيز على تصميم تطبيقك وتطويره، مع قضاء وقت وجهد أقل في إدارة إصداراتك على الرغم من نمو تطبيقك في أسواق جديدة.

تتضمّن أداة Google Play Console مجموعة من واجهات برمجة التطبيقات التي يمكنك استخدامها لإدارة تطبيقك، وهي:

البدء

لبدء استخدام واجهات برمجة التطبيقات Google Play Developer API، يمكنك الاطّلاع على وثائق البدء.

واجهة برمجة التطبيقات للنشر

تتيح لك Publishing API تشغيل المهام المتكررة بشكل مبرمَج والتي تتعلّق بتوزيع التطبيقات. ويوفّر ذلك وظائف مشابهة لتلك المتاحة للمطوّر من خلال Play Console، مثل:

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

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

أفضل الممارسات

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

واجهة برمجة تطبيقات الاشتراكات وعمليات الشراء داخل التطبيق

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

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

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

أفضل الممارسات

  • عليك تخزين معلومات الاشتراك على خادمك لتجنب إجراء اتصالات غير ضرورية من واجهة برمجة التطبيقات. عندما يحتاج تطبيقك إلى إثبات ملكية اشتراك، عليك الاعتماد على المعلومات المخزَّنة مؤقتًا على خادمك بدلاً من تكرار طلب بيانات من واجهة برمجة التطبيقات إلى Google.
  • هناك حالتان يجب أن يستخدم الخادم الآمن فيهما واجهة برمجة التطبيقات Google Play Developer API للحصول على معلومات الاشتراك:
    • يتلقى خادمك رمزًا مميزًا جديدًا للشراء لم يطّلع عليه من قبل.
    • يتلقى خادمك إشعارًا في الوقت الفعلي من المطوّرين (RTDN)، ويشير إلى أنه يجب استخدام الرمز المميّز للشراء للحصول على معلومات الاشتراك الجديدة.
  • لا يتم استطلاع رأي واجهة برمجة التطبيقات لمعرفة حالة الاشتراك بشكل منتظم. على سبيل المثال، لا تطلب واجهة برمجة التطبيقات يوميًا للتحقّق من كل اشتراك
  • بما أنّك تتلقّى رقم RTDN عند انتهاء صلاحية الاشتراك أو تجديده، لن تحتاج إلى جدولة طلب بيانات من واجهة برمجة التطبيقات استنادًا إلى وقت انتهاء الصلاحية المُجدوَل.

واجهة برمجة التطبيقات لإعداد التقارير

واجهة برمجة التطبيقات لإعداد التقارير مخصّصة للمطوّرين الذين يريدون إنشاء عمليات سير عمل مبرمَجة على بيانات Play Console، أو المطوّرين الذين يستخدمون بيانات Play Console لإعداد تقارير وتحليلات داخلية للأنشطة التجارية، وربما إلى جانب مجموعات البيانات الأخرى. يمنحك ذلك وصولاً آليًا إلى البيانات والمقاييس على مستوى التطبيق لإعداد التقارير الداخلية والتحليل والتشغيل الآلي.

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

أفضل الممارسات

  • في هذا الإصدار من Reporting API، أصبح الحدّ الأقصى التلقائي هو 10 طلبات بحث في الثانية. يمكنك الاطّلاع على استخدام حصتك في قسم الحصص في Google Cloud Console. إذا كنت بحاجة إلى تجاوز هذا الحدّ، يمكنك إرسال طلب حصة باستخدام هذا النموذج.

الردّ على واجهة برمجة التطبيقات الخاصة بالمراجعات

تسمح لك Response to Review API بعرض ملاحظات وآراء المستخدمين حول تطبيقك والردّ على هذه الملاحظات. يمكنك استخدام واجهة برمجة التطبيقات هذه للتفاعل مع المستخدمين مباشرةً ضمن مجموعة أدوات دعم العملاء الحالية، مثل نظام إدارة علاقات العملاء (CRM).

تسمح لك واجهة برمجة تطبيقات "الرد على المراجعات" بالوصول إلى التعليقات فقط لإصدارات الإنتاج من تطبيقك. إذا أردت الاطّلاع على ملاحظات وآراء حول الإصدارات الأولية أو التجريبية من تطبيقك، يمكنك استخدام Google Play Console بدلاً من ذلك. تجدر الإشارة أيضًا إلى أنّ واجهة برمجة التطبيقات تعرض فقط المراجعات التي تتضمّن تعليقات. إذا قيّم أحد المستخدمين تطبيقك ولكنه لم يقدم تعليقًا، فلن تتمكن من الوصول إلى ملاحظاته من واجهة برمجة التطبيقات.

واجهة برمجة تطبيقات الأذونات

تتيح Permissions API للمطوّرين إدارة الأذونات آليًا في Play Console. يتيح لك ذلك إمكانية التحكم المرن في المستخدمين الذين لديهم إمكانية الدخول إلى حساب المطوّر بدون أي تدخّل يدوي.

باستخدام Permissions API، يمكنك تنفيذ وظائف إدارية، مثل:

  • إزالة إمكانية وصول المستخدمين عند مغادرة شركتك
  • منح إمكانية الوصول إلى تطبيق عند انضمام مستخدم إلى الفريق ذي الصلة.

واجهة برمجة التطبيقات لعمليات الشراء الملغاة

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

تنطبق واجهة برمجة التطبيقات هذه على الطلبات داخل التطبيق واشتراكات التطبيقات لمرة واحدة.

ويمكن إبطال عملية الشراء بالطرق التالية:

  • يطلب المستخدم استرداد الأموال المدفوعة مقابل طلبه.
  • إلغاء المستخدم لطلبه.
  • يتم ردّ رسوم الطلب.
  • إلغاء المطوّر للطلب أو ردّ أمواله ملاحظة: ستظهر الطلبات التي تم إبطالها فقط في واجهة برمجة تطبيقات عمليات الشراء التي تمت إلغاؤها. إذا ردّ مطوّر البرامج ردّ الأموال بدون ضبط خيار الإبطال، لن تظهر الطلبات في واجهة برمجة التطبيقات.
  • تلغي Google الطلب أو تردّ الأموال المدفوعة.

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