> ## 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](/zh-TW/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

（選擇性）與要求相關聯的選擇性自訂標籤（例如組建編號、外部追蹤識別碼等）。

**`customTagsCount`**   uint32\_t

customTags 的計數

**`data`**   [PFStringDictionaryEntry](/zh-TW/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

（選擇性）要寫入自訂資料的索引鍵/值組。請注意，索引鍵會去除空白字元、大小有限制，而且不可以 '!' 字元開頭或為 null。

**`dataCount`**   uint32\_t

data 的計數

**`keysToRemove`**   const char\* const\*<br />*may be nullptr*

（選擇性）要從 UserData 移除的資料索引鍵選擇性清單。由於語言限制，某些 SDK 無法將 null 值插入 Data。請使用此項目直接刪除索引鍵。

**`keysToRemoveCount`**   uint32\_t

keysToRemove 的計數

**`permission`**   [PFUserDataPermission](/zh-TW/services/playfab/api-references/c/pftypes/enums/pfuserdatapermission) const\*<br />*may be nullptr*

（選擇性）要套用至此要求中寫入之所有使用者資料索引鍵的權限。若未設定，預設為 "private"。

**`playFabId`**   const char\*<br />*is null-terminated*

PlayFab 指派給要執行此作業之使用者的唯一識別碼。

## 需求

**標頭：** PFPlayerDataManagementTypes.h

## 另請參閱

[PFPlayerDataManagementTypes 成員](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagementtypes/pfplayerdatamanagementtypes_members)


## Related topics

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