التفويض

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

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

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

إنشاء مشروع على Google APIs Console

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

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

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

   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. ستتم إعادة توجيه المتصفّح إلى معرّف الموارد المنتظم لإعادة التوجيه مع المَعلمة 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.