لبدء إجراء طلبات إلى 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.
- فعِّل الخيار "واجهة برمجة التطبيقات لنشر خدمات الألعاب".
تم الآن ضبط مشروع واجهة برمجة التطبيقات للوصول إلى Publishing API.
استخدام مشروع حالي لواجهة برمجة التطبيقات
إذا كنت تستخدم حاليًا Google Play Developer API، يمكنك إعداد مشروع واجهة برمجة التطبيقات الحالي باتّباع الخطوات التالية. إذا لم يكن مشروع واجهة برمجة التطبيقات الذي تريد إعداده مدرَجًا، تأكَّد من أنّ حسابك على Google Play Console مصنَّف كمالك وتم تفعيل Google Play Developer API.
- انتقِل إلى صفحة الوصول إلى واجهة برمجة التطبيقات في Google Play Console.
- اقبل بنود الخدمة الخاصة بواجهة برمجة التطبيقات.
- اختَر المشروع الذي تريد إعداده.
- انقر على ربط. تم الآن ربط حسابك على Google Play Console بمشروع واجهة برمجة التطبيقات.
- فعِّل الخيار "واجهة برمجة التطبيقات لنشر خدمات الألعاب".
تم الآن ضبط مشروع واجهة برمجة التطبيقات للوصول إلى 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 والتطبيق النموذجي.