YouTube Reporting API를 사용하면 개발자가 보고 작업을 예약한 다음 생성된 일괄 보고서를 다운로드할 수 있습니다. API는 사전 정의된 보고서 집합을 지원하며, 각 보고서에는 채널 또는 콘텐츠 소유자를 위한 포괄적인 YouTube 분석 데이터가 포함되어 있습니다.
아래 단계에서는 보고 작업을 예약하고 보고서를 검색하는 방법을 설명합니다.
reportTypes.list()메서드를 호출하여 채널 또는 콘텐츠 소유자가 검색할 수 있는 보고서 목록을 검색합니다.jobs.create()메서드를 호출하여 채널 또는 콘텐츠 소유자를 위해 생성해야 하는 보고서를 식별합니다. 이후에 API의jobs.list()및jobs.delete()를 사용하여 생성되는 보고서 목록을 가져오거나 변경할 수 있습니다.jobs.reports.list()메서드를 호출하여 특정 작업에 관해 생성된 보고서 목록을 가져옵니다. 응답의 각 리소스에는 보고서를 다운로드할 수 있는 URL을 지정하는downloadUrl속성이 포함되어 있습니다.- 다운로드 URL에서 보고서를 검색하려면 승인된
GET요청을 보냅니다.
리소스 유형
다음 섹션에서는 API의 리소스와 메서드에 대한 일반적인 설명을 제공합니다. 표에 표시된 모든 메서드 URI는 https://youtubereporting.googleapis.com를 기준으로 합니다.
작업
| 방법 | |
|---|---|
create |
POST /v1/jobs 보고 작업을 만듭니다. 보고 작업을 만들면 YouTube에서 매일 보고서를 생성하도록 지시하는 것입니다. 이 보고서는 작업이 생성된 후 24시간 이내에 제공됩니다. |
delete |
DELETE /v1/jobs/{jobId} 보고 작업을 삭제합니다. |
get |
GET /v1/jobs/{jobId} 채널 또는 콘텐츠 소유자에게 예약된 특정 보고 작업에 대한 정보를 검색합니다. |
list |
GET /v1/jobs 채널 또는 콘텐츠 소유자가 예약한 보고 작업을 나열합니다. 응답의 각 리소스에는 YouTube가 작업을 고유하게 식별하는 데 사용하는 ID를 지정하는 id 속성이 포함되어 있습니다. 작업에 대해 생성된 보고서 목록을 검색하거나 작업을 삭제하려면 해당 ID가 필요합니다. |
작업.보고서
| 방법 | |
|---|---|
get |
GET /v1/jobs/{jobId}/reports/{reportId} 특정 보고서의 메타데이터를 검색합니다. |
list |
GET /v1/jobs/{jobId}/reports 지정된 보고 작업에 대해 생성된 보고서를 나열합니다. |
보고서 유형
| 방법 | |
|---|---|
list |
GET /v1/reportTypes 채널 또는 콘텐츠 소유자가 검색할 수 있는 보고서 유형 목록을 반환합니다. |