Privileged Intent 종류
Privileged Intent는 다루는 데이터의 특성 상 접근 권한을 얻으려면 추가적인 조건이나 요구사항이 필요한 게이트웨이 Intent입니다. 현재 대상은 다음과 같습니다.
길드 활동 상태
사용자가 언제 온라인 또는 오프라인 상태가 되거나 상태를 업데이트하는지에 대한 정보를 포함하여 활동 상태 업데이트 이벤트에 대한 액세스를 제어합니다.
길드 멤버
길드 멤버 목록을 요청할 수 있는 능력은 물론, 멤버가 언제 참가하거나, 프로필을 업데이트하거나, 서버를 탈퇴하는지 등의 길드 멤버 이벤트에 대한 접근 권한을 제어합니다.
메시지 콘텐츠
다른 인텐트와 달리, 이는 특정 이벤트에 대응하는 것이 아닌 메시지 객체에 포함된 콘텐츠, 임베드, 첨부파일, 구성 요소 등의 필드를 비롯해 당사 API 전반의 메시지 콘텐츠 데이터에 대한 접근을 제어합니다.
Privileged Intent를 사용해야 할 때
앱은 Privileged Intent 없이 플랫폼에서 대부분의 기능을 제공할 수 있지만, 일부 게이트웨이 이벤트 및 API 응답에는 Privileged Intent가 필요합니다. 앱이 정상적으로 작동하기 위해선 반드시 필요하고, 당사의 개발자 정책에 부합하는 사용 사례인 경우에만 Privileged Intent를 활성화해야 합니다. 앱에 이러한 Intent가 필요한지 그리고 이를 대체할 수 있는지 확실하지 않다면, Privileged Intents 개발자 가이드를 검토해 주시기 바랍니다.
앱의 사용자 수가 10,000명 미만인 경우, 개발자 포털에서 이를 활성화하는 것만으로도 Privileged Intent에 접근 할 수 있습니다. 다만 앱의 사용자 수가 10,000명에 도달하면, 지속적인 접근 권한을 위해 별도의 심사 절차를 거쳐야 합니다.
앱 사용자 수 계산 방법: 앱이 설치된 모든 서버에서 앱에 대한 접근 권한을 가진 고유 사용자 수를 측정합니다. 앱의 사용자 수가 10,000명에 도달하면 앱 또는 팀 소유자가 이메일 및/또는 시스템 DM을 통해 알림을 받게 됩니다. 또한 개발자 포털에 신청할 시간이 되었음을 알려주는 메시지가 표시됩니다. 90일 안에 Privileged Intents를 신청해야 합니다.
이 문서와 여기 링크된 다른 여러 문서를 검토한 후에도 궁금한 점이 있을 경우, Discord의 개발자 지원팀으로 문의해 주세요!
리소스
- 가이드: Privileged Intent 검토하기 시작하기