این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Method: recall.linkPersona

درخواست HTTP
درخواست بدن
- نمایندگی JSON
بدن پاسخگو
- نمایندگی JSON
محدوده مجوز
RecallTokensCardinality Constraint
ConflictingLinksResolution Policy
ایالت
آن را امتحان کنید!

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

درخواست HTTP

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

درخواست بدن

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

نمایندگی JSON

نمایندگی 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,
  "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 )` مورد نیاز. محدودیت کاردینالیتی که باید هنگام پیوند دادن یک شخصیت به یک بازیکن در محدوده یک بازی رعایت شود.
`conflictingLinksResolutionPolicy`	`enum ( ConflictingLinksResolutionPolicy )` مورد نیاز. خط‌مشی رزولوشن زمانی اعمال می‌شود که پیوند یک پرسونا به یک بازیکن منجر به نقض محدودیت اصلی مشخص‌شده شود.
`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 )` فقط خروجی وضعیت تلاش برای پیوند دادن پرسونا.

state

enum ( State )

فقط خروجی وضعیت تلاش برای پیوند دادن پرسونا.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

https://www.googleapis.com/auth/androidpublisher

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

RecallTokensCardinality Constraint

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

Enums

Enums
`ONE_PERSONA_TO_ONE_PLAYER`	کاردینالیتی 1:1 بین شخصیت‌های درون بازی و بازیکنان Play Games Services. تا پایان عملیات پیوند تنها یک ورودی برای بازیکن و شخصیت باید در محدوده برنامه باقی بماند. زمانی که این محدودیت مشخص شده است، پیوند جدیدی ایجاد شود یا خیر، توسط `ConflictingLinksResolutionPolicy` انتخاب شده تعیین می شود: اگر `KEEP_EXISTING_LINKS` مشخص شده باشد و پرسونای ارائه شده قبلاً به بازیکن دیگری پیوند داده شده باشد، یا بازیکن قبلاً به شخصیت دیگری پیوند داده شده باشد، هیچ پیوند جدیدی ایجاد نخواهد شد و پیوند(های) موجود از قبل به همین صورت باقی می مانند. اگر `CREATE_NEW_LINK` مشخص شده باشد و پرسونای ارائه شده قبلاً به بازیکن دیگری پیوند داده شده باشد، یا بازیکن قبلاً به شخصیت دیگری پیوند داده شده باشد، پیوند(های) قدیمی به نفع پیوند جدید در حال ایجاد حذف خواهند شد.

ONE_PERSONA_TO_ONE_PLAYER

کاردینالیتی 1:1 بین شخصیت‌های درون بازی و بازیکنان Play Games Services.

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

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

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

ConflictingLinksResolution Policy

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

Enums

Enums
`KEEP_EXISTING_LINKS`	اگر پیوند(های) بین بازیکن و پرسونا از قبل وجود داشته باشد که منجر به نقض `RecallTokensCardinalityConstraint` مشخص شده در صورت ایجاد پیوند جدید شود، پیوند(های) موجود را نگه دارید. به عنوان مثال، اگر Persona1-Player1 قبلاً در محدوده application1 پیوند داده شده باشد و سعی شود پیوند جدیدی Persona1-Player2 در محدوده application1 ایجاد شود، آنگاه پیوند قدیمی باقی خواهد ماند و پیوند جدیدی اضافه نخواهد شد. توجه داشته باشید که اگر پیوندهای موجود از قبل خط مشی مشخص شده را نقض کنند (که ممکن است رخ دهد اگر همه تماس‌های `recall.linkPersona` از `RecallTokensCardinalityConstraint` یکسان استفاده نکنند) این خط‌مشی این تخلفات را حل‌نشده باقی می‌گذارد. برای حل تضادها، باید از خط‌مشی {@link `CREATE_NEW_LINK` برای بازنویسی پیوندهایی که تضادها را حل می‌کنند استفاده شود.
`CREATE_NEW_LINK`	اگر پیوند موجود بین یک بازیکن و پرسونا از قبل وجود داشته باشد که منجر به نقض `RecallTokensCardinalityConstraint` مشخص شده در صورت ایجاد پیوند جدید شود، پیوند(های) موجود را با پیوند جدید جایگزین کنید. به عنوان مثال، اگر Persona1-Player1 قبلاً در محدوده application1 پیوند داده شده باشد و سعی شود یک پیوند جدید Persona1-Player2 در محدوده application1 ایجاد شود، پیوند قدیمی حذف می شود و پیوند جدید به جای آن اضافه می شود. .

KEEP_EXISTING_LINKS

اگر پیوند(های) بین بازیکن و پرسونا از قبل وجود داشته باشد که منجر به نقض RecallTokensCardinalityConstraint مشخص شده در صورت ایجاد پیوند جدید شود، پیوند(های) موجود را نگه دارید.

به عنوان مثال، اگر Persona1-Player1 قبلاً در محدوده application1 پیوند داده شده باشد و سعی شود پیوند جدیدی Persona1-Player2 در محدوده application1 ایجاد شود، آنگاه پیوند قدیمی باقی خواهد ماند و پیوند جدیدی اضافه نخواهد شد.

توجه داشته باشید که اگر پیوندهای موجود از قبل خط مشی مشخص شده را نقض کنند (که ممکن است رخ دهد اگر همه تماس‌های recall.linkPersona از RecallTokensCardinalityConstraint یکسان استفاده نکنند) این خط‌مشی این تخلفات را حل‌نشده باقی می‌گذارد. برای حل تضادها، باید از خط‌مشی {@link CREATE_NEW_LINK برای بازنویسی پیوندهایی که تضادها را حل می‌کنند استفاده شود.

CREATE_NEW_LINK

اگر پیوند موجود بین یک بازیکن و پرسونا از قبل وجود داشته باشد که منجر به نقض RecallTokensCardinalityConstraint مشخص شده در صورت ایجاد پیوند جدید شود، پیوند(های) موجود را با پیوند جدید جایگزین کنید.

به عنوان مثال، اگر Persona1-Player1 قبلاً در محدوده application1 پیوند داده شده باشد و سعی شود یک پیوند جدید Persona1-Player2 در محدوده application1 ایجاد شود، پیوند قدیمی حذف می شود و پیوند جدید به جای آن اضافه می شود. .

ایالت

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

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