服务 C API 概览 - PFAccountManagementTypes.h - XBOX Game Development Documentation

结构

结构	说明
PFAccountManagementAddOrUpdateContactEmailRequest	PFAccountManagementAddOrUpdateContactEmailRequest 数据模型。此 API 向玩家的个人资料添加联系电子邮件。如果玩家的个人资料已包含联系电子邮件，则会将联系电子邮件更新为指定的电子邮件地址。
PFAccountManagementAddUsernamePasswordRequest	PFAccountManagementAddUsernamePasswordRequest 数据模型。
PFAccountManagementAddUsernamePasswordResult	PFAccountManagementAddUsernamePasswordResult 数据模型。每个账户在 PlayFab 服务中必须具有唯一的用户名和电子邮件地址。创建后，该账户可以与其他账户（Steam、Facebook、Game Center 等）关联，从而添加社交网络列表和成就系统。也可以将其用作用户丢失原始访问方式时的恢复方法。
PFAccountManagementBanInfo	PFAccountManagementBanInfo 数据模型。包含封禁的信息。
PFAccountManagementBanRequest	PFAccountManagementBanRequest 数据模型。表示单个封禁请求。
PFAccountManagementBanUsersRequest	PFAccountManagementBanUsersRequest 数据模型。不会验证每个用户是否存在。按 IP 封禁时可能会影响多个玩家，因此请谨慎使用此功能。返回有关新封禁的信息。
PFAccountManagementBanUsersResult	PFAccountManagementBanUsersResult 数据模型。
PFAccountManagementClientLinkNintendoServiceAccountRequest	PFAccountManagementClientLinkNintendoServiceAccountRequest 数据模型。
PFAccountManagementClientLinkNintendoSwitchDeviceIdRequest	PFAccountManagementClientLinkNintendoSwitchDeviceIdRequest 数据模型。
PFAccountManagementClientLinkPSNAccountRequest	PFAccountManagementClientLinkPSNAccountRequest 数据模型。
PFAccountManagementClientLinkXboxAccountRequest	PFAccountManagementClientLinkXboxAccountRequest 数据模型。
PFAccountManagementClientUnlinkNintendoServiceAccountRequest	PFAccountManagementClientUnlinkNintendoServiceAccountRequest 数据模型。
PFAccountManagementClientUnlinkNintendoSwitchDeviceIdRequest	PFAccountManagementClientUnlinkNintendoSwitchDeviceIdRequest 数据模型。
PFAccountManagementClientUnlinkPSNAccountRequest	PFAccountManagementClientUnlinkPSNAccountRequest 数据模型。
PFAccountManagementClientUnlinkXboxAccountRequest	PFAccountManagementClientUnlinkXboxAccountRequest 数据模型。
PFAccountManagementClientUpdateAvatarUrlRequest	PFAccountManagementClientUpdateAvatarUrlRequest 数据模型。
PFAccountManagementDeletePlayerRequest	PFAccountManagementDeletePlayerRequest 数据模型。删除与玩家关联的所有数据，包括统计信息、自定义数据、库存、购买、虚拟货币余额、角色和共享组成员资格。从所有排行榜和玩家搜索索引中移除该玩家。不会删除与该玩家关联的 PlayStream 事件历史记录。不会删除在标题中创建该玩家的发布者用户账户，也不会删除关联数据，例如用户名、密码、电子邮件地址、账户关联或好友列表。请注意，此 API 会将该玩家加入删除队列并立即返回。完全删除所有玩家数据可能需要几分钟或更长时间。在完全删除玩家数据之前，在同一标题中使用相同用户账户重新创建该玩家的尝试将失败并显示 ‘AccountDeleted’ 错误。此 API 必须在游戏管理器网站中启用作为选项才能使用。默认情况下已禁用。
PFAccountManagementFacebookInstantGamesPlayFabIdPair	PFAccountManagementFacebookInstantGamesPlayFabIdPair 数据模型。
PFAccountManagementFacebookPlayFabIdPair	PFAccountManagementFacebookPlayFabIdPair 数据模型。
PFAccountManagementGameCenterPlayFabIdPair	PFAccountManagementGameCenterPlayFabIdPair 数据模型。
PFAccountManagementGetAccountInfoRequest	PFAccountManagementGetAccountInfoRequest 数据模型。
PFAccountManagementGetAccountInfoResult	PFAccountManagementGetAccountInfoResult 数据模型。此 API 检索有关 PlayFab 服务中玩家的详细信息。请注意，当使用此调用检索有关另一玩家（非登录到本地客户端的玩家）的数据时，出于隐私原因或为了符合所属平台的要求，将省略某些数据，例如个人身份信息 (PII)。返回的用户账户将根据所提供的标识符按优先顺序确定：PlayFabId、Username、Email，然后是 TitleDisplayName。如果未指定标识符，将返回当前登录用户的信息。
PFAccountManagementGetPlayerCombinedInfoRequest	PFAccountManagementGetPlayerCombinedInfoRequest 数据模型。
PFAccountManagementGetPlayerCombinedInfoResult	PFAccountManagementGetPlayerCombinedInfoResult 数据模型。在响应中返回用户请求的任何信息。如果未明确请求用户，则默认为已验证身份的用户。如果用户与请求者相同，将返回可用的 PII（如电子邮件地址、facebook id）。否则，仅返回公开信息。所有参数默认为 false。
PFAccountManagementGetPlayerProfileRequest	PFAccountManagementGetPlayerProfileRequest 数据模型。此 API 允许访问有关 PlayFab 服务中用户的详细信息，通常用于客户支持目的。请注意，返回的数据可能是个人身份信息 (PII)，例如电子邮件地址，因此在存储和管理此类数据时应予以注意。由于此调用始终会返回已访问该标题的用户的相关信息，建议不要在本地存储此类数据。
PFAccountManagementGetPlayerProfileResult	PFAccountManagementGetPlayerProfileResult 数据模型。
PFAccountManagementGetPlayFabIDsFromFacebookIDsRequest	PFAccountManagementGetPlayFabIDsFromFacebookIDsRequest 数据模型。
PFAccountManagementGetPlayFabIDsFromFacebookIDsResult	PFAccountManagementGetPlayFabIDsFromFacebookIDsResult 数据模型。对于尚未关联到 PlayFab 账户的 Facebook 标识符，将返回 null。
PFAccountManagementGetPlayFabIDsFromFacebookInstantGamesIdsRequest	PFAccountManagementGetPlayFabIDsFromFacebookInstantGamesIdsRequest 数据模型。
PFAccountManagementGetPlayFabIDsFromFacebookInstantGamesIdsResult	PFAccountManagementGetPlayFabIDsFromFacebookInstantGamesIdsResult 数据模型。对于尚未关联到 PlayFab 账户的 Facebook Instant Game 标识符，将返回 null。
PFAccountManagementGetPlayFabIDsFromGameCenterIDsRequest	PFAccountManagementGetPlayFabIDsFromGameCenterIDsRequest 数据模型。
PFAccountManagementGetPlayFabIDsFromGameCenterIDsResult	PFAccountManagementGetPlayFabIDsFromGameCenterIDsResult 数据模型。对于尚未关联到 PlayFab 账户的 Game Center 标识符，将返回 null。
PFAccountManagementGetPlayFabIDsFromGoogleIDsRequest	PFAccountManagementGetPlayFabIDsFromGoogleIDsRequest 数据模型。
PFAccountManagementGetPlayFabIDsFromGoogleIDsResult	PFAccountManagementGetPlayFabIDsFromGoogleIDsResult 数据模型。对于尚未关联到 PlayFab 账户的 Google 标识符，将返回 null。
PFAccountManagementGetPlayFabIDsFromGooglePlayGamesPlayerIDsRequest	PFAccountManagementGetPlayFabIDsFromGooglePlayGamesPlayerIDsRequest 数据模型。
PFAccountManagementGetPlayFabIDsFromGooglePlayGamesPlayerIDsResult	PFAccountManagementGetPlayFabIDsFromGooglePlayGamesPlayerIDsResult 数据模型。对于尚未关联到 PlayFab 账户的 Google Play Games 标识符，将返回 null。
PFAccountManagementGetPlayFabIDsFromKongregateIDsRequest	PFAccountManagementGetPlayFabIDsFromKongregateIDsRequest 数据模型。
PFAccountManagementGetPlayFabIDsFromKongregateIDsResult	PFAccountManagementGetPlayFabIDsFromKongregateIDsResult 数据模型。对于尚未关联到 PlayFab 账户的 Kongregate 标识符，将返回 null。
PFAccountManagementGetPlayFabIDsFromNintendoServiceAccountIdsRequest	PFAccountManagementGetPlayFabIDsFromNintendoServiceAccountIdsRequest 数据模型。
PFAccountManagementGetPlayFabIDsFromNintendoServiceAccountIdsResult	PFAccountManagementGetPlayFabIDsFromNintendoServiceAccountIdsResult 数据模型。对于尚未关联到 PlayFab 账户的 Nintendo 服务账户标识符，将返回 null。
PFAccountManagementGetPlayFabIDsFromNintendoSwitchDeviceIdsRequest	PFAccountManagementGetPlayFabIDsFromNintendoSwitchDeviceIdsRequest 数据模型。
PFAccountManagementGetPlayFabIDsFromNintendoSwitchDeviceIdsResult	PFAccountManagementGetPlayFabIDsFromNintendoSwitchDeviceIdsResult 数据模型。对于尚未关联到 PlayFab 账户的 Nintendo Switch 标识符，将返回 null。
PFAccountManagementGetPlayFabIDsFromPSNAccountIDsRequest	PFAccountManagementGetPlayFabIDsFromPSNAccountIDsRequest 数据模型。
PFAccountManagementGetPlayFabIDsFromPSNAccountIDsResult	PFAccountManagementGetPlayFabIDsFromPSNAccountIDsResult 数据模型。对于尚未关联到 PlayFab 账户的 PlayStation :tm: Network 标识符，将返回 null。
PFAccountManagementGetPlayFabIDsFromSteamIDsRequest	PFAccountManagementGetPlayFabIDsFromSteamIDsRequest 数据模型。
PFAccountManagementGetPlayFabIDsFromSteamIDsResult	PFAccountManagementGetPlayFabIDsFromSteamIDsResult 数据模型。对于尚未关联到 PlayFab 账户的 Steam 标识符，将返回 null。
PFAccountManagementGetPlayFabIDsFromTwitchIDsRequest	PFAccountManagementGetPlayFabIDsFromTwitchIDsRequest 数据模型。
PFAccountManagementGetPlayFabIDsFromTwitchIDsResult	PFAccountManagementGetPlayFabIDsFromTwitchIDsResult 数据模型。对于尚未关联到 PlayFab 账户的 Twitch 标识符，将返回 null。
PFAccountManagementGetPlayFabIDsFromXboxLiveIDsRequest	PFAccountManagementGetPlayFabIDsFromXboxLiveIDsRequest 数据模型。
PFAccountManagementGetPlayFabIDsFromXboxLiveIDsResult	PFAccountManagementGetPlayFabIDsFromXboxLiveIDsResult 数据模型。对于尚未关联到 PlayFab 账户的 XboxLive 标识符，将返回 null。
PFAccountManagementGetServerCustomIDsFromPlayFabIDsRequest	PFAccountManagementGetServerCustomIDsFromPlayFabIDsRequest 数据模型。
PFAccountManagementGetServerCustomIDsFromPlayFabIDsResult	PFAccountManagementGetServerCustomIDsFromPlayFabIDsResult 数据模型。对于未与服务器自定义身份关联的 PlayFab 账户，ServerCustomId 将为 null。
PFAccountManagementGetTitlePlayersFromProviderIDsResponse	PFAccountManagementGetTitlePlayersFromProviderIDsResponse 数据模型。
PFAccountManagementGetTitlePlayersFromXboxLiveIDsRequest	PFAccountManagementGetTitlePlayersFromXboxLiveIDsRequest 数据模型。给定一组 XBOX ID (XUID)，返回所有标题玩家账户。
PFAccountManagementGetUserAccountInfoRequest	PFAccountManagementGetUserAccountInfoRequest 数据模型。此 API 允许访问有关 PlayFab 服务中用户的详细信息，通常用于客户支持目的。请注意，返回的数据可能是个人身份信息 (PII)，例如电子邮件地址，因此在存储和管理此类数据时应予以注意。由于此调用始终会返回已访问该标题的用户的相关信息，建议不要在本地存储此类数据。
PFAccountManagementGetUserAccountInfoResult	PFAccountManagementGetUserAccountInfoResult 数据模型。
PFAccountManagementGetUserBansRequest	PFAccountManagementGetUserBansRequest 数据模型。获取用户的所有封禁，包括非活动和已过期的封禁。
PFAccountManagementGetUserBansResult	PFAccountManagementGetUserBansResult 数据模型。
PFAccountManagementGooglePlayFabIdPair	PFAccountManagementGooglePlayFabIdPair 数据模型。
PFAccountManagementGooglePlayGamesPlayFabIdPair	PFAccountManagementGooglePlayGamesPlayFabIdPair 数据模型。
PFAccountManagementKongregatePlayFabIdPair	PFAccountManagementKongregatePlayFabIdPair 数据模型。
PFAccountManagementLinkAndroidDeviceIDRequest	PFAccountManagementLinkAndroidDeviceIDRequest 数据模型。
PFAccountManagementLinkAppleRequest	PFAccountManagementLinkAppleRequest 数据模型。
PFAccountManagementLinkCustomIDRequest	PFAccountManagementLinkCustomIDRequest 数据模型。
PFAccountManagementLinkFacebookAccountRequest	PFAccountManagementLinkFacebookAccountRequest 数据模型。 Facebook 登录使用 Facebook 用户访问令牌完成。关于该令牌的更多信息可在 Facebook 开发者文档中找到 (https://developers.facebook.com/docs/facebook-login/access-tokens/)。例如在 Unity 中，该令牌可通过 Facebook SDK ScriptableObject FB 中的 AccessToken 获得。请注意，标题绝不应在不同的 PlayFab Title ID 之间重复使用相同的 Facebook 应用程序，因为 Facebook 为每个应用程序提供唯一的用户 ID，这样做可能导致 Facebook ID 与用户的 PlayFab 账户信息之间出现问题。如果必须在新的 PlayFab Title ID 中重复使用某个应用程序，请务必先从 Facebook 取消关联所有账户，或删除第一个 Title ID 中的所有用户。
PFAccountManagementLinkFacebookInstantGamesIdRequest	PFAccountManagementLinkFacebookInstantGamesIdRequest 数据模型。
PFAccountManagementLinkGameCenterAccountRequest	PFAccountManagementLinkGameCenterAccountRequest 数据模型。
PFAccountManagementLinkGoogleAccountRequest	PFAccountManagementLinkGoogleAccountRequest 数据模型。 Google 登录通过在设备上使用 Google Android 版登录 API 获取 Google OAuth 2.0 凭据并将其传递给此 API 来完成。
PFAccountManagementLinkGooglePlayGamesServicesAccountRequest	PFAccountManagementLinkGooglePlayGamesServicesAccountRequest 数据模型。 Google Play Games 登录通过在设备上使用 Google Play Games Android 版登录 API 获取 Google OAuth 2.0 凭据并将其传递给此 API 来完成。
PFAccountManagementLinkIOSDeviceIDRequest	PFAccountManagementLinkIOSDeviceIDRequest 数据模型。
PFAccountManagementLinkKongregateAccountRequest	PFAccountManagementLinkKongregateAccountRequest 数据模型。
PFAccountManagementLinkNintendoServiceAccountSubjectRequest	PFAccountManagementLinkNintendoServiceAccountSubjectRequest 数据模型。
PFAccountManagementLinkOpenIdConnectRequest	PFAccountManagementLinkOpenIdConnectRequest 数据模型。
PFAccountManagementLinkServerCustomIdRequest	PFAccountManagementLinkServerCustomIdRequest 数据模型。
PFAccountManagementLinkSteamAccountRequest	PFAccountManagementLinkSteamAccountRequest 数据模型。 Steam 身份验证通过 Steam Session Ticket 完成。关于该票证的更多信息可在 Steamworks SDK 中找到：https://partner.steamgames.com/documentation/auth（需要登录）。注意：要使 Steam 身份验证正常工作，标题必须在 PlayFab Game Manager 中（在 Properties 下）配置 Steam Application ID 和 Publisher Key。有关为您的标题创建 Publisher Key（在 PlayFab 中称为 Secret Key）的信息，请参见：https://partner.steamgames.com/documentation/webapi#publisherkey。
PFAccountManagementLinkSteamIdRequest	PFAccountManagementLinkSteamIdRequest 数据模型。
PFAccountManagementLinkTwitchAccountRequest	PFAccountManagementLinkTwitchAccountRequest 数据模型。
PFAccountManagementNintendoServiceAccountPlayFabIdPair	PFAccountManagementNintendoServiceAccountPlayFabIdPair 数据模型。
PFAccountManagementNintendoSwitchPlayFabIdPair	PFAccountManagementNintendoSwitchPlayFabIdPair 数据模型。
PFAccountManagementPSNAccountPlayFabIdPair	PFAccountManagementPSNAccountPlayFabIdPair 数据模型。
PFAccountManagementPSNOnlinePlayFabIdPair	PFAccountManagementPSNOnlinePlayFabIdPair 数据模型。
PFAccountManagementRemoveContactEmailRequest	PFAccountManagementRemoveContactEmailRequest 数据模型。此 API 从玩家的个人资料中移除现有的联系电子邮件。
PFAccountManagementReportPlayerClientRequest	PFAccountManagementReportPlayerClientRequest 数据模型。
PFAccountManagementReportPlayerClientResult	PFAccountManagementReportPlayerClientResult 数据模型。玩家目前每天限制五次举报。单个用户账户尝试提交超过五次的举报将导致 Updated 返回为 false。
PFAccountManagementRevokeAllBansForUserRequest	PFAccountManagementRevokeAllBansForUserRequest 数据模型。将用户所有未过期封禁的活动状态设置为“非活动”。但活动状态为“活动”的已过期封禁将被忽略。仅返回有关已应用更新的信息。
PFAccountManagementRevokeAllBansForUserResult	PFAccountManagementRevokeAllBansForUserResult 数据模型。
PFAccountManagementRevokeBansRequest	PFAccountManagementRevokeBansRequest 数据模型。将所请求的所有封禁的活动状态设置为“非活动”，无论该封禁是否已过期。不存在的 BanId 将被跳过。仅返回有关已应用更新的信息。
PFAccountManagementRevokeBansResult	PFAccountManagementRevokeBansResult 数据模型。
PFAccountManagementSendAccountRecoveryEmailRequest	PFAccountManagementSendAccountRecoveryEmailRequest 数据模型。如果相关账户是“临时”账户（例如，通过调用 LoginFromIOSDeviceID 创建的账户），此函数将无效。只有具有有效电子邮件地址的 PlayFab 账户才能使用此 API 接收密码重置电子邮件。
PFAccountManagementSendCustomAccountRecoveryEmailRequest	PFAccountManagementSendCustomAccountRecoveryEmailRequest 数据模型。具有有效电子邮件地址或用户名的 PlayFab 账户将能够使用此 API 接收密码重置电子邮件。所发送的电子邮件必须是账户恢复电子邮件模板。可以传入用户名或电子邮件以发送该电子邮件。
PFAccountManagementSendEmailFromTemplateRequest	PFAccountManagementSendEmailFromTemplateRequest 数据模型。仅向拥有关联联系电子邮件的玩家发送电子邮件。传入用于指定要发送的电子邮件模板的电子邮件模板 ID。
PFAccountManagementServerCustomIDPlayFabIDPair	PFAccountManagementServerCustomIDPlayFabIDPair 数据模型。
PFAccountManagementServerLinkNintendoServiceAccountRequest	PFAccountManagementServerLinkNintendoServiceAccountRequest 数据模型。
PFAccountManagementServerLinkNintendoSwitchDeviceIdRequest	PFAccountManagementServerLinkNintendoSwitchDeviceIdRequest 数据模型。
PFAccountManagementServerLinkPSNAccountRequest	PFAccountManagementServerLinkPSNAccountRequest 数据模型。
PFAccountManagementServerLinkXboxAccountRequest	PFAccountManagementServerLinkXboxAccountRequest 数据模型。
PFAccountManagementServerUnlinkNintendoServiceAccountRequest	PFAccountManagementServerUnlinkNintendoServiceAccountRequest 数据模型。
PFAccountManagementServerUnlinkNintendoSwitchDeviceIdRequest	PFAccountManagementServerUnlinkNintendoSwitchDeviceIdRequest 数据模型。
PFAccountManagementServerUnlinkPSNAccountRequest	PFAccountManagementServerUnlinkPSNAccountRequest 数据模型。
PFAccountManagementServerUnlinkXboxAccountRequest	PFAccountManagementServerUnlinkXboxAccountRequest 数据模型。
PFAccountManagementServerUpdateAvatarUrlRequest	PFAccountManagementServerUpdateAvatarUrlRequest 数据模型。
PFAccountManagementSteamPlayFabIdPair	PFAccountManagementSteamPlayFabIdPair 数据模型。
PFAccountManagementTwitchPlayFabIdPair	PFAccountManagementTwitchPlayFabIdPair 数据模型。
PFAccountManagementUnlinkAndroidDeviceIDRequest	PFAccountManagementUnlinkAndroidDeviceIDRequest 数据模型。
PFAccountManagementUnlinkAppleRequest	PFAccountManagementUnlinkAppleRequest 数据模型。
PFAccountManagementUnlinkCustomIDRequest	PFAccountManagementUnlinkCustomIDRequest 数据模型。
PFAccountManagementUnlinkFacebookAccountRequest	PFAccountManagementUnlinkFacebookAccountRequest 数据模型。
PFAccountManagementUnlinkFacebookInstantGamesIdRequest	PFAccountManagementUnlinkFacebookInstantGamesIdRequest 数据模型。
PFAccountManagementUnlinkGameCenterAccountRequest	PFAccountManagementUnlinkGameCenterAccountRequest 数据模型。
PFAccountManagementUnlinkGoogleAccountRequest	PFAccountManagementUnlinkGoogleAccountRequest 数据模型。
PFAccountManagementUnlinkGooglePlayGamesServicesAccountRequest	PFAccountManagementUnlinkGooglePlayGamesServicesAccountRequest 数据模型。
PFAccountManagementUnlinkIOSDeviceIDRequest	PFAccountManagementUnlinkIOSDeviceIDRequest 数据模型。
PFAccountManagementUnlinkKongregateAccountRequest	PFAccountManagementUnlinkKongregateAccountRequest 数据模型。
PFAccountManagementUnlinkOpenIdConnectRequest	PFAccountManagementUnlinkOpenIdConnectRequest 数据模型。
PFAccountManagementUnlinkServerCustomIdRequest	PFAccountManagementUnlinkServerCustomIdRequest 数据模型。
PFAccountManagementUnlinkSteamAccountRequest	PFAccountManagementUnlinkSteamAccountRequest 数据模型。
PFAccountManagementUnlinkSteamIdRequest	PFAccountManagementUnlinkSteamIdRequest 数据模型。
PFAccountManagementUnlinkTwitchAccountRequest	PFAccountManagementUnlinkTwitchAccountRequest 数据模型。
PFAccountManagementUpdateBanRequest	PFAccountManagementUpdateBanRequest 数据模型。表示单个封禁更新请求。
PFAccountManagementUpdateBansRequest	PFAccountManagementUpdateBansRequest 数据模型。对于每个封禁，仅更新已设置的值。将任何值设为 null 表示不更改。如果未找到某个封禁，其余封禁仍会应用。仅返回有关已应用更新的信息。
PFAccountManagementUpdateBansResult	PFAccountManagementUpdateBansResult 数据模型。
PFAccountManagementUpdateUserTitleDisplayNameRequest	PFAccountManagementUpdateUserTitleDisplayNameRequest 数据模型。除了 PlayFab 用户名之外，标题还可以使用 DisplayName，这同样是唯一标识符，但特定于该标题。这样便可以使用与标题主题或类型更加匹配的唯一名称，例如。
PFAccountManagementUpdateUserTitleDisplayNameResult	PFAccountManagementUpdateUserTitleDisplayNameResult 数据模型。
PFAccountManagementXboxLiveAccountPlayFabIdPair	PFAccountManagementXboxLiveAccountPlayFabIdPair 数据模型。

状态更改

状态更改	说明

枚举

枚举	说明
PFAccountManagementUserFamilyType	UserFamilyType 枚举。

最后修改于 2026年8月24日

相关主题

PFAccountManagementUserFamilyType PFAccountManagementLinkSteamAccountRequest PFAccountManagementLinkTwitchAccountRequest PFAccountManagementServerLinkPSNAccountRequest PFAccountManagementLinkFacebookAccountRequest

⌘I