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

نظرة عامة

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

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

المزايا

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

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

  • تتيح لك واجهة Publishing API تحميل التطبيقات ونشرها وتنفيذ مهام أخرى متعلّقة بالنشر.
  • تتيح لك واجهة Subscriptions and In-App Purchases API إدارة عمليات الشراء والاشتراكات داخل التطبيق. (كانت تُعرف هذه الواجهة سابقًا باسم "واجهة برمجة التطبيقات لحالة الشراء").
  • تتيح لك Reporting API استرداد معلومات حول جودة تطبيقك من "مؤشرات Android الحيوية".
  • تتيح لك واجهة Reply to Reviews API استرداد مراجعات تطبيقك والردّ عليها.
  • تتيح لك Permissions API إدارة الأذونات آليًا في Play Console.
  • تتيح لك واجهة برمجة التطبيقات لإدارة خدمات ألعاب Google Play إصدار طلبات REST للتحكّم آليًا في البيانات الوصفية التي تستند إليها ميزات "خدمات ألعاب Google Play".
  • توفّر واجهة برمجة التطبيقات Voided Purchases API قائمة بالطلبات المرتبطة بعمليات الشراء التي ألغاها المستخدم.

الخطوات الأولى

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

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

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

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

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

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

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

واجهة Subscriptions and In-App Purchases API

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

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

يمكنك استخدام واجهة برمجة التطبيقات هذه بعدة طرق، مثل:

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

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

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

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

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

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

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

واجهة Reply to Reviews API

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

تتيح لك واجهة Reply to Reviews API الوصول إلى الملاحظات المتعلّقة بالإصدارات النهائية من تطبيقك فقط. وإذا أردت الاطّلاع على الملاحظات المتعلّقة بإصدارات ألفا أو الإصدارات التجريبية من تطبيقك، يمكنك استخدام Google Play Console بدلاً من ذلك. يُرجى العِلم أيضًا أنّ واجهة برمجة التطبيقات تعرض فقط المراجعات التي تتضمّن تعليقات. إذا قيّم أحد المستخدمين تطبيقك ولكنّه لم يقدّم تعليقًا، لن تظهر ملاحظاته من خلال واجهة برمجة التطبيقات.

واجهة Permissions API

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

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

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

واجهة Voided Purchases API

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

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

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

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

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