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

# PFPlayerDataManagementServerUpdateUserDataRequest

> PFPlayerDataManagementServerUpdateUserDataRequest 数据模型。此函数对包含自定义数据的任意 JSON 对象执行增量更新。

PFPlayerDataManagementServerUpdateUserDataRequest 数据模型。此函数对包含用户自定义数据的任意 JSON 对象执行增量更新。在更新自定义数据对象时，对象中已存在的键的值将被覆盖，而具有 null 值的键将被删除。除调用中指定的键值对外，其他键值对不会更改。

## 语法

```cpp theme={null}
typedef struct PFPlayerDataManagementServerUpdateUserDataRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    PFStringDictionaryEntry const* data;  
    uint32_t dataCount;  
    const char* const* keysToRemove;  
    uint32_t keysToRemoveCount;  
    PFUserDataPermission const* permission;  
    const char* playFabId;  
} PFPlayerDataManagementServerUpdateUserDataRequest;  
```

### 成员

**`customTags`**   [PFStringDictionaryEntry](/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*可以为 nullptr*

（可选）与请求关联的可选自定义标签（例如生成号、外部跟踪标识符等）。

**`customTagsCount`**   uint32\_t

customTags 的计数

**`data`**   [PFStringDictionaryEntry](/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*可以为 nullptr*

（可选）要写入自定义数据的键值对。请注意，键会被去除空白、大小受限，并且不能以 "!" 字符开头或为 null。

**`dataCount`**   uint32\_t

data 的计数

**`keysToRemove`**   const char\* const\*<br />*可以为 nullptr*

（可选）要从 UserData 中移除的 Data 键的可选列表。由于语言约束，某些 SDK 无法将 null 值插入 Data。使用此参数可直接删除键。

**`keysToRemoveCount`**   uint32\_t

keysToRemove 的计数

**`permission`**   [PFUserDataPermission](/services/playfab/api-references/c/pftypes/enums/pfuserdatapermission) const\*<br />*可以为 nullptr*

（可选）应用于此请求中写入的所有用户数据键的权限。如果未设置，则默认为 "private"。

**`playFabId`**   const char\*<br />*以 null 结尾*

将对其执行操作的用户的 PlayFab 分配唯一 ID。

## 要求

**头文件：** PFPlayerDataManagementTypes.h

## 另请参阅

[PFPlayerDataManagementTypes 成员](/services/playfab/api-references/c/pfplayerdatamanagementtypes/pfplayerdatamanagementtypes_members)


## Related topics

- [PFPlayerDataManagementServerUpdateUserDataAsync](/zh-CN/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateuserdataasync.md)
- [PFPlayerDataManagementServerUpdateUserPublisherDataAsync](/zh-CN/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateuserpublisherdataasync.md)
- [PFPlayerDataManagementServerUpdateUserReadOnlyDataAsync](/zh-CN/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateuserreadonlydataasync.md)
- [PFPlayerDataManagementServerUpdateUserPublisherReadOnlyDataAsync](/zh-CN/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateuserpublisherreadonlydataasync.md)
- [服务 C API 概览 - PFPlayerDataManagementTypes.h](/zh-CN/services/playfab/api-references/c/pfplayerdatamanagementtypes/pfplayerdatamanagementtypes_members.md)