YouTube Reporting API

YouTube Reporting API를 사용하면 개발자가 보고 작업을 예약한 다음 생성된 일괄 보고서를 다운로드할 수 있습니다. API는 사전 정의된 보고서 세트를 지원하며, 각 보고서에는 채널 또는 콘텐츠 소유자를 위한 포괄적인 YouTube 분석 데이터 세트가 포함됩니다.

아래 단계에서는 보고 작업 예약 및 보고서 검색 방법을 설명합니다.

  1. reportTypes.list() 메서드를 호출하여 채널 또는 콘텐츠 소유자가 가져올 수 있는 보고서 목록을 가져옵니다.
  2. jobs.create() 메서드를 호출하여 채널 또는 콘텐츠 소유자에 대해 생성해야 하는 보고서를 식별합니다. 그런 다음 API의 jobs.list()jobs.delete()를 사용하여 생성되는 보고서 목록을 가져오거나 변경할 수 있습니다.
  3. jobs.reports.list() 메서드를 호출하여 특정 작업에 대해 생성된 보고서 목록을 가져옵니다. 대답의 각 리소스에는 보고서를 다운로드할 수 있는 URL을 지정하는 downloadUrl 속성이 포함되어 있습니다.
  4. 승인된 GET 요청을 보내 다운로드 URL에서 보고서를 가져옵니다.

승인

모든 YouTube Reporting API 요청은 승인된 상태여야 합니다. 승인 가이드에서는 OAuth 2.0 프로토콜을 사용하여 승인 토큰을 가져오는 방법을 설명합니다.

YouTube Reporting API 요청은 다음 승인 범위를 사용합니다.

범위
https://www.googleapis.com/auth/yt-analytics.readonly YouTube 콘텐츠에 관한 YouTube 분석 보고서를 볼 수 있습니다. 이 범위를 사용하여 사용자 활동 측정항목(예: 조회수, 평가 횟수)을 조회할 수 있습니다.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly YouTube 콘텐츠에 관한 YouTube 분석 금전적 보고서를 볼 수 있습니다. 이 범위는 사용자 활동 측정항목과 예상 수익 및 광고 실적 측정항목에 대한 액세스를 제공합니다.

리소스 유형

다음 섹션에서는 API의 리소스와 메서드에 대해 간략하게 설명합니다. 표에 표시된 모든 메서드 URI는 https://youtubereporting.googleapis.com을 기준으로 합니다.

jobs

메서드
create POST /v1/jobs
보고 작업을 만듭니다. 보고 작업 생성은 YouTube에 해당 보고서를 매일 생성하도록 지시하는 것입니다. 보고서는 작업이 생성된 후 24시간 이내에 제공됩니다.
delete DELETE /v1/jobs/{jobId}
보고 작업을 삭제합니다.
get GET /v1/jobs/{jobId}
채널 또는 콘텐츠 소유자에 대해 예약된 특정 보고 작업에 관한 정보를 가져옵니다.
list GET /v1/jobs
채널 또는 콘텐츠 소유자에 대해 예약된 보고 작업을 나열합니다. 대답의 각 리소스에는 YouTube가 작업을 고유하게 식별하는 데 사용하는 ID를 지정하는 id 속성이 포함되어 있습니다. 이 ID는 작업에 대해 생성된 보고서 목록을 가져오거나 작업을 삭제하는 데 필요합니다.

jobs.reports

메서드
get GET /v1/jobs/{jobId}/reports/{reportId}
특정 보고서의 메타데이터를 가져옵니다.
list GET /v1/jobs/{jobId}/reports
지정된 보고 작업에 대해 생성된 보고서를 나열합니다.

reportTypes

메서드
list GET /v1/reportTypes
채널 또는 콘텐츠 소유자가 가져올 수 있는 보고서 유형 목록을 반환합니다.