> ## 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 />*may be nullptr*

(선택 사항) 요청과 연결된 선택적 사용자 지정 태그입니다(예: 빌드 번호, 외부 추적 식별자 등).

**`customTagsCount`**   uint32\_t

customTags의 개수입니다.

**`data`**   [PFStringDictionaryEntry](/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에서 제거할 Data 키의 선택적 목록입니다. 일부 SDK는 언어 제약으로 인해 Data에 null 값을 삽입할 수 없습니다. 키를 직접 삭제하려면 이 항목을 사용하세요.

**`keysToRemoveCount`**   uint32\_t

keysToRemove의 개수입니다.

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

(선택 사항) 이 요청에서 기록되는 모든 사용자 데이터 키에 적용할 사용 권한입니다. 설정하지 않으면 기본값은 "private"입니다.

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

작업을 수행할 대상 사용자의 고유 PlayFab 할당 ID입니다.

## 요구 사항

**헤더:** PFPlayerDataManagementTypes.h

## 참고 항목

[PFPlayerDataManagementTypes 멤버](/services/playfab/api-references/c/pfplayerdatamanagementtypes/pfplayerdatamanagementtypes_members)


## Related topics

- [PFPlayerDataManagementServerUpdateUserDataAsync](/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateuserdataasync.md)
- [PFPlayerDataManagementServerUpdateUserPublisherDataAsync](/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateuserpublisherdataasync.md)
- [PFPlayerDataManagementServerUpdateUserReadOnlyDataAsync](/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateuserreadonlydataasync.md)
- [PFPlayerDataManagementServerUpdateUserPublisherReadOnlyDataAsync](/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateuserpublisherreadonlydataasync.md)
- [Services C API 개요 - PFPlayerDataManagementTypes.h](/ko/services/playfab/api-references/c/pfplayerdatamanagementtypes/pfplayerdatamanagementtypes_members.md)