메인 콘텐츠로 건너뛰기
X는 X API로 빌드하는 개발자 커뮤니티와의 약속을 지킵니다. 이 약속의 일환으로, 우리는 API를 개발자에게 개방적이고 공정하게 제공하며, X의 이용자에게 안전하고, X 플랫폼 전체에 이로우며, 이를 통해 생태계 전반에 도움이 되도록 하는 것을 목표로 합니다. X 콘텐츠를 오프라인으로 저장하는 모든 개발자는 데이터가 이용자의 의도와 X 상의 콘텐츠의 최신 상태를 반영하도록 하는 것이 중요합니다. 예를 들어, X에서 누군가가 게시물이나 계정을 삭제하거나, 게시물을 보호로 전환하거나, 게시물에서 위치 정보(geo)를 제거한 경우, 그 사람의 기대와 의도를 X와 개발자 모두가 존중하는 것이 매우 중요합니다. 배치 컴플라이언스 엔드포인트는 개발자가 X Developer Agreement and Policy를 준수하여 X 데이터를 유지하도록 돕는 간편한 도구를 제공합니다.  이 배치 컴플라이언스 엔드포인트를 사용하면 게시물 또는 사용자 ID로 구성된 대규모 데이터셋을 업로드하여 컴플라이언스 상태를 조회하고, 데이터셋을 규정 준수 상태로 맞추기 위해 어떤 데이터에 조치가 필요한지 판단할 수 있습니다. 참고로, 배치 컴플라이언스 엔드포인트의 사용은 앞서 언급한 사용 사례로 제한되며, 그 외의 목적은 금지되며 제재 조치로 이어질 수 있습니다. 일반적으로 이 엔드포인트를 사용할 때는 다음 4단계를 따릅니다:
  1. 컴플라이언스 작업 생성 작업 유형을 지정할 수 있으며, 업로드하려는 데이터셋에 게시물 ID가 있는지 사용자 ID가 있는지 나타내기 위해 값으로 tweets 또는 users를 사용합니다. 각 작업 유형당 동시에 하나의 작업만 실행할 수 있습니다.
  2. upload_url로 데이터셋 업로드 다음으로, 제공된 upload_url에 데이터셋을 일반 텍스트 파일로 업로드합니다. 파일의 각 줄에는 하나의 게시물 ID 또는 사용자 ID가 포함되어야 합니다. upload_url은 15분 후 만료됩니다.
  3. (선택 사항) 작업 상태 확인 컴플라이언스 작업의 상태가 created, in_progress, failed 또는 complete인지 확인할 수 있습니다.
  4. 결과 다운로드 작업이 완료되면 download_url을 사용하여 결과를 다운로드할 수 있습니다. download_url은 작업 생성 시점으로부터 1주일 후 만료됩니다. 결과에는 JSON 객체 집합(줄당 하나의 객체)이 포함됩니다. 각 객체에는 게시물 ID, 게시물의 생성 날짜(날짜별로 게시물을 찾는 데 유용), 필요한 조치, 컴플라이언스 조치의 사유, 사용자 정지 일자가 포함됩니다.
결과에서 다음 컴플라이언스 이벤트 유형을 받게 됩니다:
  • deleted - 게시물 또는 사용자 계정이 삭제되었음을 나타냄
  • deactivated - 게시물 또는 사용자 계정이 비활성화되었음을 나타냄
  • scrub_geo - 게시물 또는 사용자에 연관된 위치 정보가 제거되었음을 나타냄
  • protected - 해당 게시물을 작성한 계정이 비공개로 전환되었음을 나타냄
  • suspended - 해당 게시물을 작성한 계정이 정지되었음을 나타냄
계정 설정 이 엔드포인트에 액세스하려면 다음이 필요합니다: X API v2 엔드포인트에 대한 액세스 권한 얻기에 대해 더 알아보려면 시작 가이드를 참고하세요.