FanFundingEvents: list

참고: 지원 중단 공지입니다.

팬 자금지원 기능은 지원 중단되었으며 2017년 2월 28일에 팬 자금지원 API가 사용 중지됩니다. 이번 지원 중단 발표는 YouTube의 새로운 Super Chat 기능 출시와 동시에 제공됩니다.

채널의 팬 자금지원 이벤트 목록 API 요청은 채널 소유자의 승인을 받아야 합니다.

요청

HTTP 요청

GET https://www.googleapis.com/youtube/v3/fanFundingEvents

승인

이 요청에는 다음 범위 중 최소 하나를 사용하여 인증이 필요합니다. (인증 및 승인에 대해 자세히 알아보기)

범위
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtube.readonly

매개변수

다음 표에는 이 쿼리가 지원하는 매개변수가 나와 있습니다. 나열된 모든 매개변수는 쿼리 매개변수입니다.

매개변수
필수 매개변수
part string
part 매개변수는 API 응답에 포함될 fanFundingEvent 리소스 부분을 지정합니다. 지원되는 값은 id 및 snippet입니다.
선택적 매개변수
hl string
hl 매개변수는 YouTube 웹사이트에서 지원하는 특정 애플리케이션 언어에 대해 현지화된 통화 표시 문자열을 검색하도록 API에 지시합니다. 예를 들어 영어의 경우 통화가 $1.50로 표시되지만 프랑스어의 경우 1,50$로 표시됩니다.

매개변수 값은 i18nLanguages.list 메서드에 의해 반환된 목록에 포함된 언어 코드여야 합니다.
maxResults unsigned integer
maxResults 매개변수는 결과 집합에 반환해야 하는 최대 항목 수를 지정합니다. 사용 가능한 값: 0~50 기본값은 5입니다.
pageToken string
pageToken 매개변수는 결과 집합에서 API 서버에 반환을 요청하는 특정 페이지를 식별합니다. API 응답에서 nextPageToken 속성은 요청에 대한 결과의 다음 페이지를 식별합니다.

요청 본문

이 메소드를 호출할 때 요청 본문을 제공하지 마세요.

응답

요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.

{
  "kind": "youtube#fanFundingEventListResponse",
  "etag": etag,
  "nextPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    fanFundingEvent resource
  ]
}

속성

다음 표는 이 리소스에 표시되는 속성을 정의합니다.

속성
kind string
API 리소스의 유형을 식별합니다. 값은 youtube#fanFundingEventListResponse입니다.
etag etag
이 리소스의 Etag입니다.
nextPageToken string
pageToken 매개변수의 값으로 사용하여 결과 집합의 다음 페이지를 가져올 수 있는 토큰입니다.
pageInfo object
pageInfo 객체는 결과 세트의 페이징 정보를 캡슐화합니다.
pageInfo.totalResults integer
결과 집합의 총 결과 수입니다.
pageInfo.resultsPerPage integer
API 응답에 포함된 결과 수입니다.
items[] list
요청 기준과 일치하는 팬 자금지원 이벤트 목록입니다.

오류

다음 표에서는 이 메서드 호출에 대한 응답으로 API가 반환할 수 있는 오류 메시지를 확인합니다. 자세한 내용은 오류 메시지 설명서를 참조하세요.

오류 유형 오류 세부정보 설명
forbidden (403) insufficientPermissions 채널의 팬 자금지원 이벤트를 보는 데 필요한 권한이 없습니다.
invalidValue (400) fanFundingNotEnabledForChannelId 채널에 팬 자금지원 기능을 사용 설정하지 않았습니다.

사용해 보기

API Explorer를 사용하여 실시간 데이터에서 이 메소드를 호출하고 API 요청 및 응답을 확인해 보세요.