قبل البدء في إجراء طلبات بيانات من واجهة برمجة التطبيقات، عليك إعداد إمكانية الوصول إلى واجهة برمجة التطبيقات على حساب المطوّر الخاص بك على 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 من عميل الويب نيابةً عن المستخدم، يمكنك استخدام معرّف العميل. ستتم مصادقة المستخدم بحسابه على Google بدلاً من حساب الخدمة. ويتيح لك ذلك إجراء طلبات بيانات من واجهة برمجة التطبيقات نيابةً عن مستخدم بدون المساس ببيانات اعتماد حساب الخدمة.
- حساب الخدمة: ستصل خدمة برامج آمنة إلى واجهة برمجة التطبيقات (الأكثر شيوعًا)
- عملاء OAuth: سيتمكن المستخدم من الوصول إلى واجهة برمجة التطبيقات
استخدام حساب خدمة
يمكنك إنشاء حساب خدمة من Google Play Console.
- في Google Cloud Console، انتقِل إلى حسابات الخدمة.
- انقر على إنشاء حساب خدمة واتّبِع الخطوات.
- انتقِل إلى صفحة المستخدمون والأذونات على Google Play Console.
- انقر على دعوة مستخدِمين جُدد.
ضَع عنوان بريد إلكتروني لحساب الخدمة في حقل عنوان البريد الإلكتروني وامنح الحقوق اللازمة لتنفيذ الإجراءات.
لاستخدام واجهات Google Play Billing API، عليك منح الأذونات التالية:
- عرض البيانات المالية والطلبات والردود على استطلاع أسباب الإلغاء
- إدارة الطلبات والاشتراكات
انقر على دعوة مستخدم.
في هذه المرحلة، من المفترض أن تتمكّن من الوصول إلى Google Play Developer API من خلال حساب الخدمة. للحصول على مزيد من المعلومات، يُرجى الاطّلاع على استخدام OAuth 2.0 لتطبيقات "خادم إلى خادم".
استخدام عملاء OAuth
يمكنك السماح للمستخدمين بتنفيذ إجراءات باستخدام واجهة برمجة التطبيقات ضمن بيانات الاعتماد الخاصة بهم باستخدام برنامج OAuth. تقتصر إجراءات المستخدم على الإجراءات المسموح بها عبر صفحة المستخدمون والأذونات على Google Play Console.
قبل إنشاء عملاء OAuth، يجب ضبط معلومات العلامة التجارية لمنتجك. لمزيد من المعلومات، راجِع إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
- في Google Cloud Console، انتقِل إلى صفحة شاشة موافقة OAuth.
- اتّبِع الخطوات لإنشاء شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
لإنشاء عميل OAuth، يُرجى اتّباع الخطوات التالية:
- في Google Cloud Console، انتقِل إلى بيانات الاعتماد.
- انقر على إنشاء بيانات اعتماد > معرّف عميل 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 على العديد من واجهات برمجة التطبيقات المتخصصة التي تتيح لك إجراء أنواع محدّدة من التحليل على تطبيقك:
- الردّ على واجهة برمجة التطبيقات الخاصة بالمراجعات
- يسمح لك بعرض ملاحظات المستخدمين بشأن تطبيقك والردّ على هذه الملاحظات.
- واجهة برمجة التطبيقات لعمليات الشراء التي تم إبطالها
- تتيح لك هذه السياسة إبطال إمكانية الوصول إلى المنتجات داخل التطبيق المرتبطة بعمليات الشراء التي ألغاها المستخدم.
مكتبات العملاء
لقد وفرنا مكتبات عملاء يمكنك استخدامها للوصول آليًا إلى واجهات برمجة تطبيقات REST. لمزيد من المعلومات، يُرجى الاطّلاع على مكتبات العميل ونماذج الرموز.