> For the complete documentation index, see [llms.txt](/llms.txt)

# GS2-Friend API 레퍼런스

친구·팔로우 기능




게임 내 친구 관계를 구현할 때 사용합니다.

요청을 보내고 승인되어야 비로소 관계가 구축되는 친구와, 상대방의 승인 절차 없이 구축할 수 있는 팔로우가 있습니다.

게임 플레이어의 메타데이터로 프로필 정보를 가지게 할 수 있습니다.<br>
프로필 정보는 `공개` `팔로워에게 공개` `친구에게 공개`의 범위가 있으며, 범위에 따라 다른 플레이어에게 공개됩니다.

친구·팔로워 수의 상한은 각각 1,000명이지만, 연동하는 서비스에 따라 각 서비스의 정책에 따른 추가 제한이 붙을 수 있습니다.

친구 관계를 구축하고자 하는 플레이어 중 한쪽이 상대방에게 친구 요청을 보내고, 친구 요청을 받은 플레이어가 이를 승낙함으로써 친구 관계가 성립합니다.

GS2-Friend는 플레이어의 프로필을 보관하는 영역을 제공합니다.<br>
프로필에는 임의의 값을 보관할 수 있으며, 공간이 3곳 존재합니다.

블랙리스트는 플레이어가 차단한 사용자 ID 목록을 보관하는 영역입니다.<br>
어디까지나 영속화하는 기능이 존재할 뿐이며, 여기에 추가하는 것만으로는 아무런 기능도 하지 않습니다.<br>
GS2-Matchmaking의 매치메이킹 조건에 목록을 전달하는 등, 별도로 여기에 기록한 목록을 필요에 따라 사용해야 합니다.

[마이크로서비스 소개 / GS2-Friend](../../microservices/friend)



- [GS2-Friend Deploy/CDK 레퍼런스](/ko/api_reference/friend/deploy/)
  
- [GS2-Friend SDK API 레퍼런스](/ko/api_reference/friend/sdk/)
  
- [GS2-Friend SDK for Game Engine API 레퍼런스](/ko/api_reference/friend/game_engine/)
  
- [GS2-Friend 스크립트 트리거 레퍼런스](/ko/api_reference/friend/script/)
  
- [GS2-Friend 트랜잭션 액션](/ko/api_reference/friend/stamp_sheet/)