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

# Profile Reads 미터 API 설명

> 프로필 읽기 미터를 증가시키는 플레이어 프로필, 엔터티, 캐릭터, 그룹 및 인벤토리 KVP에 대한 PlayFab API의 참조 목록입니다.

Profile에는 플레이어 프로필, 엔터티 프로필, 캐릭터 프로필, 그룹 및 인벤토리와 관련하여 저장된 모든 데이터가 포함됩니다. 프로필 데이터는 개별 플레이어, 플레이어 그룹 또는 아이템에 적용되는 정보로, PlayFab에서 키/값 쌍(KVP)으로 저장됩니다.

다음 API는 프로필 읽기 미터를 증가시킵니다.

## Admin API

* [CheckLimitedEditionItemAvailability](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-item-management/check-limited-edition-item-availability?view=playfab-rest\&preserve-view=true) 한정판 아이템의 전역 개수를 확인합니다.
* [GetAllSegments](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/play-stream/get-all-segments?view=playfab-rest\&preserve-view=true) 플레이어 세그먼트 정의 배열을 검색합니다. 여기의 결과는 Segment ID가 필요한 GetPlayersInSegment와 같은 후속 API 호출에서 사용할 수 있습니다. 세그먼트 이름은 변경될 수 있지만 해당 세그먼트의 ID는 변경되지 않습니다.
* [ExportMasterPlayerData](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/account-management/export-master-player-data?view=playfab-rest\&preserve-view=true) 마스터 플레이어 계정의 모든 관련 데이터를 내보냅니다.
* [GetCatalogItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/title-wide-data-management/get-catalog-items?view=playfab-rest\&preserve-view=true) 정의된 모든 속성을 포함하여 지정된 버전의 타이틀 가상 상품 카탈로그를 검색합니다.
* [GetContentList](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/content/get-content-list?view=playfab-rest\&preserve-view=true) 타이틀의 모든 콘텐츠를 나열하고 크기와 같은 통계를 가져옵니다.
* [GetDataReport](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/get-data-report?view=playfab-rest\&preserve-view=true) 요청된 보고서의 다운로드 URL을 검색합니다.
* [GetPlayerSegments](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/play-stream/get-player-segments?view=playfab-rest\&preserve-view=true) 현재 플레이어가 속한 모든 세그먼트를 나열합니다.
* [GetPlayerTags](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/play-stream/get-player-tags?view=playfab-rest\&preserve-view=true) 플레이어 프로필에서 지정된 네임스페이스(선택 사항)의 모든 태그를 가져옵니다.
* [GetPolicy](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/authentication/get-policy?view=playfab-rest\&preserve-view=true) 요청된 정책을 가져옵니다.
* [GetPublisherData](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/title-wide-data-management/get-publisher-data?view=playfab-rest\&preserve-view=true) 사용자 지정 게시자 설정의 키-값 저장소를 검색합니다.
* [GetRandomResultTables](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/title-wide-data-management/get-random-result-tables?view=playfab-rest\&preserve-view=true) 타이틀에 대한 랜덤 드롭 테이블 구성을 검색합니다.
* [GetStoreItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/title-wide-data-management/get-store-items?view=playfab-rest\&preserve-view=true) 정의된 모든 가격을 포함하여 지정된 상점에 대해 정의된 아이템 세트를 검색합니다.
* [GetTitleData](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/title-wide-data-management/get-title-data?view=playfab-rest\&preserve-view=true) 클라이언트에서 읽을 수 있는 사용자 지정 타이틀 설정의 키-값 저장소를 검색합니다.
* \[GetUserAccountInfo]\(제공된 고유 식별자와의 일치를 기반으로 지정된 사용자에 대한 관련 세부 정보를 검색합니다) 제공된 고유 식별자와의 일치를 기반으로 지정된 사용자에 대한 관련 세부 정보를 검색합니다.
* [GetUserBans](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/account-management/get-user-bans?view=playfab-rest\&preserve-view=true) 사용자에 대한 모든 밴을 가져옵니다.
* [GetUserData](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/get-user-data?view=playfab-rest\&preserve-view=true) 클라이언트에서 읽고 쓸 수 있는 사용자의 타이틀별 사용자 지정 데이터를 검색합니다.
* [GetUserInternalData](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/get-user-internal-data?view=playfab-rest\&preserve-view=true) 클라이언트에서 액세스할 수 없는 사용자의 타이틀별 사용자 지정 데이터를 검색합니다.
* [GetUserInventory](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-item-management/get-user-inventory?view=playfab-rest\&preserve-view=true) 지정된 사용자의 현재 가상 상품 인벤토리를 검색합니다.
* [GetUserPublisherData](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/get-user-publisher-data?view=playfab-rest\&preserve-view=true) 클라이언트에서 읽고 쓸 수 있는 사용자의 게시자별 사용자 지정 데이터를 검색합니다.
* [GetUserPublisherInternalData](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/get-user-publisher-internal-data?view=playfab-rest\&preserve-view=true) 클라이언트에서 액세스할 수 없는 사용자의 게시자별 사용자 지정 데이터를 검색합니다.
* [GetUserPublisherReadOnlyData](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/get-user-publisher-read-only-data?view=playfab-rest\&preserve-view=true) 클라이언트에서 읽기만 가능한 사용자의 게시자별 사용자 지정 데이터를 검색합니다.
* [GetUserReadOnlyData](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/player-data-management/get-user-read-only-data?view=playfab-rest\&preserve-view=true) 클라이언트에서 읽기만 가능한 사용자의 타이틀별 사용자 지정 데이터를 검색합니다.
* [ListVirtualCurrencyTypes](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/title-wide-data-management/list-virtual-currency-types?view=playfab-rest\&preserve-view=true) 타이틀에 대해 정의된 모든 가상 화폐 목록을 반환합니다.
* [GetPlayerIdFromAuthToken](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/account-management/get-player-id-from-auth-token?view=playfab-rest\&preserve-view=true) 인증 토큰에서 플레이어의 ID를 가져옵니다.
* [GetPlayersInSegment](https://learn.microsoft.com/en-us/rest/api/services/playfab/admin/play-stream/get-players-in-segment?view=playfab-rest\&preserve-view=true) 지정된 세그먼트의 모든 플레이어를 페이징할 수 있게 해줍니다. 이 API는 생성 시점에 세그먼트 정의와 일치하는 모든 플레이어 프로필의 스냅샷을 생성하고, Continuation Token의 후속 사용마다 수명을 갱신하는 Total Seconds to Live 동안 유지됩니다. 페이징 중에 변경되는 프로필은 결과에 반영되지 않습니다. AB Test 세그먼트는 현재 이 작업에서 지원되지 않습니다.
* [GetExperiments](https://learn.microsoft.com/en-us/rest/api/services/playfab/experimentation/experimentation/get-experiments?view=playfab-rest\&preserve-view=true) 타이틀에 대한 모든 실험의 세부 정보를 가져옵니다.
* [GetLatestScorecard](https://learn.microsoft.com/en-us/rest/api/services/playfab/experimentation/experimentation/get-latest-scorecard?view=playfab-rest\&preserve-view=true) 타이틀에 대한 실험의 최신 성적표를 가져옵니다.
* [GetTreatmentAssignment](https://learn.microsoft.com/en-us/rest/api/services/playfab/experimentation/experimentation/get-treatment-assignment?view=playfab-rest\&preserve-view=true) 타이틀에서 실행 중인 모든 실험에 대한 플레이어의 처리 할당을 가져옵니다.

## Client API

* [GetAllUsersCharacters](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/characters/get-all-users-characters?view=playfab-rest\&preserve-view=true) 특정 사용자에 속한 모든 캐릭터를 나열합니다. CharacterIds는 전역적으로 고유하지 않습니다; 고유성을 보장하려면 characterId를 부모 PlayFabId와 함께 평가해야 합니다.
* [GetCatalogItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/title-wide-data-management/get-catalog-items?view=playfab-rest\&preserve-view=true) 정의된 모든 속성을 포함하여 지정된 버전의 타이틀 가상 상품 카탈로그를 검색합니다.
* [GetCharacterData](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/character-data/get-character-data?view=playfab-rest\&preserve-view=true) 클라이언트에서 읽고 쓸 수 있는 캐릭터의 타이틀별 사용자 지정 데이터를 검색합니다.
* [GetCharacterInventory](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/player-item-management/get-character-inventory?view=playfab-rest\&preserve-view=true) 지정된 캐릭터의 현재 가상 상품 인벤토리를 검색합니다.
* [GetCharacterLeaderboard](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/characters/get-character-leaderboard?view=playfab-rest\&preserve-view=true) 리더보드의 지정된 지점에서 시작하여 지정된 통계에 대한 순위 캐릭터 목록을 검색합니다.
* [GetCharacterReadOnlyData](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/character-data/get-character-read-only-data?view=playfab-rest\&preserve-view=true) 클라이언트에서 읽기만 가능한 캐릭터의 타이틀별 사용자 지정 데이터를 검색합니다.
* [GetCharacterStatistics](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/characters/get-character-statistics?view=playfab-rest\&preserve-view=true) 사용자의 모든 타이틀별 통계 세부 정보를 검색합니다.
* [GetFriendLeaderboard](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/player-data-management/get-friend-leaderboard?view=playfab-rest\&preserve-view=true) 리더보드의 지정된 지점에서 시작하여 지정된 통계에 대한 현재 플레이어의 순위 친구 목록을 검색합니다.
* [GetFriendLeaderboardAroundPlayer](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/player-data-management/get-friend-leaderboard-around-player?view=playfab-rest\&preserve-view=true) 요청된 PlayFab 사용자를 중심으로 지정된 통계에 대한 현재 플레이어의 순위 친구 목록을 검색합니다. PlayFabId가 비어 있거나 null이면 현재 로그인한 사용자를 반환합니다.
* [GetFriendsList](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/friend-list-management/get-friends-list?view=playfab-rest\&preserve-view=true) 로컬 사용자의 현재 친구 목록을 검색하며, PlayFab 계정이 있는 사용자로 제한됩니다. 연결된 계정(Facebook, Steam)의 친구도 포함됩니다. 선택적으로 일부 연결된 서비스의 친구를 제외할 수 있습니다.
* [GetLeaderboard](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/player-data-management/get-leaderboard?view=playfab-rest\&preserve-view=true) 리더보드의 지정된 지점에서 시작하여 지정된 통계에 대한 순위 사용자 목록을 검색합니다.
* [GetLeaderboardAroundCharacter](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/characters/get-leaderboard-around-character?view=playfab-rest\&preserve-view=true) 요청된 Character ID를 중심으로 지정된 통계에 대한 순위 캐릭터 목록을 검색합니다.
* [GetLeaderboardAroundPlayer](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/player-data-management/get-leaderboard-around-player?view=playfab-rest\&preserve-view=true) 요청된 플레이어를 중심으로 지정된 통계에 대한 순위 사용자 목록을 검색합니다. PlayFabId가 비어 있거나 null이면 현재 로그인한 사용자를 반환합니다.
* [GetLeaderboardForUserCharacters](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/characters/get-leaderboard-for-user-characters?view=playfab-rest\&preserve-view=true) 지정된 통계에 대한 사용자의 모든 캐릭터 목록을 검색합니다.
* [GetPaymentToken](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/player-item-management/get-payment-token?view=playfab-rest\&preserve-view=true) 공급자가 PlayFab(이행자)에서 거래를 시작해야 하지만 클라이언트가 나머지 흐름을 완료하는 결제 흐름의 경우. Xsolla의 경우 여기서 반환된 토큰은 클라이언트에 의해 Xsolla에 전달되어 장바구니를 생성합니다. 결제를 완료한 후 반환된 OrderId를 사용하여 GetPurchase를 폴링합니다.
* [GetPlayerProfile](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/get-player-profile?view=playfab-rest\&preserve-view=true) 플레이어의 프로필을 검색합니다.
* [GetPlayerSegments](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/play-stream/get-player-segments?view=playfab-rest\&preserve-view=true) 현재 플레이어가 속한 모든 세그먼트를 나열합니다.
* [GetPlayerStatistics](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/player-data-management/get-player-statistics?view=playfab-rest\&preserve-view=true) 로컬 플레이어에 대해 지정된 통계(지정된 것이 없으면 모든 통계의 현재 버전 및 값)를 검색합니다.
* [GetPlayerStatisticVersions](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/player-data-management/get-player-statistic-versions?view=playfab-rest\&preserve-view=true) 지정된 통계의 사용 가능한 버전에 대한 정보를 검색합니다.
* [GetPlayerTags](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/play-stream/get-player-tags?view=playfab-rest\&preserve-view=true) 플레이어 프로필에서 지정된 네임스페이스(선택 사항)의 모든 태그를 가져옵니다.
* [GetPlayerTrades](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/trading/get-player-trades?view=playfab-rest\&preserve-view=true) 플레이어가 여는 모든 거래 또는 수락한 거래를 가져오며, 선택적으로 거래 상태로 필터링됩니다.
* [GetPlayFabIDsFromFacebookIDs](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/get-playfab-ids-from-facebook-ids?view=playfab-rest\&preserve-view=true) 지정된 Facebook 식별자 세트에 대한 고유 PlayFab 식별자를 검색합니다.
* [GetPlayFabIDsFromFacebookInstantGamesIds](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/get-playfab-ids-from-facebook-instant-games-ids?view=playfab-rest\&preserve-view=true) 지정된 Facebook Instant Game 식별자 세트에 대한 고유 PlayFab 식별자를 검색합니다.
* [GetPlayFabIDsFromGameCenterIDs](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/get-playfab-ids-from-game-center-ids?view=playfab-rest\&preserve-view=true) 지정된 Game Center 식별자 세트(Game Center 프로그래밍 가이드에서 Player Identifier로 참조됨)에 대한 고유 PlayFab 식별자를 검색합니다.
* [GetPlayFabIDsFromGenericIDs](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/get-playfab-ids-from-generic-ids?view=playfab-rest\&preserve-view=true) 지정된 일반 서비스 식별자 세트에 대한 고유 PlayFab 식별자를 검색합니다. 일반 식별자는 일반 식별자가 플레이어 계정에 추가되었을 때 타이틀에서 지정한 대로 플레이어에 대한 서비스별 ID와 서비스 이름입니다.
* [GetPlayFabIDsFromGoogleIDs](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/get-playfab-ids-from-google-ids?view=playfab-rest\&preserve-view=true) 지정된 Google 식별자 세트에 대한 고유 PlayFab 식별자를 검색합니다. Google 식별자는 사용자 계정에 대한 ID로, Google+ People API 호출에서 `id`로 사용할 수 있습니다.
* [GetPlayFabIDsFromKongregateIDs](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/get-playfab-ids-from-kongregate-ids?view=playfab-rest\&preserve-view=true) 지정된 Kongregate 식별자 세트에 대한 고유 PlayFab 식별자를 검색합니다. Kongregate 식별자는 사용자 계정에 대한 ID로, Kongregate API 메서드에서 `user_id`로 사용할 수 있습니다(예: [https://docs.kongregate.com/docs/concepts-handling-guests](https://docs.kongregate.com/docs/concepts-handling-guests)).
* [GetPlayFabIDsFromNintendoSwitchDeviceIds](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/get-playfab-ids-from-nintendo-switch-device-ids?view=playfab-rest\&preserve-view=true) 지정된 Nintendo Switch 식별자 세트에 대한 고유 PlayFab 식별자를 검색합니다.
* [GetPlayFabIDsFromPSNAccountIDs](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/get-playfab-ids-from-psn-account-ids?view=playfab-rest\&preserve-view=true) 지정된 PlayStation™ Network 식별자 세트에 대한 고유 PlayFab 식별자를 검색합니다.
* [GetPlayFabIDsFromSteamIDs](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/get-playfab-ids-from-steam-ids?view=playfab-rest\&preserve-view=true) 지정된 Steam 식별자 세트에 대한 고유 PlayFab 식별자를 검색합니다. Steam 식별자는 사용자 계정에 대한 프로필 ID로, Steamworks Community API 호출에서 SteamId로 사용할 수 있습니다.
* [GetPlayFabIDsFromTwitchIDs](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/get-playfab-ids-from-twitch-ids?view=playfab-rest\&preserve-view=true) 지정된 Twitch 식별자 세트에 대한 고유 PlayFab 식별자를 검색합니다. Twitch 식별자는 사용자 계정에 대한 ID로, Twitch API 메서드에서 "\_id"로 사용할 수 있습니다(예: [https://github.com/justintv/Twitch-API/blob/master/v3\_resources/users.md#get-usersuser](https://github.com/justintv/Twitch-API/blob/master/v3_resources/users.md#get-usersuser)).
* [GetPlayFabIDsFromXboxLiveIDs](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/get-playfab-ids-from-xbox-live-ids?view=playfab-rest\&preserve-view=true) 지정된 XboxLive 식별자 세트에 대한 고유 PlayFab 식별자를 검색합니다.
* [GetPublisherData](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/title-wide-data-management/get-publisher-data?view=playfab-rest\&preserve-view=true) 사용자 지정 게시자 설정의 키-값 저장소를 검색합니다.
* [GetPurchase](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/player-item-management/get-purchase?view=playfab-rest\&preserve-view=true) 현재 PlayFab 상태와 함께 구매를 검색합니다. 여전히 활성 상태인 구매의 인벤토리 아이템을 반환합니다.
* [GetSharedGroupData](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/shared-group-data/get-shared-group-data?view=playfab-rest\&preserve-view=true) 공유 그룹 객체에 저장된 데이터와 그룹의 멤버 목록을 검색합니다. 그룹의 비멤버는 이를 사용하여 멤버십을 포함한 그룹 데이터를 검색하지만, 비공개로 표시된 키에 대한 데이터는 받지 못합니다. 공유 그룹은 소수의 플레이어 간에 데이터를 공유하기 위해 설계되었습니다. 자세한 내용은 [Using Shared Group Data](/services/playfab/community/associations/groups/using-shared-group-data)를 참조하세요.
* [GetStoreItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/title-wide-data-management/get-store-items?view=playfab-rest\&preserve-view=true) 정의된 모든 가격을 포함하여 지정된 상점에 대해 정의된 아이템 세트를 검색합니다.
* [GetTitleData](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/title-wide-data-management/get-title-data?view=playfab-rest\&preserve-view=true) 사용자 지정 타이틀 설정의 키-값 저장소를 검색합니다.
* [GetAccountInfo](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/get-account-info?view=playfab-rest\&preserve-view=true) 사용자의 PlayFab 계정 세부 정보를 검색합니다.
* [LoginWithAndroidDeviceID](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/authentication/login-with-android-device-id?view=playfab-rest\&preserve-view=true) Android 장치 식별자를 사용하여 사용자를 로그인시키고, 인증된 사용자가 필요한 API 호출에 나중에 사용할 수 있는 세션 식별자를 반환합니다.
* [LoginWithCustomID](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/authentication/loginwithcustomid?view=playfab-rest\&preserve-view=true) 타이틀에서 생성된 사용자 지정 고유 식별자를 사용하여 사용자를 로그인시키고, 인증된 사용자가 필요한 API 호출에 나중에 사용할 수 있는 세션 식별자를 반환합니다.
* [LoginWithEmailAddress](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/authentication/login-with-email-address?view=playfab-rest\&preserve-view=true) 사용자를 PlayFab 계정으로 로그인시키고, 인증된 사용자가 필요한 API 호출에 나중에 사용할 수 있는 세션 식별자를 반환합니다. 대부분의 다른 로그인 API 호출과 달리, LoginWithEmailAddress는 CreateAccountFlag를 통해 새 계정 생성을 허용하지 않습니다. 이메일 주소는 RegisterPlayFabUser를 통해 계정을 생성하는 데 사용될 수 있습니다.
* [LoginWithFacebook](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/authentication/login-with-facebook?view=playfab-rest\&preserve-view=true) Facebook 액세스 토큰을 사용하여 사용자를 로그인시키고, 인증된 사용자가 필요한 API 호출에 나중에 사용할 수 있는 세션 식별자를 반환합니다.
* [LoginWithFacebookInstantGamesId](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/authentication/login-with-facebook-instant-games-id?view=playfab-rest\&preserve-view=true) Facebook Instant Games ID를 사용하여 사용자를 로그인시키고, 인증된 사용자가 필요한 API 호출에 사용할 수 있는 세션 식별자를 반환합니다. Facebook Instant Games를 구성해야 합니다.
* [LoginWithGameCenter](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/authentication/loginwithgamecenter?view=playfab-rest\&preserve-view=true) iOS Game Center 플레이어 식별자를 사용하여 사용자를 로그인시키고, 인증된 사용자가 필요한 API 호출에 나중에 사용할 수 있는 세션 식별자를 반환합니다.
* [LoginWithGoogleAccount](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/authentication/login-with-game-center?view=playfab-rest\&preserve-view=true) iOS Game Center 플레이어 식별자를 사용하여 사용자를 로그인시키고, 인증된 사용자가 필요한 API 호출에 나중에 사용할 수 있는 세션 식별자를 반환합니다.
* [LoginWithIOSDeviceID](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/authentication/login-with-google-account?view=playfab-rest\&preserve-view=true) Google 계정 자격 증명을 사용하여 사용자를 로그인시킵니다.
* [LoginWithKongregate](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/authentication/login-with-kongregate?view=playfab-rest\&preserve-view=true) Kongregate 플레이어 계정을 사용하여 사용자를 로그인시킵니다.
* [LoginWithNintendoSwitchDeviceId](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/authentication/login-with-nintendo-switch-device-id?view=playfab-rest\&preserve-view=true) Nintendo Switch Device ID를 사용하여 사용자를 로그인시키고, 인증된 사용자가 필요한 API 호출에 사용할 수 있는 세션 식별자를 반환합니다.
* [LoginWithOpenIdConnect](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/authentication/login-with-openid-connect?view=playfab-rest\&preserve-view=true) 타이틀과 Open ID Connect 공급자 간의 기존 관계로 생성된 Open ID Connect JWT를 사용하여 사용자를 로그인시킵니다.
* [LoginWithPlayFab](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/authentication/login-with-playfab?view=playfab-rest\&preserve-view=true) 인증된 사용자가 필요합니다. 대부분의 다른 로그인 API 호출과 달리, `LoginWithPlayFab`은 `CreateAccountFlag`를 통해 새 계정 생성을 허용하지 않습니다. Username/Password 자격 증명은 `RegisterPlayFabUser`를 통해 계정을 생성하는 데 사용되거나 `AddUsernamePassword`를 사용하여 기존 계정에 추가할 수 있습니다.
* [LoginWithPSN](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/authentication/login-with-psn?view=playfab-rest\&preserve-view=true)    사용자를 PlayFab 계정으로 로그인시키고, 인증된 사용자가 필요한 API 호출에 사용할 수 있는 세션 식별자를 반환합니다. 대부분의 다른 로그인 API 호출과 달리, `LoginWithPlayFab`은 `CreateAccountFlag`를 통해 새 계정 생성을 허용하지 않습니다. Username/Password 자격 증명은 `RegisterPlayFabUser`를 통해 계정을 생성하는 데 사용되거나 `AddUsernamePassword`를 사용하여 기존 계정에 추가할 수 있습니다.
* [LoginWithSteam](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/authentication/login-with-steam?view=playfab-rest\&preserve-view=true) Steam 인증 티켓을 사용하여 사용자를 로그인시키고, 인증된 사용자가 필요한 API 호출에 나중에 사용할 수 있는 세션 식별자를 반환합니다.
* [LoginWithTwitch](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/authentication/login-with-twitch?view=playfab-rest\&preserve-view=true) Twitch 액세스 토큰을 사용하여 사용자를 로그인시킵니다.
* [LoginWithXbox](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/authentication/loginwithxbox?view=playfab-rest\&preserve-view=true) XBOX Live 토큰을 사용하여 사용자를 로그인시키고, 인증된 사용자가 필요한 API 호출에 나중에 사용할 수 있는 세션 식별자를 반환합니다.
* [GetPlayerCombinedInfo](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/account-management/get-player-combined-info?view=playfab-rest\&preserve-view=true) 사용자의 여러 유형의 정보를 모두 검색합니다.

"PlayStation"은 Sony Interactive Entertainment Inc.의 등록 상표 또는 상표입니다.

## Data API

* [GetObjects](https://learn.microsoft.com/en-us/rest/api/services/playfab/data/object/get-objects?view=playfab-rest\&preserve-view=true) 엔터티 프로필에서 객체를 검색합니다.

## Groups API

* [GetGroup](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/get-group?view=playfab-rest\&preserve-view=true) 그룹과 해당 역할에 대한 정보를 가져옵니다.
* [IsMember](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/is-member?view=playfab-rest\&preserve-view=true) 엔터티가 그룹 또는 그룹 내 역할의 구성원인지 확인합니다.
* [ListGroupApplications](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/list-group-applications?view=playfab-rest\&preserve-view=true) 그룹 가입에 대한 모든 미결 요청을 나열합니다.
* [ListGroupBlocks](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/list-group-blocks?view=playfab-rest\&preserve-view=true) 그룹 가입이 차단된 모든 엔터티를 나열합니다.
* [ListGroupInvitations](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/list-group-invitations?view=playfab-rest\&preserve-view=true) 그룹에 대한 모든 미결 초대장을 나열합니다.
* [ListGroupMembers](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/list-group-members?view=playfab-rest\&preserve-view=true) 그룹의 모든 구성원을 나열합니다.
* [ListMembership](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/list-membership?view=playfab-rest\&preserve-view=true) 엔터티에 대한 모든 그룹과 역할을 나열합니다.
* [ListMembershipOpportunities](https://learn.microsoft.com/en-us/rest/api/services/playfab/groups/groups/list-membership-opportunities?view=playfab-rest\&preserve-view=true) 엔터티에 대한 모든 미결 초대장 및 그룹 신청서를 나열합니다.

## Profile API

* [GetGlobalPolicy](https://learn.microsoft.com/en-us/rest/api/services/playfab/profiles/account-management/get-global-policy?view=playfab-rest\&preserve-view=true) 전역 타이틀 액세스 정책을 가져옵니다.
* [GetProfile](https://learn.microsoft.com/en-us/rest/api/services/playfab/profiles/account-management/get-profile?view=playfab-rest\&preserve-view=true) 엔터티의 프로필을 검색합니다.
* [GetProfiles](https://learn.microsoft.com/en-us/rest/api/services/playfab/profiles/account-management/get-profiles?view=playfab-rest\&preserve-view=true) 엔터티의 프로필을 검색합니다.
* [GetTitlePlayersFromMasterPlayerAccountIds](https://learn.microsoft.com/en-us/rest/api/services/playfab/profiles/account-management/get-title-players-from-master-player-account-ids?view=playfab-rest\&preserve-view=true) 지정된 마스터 플레이어 계정과 연관된 타이틀 플레이어 계정을 검색합니다.

## Server API

* [EvaluateRandomResultTable](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/evaluate-random-result-table?view=playfab-rest\&preserve-view=true) Random Result Table의 평가 결과를 반환합니다 - Random Result Table이 Bundle을 통해 추가되었거나 UnlockContainer에 대한 호출로 인해 플레이어 인벤토리에 추가되었을 게임 카탈로그의 `ItemId`.
* [GetAllSegments](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/play-stream/get-all-segments?view=playfab-rest\&preserve-view=true) 플레이어 세그먼트 정의 배열을 검색합니다. 여기의 결과는 Segment ID가 필요한 GetPlayersInSegment와 같은 후속 API 호출에서 사용할 수 있습니다. 세그먼트 이름은 변경될 수 있지만 해당 세그먼트의 ID는 변경되지 않습니다.
* [GetAllUsersCharacters](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/characters/get-all-users-characters?view=playfab-rest\&preserve-view=true) 특정 사용자에 속한 모든 캐릭터를 나열합니다. CharacterIds는 전역적으로 고유하지 않습니다; 고유성을 보장하려면 characterId를 부모 PlayFabId와 함께 평가해야 합니다.
* [GetCatalogItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/title-wide-data-management/get-catalog-items?view=playfab-rest\&preserve-view=true) 정의된 모든 속성을 포함하여 지정된 버전의 타이틀 가상 상품 카탈로그를 검색합니다.
* [GetCharacterData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/character-data/get-character-data?view=playfab-rest\&preserve-view=true) 클라이언트에서 읽고 쓸 수 있는 사용자의 타이틀별 사용자 지정 데이터를 검색합니다.
* [GetCharacterInternalData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/character-data/get-character-internal-data?view=playfab-rest\&preserve-view=true) 클라이언트에서 액세스할 수 없는 사용자 캐릭터의 타이틀별 사용자 지정 데이터를 검색합니다.
* [GetCharacterInventory](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/get-character-inventory?view=playfab-rest\&preserve-view=true) 지정된 캐릭터의 현재 가상 상품 인벤토리를 검색합니다.
* [GetCharacterReadOnlyData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/characters/get-character-leaderboard?view=playfab-rest\&preserve-view=true)
* [GetCharacterStatistics](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/characters/get-character-statistics?view=playfab-rest\&preserve-view=true) 특정 캐릭터의 모든 타이틀별 통계 세부 정보를 검색합니다.
* [GetFriendLeaderboard](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-data-management/get-friend-leaderboard?view=playfab-rest\&preserve-view=true) 리더보드의 지정된 지점에서 시작하여 지정된 통계에 대한 지정된 플레이어의 순위 친구 목록을 검색합니다.
* [GetFriendsList](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/friend-list-management/get-friends-list?view=playfab-rest\&preserve-view=true) `PlayFabId`를 가진 사용자의 현재 친구를 검색하며, PlayFab 계정이 있는 사용자로 제한됩니다. 연결된 계정(Facebook, Steam)의 친구도 포함됩니다. 선택적으로 일부 연결된 서비스의 친구를 제외할 수 있습니다.
* [GetLeaderboard](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-data-management/get-leaderboard?view=playfab-rest\&preserve-view=true) 리더보드의 지정된 지점에서 시작하여 지정된 통계에 대한 순위 사용자 목록을 검색합니다.
* [GetLeaderboardAroundCharacter](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/characters/getleaderboardaroundcharacter?view=playfab-rest\&preserve-view=true) 요청된 사용자를 중심으로 지정된 통계에 대한 순위 캐릭터 목록을 검색합니다.
* [GetLeaderboardAroundUser](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/characters/get-leaderboard-around-character?view=playfab-rest\&preserve-view=true) 요청된 사용자를 중심으로 지정된 통계에 대한 순위 캐릭터 목록을 검색합니다.
* [GetLeaderboardForUserCharacters](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/characters/get-leaderboard-for-user-characters?view=playfab-rest\&preserve-view=true) 지정된 통계에 대한 사용자의 모든 캐릭터 목록을 검색합니다.
* [GetPlayerCombinedInfo](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-data-management/get-player-combined-info?view=playfab-rest\&preserve-view=true) 사용자에 대한 응답에서 요청된 모든 정보를 반환합니다. 이메일 주소, Facebook ID와 같은 개인 데이터가 반환될 수 있음에 유의하세요. 모든 매개변수는 기본적으로 false로 설정됩니다.
* [GetPlayerProfile](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/get-player-profile?view=playfab-rest\&preserve-view=true) 플레이어의 프로필을 검색합니다.
* [GetPlayerSegments](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/play-stream/get-player-segments?view=playfab-rest\&preserve-view=true) 현재 플레이어가 속한 모든 세그먼트를 나열합니다.
* [GetPlayersInSegment](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/play-stream/get-players-in-segment?view=playfab-rest\&preserve-view=true) 지정된 세그먼트의 모든 플레이어를 페이징할 수 있게 해줍니다. 이 API는 생성 시점에 세그먼트 정의와 일치하는 모든 플레이어 프로필의 스냅샷을 생성하고, Continuation Token의 후속 사용마다 수명을 갱신하는 Total Seconds to Live 동안 유지됩니다. 페이징 중에 변경되는 프로필은 결과에 반영되지 않습니다. AB Test 세그먼트는 현재 이 작업에서 지원되지 않습니다.
* [GetPlayerStatistics](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-data-management/get-player-statistics?view=playfab-rest\&preserve-view=true) 로컬 플레이어에 대해 지정된 통계의 현재 버전 및 값을 검색합니다.
* [GetPlayerStatisticVersions](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-data-management/get-player-statistic-versions?view=playfab-rest\&preserve-view=true) 지정된 통계의 사용 가능한 버전에 대한 정보를 검색합니다.
* [GetPlayerTags](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/play-stream/get-player-tags?view=playfab-rest\&preserve-view=true) 플레이어 프로필에서 지정된 네임스페이스(선택 사항)의 모든 태그를 가져옵니다.
* [GetPlayFabIDsFromFacebookIDs](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/getplayfabidsfromfacebookids?view=playfab-rest\&preserve-view=true) 지정된 Facebook 식별자 세트에 대한 고유 PlayFab 식별자를 검색합니다.
* [GetPlayFabIDsFromFacebookInstantGamesIds](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/get-playfab-ids-from-facebook-ids?view=playfab-rest\&preserve-view=true) 지정된 Facebook 식별자 세트에 대한 고유 PlayFab 식별자를 검색합니다.
* [GetPlayFabIDsFromGenericIDs](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/get-playfab-ids-from-generic-ids?view=playfab-rest\&preserve-view=true) 지정된 일반 서비스 식별자 세트에 대한 고유 PlayFab 식별자를 검색합니다. 일반 식별자는 일반 식별자가 플레이어 계정에 추가되었을 때 타이틀에서 지정한 대로 플레이어에 대한 서비스별 ID와 서비스 이름입니다.
* [GetPlayFabIDsFromNintendoSwitchDeviceIds](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/get-playfab-ids-from-nintendo-switch-device-ids?view=playfab-rest\&preserve-view=true) 지정된 Nintendo Switch Device 식별자 세트에 대한 고유 PlayFab 식별자를 검색합니다.
* [GetPlayFabIDsFromPSNAccountIDs](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/get-playfab-ids-from-psn-account-ids?view=playfab-rest\&preserve-view=true) 지정된 PlayStation Network 식별자 세트에 대한 고유 PlayFab 식별자를 검색합니다.
* [GetPlayFabIDsFromSteamIDs](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/get-playfab-ids-from-steam-ids?view=playfab-rest\&preserve-view=true) 지정된 Steam 식별자 세트에 대한 고유 PlayFab 식별자를 검색합니다. Steam 식별자는 사용자 계정에 대한 프로필 ID로, Steamworks Community API 호출에서 SteamId로 사용할 수 있습니다.
* [GetPlayFabIDsFromXboxLiveIDs](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/get-playfab-ids-from-xbox-live-ids?view=playfab-rest\&preserve-view=true) 지정된 XboxLive 식별자 세트에 대한 고유 PlayFab 식별자를 검색합니다.
* [GetPublisherData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/title-wide-data-management/get-publisher-data?view=playfab-rest\&preserve-view=true) 사용자 지정 게시자 설정의 키-값 저장소를 검색합니다.
* [GetRandomResultTables](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/get-random-result-tables?view=playfab-rest\&preserve-view=true) 모든 ItemId 값과 가중치를 포함하여 타이틀의 지정된 랜덤 결과 테이블에 대한 구성 정보를 검색합니다.
* [GetServerCustomIDsFromPlayFabIDs](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/get-server-custom-ids-from-playfab-ids?view=playfab-rest\&preserve-view=true) 지정된 서버 사용자 지정 식별자 세트에 대해 연결된 PlayFab 계정 식별자를 검색합니다.
* [GetSharedGroupData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/shared-group-data/get-shared-group-data?view=playfab-rest\&preserve-view=true) 공유 그룹 객체에 저장된 데이터와 그룹의 멤버 목록을 검색합니다. 서버는 모든 공개 및 비공개 그룹 데이터에 액세스할 수 있습니다. 공유 그룹은 소수의 플레이어 간에 데이터를 공유하기 위해 설계되었습니다. 자세한 내용은 [Using Shared Group Data](/services/playfab/community/associations/groups/using-shared-group-data)를 참조하세요.
* [GetStoreItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/title-wide-data-management/get-store-items?view=playfab-rest\&preserve-view=true) 지정된 플레이어에 대해 정의된 모든 가격을 포함하여 지정된 상점에 대해 정의된 아이템 세트를 검색합니다.
* [GetTitleData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/title-wide-data-management/get-title-data?view=playfab-rest\&preserve-view=true) 사용자 지정 타이틀 설정의 키-값 저장소를 검색합니다.
* [GetTitleInternalData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/title-wide-data-management/get-title-internal-data?view=playfab-rest\&preserve-view=true) 사용자 지정 내부 타이틀 설정의 키-값 저장소를 검색합니다.
* [GetUserAccountInfo](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/get-user-account-info?view=playfab-rest\&preserve-view=true) 지정된 사용자에 대한 관련 세부 정보를 검색합니다.
* [GetUserBans](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/account-management/get-user-bans?view=playfab-rest\&preserve-view=true) 사용자에 대한 모든 밴을 가져옵니다.
* [GetUserData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-data-management/get-user-data?view=playfab-rest\&preserve-view=true) 클라이언트에서 읽고 쓸 수 있는 사용자의 타이틀별 사용자 지정 데이터를 검색합니다.
* [GetUserInternalData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-data-management/get-user-internal-data?view=playfab-rest\&preserve-view=true) 클라이언트에서 액세스할 수 없는 사용자의 타이틀별 사용자 지정 데이터를 검색합니다.
* [GetUserInventory](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-item-management/get-user-inventory?view=playfab-rest\&preserve-view=true) 지정된 사용자의 현재 가상 상품 인벤토리를 검색합니다.
* [GetUserPublisherData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-data-management/get-user-publisher-data?view=playfab-rest\&preserve-view=true) 클라이언트에서 읽고 쓸 수 있는 사용자의 게시자별 사용자 지정 데이터를 검색합니다.
* [GetUserPublisherInternalData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-data-management/getuserpublisherinternaldata?view=playfab-rest\&preserve-view=true) 클라이언트에서 액세스할 수 없는 사용자의 게시자별 사용자 지정 데이터를 검색합니다.
* [GetUserPublisherReadOnlyData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-data-management/get-user-publisher-internal-data?view=playfab-rest\&preserve-view=true)
* [GetUserReadOnlyData](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/player-data-management/update-user-read-only-data?view=playfab-rest\&preserve-view=true) 클라이언트에서 읽기만 가능한 사용자의 타이틀별 사용자 지정 데이터를 업데이트합니다.
* [LoginWithServerCustomId](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/authentication/login-with-server-custom-id?view=playfab-rest\&preserve-view=true) 해당 플레이어에 대한 사용자 지정 식별자를 사용하여 외부 서버 백엔드에서 게임 클라이언트를 안전하게 로그인시킵니다. Server Custom ID와 Client Custom ID는 상호 배타적이며 동일한 플레이어 계정을 검색하는 데 사용할 수 없습니다.
* [LoginWithXbox](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/authentication/login-with-xbox?view=playfab-rest\&preserve-view=true) 외부 서버 백엔드에서 XBOX Live 토큰을 사용하여 사용자를 로그인시키고, 인증된 사용자가 필요한 API 호출에 나중에 사용할 수 있는 세션 식별자를 반환합니다.
* [LoginWithXboxId](https://learn.microsoft.com/en-us/rest/api/services/playfab/server/authentication/login-with-xbox-id?view=playfab-rest\&preserve-view=true) XBOX ID와 Sandbox ID를 사용하여 사용자를 로그인시키고, 인증된 사용자가 필요한 API 호출에 나중에 사용할 수 있는 세션 식별자를 반환합니다.


## Related topics

- [Profile Writes 미터 API 설명](/ko/services/playfab/pricing/meters/profile-writes.md)
- [Inventory Reads 미터 API 설명](/ko/services/playfab/pricing/meters/economy-reads.md)
- [Content & Configuration Reads 미터 API 설명](/ko/services/playfab/pricing/meters/file-reads.md)
- [Inventory Writes 미터 API 설명](/ko/services/playfab/pricing/meters/economy-writes.md)
- [Content & Configuration Writes 미터 API 설명](/ko/services/playfab/pricing/meters/file-writes.md)