PlayFab Services SDK 2026 发行说明

​

260805

日期：2026 年 8 月 5 日

• 在 Admin API 中新增了 IP 封禁管理，包括 CreateIPBan、UpdateIPBan、RevokeIPBan、GetIPBansForIP 和 GetIPBansForTitle，同时支持单个 IP 地址与 CIDR 范围。
• 在 Client 与 Server API 的 LinkPSNAccount 与 LoginWithPSN 请求中新增了可选的 AuthVersion 字段，用于选择 PlayStation Network 认证版本。
• 在 Client 与 Server API 的 GetPlayFabIDsFromPSNAccountIDs 与 GetPlayFabIDsFromPSNOnlineIDs，以及 Server API 的 LinkPSNId 中新增了可选的 SandboxId 字段。
• 在 Client 与 Server API 的 GetPlayFabIDsFromNintendoServiceAccountIds 中新增了可选的 Issuer 字段，用于将查找范围限定到 Nintendo 环境。
• 在 Multiplayer API 的 AzureRegion 枚举中新增了 27 个 Azure 区域，包括 CanadaEast、UkWest、SpainCentral、ItalyNorth、PolandCentral 和 IsraelCentral。
• 在 Admin API 的 CreateActionsOnPlayersInSegmentTask 中新增了 CatalogBadRequest 错误代码。
• 在多个 API 中新增了 PSNNextGenNotConfiguredForTitle 和 InvalidNintendoIssuer 错误代码。

​

260526

日期：2026 年 5 月 26 日

• 从 Admin 与 Server API 中移除了已弃用的 GetPlayersInSegment 请求与响应模型。
• 在 Admin 与 Server API 中新增了 GetSegmentPlayerCount 请求与响应模型。
• 在 Admin API 的 AddNews 中新增了对 NewsStatus 枚举与 Status 字段的支持。
• 更新了 Authentication API 中 GetEntityToken 的文档，并将可选的 Entity 请求字段标记为待弃用。
• 作为弃用清理的一部分，跨多个 API 移除了已停用的错误代码。

​

260512

日期：2026 年 5 月 12 日

• 向 Server API 新增了 UnlinkApple 与 UnlinkGameCenterAccount
• 向 Progression API 的 UpdateStatistics 新增了 EntityIsNotAMember 与 InvalidEntityTypeForAggregation 错误
• 在多个 API 中新增了 StatisticVersionIncrementNotAllowedWhileLinked 错误代码
• 更新了 Data、Groups 与 Profiles API 中关于 profile 与 group 版本校验的并发控制描述
• 为新的服务错误添加了错误代码

​

260424

日期：2026 年 4 月 24 日

• 在 Multiplayer 与 Events API 的多个调用中新增了 ProductDisabledForTitle 错误代码
• 在 Admin 与 Server API 的分段玩家获取中新增了 GetPlayersInSegmentRetired 错误代码
• 在 Admin API 中新增了 EventSinkResourceMisconfigured 错误代码
• 更新了 Economy API GetTransactionHistory 的文档，明确了限制（默认 50 条事件，启用响应压缩时 250 条）
• 更新了 Progression API 的 GetFriendLeaderboardForEntity 请求示例

​

260410

日期：2026 年 4 月 10 日

• 向 Admin API 新增了 ValidateApiPolicy
• 向 Server API 新增了 ExportPlayersInSegment 与 GetSegmentExport
• 在 Progression API 的统计更新请求中新增了 AggregationTargetEntityKeys 字段
• 向 Multiplayer API 新增了 WestUs3 Azure 区域
• 向 Multiplayer API 新增了新的 VM 系列与规格（Fasv6、Fasv7、Fadsv7、Eadsv5、Eadsv6、Eadsv7、Dadsv7）
• 为新的服务错误添加了错误代码

​

260327

日期：2026 年 3 月 27 日

• 向 Profiles API 的 GetEntityProfile 与 GetEntityProfiles 新增了 IncludeStatistics 参数
• 在 Profiles API 的实体档案响应中新增了 StatisticsColumnDetails 字段
• 在 Admin API 的 GetPolicy 响应中新增了 LastUpdated 字段
• 在 Admin API 的 UpdatePolicy 响应中新增了 Warnings 字段
• 更新了 Admin API 中 GetPolicy 与 UpdatePolicy 请求参数的文档
• 在 Economy API 的 GetInventoryItems 与 TransferInventoryItems 中新增了 PreconditionFailed 错误代码
• 在 Progression API 中新增了 StatisticUpdateNotAllowedWhileLinked 错误代码
• 为新的服务错误添加了错误代码

​

260313

日期：2026 年 3 月 13 日

• 将 GetPlayersInSegmentDeprecated 错误代码重命名为 GetPlayersInSegmentRetired
• 更新了 Client 与 Server API 中 GetFriendsList 的文档，以说明 XBOX 好友行为
• 更新了 Multiplayer API 中 FindFriendLobbies 的文档，以说明互为好友的要求
• 在 Client、Server、Admin 与 Experimentation API 的多个调用中新增了 ProductDisabledForTitle 错误代码
• 为新的服务错误添加了错误代码

​

260227

日期：2026 年 2 月 27 日

• 在 Client、Server 与 Admin API 的多个调用中新增了 ProductDisabledForTitle 错误代码
• 为新的服务错误添加了错误代码

​

260213

日期：2026 年 2 月 13 日

• 向 Server API 新增了 AddOrUpdateContactEmail
• 向 Multiplayer API 新增了 PubSub 连接生命周期扩展支持
• 为新的服务错误添加了错误代码

​

260123

日期：2026 年 1 月 23 日

• 从 Economy API 移除了 GetMicrosoftStoreAccessTokens
• 为新的服务错误添加了错误代码

​

260109

日期：2026 年 1 月 9 日

• 向 Server API 新增了以下调用：
  • UnlinkFacebookAccount
  • UnlinkFacebookInstantGamesId
• 为新的服务错误添加了错误代码