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

# PFPlayerDataManagementClientUpdateUserDataRequest

> PFPlayerDataManagementClientUpdateUserDataRequest 데이터 모델입니다. 이 함수는 사용자 지정 데이터를 담고 있는 임의의 문자열에 대해 가산적 업데이트를 수행합니다.

PFPlayerDataManagementClientUpdateUserDataRequest 데이터 모델입니다. 이 함수는 사용자의 사용자 지정 데이터를 담고 있는 임의의 문자열에 대해 가산적 업데이트를 수행합니다. 사용자 지정 데이터 개체를 업데이트할 때, 개체에 이미 존재하는 키는 값이 덮어써지고, null 값을 가진 키는 제거됩니다. 새 키는 지정한 값과 함께 추가됩니다. 호출에서 지정한 것 외의 다른 키-값 쌍은 변경되지 않습니다.

## 구문

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

### 멤버

**`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"입니다. 이는 한 플레이어가 다른 플레이어의 정보에 대해 보내는 요청에 사용됩니다. 이러한 요청은 Public 키만 반환합니다.

## 요구 사항

**헤더:** PFPlayerDataManagementTypes.h

## 참고 항목

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


## Related topics

- [PFPlayerDataManagementClientUpdateUserDataAsync](/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateuserdataasync.md)
- [PFPlayerDataManagementClientUpdateUserPublisherDataAsync](/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateuserpublisherdataasync.md)
- [Services C API 개요 - PFPlayerDataManagementTypes.h](/ko/services/playfab/api-references/c/pfplayerdatamanagementtypes/pfplayerdatamanagementtypes_members.md)
- [PFPlayerDataManagementServerUpdateUserDataRequest](/ko/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementserverupdateuserdatarequest.md)
- [PFPlayerDataManagementUpdateUserInternalDataRequest](/ko/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementupdateuserinternaldatarequest.md)