Method: recall.linkPersona

اصل بازیکن PGS رمزگذاری شده در شناسه جلسه فراخوان ارائه شده را با یک حساب درون بازی مرتبط کنید

درخواست HTTP

POST https://games.googleapis.com/games/v1/recall:linkPersona

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "sessionId": string,
  "persona": string,
  "token": string,
  "cardinalityConstraint": enum (RecallTokensCardinalityConstraint),
  "conflictingLinksResolutionPolicy": enum (ConflictingLinksResolutionPolicy),

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
}
زمینه های
sessionId

string

ضروری. رشته تولید شده توسط سرور غیرشفاف که تمام اطلاعات لازم برای شناسایی کاربر و برنامه پخش کننده PGS / Google را رمزگذاری می کند.

persona

string

ضروری. شناسه پایدار حساب درون بازی. لطفا از استفاده مجدد از یک شخصیت برای بازی های مختلف خودداری کنید.

token

string

ضروری. ارزش توکن برای ایجاد. برای بازی‌های Play مات و ناپایدار فرض می‌شود (رمزگذاری شده با چرخش کلید).

cardinalityConstraint

enum ( RecallTokensCardinalityConstraint )

ضروری. محدودیت کاردینالیتی که باید هنگام پیوند دادن یک شخصیت به یک بازیکن در محدوده یک بازی رعایت شود.

expiration میدان اتحادیه زمان انقضای رمز اختیاری یا زمان زندگی. expiration فقط می تواند یکی از موارد زیر باشد:
expireTime

string ( Timestamp format)

فقط ورودی زمان انقضا اختیاری

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

ttl

string ( Duration format)

فقط ورودی زمان اختیاری برای زندگی

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

بدن پاسخگو

نتیجه تلاش برای پیوند دادن افراد

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "state": enum (State)
}
زمینه های
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.

تا پایان عملیات پیوند تنها یک ورودی برای بازیکن و شخصیت باید در محدوده برنامه باقی بماند.

زمانی که این محدودیت مشخص شده است، پیوند جدیدی ایجاد شود یا خیر، توسط ConflictingLinksResolutionPolicy انتخاب شده تعیین می شود:

  • اگر KEEP_EXISTING_LINKS مشخص شده باشد و پرسونای ارائه شده قبلاً به بازیکن دیگری پیوند داده شده باشد، یا بازیکن قبلاً به شخصیت دیگری پیوند داده شده باشد، هیچ پیوند جدیدی ایجاد نخواهد شد و پیوند(های) موجود از قبل به همین صورت باقی می مانند.

  • اگر CREATE_NEW_LINK مشخص شده باشد و پرسونای ارائه شده قبلاً به بازیکن دیگری پیوند داده شده باشد، یا بازیکن قبلاً به شخصیت دیگری پیوند داده شده باشد، پیوند(های) قدیمی به نفع پیوند جدید در حال ایجاد حذف خواهند شد.

ConflictingLinksResolution Policy

خط‌مشی رزولوشن زمانی اعمال می‌شود که پیوند یک پرسونا به یک بازیکن منجر به نقض محدودیت اصلی مشخص‌شده شود.

Enums

حالت

وضعیت تلاش برای پیوند دادن پرسونا.

Enums
PERSONA_OR_PLAYER_ALREADY_LINKED پیوند مشخص شده در درخواست ایجاد نشده است زیرا پیوندهای موجود در صورت ایجاد، منجر به نقض پیوند جدید RecallTokensCardinalityConstraint مشخص شده می شود.