YouTube에서 Shorts 동영상의 조회수를 집계하는 방식에 맞게 YouTube 분석 및 보고 API가 업데이트됩니다.
자세히 알아보기
Method jobs.reports.get
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
요청
HTTP 요청
GET https://youtubereporting.googleapis.com/v1/jobs/{jobId}/reports/{reportId}
승인
모든 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 분석 금전 보고서 보기 이 범위에서는 사용자 활동 측정항목, 예상 수익, 광고 실적 측정항목에 액세스할 수 있습니다. |
매개변수
경로 매개변수
| 매개변수 |
jobId |
string
YouTube에서 검색 중인 보고서와 연결된 작업을 고유하게 식별하는 데 사용하는 ID입니다. |
reportId |
string
YouTube에서 가져오는 보고서를 고유하게 식별하는 데 사용하는 ID입니다. |
쿼리 매개변수
| 매개변수 |
onBehalfOfContentOwner |
string
API 요청이 이루어지는 콘텐츠 소유자의 ID입니다. 요청에서 이 매개변수의 값을 지정하지 않으면 API 서버는 사용자의 자체 채널에 대한 요청이라고 가정합니다. |
응답
성공하면 응답 본문에 Report 리소스가 포함됩니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-05-08(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-05-08(UTC)"],[[["This endpoint retrieves metadata for a specific report using its `jobId` and `reportId`."],["Authorization is required for all requests, utilizing OAuth 2.0 and specific scopes like `https://www.googleapis.com/auth/yt-analytics.readonly` or `https://www.googleapis.com/auth/yt-analytics-monetary.readonly`."],["Path parameters `jobId` and `reportId` are required to identify the job and the report being retrieved."],["The `onBehalfOfContentOwner` query parameter allows specifying a content owner ID, otherwise, the request defaults to the user's own channel."],["A successful response returns a `Report` resource containing the report's metadata."]]],["This describes how to retrieve metadata for a specific YouTube report using the Reporting API. A `GET` request is sent to a URL containing the `jobId` and `reportId`. Authorization is required using OAuth 2.0, with scopes for viewing analytics and/or monetary reports. The request can also specify a `content owner` using `onBehalfOfContentOwner`. The request body is empty. A successful response returns a `Report` resource.\n"]]
