> ## 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.

# 配置文件写入计量 API 说明

> PlayFab API 参考列表，包括 AddPlayerTag 和虚拟货币更新等针对玩家与实体数据累加配置文件写入计量的 API。

Profile 包括与玩家配置文件、实体配置文件、角色配置文件、组和库存相关的任何存储数据。配置文件数据是适用于单个玩家、玩家组或物品的信息，由 PlayFab 以键/值对（KVP）形式存储。

以下 API 会导致配置文件写入计量累加。

## Admin API

* [AddPlayerTag](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/playstream/addplayertag?) 向玩家配置文件添加给定的标签。标签的命名空间会根据标签来源自动生成。
* [AddUserVirtualCurrency](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-item-management/adduservirtualcurrency?) 将指定虚拟货币按所述数量递增
* [AddVirtualCurrencyTypes](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/title-wide-data-management/addvirtualcurrencytypes?) 向为标题定义的集合中添加一种或多种虚拟货币。授予玩家时，虚拟货币的最大值为 2,147,483,647。任何超过该值的数值都将被丢弃。
* [BanUsers](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/account-management/banusers?) 通过 PlayFab ID 封禁用户，可为所提供的游戏提供可选的 IP 地址。
* [CreateActionsOnPlayersInSegmentTask](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/scheduledtask/createactionsonplayersinsegmenttask?) 创建 ActionsOnPlayersInSegment 任务，遍历细分中的所有玩家以执行操作。
* [CreatePlayerSharedSecret](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/authentication/createplayersharedsecret?) 创建新的玩家共享密钥。该 API 返回后，此密钥可能需要最多 5 分钟才能普遍可用。
* [CreatePlayerStatisticDefinition](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/createplayerstatisticdefinition?) 向标题添加新的玩家统计信息配置，可选允许开发者指定重置间隔和聚合方法。
* [DeleteMasterPlayerAccount](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/account-management/deletemasterplayeraccount?) 从所有标题中完全删除主玩家账户，并删除所有相关联的数据。
* [DeletePlayer](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/account-management/deleteplayer?) 从标题中删除用户的玩家账户，并删除所有相关联的数据
* [DeletePlayerSharedSecret](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/authentication/deleteplayersharedsecret?) 删除现有的玩家共享密钥。该 API 返回后，此删除操作可能需要最多 5 分钟才能生效。
* [DeleteStore](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/title-wide-data-management/deletestore?) 删除现有的虚拟物品商店。
* [DeleteTitle](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/account-management/deletetitle?) 永久删除标题及所有相关联的配置。
* [GrantItemsToUsers](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-item-management/grantitemstousers?) 将指定物品添加到指定用户库存
* [IncrementLimitedEditionItemAvailability](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-item-management/incrementlimitededitionitemavailability?) 增加给定稀缺资源的全局数量。
* [IncrementPlayerStatisticVersion](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/incrementplayerstatisticversion?) 重置指定的统计信息，删除该统计信息的所有玩家条目并备份旧值。
* [RefundPurchase](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/refundpurchase?) 尝试通过原始真实货币支付提供商处理订单退款。""
* [RemovePlayerTag](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/playstream/removeplayertag?) 从玩家配置文件中移除给定标签。标签的命名空间根据标签来源自动生成。
* [RemoveVirtualCurrencyTypes](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/title-wide-data-management/removevirtualcurrencytypes?) 从为标题定义的集合中移除一种或多种虚拟货币。
* [ResetCharacterStatistics](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/characters/resetcharacterstatistics?) 完全移除当前游戏中指定角色的所有统计信息。
* [ResetUserStatistics](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/resetuserstatistics?) 完全移除当前游戏中指定用户的所有统计信息。
* [ResolvePurchaseDispute](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/resolvepurchasedispute?) 尝试与原订单的支付提供商解决争议。
* [RevokeAllBansForUser](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/account-management/revokeallbansforuser?) 撤销用户的所有活动封禁。
* [RevokeBans](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/account-management/revokebans?) 撤销所有以 BanId 指定的活动封禁。
* [RevokeInventoryItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-item-management/revokeinventoryitem?) 撤销对用户库存中某项物品的访问权限
* [RevokeInventoryItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-item-management/revokeinventoryitems?) 撤销跨多个用户和角色最多 25 个物品的访问权限。
* [SetCatalogItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/title-wide-data-management/setcatalogitems?) 为指定目录版本创建所有虚拟商品的目录配置。
* [SetPlayerSecret](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/authentication/setplayersecret?) 设置或重置玩家密钥。玩家密钥用于签名 API 请求。
* [SetPublishedRevision](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/server-side-cloud-script/setpublishedrevision?) 设置标题 Cloud Script 的当前发布修订版本。
* [SetPublisherData](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/shared-group-data/setpublisherdata?) 更新自定义发布者设置的键值存储
* [SetStoreItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/title-wide-data-management/setstoreitems?) 设置一个虚拟商店中的所有物品。
* [SetTitleData](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/title-wide-data-management/settitledata?) 创建并更新客户端可读取的自定义标题设置的键值存储。
* [SetTitleInternalData](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/title-wide-data-management/settitleinternaldata?) 更新客户端无法读取的自定义标题设置的键值存储。
* [SubtractUserVirtualCurrency](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-item-management/subtractuservirtualcurrency?) 将指定虚拟货币按所述数量递减。
* [UpdateBans](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/account-management/updatebans?) 更新以 Ban Id 指定的现有封禁列表的信息。
* [UpdateCatalogItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/title-wide-data-management/updatecatalogitems?) 更新指定目录版本中虚拟商品的目录配置。
* [UpdatePlayerSharedSecret](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/authentication/updateplayersharedsecret?) 更新现有的玩家共享密钥。该 API 返回后，此更新可能需要最多 5 分钟才能普遍可用。
* [UpdatePlayerStatisticDefinition](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/updateplayerstatisticdefinition?) 更新标题的玩家统计信息配置，可选允许开发者指定重置间隔。
* [UpdateRandomResultTables](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/title-wide-data-management/updaterandomresulttables?) 更新标题的随机掉落表配置
* [UpdateStoreItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/title-wide-data-management/updatestoreitems?) 使用新的或修改的物品更新现有的虚拟物品商店。
* [UpdateUserData](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/updateuserdata?) 更新用户可由客户端读写的标题特定自定义数据。
* [UpdateUserInternalData](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/updateuserinternaldata?) 更新用户的标题特定自定义数据，客户端无法访问。
* [UpdateUserPublisherData](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/updateuserpublisherdata?) 更新用户可由客户端读写的发布者特定自定义数据。
* [UpdateUserPublisherInternalData](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/updateuserpublisherinternaldata?) 更新用户的发布者特定自定义数据，客户端无法访问。
* [UpdateUserPublisherReadOnlyData](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/updateuserpublisherreadonlydata?) 更新用户仅可由客户端读取的发布者特定自定义数据。
* [UpdateUserReadOnlyData](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/updateuserreadonlydata?) 更新用户仅可由客户端读取的标题特定自定义数据。
* [UpdateUserTitleDisplayName](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/account-management/updateusertitledisplayname?) 更新用户的标题特定显示名称。

