Skip to main content
이 가이드는 게임 내 콘텐츠에 대한 조정 흐름을 만드는 데 사용할 수 있는 API 호출을 살펴봅니다.

아이템 신고

플레이어는 클라이언트에서 ReportItem API를 호출하여 아이템을 신고할 수 있습니다. 아이템 Id 또는 AlernateId를 제공해야 합니다. 다음과 같은 추가 선택적 매개 변수를 추가할 수 있습니다.
  • ConcernCategory: 신고에 대한 우려 범주
  • Reason: 신고에 대한 자유 텍스트 입력
다음은 샘플 요청 본문입니다.
지정되지 않은 경우 ConcernCategory는 기본적으로 None으로 설정됩니다. 유효한 ConcernCategory 값은 다음과 같습니다.
  • None
  • OffensiveContent
  • ChildExploitation
  • MalwareOrVirus
  • PrivacyConcerns
  • MisleadingApp
  • PoorPerformance
  • ReviewResponse
  • SpamAdvertising
  • Profanity
ReportItem API를 호출하면 이벤트 이름 item_reported오직 PlayStream 이벤트만 발생합니다. Game Manager에서 Data Explorer를 사용해 이를 쿼리할 수 있습니다. 예제 쿼리는 아래에서 볼 수 있습니다. 다음 쿼리는 최근 3일 동안 ItemId별 ConcernCategory별 총 신고 수를 반환합니다.
다음 쿼리는 최근 3일 동안 특정 ItemId에 대해 제출된 모든 신고를 반환합니다.

아이템의 조정 상태 변경

SetItemModerationState API를 사용해 게시된 아이템의 조정 상태를 변경할 수 있습니다. Approved가 아닌 상태의 아이템은 모든 플레이어에 대해 공개 카탈로그에서 액세스할 수 없습니다. 아이템 작성자는 GetItemGetDraftItems API를 사용해 계속해서 아이템에 액세스할 수 있습니다. 타이틀 엔터티관리자SearchItems, GetDraftItems, GetItem을 통해 승인되지 않은 아이템을 볼 수 있습니다. 이 API는 타이틀 엔터티만 호출할 수 있습니다. 아이템 Id 또는 AlernateIdStatus를 제공해야 합니다. 선택적 Reason 자유 텍스트 매개 변수도 추가할 수 있습니다. 서비스 호출로는 다음과 같습니다.
기본적으로 게시된 아이템은 조정 상태가 없습니다. 초안 아이템을 다시 게시하는 것은 조정 상태를 변경하지 않습니다. 유효한 Status 값은 다음과 같습니다.
  • AwaitingModeration
  • Approved
  • Rejected
다음 쿼리는 최근 3일 동안 현재 AwaitingModeration 상태인 모든 아이템을 반환합니다.

아이템 삭제

DeleteItem API를 호출하여 아이템을 삭제할 수 있습니다. 이 호출은 초안 카탈로그에서 아이템을 제거하고(게시된 경우) 공개 카탈로그의 해당 아이템도 제거합니다. 아이템 Id 또는 AlernateId를 제공해야 합니다.
마지막 수정일 2026년 8월 13일