- طلب HTTP
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- RecallTokensCardinalityConstraint
- ConflictingLinksResolutionPolicy
- الولاية
- جرِّبه الآن
اربط العنصر الرئيسي لمشغّل "خدمات ألعاب Play" المشفر في رقم تعريف جلسة الاستدعاء المقدَّم بحساب داخل اللعبة.
طلب HTTP
POST https://games.googleapis.com/games/v1/recall:linkPersona
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "sessionId": string, "persona": string, "token": string, "cardinalityConstraint": enum ( |
الحقول | |
---|---|
sessionId |
مطلوب. سلسلة معتمة ينشئها الخادم ترمّز جميع المعلومات اللازمة لتحديد مشغّل "خدمات ألعاب Play" / مستخدم Google وتطبيقها |
persona |
مطلوب. معرّف ثابت للحساب داخل اللعبة يُرجى عدم إعادة استخدام الشخصية نفسها في ألعاب مختلفة. |
token |
مطلوب. قيمة الرمز المميّز المطلوب إنشاؤه معتم في "ألعاب Play" ويُفترَض أن يكون غير مستقر (يتم تشفيره باستخدام تدوير المفتاح) |
cardinalityConstraint |
مطلوب. يشير ذلك المصطلح إلى قيد على عدد العناصر في الحقل يجب ملاحظته عند ربط شخصية بلاعب في نطاق لعبة. |
conflictingLinksResolutionPolicy |
مطلوب. سياسة الحل التي تُطبَّق عندما يؤدي ربط الشخصية باللاعب إلى انتهاك قيد عدد العناصر في الحقل المحدّد |
حقل الاتحاد expiration . وقت أو وقت انتهاء صلاحية الرمز المميّز الاختياري يمكن أن يكون expiration واحدًا فقط مما يلي: |
|
expireTime |
الإدخال فقط. وقت انتهاء الصلاحية اختياري. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
ttl |
الإدخال فقط. مدة البقاء اختيارية. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
نص الاستجابة
نتيجة محاولة ربط الشخصية.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"state": enum ( |
الحقول | |
---|---|
state |
النتائج فقط. حالة محاولة ربط الشخصية. |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
RecallTokensCardinalityConstraint
يشير ذلك المصطلح إلى قيد على عدد العناصر في الحقل يجب ملاحظته عند ربط شخصية بلاعب في نطاق لعبة.
عمليات التعداد | |
---|---|
ONE_PERSONA_TO_ONE_PLAYER |
يشير ذلك إلى عدد العناصر في الحقل بين الشخصيات داخل اللعبة واللاعبين في "خدمات ألعاب Play". بحلول نهاية عملية الربط، يجب أن يظل إدخال واحد فقط للاعب والشخصية في نطاق التطبيق. يتم تحديد ما إذا تم إنشاء رابط جديد أم لا عند تحديد هذا القيد من خلال سياسة
|
ConflictingLinksResolutionPolicy
سياسة الحل التي تُطبَّق عندما يؤدي ربط الشخصية باللاعب إلى انتهاك قيد عدد العناصر في الحقل المحدّد
عمليات التعداد | |
---|---|
KEEP_EXISTING_LINKS |
في حال توفُّر روابط بين اللاعب والشخصية، والتي قد تؤدي إلى انتهاك على سبيل المثال، إذا تم ربط شخصية1-Player1 بالفعل في نطاق application1 وتمت محاولة إنشاء رابط جديد باسم application1-Player2 في نطاق application1، فسيظل الرابط القديم ولن تتم إضافة رابط جديد. وإذا كانت الروابط الحالية تخالف السياسة المحدّدة (يمكن أن يحدث ذلك إذا لم تستخدم جميع طلبات |
CREATE_NEW_LINK |
إذا كان هناك رابط حالي بين اللاعب والشخصية، ما قد يؤدي إلى انتهاك سياسة على سبيل المثال، إذا كانت الشخصية 1-Player1 مرتبطة بالفعل في نطاق application1 وتمت محاولة إنشاء رابط جديد، Persona1-Player2، في نطاق application1، فستتم إزالة الرابط القديم وإضافة الرابط الجديد ليحل محله. |
الحالة
حالة محاولة ربط الشخصية.
عمليات التعداد | |
---|---|
LINK_CREATED |
تم إنشاء الرابط المحدّد في الطلب. |
PERSONA_OR_PLAYER_ALREADY_LINKED |
لم يتم إنشاء الرابط المحدّد في الطلب لأنّ الروابط الحالية ستؤدي إلى انتهاك الرابط الجديد لسياسة RecallTokensCardinalityConstraint المحدّدة إذا تم إنشاؤه. |