التفويض

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

الضبط المبدئي

تتم مصادقة الوصول إلى واجهة برمجة التطبيقات Google Play 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.