## Client API

* [AcceptTrade](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/trading/accepttrade?) 接受尚未被接受或取消的开放交易——前提是本地登录玩家在该交易的允许玩家列表中，或该交易对所有玩家开放。若调用成功，报价和接受的物品将在两位玩家的库存之间交换。
* [AddFriend](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/friend-list-management/addfriend?) 根据提供的唯一标识符匹配，将 PlayFab 用户添加到本地用户的好友列表。至少需要初始化 FriendPlayFabId、FriendUsername、FriendEmail 或 FriendTitleDisplayName 之一。
* [AddGenericID](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/addgenericid?) 将指定的通用服务标识符添加到玩家的 PlayFab 账户。这样做旨在允许对标题希望添加的任意服务标识符进行 PlayFab ID 查找。此标识符不应用作身份验证凭据，因为其目的是可被其他玩家轻松访问。
* [AddOrUpdateContactEmail](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/addorupdatecontactemail?) 向玩家配置文件添加或更新联系电子邮件。
* [AddSharedGroupMembers](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/shared-group-data/addsharedgroupmembers?) 将用户添加到能够更新共享数据以及组内成员集合的用户集合。只有组内用户（和服务器）可添加新成员。共享组适用于极少数玩家之间共享数据，见 [使用共享组数据](/services/playfab/community/associations/groups/using-shared-group-data)。
* [AddUsernamePassword](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/addusernamepassword?) 向通过匿名身份验证方式（例如自动设备 ID 登录）创建的现有账户添加 PlayFab 用户名/密码身份验证。
* [AndroidDevicePushNotificationRegistration](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/platform-specific-methods/androiddevicepushnotificationregistration?) 注册 Android 设备以接收推送通知
* [ConsumePSNEntitlements](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/platform-specific-methods/consumepsnentitlements?) 检查是否有新的可消耗权利。如果有，将被消耗并作为 PlayFab 物品添加。
* [ConsumeXboxEntitlements](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/platform-specific-methods/consumexboxentitlements?) 授予玩家当前从 XBOX Live 获得的权利，消耗 XBOX 中所有可用物品并将其授予玩家的 PlayFab 库存。此调用是幂等的，不会向玩家授予先前已授予的物品。
* [CreateSharedGroup](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/shared-group-data/createsharedgroup?) 请求创建共享组对象，其中包含可由该组所有成员更新的键/值对。创建时，当前用户将是组的唯一成员。共享组适用于极少数玩家之间共享数据。更多信息请参阅 [使用共享组数据](/services/playfab/community/associations/groups/using-shared-group-data)。
* [GrantCharacterToUser](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/characters/grantcharactertouser?) 向用户授予指定角色类型。CharacterIds 不是全局唯一的；必须结合父级 PlayFabId 评估 characterId 以保证唯一性。
* [LinkAndroidDeviceID](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/linkandroiddeviceid?) 将 Android 设备标识符链接到用户的 PlayFab 账户
* [LinkCustomID](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/linkcustomid?) 将由标题生成的自定义标识符链接到用户的 PlayFab 账户。
* [LinkFacebookAccount](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/linkfacebookaccount?) 将与提供的 Facebook 访问令牌关联的 Facebook 账户链接到用户的 PlayFab 账户。
* [LinkFacebookInstantGamesId](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/linkfacebookinstantgamesid?) 将 Facebook Instant Games Id 链接到用户的 PlayFab 账户。
* [LinkGameCenterAccount](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/linkgamecenteraccount?) 将与提供的 Game Center ID 关联的 Game Center 账户链接到用户的 PlayFab 账户。
* [LinkGoogleAccount](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/linkgoogleaccount?) 使用 Google 账户凭据将当前登录的用户账户链接到其 Google 账户。
* [LinkIOSDeviceID](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/linkiosdeviceid?) 将特定供应商的 iOS 设备标识符链接到用户的 PlayFab 账户。
* [LinkKongregate](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/linkkongregate?) 将 Kongregate 标识符链接到用户的 PlayFab 账户。
* [LinkNintendoSwitchDeviceId](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/linknintendoswitchdeviceid?) 将 NintendoSwitchDeviceId 链接到用户的 PlayFab 账户。
* [LinkOpenIdConnect](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/linkopenidconnect?) 基于标题与 Open ID Connect 提供者的现有关系以及该提供者的 OpenId Connect JWT，将 OpenID Connect 账户链接到用户的 PlayFab 账户。
* [LinkPSNAccount](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/linkpsnaccount?) 将与提供的访问代码关联的 PlayStation™Network 账户链接到用户的 PlayFab 账户。
* [LinkSteamAccount](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/linksteamaccount?) 将与提供的 Steam 身份验证凭证关联的 Steam 账户链接到用户的 PlayFab 账户。
* [LinkTwitch](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/linktwitch?) 将与令牌关联的 Twitch 账户链接到用户的 PlayFab 账户。
* [LinkXboxAccount](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/linkxboxaccount?) 将与提供的访问代码关联的 XBOX Live 账户链接到用户的 PlayFab 账户。
* [OpenTrade](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/trading/opentrade?) 开启新的未处理交易。请注意，任何给定的物品实例一次只能存在于一笔开放交易中。
* [PurchaseItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/player-item-management/purchaseitem?) 用虚拟货币购买单件物品。你必须同时指定用于购买的虚拟货币，以及客户端所认为的价格。这样，如果价格已更改，服务器可以让购买失败。
* [PayForPurchase](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/player-item-management/payforpurchase?) 为通过 StartPurchase 创建的采购订单选择支付方式
* [RegisterForIOSPushNotification](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/platform-specific-methods/registerforiospushnotification?) 注册 iOS 设备以接收推送通知
* [RegisterPlayFabUser](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/authentication/registerplayfabuser?) 注册新的 PlayFab 用户账户，返回可用于后续需要身份验证的 API 调用的会话标识符。你必须提供用户名或电子邮件地址。
* [RemoveContactEmail](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/removecontactemail?) 从玩家配置文件中移除联系电子邮件。
* [RemoveFriend](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/friend-list-management/removefriend?) 从本地用户的好友列表中移除指定用户。
* [RemoveGenericID](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/removegenericid?) 从玩家的 PlayFab 账户中移除指定的通用服务标识符。
* [RemoveSharedGroupMembers](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/shared-group-data/removesharedgroupmembers?) 从能够更新共享数据的用户集合以及组内用户集合中移除用户。只有组内用户可以移除成员。如果调用结果导致零用户拥有访问权限，则组及其相关数据将被删除。共享组适用于极少数玩家之间共享数据，见 [使用共享组数据](/services/playfab/community/associations/groups/using-shared-group-data)。
* [ReportAdActivity](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/advertising/reportadactivity?) 报告玩家的广告活动
* [ReportDeviceInfo](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/analytics/reportdeviceinfo?) 写入 PlayStream 事件以描述所提供的玩家设备信息。此 API 方法不适合开发者直接调用。每个 PlayFab 客户端 SDK 最终会自动报告此信息。
* [ReportPlayer](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/reportplayer?) 提交对另一玩家（因不当行为等）的举报，以便标题的客户服务代表可以对可能有害的玩家采取行动。
* [RestoreIOSPurchases](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/platform-specific-methods/restoreiospurchases?) 基于给定的恢复凭据恢复所有应用内购买
* [SetFriendTags](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/friend-list-management/setfriendtags?) 更新本地用户好友列表中指定用户的标签列表。
* [SubtractUserVirtualCurrency](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/player-item-management/subtractuservirtualcurrency?) 将用户指定虚拟货币的余额按所述数量递减。此 API 可使 VC 余额为负。
* [UnlinkAndroidDeviceID](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/unlinkandroiddeviceid?) 从用户的 PlayFab 账户取消相关 Android 设备标识符的链接。
* [UnlinkCustomID](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/unlinkcustomid?) 从用户的 PlayFab 账户取消相关自定义标识符的链接。
* [UnlinkFacebookAccount](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/unlinkfacebookaccount?) 从用户的 PlayFab 账户取消相关 Facebook 账户的链接。
* [UnlinkFacebookInstantGamesId](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/unlinkfacebookinstantgamesid?) 从用户的 PlayFab 账户取消相关 Facebook Instant Game Id 的链接。
* [UnlinkGameCenterAccount](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/unlinkgoogleaccount?) 从用户的 PlayFab 账户取消相关 Game Center 账户的链接。
* [UnlinkGoogleAccount](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/unlinkiosdeviceid?) 从用户的 PlayFab 账户取消相关 Google 账户的链接 ([https://developers.google.com/android/reference/com/google/android/gms/auth/GoogleAuthUtil#public-methods](https://developers.google.com/android/reference/com/google/android/gms/auth/GoogleAuthUtil#public-methods))。
* [UnlinkIOSDeviceID](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/unlinkiosdeviceid?) 从用户的 PlayFab 账户取消相关 iOS 设备标识符的链接。
* [UnlinkKongregate](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/unlinkkongregate?) 从用户的 PlayFab 账户取消相关 Kongregate 标识符的链接。
* [UnlinkNintendoSwitchDeviceId](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/unlinknintendoswitchdeviceid?) 从用户的 PlayFab 账户取消相关 NintendoSwitchDeviceId 的链接。
* [UnlinkOpenIdConnect](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/unlinkopenidconnect?) 基于标题与 Open ID Connect 提供者之间现有关系的连接 ID，从用户的 PlayFab 账户取消 OpenID Connect 账户的链接。
* [UnlinkPSNAccount](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/unlinkpsnaccount?) 从用户的 PlayFab 账户取消相关 PSN™ 账户的链接。
* [UnlinkSteamAccount](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/unlinksteamaccount?) 从用户的 PlayFab 账户取消相关 Steam 账户的链接。
* [UnlinkTwitch](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/unlinktwitch?) 从用户的 PlayFab 账户取消相关 Twitch 账户的链接。
* [UnlinkXboxAccount](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/unlinkxboxaccount?) 从用户的 PlayFab 账户取消相关 XBOX Live 账户的链接。
* [UnlockContainerInstance](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/player-item-management/unlockcontainerinstance?) 使用指定密钥（如需）打开指定容器，并返回打开容器的内容。若容器（以及相关密钥）是可消耗的（RemainingUses > 0），其 RemainingUses 将被递减，行为与 ConsumeItem 保持一致。
* [UnlockContainerItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/player-item-management/unlockcontaineritem?) 在目标库存中搜索匹配给定 CatalogItemId 的 ItemInstance，必要时使用合适的密钥解锁，并返回打开容器的内容。若容器（以及相关密钥）是可消耗的（RemainingUses > 0），其 RemainingUses 将被递减，行为与 ConsumeItem 保持一致。
* [UpdateAvatarUrl](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/updateavatarurl?) 更新玩家的头像 URL。
* [UpdateCharacterData](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/character-data/updatecharacterdata?) 创建并更新用户角色可由客户端读写的标题特定自定义数据
* [UpdateCharacterStatistics](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/characters/updatecharacterstatistics?) 更新指定角色的标题特定统计信息值。默认情况下，客户端不允许更新统计信息。开发者可以在 Game Manager > Settings > API Features 中覆盖此设置。
* [UpdatePlayerStatistics](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/player-data-management/updateplayerstatistics?) 更新用户的标题特定统计信息值。默认情况下，客户端不允许更新统计信息。开发者可以在 Game Manager > Settings > API Features 中覆盖此设置。
* [UpdateSharedGroupData](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/shared-group-data/updatesharedgroupdata?) 为共享组对象添加、更新和移除数据键。如果权限设置为 Public，则在此调用中更新或添加的所有字段都可以被非组成员读取。默认情况下，数据权限设置为 Private。无论权限设置如何，只有组内成员可以更新数据。共享组适用于极少数玩家之间共享数据，见 [使用共享组数据](/services/playfab/community/associations/groups/using-shared-group-data)。
* [UpdateUserData](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/player-data-management/updateuserdata?) 创建并更新用户可由客户端读写的标题特定自定义数据。
* [UpdateUserPublisherData](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/player-data-management/updateuserpublisherdata?) 创建并更新用户可由客户端读写的发布者特定自定义数据。
* [UpdateUserTitleDisplayName](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/updateusertitledisplayname?) 更新用户的标题特定显示名称

"PlayStation" 是 Sony Interactive Entertainment Inc. 的注册商标或商标。

"PSN" 是 Sony Interactive Entertainment Inc. 的注册商标或商标。

## Data API

* [SetObjects](https://learn.microsoft.com/en-us/rest/api/services/playfab/data/object/setobjects?) 在实体的配置文件上设置对象。

## Groups API

* [AcceptGroupApplication](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/acceptgroupapplication?) 接受加入组的未处理邀请
* [AcceptGroupInvitation](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/acceptgroupinvitation?) 接受加入组的邀请。
* [AddMembers](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/addmembers?) 向组或角色添加成员。
* [ApplyToGroup](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/applytogroup?) 申请加入组。
* [BlockEntity](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/blockentity?) 阻止实体列表加入组。
* [ChangeMemberRole](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/changememberrole?) 将实体列表的角色成员身份从一个角色更改为另一个角色。
* [CreateGroup](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/creategroup?) 创建新的组。
* [CreateRole](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/createrole?) 创建新的组角色。
* [DeleteGroup](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/deletegroup?) 删除组以及与之关联的所有角色、邀请、加入申请和阻止。
* [DeleteRole](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/deleterole?) 删除组中的现有角色。
* [InviteToGroup](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/invitetogroup?) 邀请玩家加入组。
* [RemoveGroupApplication](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/removegroupapplication?) 移除加入组的申请。
* [RemoveGroupInvitation](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/removegroupinvitation?) 移除加入组的邀请。
* [RemoveMembers](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/removemembers?) 从组中移除成员。
* [UnblockEntity](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/unblockentity?) 取消阻止实体列表加入组。
* [UpdateGroup](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/updategroup?) 更新组的非成员身份数据。
* [UpdateRole](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/updaterole?) 更新角色的元数据。

## Profile API

* [SetGlobalPolicy](https://learn.microsoft.com/en-us/rest/api/services/playfab/profiles/account-management/setglobalpolicy?) 设置全局标题访问策略。
* [SetProfileLanguage](https://learn.microsoft.com/en-us/rest/api/services/playfab/profiles/account-management/setprofilelanguage?) 更新实体的语言。与玩家沟通的优先级层次为：Title Player Account 语言、Master Player Account 语言，然后是标题默认语言（若前两者未设置或不受支持）。
* [SetProfilePolicy](https://learn.microsoft.com/en-us/rest/api/services/playfab/profiles/account-management/setprofilepolicy?) 设置配置文件访问策略。

## Server API

* [AddCharacterVirtualCurrency](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/addcharactervirtualcurrency?) 将角色指定虚拟货币的余额按所述数量递增。
* [AddFriend](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/friend-list-management/addfriend?) 将 Friend 用户添加到具有 PlayFabId 的用户的好友列表。至少需要初始化 FriendPlayFabId、FriendUsername、FriendEmail 或 FriendTitleDisplayName 之一。
* [AddGenericID](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/addgenericid?) 将指定的通用服务标识符添加到玩家的 PlayFab 账户。这样做旨在允许对标题希望添加的任意服务标识符进行 PlayFab ID 查找。此标识符不应用作身份验证凭据，因为其目的是可被其他玩家轻松访问。
* [AddPlayerTag](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/playstream/addplayertag?) 向玩家配置文件添加给定标签。标签的命名空间根据标签来源自动生成。
* [AddSharedGroupMembers](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/shared-group-data/addsharedgroupmembers?) 将用户添加到能够更新共享数据以及组内成员集合的用户集合。只有组内用户（和服务器）可添加新成员。共享组适用于极少数玩家之间共享数据，见 [使用共享组数据](/services/playfab/community/associations/groups/using-shared-group-data)。
* [AddUserVirtualCurrency](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/adduservirtualcurrency?) 将用户指定虚拟货币的余额按所述数量递增。
* [AwardSteamAchievement](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/platform-specific-methods/awardsteamachievement?) 向指定用户授予指定的 Steam 成就。
* [BanUsers](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/banusers?) 通过 PlayFab ID 封禁用户，可为所提供的游戏提供可选的 IP 地址。
* [ConsumeItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/consumeitem?) 消耗可消耗物品的使用次数。当所有使用次数用完时，将从玩家库存中移除。
* [CreateSharedGroup](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/shared-group-data/createsharedgroup?) 请求创建共享组对象，其中包含可由该组所有成员更新的键/值对。由服务器创建时，组最初没有成员。共享组适用于极少数玩家之间共享数据，见 [使用共享组数据](/services/playfab/community/associations/groups/using-shared-group-data)。
* [DeleteCharacterFromUser](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/characters/deletecharacterfromuser?) 从指定用户中删除特定角色 ID。
* [DeleteSharedGroup](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/shared-group-data/deletesharedgroup?) 删除共享组，释放共享组 ID 以供新组重用。共享组适用于极少数玩家之间共享数据，见 [使用共享组数据](/services/playfab/community/associations/groups/using-shared-group-data)。
* [GrantCharacterToUser](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/characters/grantcharactertouser?) 向用户授予指定角色类型。CharacterIds 不是全局唯一的；必须结合父级 PlayFabId 评估 characterId 以保证唯一性。
* [GrantItemsToCharacter](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/grantitemstocharacter?) 将指定物品添加到指定角色的库存。
* [GrantItemsToUser](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/grantitemstouser?) 将指定物品添加到指定用户的库存。
* [GrantItemsToUsers](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/grantitemstousers?) 将指定物品添加到指定用户库存。
* [LinkServerCustomId](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/linkservercustomid?) 将由标题生成的自定义服务器标识符链接到用户的 PlayFab 账户。
* [LinkXboxAccount](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/linkxboxaccount?) 将与提供的访问代码关联的 XBOX Live 账户链接到用户的 PlayFab 账户。
* [ModifyItemUses](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/modifyitemuses?) 修改玩家库存物品的剩余使用次数。
* [MoveItemToCharacterFromCharacter](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/moveitemtocharacterfromcharacter?) 将物品从一个角色的库存移动到该用户的另一个角色的库存中。
* [MoveItemToCharacterFromUser](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/moveitemtocharacterfromuser?) 将物品从用户的库存移动到其角色的库存中。
* [MoveItemToUserFromCharacter](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/moveitemtouserfromcharacter?) 将物品从角色的库存移动到所属用户的库存中。
* [RedeemCoupon](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/redeemcoupon?) 将与优惠券关联的虚拟商品添加到用户的库存。可通过 PlayFab Game Manager 中的 Economy->Catalogs 标签生成优惠券。
* [RemoveFriend](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/friend-list-management/removefriend?) 从用户的好友列表中移除指定的好友。
* [RemoveGenericID](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/removegenericid?) 从玩家的 PlayFab 账户中移除指定的通用服务标识符。
* [RemovePlayerTag](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/playstream/removeplayertag?) 从玩家配置文件中移除给定标签。标签的命名空间根据标签来源自动生成。
* [RemoveSharedGroupMembers](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/shared-group-data/removesharedgroupmembers?) 从能够更新共享数据的用户集合以及组内用户集合中移除用户。只有组内用户可以移除成员。如果调用结果导致零用户拥有访问权限，则组及其相关数据将被删除。共享组适用于极少数玩家之间共享数据，见 [使用共享组数据](/services/playfab/community/associations/groups/using-shared-group-data)。
* [RevokeAllBansForUser](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/revokeallbansforuser?) 撤销用户的所有活动封禁。
* [RevokeBans](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/revokebans?) 撤销所有以 BanId 指定的活动封禁。
* [RevokeInventoryItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/revokeinventoryitem?) 撤销对用户库存中某项物品的访问权限。
* [RevokeInventoryItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/revokeinventoryitems?) 撤销跨多个用户和角色最多 25 个物品的访问权限。
* [SetFriendTags](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/friend-list-management/setfriendtags?) 更新另一用户好友列表中指定用户的标签列表。
* [SetPlayerSecret](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/authentication/setplayersecret?) 如果玩家密钥尚未设置，则设置它。玩家密钥用于签名 API 请求。要重置玩家密钥，请使用 Admin 或 Server API 方法 SetPlayerSecret。
* [SetPublisherData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/title-wide-data-management/setpublisherdata?) 更新自定义发布者设置的键值存储。
* [SetTitleData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/title-wide-data-management/settitledata?) /rest/api/services/playfab/server/title-wide-data-management/setpublisherdata?
* [SetTitleInternalData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/title-wide-data-management/settitleinternaldata?) 更新自定义标题设置的键值存储
* [SubtractCharacterVirtualCurrency](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/subtractcharactervirtualcurrency?) 将角色指定虚拟货币的余额按所述数量递减。此 API 可使 VC 余额为负。
* [SubtractUserVirtualCurrency](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/subtractuservirtualcurrency?) 将用户指定虚拟货币的余额按所述数量递减。此 API 可使 VC 余额为负。
* [UnlinkServerCustomId](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/unlinkservercustomid?) 从用户的 PlayFab 账户取消自定义服务器标识符的链接。
* [UnlinkXboxAccount](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/unlinkxboxaccount?) 从用户的 PlayFab 账户取消相关 XBOX Live 账户的链接。
* [UnlockContainerInstance](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/unlockcontainerinstance?) 使用指定密钥（KeyItemInstanceId，如需）打开特定容器（ContainerItemInstanceId），并返回打开容器的内容。若容器（以及相关密钥）是可消耗的（RemainingUses > 0），其 RemainingUses 将被递减，行为与 ConsumeItem 保持一致。
* [UnlockContainerItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/unlockcontaineritem?) 在玩家或角色库存中搜索匹配给定 CatalogItemId 的任何 ItemInstance，必要时使用任何合适的密钥解锁，并返回打开容器的内容。若容器（以及相关密钥）是可消耗的（RemainingUses > 0），其 RemainingUses 将被递减，行为与 ConsumeItem 保持一致。
* [UpdateAvatarUrl](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/updateavatarurl?) 更新指定玩家的头像 URL。
* [UpdateBans](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/updatebans?) 更新以 Ban Id 指定的现有封禁列表的信息。
* [UpdateCharacterData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/character-data/updatecharacterdata?) 更新用户角色可由客户端读写的标题特定自定义数据。
* [UpdateCharacterInternalData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/character-data/updatecharacterinternaldata?) 更新用户角色的标题特定自定义数据，客户端无法访问。
* [UpdateCharacterReadOnlyData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/character-data/updatecharacterreadonlydata?) 更新用户角色仅可由客户端读取的标题特定自定义数据。
* [UpdateCharacterStatistics](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/characters/updatecharacterstatistics?) 更新指定角色的标题特定统计信息值。
* [UpdatePlayerStatistics](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-data-management/updateplayerstatistics?) 更新用户的标题特定统计信息值。
* [UpdateUserData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-data-management/updateuserdata?) 更新用户可由客户端读写的标题特定自定义数据。
* [UpdateUserInternalData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-data-management/updateuserinternaldata?) 更新用户的标题特定自定义数据，客户端无法访问。
* [UpdateUserInventoryItemCustomData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/updateuserinventoryitemcustomdata?) 更新标记到指定物品的键值对数据，该数据对客户端为只读。
* [UpdateUserPublisherData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-data-management/updateuserpublisherdata?) 更新用户可由客户端读写的发布者特定自定义数据。
* [UpdateUserPublisherInternalData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-data-management/updateuserpublisherinternaldata?) 更新用户的发布者特定自定义数据，客户端无法访问。
* [UpdateUserPublisherReadOnlyData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-data-management/updateuserpublisherreadonlydata?) 更新用户仅可由客户端读取的发布者特定自定义数据。
* [UpdateUserReadOnlyData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-data-management/updateuserreadonlydata?) 更新用户仅可由客户端读取的标题特定自定义数据。


## Related topics

- [内容与配置写入计量 API 说明](/zh-CN/services/playfab/pricing/meters/file-writes.md)
- [库存写入计量表 API 说明](/zh-CN/services/playfab/pricing/meters/economy-writes.md)
- [配置文件读取计量 API 说明](/zh-CN/services/playfab/pricing/meters/profile-reads.md)
- [内容与配置读取计量 API 说明](/zh-CN/services/playfab/pricing/meters/file-reads.md)
- [统计信息计量](/zh-CN/services/playfab/pricing/meters/statistics-meters.md)