YouTube Reporting API를 사용하면 개발자가 보고 작업을 예약한 다음 생성된 일괄 보고서를 다운로드할 수 있습니다. API는 사전 정의된 보고서 세트를 지원하며, 각 보고서에는 채널 또는 콘텐츠 소유자를 위한 포괄적인 YouTube 분석 데이터 세트가 포함됩니다.
아래 단계에서는 보고 작업 예약 및 보고서 검색 방법을 설명합니다.
reportTypes.list()메서드를 호출하여 채널 또는 콘텐츠 소유자가 가져올 수 있는 보고서 목록을 가져옵니다.jobs.create()메서드를 호출하여 채널 또는 콘텐츠 소유자에 대해 생성해야 하는 보고서를 식별합니다. 그런 다음 API의jobs.list()및jobs.delete()를 사용하여 생성되는 보고서 목록을 가져오거나 변경할 수 있습니다.jobs.reports.list()메서드를 호출하여 특정 작업에 대해 생성된 보고서 목록을 가져옵니다. 대답의 각 리소스에는 보고서를 다운로드할 수 있는 URL을 지정하는downloadUrl속성이 포함되어 있습니다.- 승인된
GET요청을 보내 다운로드 URL에서 보고서를 가져옵니다.
리소스 유형
다음 섹션에서는 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 채널 또는 콘텐츠 소유자가 가져올 수 있는 보고서 유형 목록을 반환합니다. |