- Yêu cầu HTTP
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- RecallTokensCardinalityConstraint
- ConflictingLinksResolutionPolicy
- Trạng thái
- Hãy làm thử!
Liên kết với một tài khoản trong trò chơi để liên kết với người chơi gốc PGS được mã hoá theo mã phiên hoạt động gọi lại được cung cấp
Yêu cầu HTTP
POST https://games.googleapis.com/games/v1/recall:linkPersona
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "sessionId": string, "persona": string, "token": string, "cardinalityConstraint": enum ( |
Trường | |
---|---|
sessionId |
Bắt buộc. Chuỗi mờ do máy chủ tạo, mã hoá tất cả thông tin cần thiết để xác định người chơi PGS / người dùng Google và ứng dụng. |
persona |
Bắt buộc. Giá trị nhận dạng ổn định của tài khoản trong trò chơi. Vui lòng không sử dụng lại cùng một cá tính cho các trò chơi khác nhau. |
token |
Bắt buộc. Giá trị của mã thông báo cần tạo. Mờ đối với Play Games và được giả định là không ổn định (được mã hoá bằng tính năng xoay vòng khoá). |
cardinalityConstraint |
Bắt buộc. Ràng buộc về số lượng giá trị riêng biệt cần theo dõi khi liên kết một persona với một người chơi trong phạm vi một trò chơi. |
conflictingLinksResolutionPolicy |
Bắt buộc. Chính sách giải quyết vấn đề được áp dụng khi việc liên kết một persona với một người chơi sẽ dẫn đến việc vi phạm quy tắc ràng buộc về số lượng giá trị riêng biệt đã chỉ định. |
Trường kết hợp expiration . Thời gian hết hạn mã thông báo (không bắt buộc) hoặc thời gian tồn tại. expiration chỉ có thể là một trong những trạng thái sau đây: |
|
expireTime |
Chỉ nhập. Thời gian hết hạn (không bắt buộc). Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: |
ttl |
Chỉ nhập. Thời gian phát trực tiếp (không bắt buộc). Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng " |
Nội dung phản hồi
Kết quả của một hành vi liên kết persona.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"state": enum ( |
Trường | |
---|---|
state |
Chỉ có đầu ra. Trạng thái của một hành động liên kết persona. |
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/androidpublisher
Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
RecallTokensCardinalityConstraint
Ràng buộc về số lượng giá trị riêng biệt cần theo dõi khi liên kết một persona với một người chơi trong phạm vi một trò chơi.
Enum | |
---|---|
ONE_PERSONA_TO_ONE_PLAYER |
Số lượng giá trị riêng biệt 1:1 giữa persona trong trò chơi và người chơi sử dụng Dịch vụ trò chơi của Play. Vào cuối thao tác liên kết, chỉ một mục nhập cho người chơi và persona sẽ vẫn nằm trong phạm vi ứng dụng. Việc đường liên kết mới có được tạo hay không khi quy tắc ràng buộc này được chỉ định sẽ do
|
ConflictingLinksResolutionPolicy
Chính sách giải quyết vấn đề được áp dụng khi việc liên kết một persona với một người chơi sẽ dẫn đến việc vi phạm quy tắc ràng buộc về số lượng giá trị riêng biệt đã chỉ định.
Enum | |
---|---|
KEEP_EXISTING_LINKS |
Nếu đã có(các) mối liên kết giữa người chơi và persona, dẫn đến việc vi phạm Ví dụ: nếu Persona1-Player1 đã được liên kết trong phạm vi application1 và một liên kết mới Persona1-Player2 được cố gắng tạo trong phạm vi của application1, thì liên kết cũ sẽ vẫn còn và không có đường liên kết mới nào được thêm. Xin lưu ý rằng nếu các đường liên kết hiện có vi phạm chính sách được chỉ định (có thể xảy ra nếu không phải tất cả lệnh gọi |
CREATE_NEW_LINK |
Nếu đã có một mối liên kết hiện có giữa người chơi và persona, dẫn đến việc vi phạm Ví dụ: nếu Persona1-Player1 đã được liên kết trong phạm vi application1 và một đường liên kết mới Persona1-Player2 được cố gắng tạo trong phạm vi của application1, thì đường liên kết cũ sẽ bị gỡ bỏ và đường liên kết mới sẽ được thêm vào để thay thế. |
Tiểu bang
Trạng thái của một hành động liên kết persona.
Enum | |
---|---|
LINK_CREATED |
Đường liên kết được chỉ định trong yêu cầu đã được tạo. |
PERSONA_OR_PLAYER_ALREADY_LINKED |
Đường liên kết được chỉ định trong yêu cầu chưa được tạo vì các đường liên kết hiện có sẽ khiến đường liên kết mới vi phạm RecallTokensCardinalityConstraint được chỉ định nếu được tạo. |