لبدء إجراء طلبات إلى واجهة برمجة التطبيقات Publishing API، عليك الربط بأحد مشاريع واجهة برمجة التطبيقات مباشرةً من Google Play Console وتفعيل واجهة برمجة التطبيقات Publishing API لهذا المشروع. بعد إعداد مشروع واجهة برمجة التطبيقات، يمكن استخدامه لإدارة مشاريع الألعاب الأخرى التي تملكها.
لا يمكن ضبط واجهة برمجة التطبيقات Publishing API إلا من قِبل مالك حساب المطوّر الخاص بك على Google Play. توضّح التعليمات التالية كيفية تنفيذ ما يلي:
- إعداد مشروع واجهة برمجة تطبيقات جديد أو حالي
- إدارة عملاء OAuth
- استخدام حساب خدمة للوصول إلى واجهة برمجة التطبيقات Publishing API
إعداد مشروع واجهة برمجة التطبيقات
قبل أن تتمكّن من الوصول إلى واجهة برمجة التطبيقات Publishing API، عليك ربط Google Play Console بمشروع واجهة برمجة التطبيقات. في معظم الحالات، ننصحك بإنشاء مشروع جديد لواجهة برمجة التطبيقات، على الرغم من أنّه يمكن لمستخدمي Google Play Developer Publishing API الحاليين الربط بمشروع حالي لواجهة برمجة التطبيقات. يُرجى العِلم أنّه يمكن ربط كل مشروع لواجهة برمجة التطبيقات بحساب واحد فقط على Google Play Console.
إنشاء مشروع جديد لواجهة برمجة التطبيقات
- انتقِل إلى صفحة الوصول إلى واجهة برمجة التطبيقات في Google Play Console.
- يجب قبول بنود الخدمة.
- انقر على إنشاء مشروع جديد. يتم إنشاء مشروع واجهة برمجة تطبيقات تلقائيًا و ربطه بحسابك على Google Play Console.
- فعِّل خيار واجهة برمجة التطبيقات Game Services Publishing API على تفعيل.
تم الآن ضبط مشروع واجهة برمجة التطبيقات للوصول إلى واجهة Publishing API.
استخدام مشروع واجهة برمجة تطبيقات حالي
إذا كنت من مستخدمي Google Play Developer API، يمكنك إعداد مشروع واجهة برمجة التطبيقات الحالي باتّباع الخطوات التالية. إذا لم يكن مشروع واجهة برمجة التطبيقات الذي تريد إعداده مُدرَجًا، تأكَّد من أنّ حسابك على Google Play Console مُصنَّف على أنّه مالك، ومن أنّ واجهة برمجة التطبيقات Google Play Developer API مفعَّلة.
- انتقِل إلى صفحة الوصول إلى واجهة برمجة التطبيقات في Google Play Console.
- وافِق على بنود خدمة واجهة برمجة التطبيقات.
- اختَر المشروع الذي تريد إعداده.
- انقر على ربط. أصبح حسابك على Google Play Console مرتبطًا بمشروع واجهة برمجة التطبيقات.
- فعِّل خيار واجهة برمجة التطبيقات Game Services Publishing API على تفعيل.
تم الآن ضبط مشروع واجهة برمجة التطبيقات للوصول إلى واجهة Publishing API.
إعداد عملاء الوصول إلى واجهة برمجة التطبيقات
يمكنك الوصول إلى واجهة برمجة التطبيقات Publishing API من خلال عميل OAuth أو حساب خدمة.
استخدام عملاء OAuth
يمكنك السماح للمستخدمين بتنفيذ إجراءات من خلال Publishing API باستخدام بيانات اعتمادهم الخاصة باستخدام عميل OAuth.
تقتصر إجراءات المستخدم على الإجراءات المسموح بها من خلال صفحة حسابات المستخدمين والحقوق في Google Play Console.
- انتقِل إلى صفحة الوصول إلى واجهة برمجة التطبيقات في Google Play Console.
- ضمن برامج OAuth، انقر على إنشاء برنامج OAuth.
- اضبط معلومات العلامة التجارية لمنتجك، ثم انقر على متابعة.
- انقر على إنشاء معرِّف عميل.
يتم عرض تفاصيل برنامج OAuth الجديد في قائمة على هذه الصفحة.
استخدام حساب خدمة
يمكنك أيضًا إنشاء حساب خدمة للوصول إلى واجهة برمجة التطبيقات Publishing API من خادم إصدارات بدون تقديم بيانات اعتماد المستخدم الشخصية:
- انتقِل إلى صفحة الوصول إلى واجهة برمجة التطبيقات في Google Play Console.
- ضمن حسابات الخدمة، انقر على إنشاء حساب خدمة.
- اتّبِع التعليمات الواردة في الصفحة لإنشاء حساب الخدمة.
- بعد إنشاء حساب الخدمة في Google Developers Console، انقر على تم. تتم إعادة تحميل صفحة الوصول إلى واجهة برمجة التطبيقات تلقائيًا، وسيتم إدراج حساب الخدمة.
- انقر على منح الإذن بالوصول لمنح حساب الخدمة الحقوق اللازمة للقيام بالإجراءات.
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة استخدام OAuth 2.0 لتطبيقات الخادم إلى الخادم.
الوصول إلى واجهة برمجة التطبيقات Google Play Games Services Publishing API
يمكنك الوصول إلى Publishing API مباشرةً من خلال HTTP. لمزيد من المعلومات، يُرجى الاطّلاع على مرجع Publishing API ونموذج التطبيق.