قبل بدء إجراء طلبات بيانات من واجهة برمجة التطبيقات، يجب إعداد الوصول إلى واجهة برمجة التطبيقات إلى حساب مطوِّر على Google Play ويتضمن ذلك تغييرات في Google Play Console وGoogle Cloud Console يُرجى اتّباع التعليمات التالية: الخطوات اللازمة لبدء استخدام Google Play Developer API.
- أنشِئ مشروعًا على Google Cloud.
- تفعيل Google Play Developer API لمشروعك على Google Cloud
- عليك إعداد حساب خدمة باستخدام أذونات Google Play Console المناسبة للوصول إلى Google Play Developer API.
إنشاء مشروع على Google Cloud
يمكنك تخطّي هذه الخطوة إذا كان لديك مشروع على Google Cloud حاليًا. تريد استخدامها.
أنشئ مشروعًا في Google Cloud Console:
لمزيد من المعلومات حول مشاريع Google Cloud، راجِع قسم إنشاء المشاريع وإدارتها.
تفعيل واجهة برمجة التطبيقات
بعد إعداد مشروع Google Cloud، عليك تفعيل واجهة برمجة التطبيقات Google Play Developer API لهذا المشروع.
لتفعيل واجهة Google Play Developer API:
- انتقِل إلى صفحة Google Play Developer API في Google Cloud Console.
- انقر على تفعيل.
إعداد حسابات الخدمة وبروتوكول OAuth
يجب ضبط إمكانية الوصول إلى واجهة Google Play Developer API باستخدام عميل OAuth أو حساب خدمة. في معظم الحالات، عليك استخدام حساب الخدمة للوصول إلى واجهة برمجة التطبيقات.
يجب استخدام حسابات الخدمة في بيئة آمنة، مثل الخادم. يجب إدارة بيانات اعتماد حساب الخدمة بأمان لكي لا تتم يتم الكشف عنها لأي شخص غير مصرح له باستخدام واجهة برمجة التطبيقات.
يجب استخدام معرّف عميل OAuth إذا كنت بحاجة إلى الوصول إلى واجهة برمجة التطبيقات نيابةً عن لمستخدم فردي. على سبيل المثال، إذا كان موقعك الإلكتروني بحاجة إلى الوصول إلى Google Play Developer API من برنامج الويب نيابةً عن المستخدم، ويمكنك استخدام معرِّف العميل (Client ID). ستتم مصادقة المستخدم باستخدام حسابه على Google بدلاً من ذلك. لحساب الخدمة. يتيح لك ذلك إجراء طلبات بيانات من واجهة برمجة التطبيقات نيابةً عن المستخدم. بدون المساس ببيانات اعتماد حساب الخدمة.
- حساب الخدمة: ستصل خدمة البرامج الآمنة إلى واجهة برمجة التطبيقات (الأكثر شيوعًا)
- عملاء OAuth: سيتمكن المستخدم من الوصول إلى واجهة برمجة التطبيقات
استخدام حساب خدمة
يمكنك إنشاء حساب خدمة من Google Play Console.
- في Google Cloud Console، انتقِل إلى حسابات الخدمة.
- انقر على إنشاء حساب خدمة واتّبِع الخطوات.
- انتقِل إلى صفحة المستخدمون الأذونات في Google Play Console.
- انقر على دعوة مستخدمين جُدد.
إدخال عنوان بريد إلكتروني لحساب الخدمة في عنوان البريد الإلكتروني وامنح الحقوق اللازمة لتنفيذ الإجراءات.
لاستخدام واجهات برمجة التطبيقات الخاصة بالفوترة في Google Play، يجب منح الأذونات التالية:
- عرض البيانات المالية والطلبات والردود على استطلاعات أسباب الإلغاء
- إدارة الطلبات والاشتراكات
انقر على دعوة مستخدم.
في هذه المرحلة، من المفترض أن يكون بإمكانك الوصول إلى Google Play Developer API من خلال حساب الخدمة الخاص بك. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام OAuth 2.0 من خادم إلى خادم. التطبيقات:
استخدام عملاء OAuth
يمكنك السماح للمستخدمين بتنفيذ إجراءات باستخدام واجهة برمجة التطبيقات ضمن بيانات اعتمادهم الخاصة. باستخدام برنامج OAuth. وتقتصر إجراءات المستخدم على الإجراءات المسموح بها عبر المستخدِمون والأذونات على Google Play Console.
قبل إنشاء عملاء OAuth، يجب ضبط معلومات العلامات التجارية للنطاق منتجك. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
- في Google Cloud Console، انتقِل إلى صفحة شاشة موافقة OAuth.
- اتّبِع الخطوات لإنشاء شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
لإنشاء عميل OAuth، عليك اتّباع الخطوات التالية:
- في Google Cloud Console، انتقِل إلى Credentials (بيانات الاعتماد).
- انقر على إنشاء بيانات اعتماد >. معرِّف عميل OAuth.
- اختَر نوع الطلب واتّبِع التعليمات.
معلومات إضافية
استخدم النصائح والحيل التالية لمساعدتك في البدء في استخدام واجهة برمجة التطبيقات في Google Play.
الحصول على معرّف المطوّر
تتطلّب بعض واجهات برمجة التطبيقات تقديم معرّف مطوّر برامج Google Play Console. هذا النمط هو رقم طويل تم تخصيصه عند استخدام حساب المطوّر على Google Play تم إنشاؤه. يمكن العثور على معرّف المطوّر في عنوان URL لأي صفحة على أداة Google Play Console، مثل الوصول إلى واجهة برمجة التطبيقات.
على سبيل المثال، إليك عنوان URL الخاص بأداة Google Play Console:
https://play.google.com/console/developers/1234567890123456789/api-access
في عنوان URL أعلاه، سيكون رقم تعريف المطوّر هو 1234567890123456789.
ملاحظة: في حال نقل تطبيق من حساب مطوِّر على Google Play واحد إلى آخر، سيتم تغيير معرّف المطوّر المرتبط بهذا التطبيق. يعني ذلك أنه بعد اكتمال النقل، يجب استخدام معرف المطوّر حساب مطوِّر على Google Play في طلبات البيانات من واجهة برمجة التطبيقات لهذا التطبيق
واجهات برمجة التطبيقات المتخصصة
وتحتوي واجهة برمجة التطبيقات Google Play Developer API على العديد من واجهات برمجة التطبيقات المتخصّصة التي تتيح بإجراء أنواع محددة من التحليل على تطبيقك:
- الرد على واجهة برمجة التطبيقات الخاصة بالمراجعات
- يسمح لك بعرض تعليقات المستخدمين على تطبيقك والرد على هذه التعليقات.
- واجهة Voided Purchases API
- يسمح لك بإبطال الوصول إلى المنتجات داخل التطبيق المرتبطة بعمليات الشراء التي قام المستخدم بالإلغاء.
مكتبات العملاء
قدمنا مكتبات للعملاء التي يمكنك استخدامها آليًا الوصول إلى واجهات برمجة تطبيقات REST. لمزيد من المعلومات، راجع مكتبات العميل ورموزه العيّنات: