قبل أن تتمكّن من بدء إجراء طلبات من واجهة برمجة التطبيقات، عليك ضبط إعدادات الوصول إلى واجهة برمجة التطبيقات في حساب المطوّر على 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 من عميل الويب نيابةً عن المستخدم، يمكنك استخدام معرّف العميل. سيتم إثبات هوية المستخدم باستخدام حسابه على 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، انتقِل إلى بيانات الاعتماد.
- انقر على "إنشاء بيانات اعتماد" > "معرِّف عميل 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 العديد من واجهات برمجة التطبيقات المتخصّصة التي تتيح لك إجراء أنواع محدّدة من التحليلات على تطبيقك:
- واجهة Reply to Reviews API
- تتيح لك هذه الميزة الاطّلاع على ملاحظات المستخدمين بشأن تطبيقك والردّ عليها.
- Voided Purchases API
- تتيح لك إبطال إذن الوصول إلى المنتجات داخل التطبيق المرتبطة بعمليات الشراء التي ألغاها المستخدم.
مكتبات العملاء
لقد وفّرنا مكتبات للعملاء يمكنك استخدامها للوصول إلى واجهات برمجة تطبيقات REST آليًا. لمزيد من المعلومات، يُرجى الاطّلاع على مكتبات البرامج النموذجية وعيّنات الرموز البرمجية.