- درخواست HTTP
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- RecallTokensCardinality Constraint
- ConflictingLinksResolution Policy
- ایالت
- آن را امتحان کنید!
اصل بازیکن PGS رمزگذاری شده در شناسه جلسه فراخوان ارائه شده را با یک حساب درون بازی مرتبط کنید
درخواست HTTP
POST https://games.googleapis.com/games/v1/recall:linkPersona
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "sessionId": string, "persona": string, "token": string, "cardinalityConstraint": enum ( |
فیلدها | |
---|---|
sessionId | مورد نیاز. رشته تولید شده توسط سرور غیرشفاف که تمام اطلاعات لازم برای شناسایی کاربر و برنامه پخش کننده PGS / Google را رمزگذاری می کند. |
persona | مورد نیاز. شناسه پایدار حساب درون بازی. لطفا از استفاده مجدد از یک شخصیت برای بازی های مختلف خودداری کنید. |
token | مورد نیاز. ارزش توکن برای ایجاد. برای بازیهای Play مات و ناپایدار فرض میشود (رمزگذاری شده با چرخش کلید). |
cardinalityConstraint | مورد نیاز. محدودیت کاردینالیتی که باید هنگام پیوند دادن یک شخصیت به یک بازیکن در محدوده یک بازی رعایت شود. |
conflictingLinksResolutionPolicy | مورد نیاز. خطمشی رزولوشن زمانی اعمال میشود که پیوند یک پرسونا به یک بازیکن منجر به نقض محدودیت اصلی مشخصشده شود. |
expiration میدان اتحادیه زمان انقضای رمز اختیاری یا زمان زندگی. expiration فقط می تواند یکی از موارد زیر باشد: | |
expireTime | فقط ورودی زمان انقضا اختیاری مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثالها: |
ttl | فقط ورودی زمان اختیاری برای زندگی مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' |
بدن پاسخگو
نتیجه تلاش برای پیوند دادن افراد
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"state": enum ( |
فیلدها | |
---|---|
state | فقط خروجی وضعیت تلاش برای پیوند دادن افراد. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/androidpublisher
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
RecallTokensCardinality Constraint
محدودیت کاردینالیتی که باید هنگام پیوند دادن یک شخصیت به یک بازیکن در محدوده یک بازی رعایت شود.
Enums | |
---|---|
ONE_PERSONA_TO_ONE_PLAYER | کاردینالیتی 1:1 بین شخصیتهای درون بازی و بازیکنان Play Games Services. تا پایان عملیات پیوند تنها یک ورودی برای بازیکن و شخصیت باید در محدوده برنامه باقی بماند. زمانی که این محدودیت مشخص شده است، پیوند جدیدی ایجاد شود یا خیر، توسط
|
ConflictingLinksResolution Policy
خطمشی رزولوشن زمانی اعمال میشود که پیوند یک پرسونا به یک بازیکن منجر به نقض محدودیت اصلی مشخصشده شود.
Enums | |
---|---|
KEEP_EXISTING_LINKS | اگر پیوند(های) بین بازیکن و پرسونا از قبل وجود داشته باشد که منجر به نقض به عنوان مثال، اگر Persona1-Player1 قبلاً در محدوده application1 پیوند داده شده باشد و سعی شود پیوند جدیدی Persona1-Player2 در محدوده application1 ایجاد شود، آنگاه پیوند قدیمی باقی خواهد ماند و پیوند جدیدی اضافه نخواهد شد. توجه داشته باشید که اگر پیوندهای موجود از قبل خط مشی مشخص شده را نقض کنند (که ممکن است رخ دهد اگر همه تماسهای |
CREATE_NEW_LINK | اگر پیوند موجود بین یک بازیکن و پرسونا از قبل وجود داشته باشد که منجر به نقض به عنوان مثال، اگر Persona1-Player1 قبلاً در محدوده application1 پیوند داده شده باشد و سعی شود یک پیوند جدید Persona1-Player2 در محدوده application1 ایجاد شود، پیوند قدیمی حذف می شود و پیوند جدید به جای آن اضافه می شود. . |
ایالت
وضعیت تلاش برای پیوند دادن پرسونا.
Enums | |
---|---|
LINK_CREATED | لینک مشخص شده در درخواست ایجاد شد. |
PERSONA_OR_PLAYER_ALREADY_LINKED | پیوند مشخص شده در درخواست ایجاد نشده است زیرا پیوندهای موجود در صورت ایجاد، منجر به نقض پیوند جدید RecallTokensCardinalityConstraint مشخص شده می شود. |