> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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)中的 [release notes](https://github.com/PlayFab/PlayFab/releases) 部分。
</Note>

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


## Related topics

- [PlayFab Services SDK 2026 发行说明](/zh-CN/services/playfab/release-notes/index.md)
- [PlayFab Party 发行说明](/zh-CN/services/playfab/multiplayer/networking/release-notes.md)
- [PlayFab Multiplayer C++ SDK 发行说明](/zh-CN/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [PlayFab Party XBOX Live 辅助库发行说明](/zh-CN/services/playfab/multiplayer/networking/party-xboxlive-relnotes.md)
- [PlayFab Services C/C++ SDK 发行说明](/zh-CN/services/playfab/release-notes/playfab-c/index.md)