> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PlayFab Services SDK 2026 年发行说明

> PlayFab Services SDK 2026 年发行说明，列出各版本中的 SDK 版本更新、新增 API、功能更改、弃用内容和错误修复。

> [!NOTE]
>
> 有关服务发布和产品更新的发行说明，请参阅 [PlayFab 的公开 GitHub 存储库](https://github.com/PlayFab/PlayFab)中的[发行说明](https://github.com/PlayFab/PlayFab/releases)部分。

## 260922

日期：2026 年 9 月 22 日

* 在 Admin、Client 和 Server API 中向 `UserPsnInfo` 添加了 `IssuerId` 字段，该字段报告帐户所对应的 PlayStation Network 颁发者环境。
* 更新了 Client 和 Server API 中 `GetPlayFabIDsFromPSNAccountIDs` 和 `GetPlayFabIDsFromPSNOnlineIDs` 以及 Server API 中 `LinkPSNId` 的 `IssuerId` 和 `SandboxId` 说明，阐明沙盒成员身份是按帐户确定的，并且值不匹配时会返回 null `PlayFabId` 而不是错误。
* 在 Multiplayer API 中向 `GetBuild` 响应添加了 `GameSecretReferences` 字段。
* 在 Server API 中向帐户关联、取消关联和服务器登录调用添加了 `AccountNotFound` 和 `InvalidNamespaceMismatch` 错误代码。
* 在 Server API 中向 `LinkTwitchAccount` 添加了 `LinkedAccountAlreadyClaimed` 错误代码。
* 从 Insights API 中的 `SetPerformance` 中删除了 `InsightsManagementNewActiveEventExportLimitInvalid` 错误代码，并阐明 `ActiveEventExports` 始终为零。

## 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 中针对配置文件和组版本检查的并发控制说明
* 添加了新服务错误的错误代码

## 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`
* 添加了新服务错误的错误代码


## Related topics

- [PlayFab Services SDK 2026 年发行说明](https://docs.xbox.com/zh-CN/tools/tools-pc/xbox-pc-remote-tools/release-notes/index.md)
- [PlayFab Services SDK 2025 年发行说明](https://docs.xbox.com/zh-CN/services/playfab/release-notes/2025.md)
- [PlayFab Multiplayer C++ SDK 发行说明](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [PlayFab Party 发行说明](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/release-notes.md)
- [PlayFab Services C/C++ SDK 发行说明](https://docs.xbox.com/zh-CN/services/playfab/release-notes/playfab-c/index.md)