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

# 내부 플레이어 데이터를 가져오는 방법

> 서버 API에서 내부 PlayFab 플레이어 데이터를 검색하여 클라이언트에는 숨겨진 채로 타이틀에 안전하게 유지되는 비공개 필드에 액세스합니다.

내부 플레이어 데이터를 가져오려면 Server API [GetUserInternalData](xref:titleid.playfabapi.com.server.playerdatamanagement.getuserinternaldata) 메서드를 사용합니다. 이는 *내부* 데이터이며 클라이언트에 노출해서는 안 됩니다.

이 문서의 C# 샘플은 Unity SDK용으로 작성되었습니다. Unity SDK는 이벤트 기반 모델을 사용하여 비동기 작업을 처리합니다. C# SDK를 사용하여 샘플 코드를 실행하려면 async Task 모델을 사용하도록 코드를 수정해야 합니다. 수정해야 하는 메서드는 서명의 메서드 이름에 Async가 추가되어 있습니다. 예를 들어, Unity SDK의 SetObject는 C# SDK에서 SetObjectAsync가 됩니다. 자세한 내용은 [async 및 await를 사용한 비동기 프로그래밍](https://learn.microsoft.com/en-us/dotnet/csharp/programming-guide/concepts/async/)을 참조하세요.

## C# 코드 예제

다음 **C#** 코드 예제는 플레이어 내부 데이터의 키 값 쌍을 검색합니다.

```csharp theme={null}
public void GetUserInternalData() {
    PlayFabServerAPI.GetUserInternalData(new GetUserDataRequest() {
        PlayFabId = "user PlayFabId here - obtained from any successful LoginResult",
    },
    result => {
        if(result.Data == null || !result.Data.ContainsKey("Class")) Debug.Log("No Class");
        else Debug.Log("Class: " + result.Data["Class"].Value);
    },
    error => {
        Debug.Log("Got error getting internal user data:");
        Debug.Log(error.GenerateErrorReport());
    });
}
```

## 참고 항목

[내부 플레이어 데이터를 설정하는 방법](/services/playfab/player-progression/player-data/how-to-set-internal-player-data)


## Related topics

- [플레이어 데이터 빠른 시작](/ko/services/playfab/player-progression/player-data/quickstart.md)
- [내부 플레이어 데이터 설정 방법](/ko/services/playfab/player-progression/player-data/how-to-set-internal-player-data.md)
- [읽기 전용 플레이어 데이터 가져오기 방법](/ko/services/playfab/player-progression/player-data/how-to-get-read-only-player-data.md)
- [읽기 전용 플레이어 데이터 설정 방법](/ko/services/playfab/player-progression/player-data/how-to-set-read-only-player-data.md)
- [CloudScript를 통해 읽기 전용 또는 내부 플레이어 데이터 수정](/ko/services/playfab/player-progression/player-data/how-to-modify-read-only-internal-player-data.md)