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

# PFPlayerDataManagementUpdateUserInternalDataRequest

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

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

## 语法

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

### 成员

**`customTags`**   [PFStringDictionaryEntry](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry.md) const\*\
*可以为 nullptr*

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

**`customTagsCount`**   uint32\_t

customTags 的计数

**`data`**   [PFStringDictionaryEntry](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry.md) const\*\
*可以为 nullptr*

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

**`dataCount`**   uint32\_t

data 的计数

**`keysToRemove`**   const char\* const\*\
*可以为 nullptr*

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

**`keysToRemoveCount`**   uint32\_t

keysToRemove 的计数

**`playFabId`**   const char\*\
*以 null 结尾*

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

## 要求

**头文件：** PFPlayerDataManagementTypes.h

## 另请参阅

[PFPlayerDataManagementTypes 成员](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfplayerdatamanagementtypes/pfplayerdatamanagementtypes_members.md)


## Related topics

- [PFPlayerDataManagementServerUpdateUserInternalDataAsync](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateuserinternaldataasync.md)
- [PFPlayerDataManagementServerUpdateUserPublisherInternalDataAsync](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateuserpublisherinternaldataasync.md)
- [服务 C API 概览 - PFPlayerDataManagementTypes.h](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfplayerdatamanagementtypes/pfplayerdatamanagementtypes_members.md)
- [Update User Internal Data](https://docs.xbox.com/api-reference/player-data-management/update-user-internal-data.md)
- [Update User Publisher Internal Data](https://docs.xbox.com/api-reference/player-data-management/update-user-publisher-internal-data.md)