التفويض

يتضمّن هذا القسم تعليمات خاصة بواجهة برمجة التطبيقات Google Play Developer API. يمكنك الاطّلاع على مستندات OAuth2 الكاملة لمزيد من التفاصيل.

الإعداد الأولي

تتم مصادقة الوصول إلى واجهة برمجة التطبيقات Google Play Android Developer API باستخدام خادم الويب OAuth 2.0 التدفق. لتتمكّن من استخدام واجهة برمجة التطبيقات، يجب إعداد وحدة التحكم في واجهات برمجة التطبيقات. وإنشاء معرّف عميل وإنشاء رمز مميّز لإعادة التحميل.

إنشاء مشروع وحدة تحكم واجهات برمجة التطبيقات

1. انتقِل إلى APIs Console وسجِّل الدخول باستخدام حسابك على Google Play Console
2. اختَر إنشاء مشروع.
3. انتقِل إلى الخدمات في لوحة التنقّل اليمنى.
4. فعِّل Google Play Android Developer API.
5. قبول بنود الخدمة
6. انتقِل إلى الوصول إلى واجهة برمجة التطبيقات في لوحة التنقّل اليمنى.
7. اختَر إنشاء معرِّف عميل OAuth 2.0.
   • في الصفحة الأولى، ستحتاج إلى ملء اسم المنتج، ولكن يجب كتابة شعار غير مطلوب. ملاحظة: لن يظهر اسم المنتج للمستخدمين النهائيين.
   • في الصفحة الثانية، حدد تطبيق الويب وعيِّن معرف الموارد المنتظم (URI) لإعادة التوجيه أصول JavaScript. ويمكن تغيير هذَين الإعدادَين لاحقًا.
8. اختَر إنشاء معرِّف عميل.

إنشاء رمز مميّز لإعادة التحميل

1. أثناء تسجيل الدخول باستخدام حسابك على Google Play Console، انتقِل إلى عنوان URI التالي:

   https://accounts.google.com/o/oauth2/auth?scope=https://www.googleapis.com/auth/androidpublisher&response_type=code&access_type=offline&redirect_uri=...&client_id=...

   ملاحظة: redirect_uri يجب أن تتطابق المعلمة تمامًا مع القيمة المسجلة بمعرّف العميل، بما في ذلك والشرطة المائلة للخلف اللاحقة، إن وجدت.
2. اختَر السماح بالوصول عندما يُطلب منك ذلك.
3. ستتم إعادة توجيه المتصفّح إلى معرّف الموارد المنتظم (URI) الخاص بإعادة التوجيه باستخدام code التي ستبدو مشابهة لـ 4/eWdxD7b-YSQ5CNNb-c2iI83KQx19.wp6198ti5Zc7dJ3UXOl0T3aRLxQmbwI.
4. يمكنك استبدال هذا الرمز بزوج من الرموز المميّزة للدخول وإعادة التحميل من خلال إرسال طلب POST. إرسال طلب إلى https://accounts.google.com/o/oauth2/token مع مجموعة الحقول التالية:

   grant_type=authorization_code
   code=<the code from the previous step>
   client_id=<the client ID token created in the APIs Console>
   client_secret=<the client secret corresponding to the client ID>
   redirect_uri=<the URI registered with the client ID>
   

   ستحتوي الاستجابة الناجحة على الرموز المميزة بتنسيق JSON:

   {
     "access_token" : "ya29.ZStBkRnGyZ2mUYOLgls7QVBxOg82XhBCFo8UIT5gM",
     "token_type" : "Bearer",
     "expires_in" : 3600,
     "refresh_token" : "1/zaaHNytlC3SEBX7F2cfrHcqJEa3KoAHYeXES6nmho"
   }
   

الوصول إلى واجهة برمجة التطبيقات

بعد إنشاء بيانات اعتماد العميل والرمز المميز للتحديث، ستبدأ الخوادم الوصول إلى واجهة برمجة التطبيقات بدون تسجيل دخول نشط أو تدخل بشري.

استخدام رمز الدخول

يمكن للخوادم إجراء اتصالات بواجهة برمجة التطبيقات من خلال تمرير رمز الدخول في عنوان Authorization للطلب:

Authorization: Bearer oauth2-token

استخدام الرمز المميز للتحديث

يكون كل رمز دخول صالحًا فقط لفترة قصيرة. بمجرد رمز الدخول الحالي سيحتاج الخادم إلى استخدام الرمز المميز للتحديث للحصول على رمز جديد. للقيام بذلك، هذا، أريد إرسال طلب POST إلى https://accounts.google.com/o/oauth2/token مع تضمين مجموعة الحقول التالية:

grant_type=refresh_token
client_id=<the client ID token created in the APIs Console>
client_secret=<the client secret corresponding to the client ID>
refresh_token=<the refresh token from the previous step>

ستحتوي الاستجابة الناجحة على رمز دخول آخر:

{
  "access_token" : "ya29.AHES3ZQ_MbZCwac9TBWIbjW5ilJkXvLTeSl530Na2",
  "token_type" : "Bearer",
  "expires_in" : 3600,
}

ويتيح الرمز المميز لإعادة التحميل لخادم الويب إمكانية الوصول المستمر إلى واجهة برمجة التطبيقات بدون تتطلب تسجيل دخول نشط إلى حساب Google.