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