YouTube에서 Shorts 동영상의 조회수를 집계하는 방식에 맞게 YouTube 분석 및 보고 API가 업데이트됩니다.
자세히 알아보기
YouTube Reporting API
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
YouTube Reporting API를 사용하면 개발자가 보고 작업을 예약한 다음 생성된 일괄 보고서를 다운로드할 수 있습니다. API는 사전 정의된 보고서 세트를 지원하며, 각 보고서에는 채널 또는 콘텐츠 소유자를 위한 포괄적인 YouTube 분석 데이터 세트가 포함됩니다.
아래 단계에서는 보고 작업 예약 및 보고서 검색 방법을 설명합니다.
reportTypes.list() 메서드를 호출하여 채널 또는 콘텐츠 소유자가 가져올 수 있는 보고서 목록을 가져옵니다.jobs.create() 메서드를 호출하여 채널 또는 콘텐츠 소유자에 대해 생성해야 하는 보고서를 식별합니다. 그런 다음 API의 jobs.list() 및 jobs.delete()를 사용하여 생성되는 보고서 목록을 가져오거나 변경할 수 있습니다.jobs.reports.list() 메서드를 호출하여 특정 작업에 대해 생성된 보고서 목록을 가져옵니다. 대답의 각 리소스에는 보고서를 다운로드할 수 있는 URL을 지정하는 downloadUrl 속성이 포함되어 있습니다. - 승인된
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을 기준으로 합니다.
| 메서드 |
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
채널 또는 콘텐츠 소유자가 가져올 수 있는 보고서 유형 목록을 반환합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-16(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-16(UTC)"],[[["The YouTube Reporting API allows developers to schedule and download bulk reports containing comprehensive YouTube Analytics data for channels or content owners."],["Developers can use the API to retrieve a list of available reports, create jobs to generate reports, and manage these jobs through listing and deletion."],["Generated reports can be downloaded via a specified URL obtained from the API's response, after retrieving them by using the `jobs.reports.list()` method."],["The API requires OAuth 2.0 authorization, and provides scopes for viewing user activity metrics (`https://www.googleapis.com/auth/yt-analytics.readonly`) and monetary reports (`https://www.googleapis.com/auth/yt-analytics-monetary.readonly`)."]]],["Developers use the YouTube Reporting API to schedule and download bulk reports containing YouTube Analytics data. Key actions include: listing available report types via `reportTypes.list()`, creating reporting jobs with `jobs.create()`, and managing jobs using `jobs.list()` and `jobs.delete()`. To get data, retrieve generated reports for a specific job with `jobs.reports.list()`, each with a downloadable URL. Finally, you can request the download using the given URL. All actions require authorization via OAuth 2.0.\n"]]
