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

# GS2-Schedule API 레퍼런스

이벤트 스케줄 기능




게임 내 이벤트의 일정을 관리합니다.

이 서비스는 단독으로 사용하지 않고, GS2-Showcase나 GS2-Quest 등과 연계하여 이벤트 개최 기간에만 스토어에 진열되는 상품이나 퀘스트를 구현합니다.

이벤트 개최 기간에는 두 가지 종류가 있습니다.

- 절대 기간은 모든 플레이어가 동일한 기간을 공유합니다. "1월 1일~1월 3일에 뉴이어 이벤트를 개최한다"와 같은 경우에 사용하며, `absoluteBegin` / `absoluteEnd` 를 마스터 데이터에서 지정합니다.
- 상대 기간은 플레이어마다 기간이 다릅니다. "게임 시작으로부터 1주일"이나 "처음 보스를 쓰러뜨린 후 24시간"과 같은 경우에 사용합니다. 트리거를 당길 때 이미 트리거가 당겨져 있는 경우 이벤트 기간을 지정하는 방식에는 여러 가지가 있습니다.

절대 기간·상대 기간 모두, `RepeatSetting` 을 조합함으로써 "특정 요일이나 시간대에만 유효", "며칠 주기로 유효·무효를 전환"과 같은 반복 스케줄을 표현할 수 있습니다.

반복 설정을 가진 이벤트에 대해서는 현재 및 직전 반복 주기의 시작 일시·종료 일시를 `RepeatSchedule` 로 취득할 수 있습니다.<br>
이를 통해 현재 주기 내에서 보상을 몇 번 수령했는지에 대한 집계나, 다음 주기까지의 남은 시간 표시가 가능합니다.

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



- [GS2-Schedule Deploy/CDK 레퍼런스](/ko/api_reference/schedule/deploy/)
  
- [GS2-Schedule SDK API 레퍼런스](/ko/api_reference/schedule/sdk/)
  
- [GS2-Schedule SDK for Game Engine API 레퍼런스](/ko/api_reference/schedule/game_engine/)
  
- [GS2-Schedule 마스터 데이터 레퍼런스](/ko/api_reference/schedule/master_data/)
  
- [GS2-Schedule 트랜잭션 액션](/ko/api_reference/schedule/stamp_sheet/)