FanFundingEvents

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

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

fanFundingEvent 리소스는 YouTube 채널의 팬 자금지원 이벤트를 나타냅니다. 팬 자금지원은 YouTube 크리에이터를 금전적으로 후원할 수 있는 방법입니다. 팬 자금지원 이벤트는 사용자가 채널에 일회성으로 자발적으로 결제하면 발생합니다. 팬 자금지원에 대해 자세히 알아보려면 YouTube 고객센터를 참조하세요.

방법

API는 fanFundingEvents 리소스에 다음 메서드를 지원합니다.

list
채널의 팬 자금지원 이벤트를 나열합니다. API 요청은 채널 소유자의 승인을 받아야 합니다. 지금 사용해보기

리소스 표현

다음 JSON 구조는 fanFundingEvents 리소스의 형식을 보여줍니다.

{
  "kind": "youtube#fanFundingEvent",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "supporterDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "commentText": string,
    "createdAt": datetime,
    "amountMicros": unsigned long,
    "currency": string,
    "displayString": string
  }
}

속성

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

속성
kind string
API 리소스의 유형을 식별합니다. 값은 youtube#fanFundingEvent입니다.
etag etag
이 리소스의 Etag입니다.
id string
YouTube가 팬 자금지원 이벤트를 고유하게 식별하기 위해 할당하는 ID입니다.
snippet object
snippet 객체에는 팬 자금지원 이벤트에 대한 정보가 포함되어 있습니다.
snippet.channelId string
자금을 받은 채널의 ID
snippet.supporterDetails object
후원자의 채널에 대한 세부정보입니다. 이 객체는 후원자가 자금 지원 이벤트를 공개한 경우에만 표시됩니다.
snippet.supporterDetails.channelId string
후원자의 YouTube 채널 ID입니다.
snippet.supporterDetails.channelUrl string
후원자 채널의 URL입니다.
snippet.supporterDetails.displayName string
후원자 채널의 표시 이름입니다.
snippet.supporterDetails.profileImageUrl string
후원자 채널의 아바타 URL입니다.
snippet.commentText string
지지자 댓글의 텍스트 콘텐츠입니다.
snippet.createdAt datetime
자금이 발생한 날짜 및 시간입니다. 값은 ISO 8601(YYYY-MM-DDThh:mm:ss.sZ) 형식으로 지정됩니다.
snippet.amountMicros unsigned long
자금 지원 이벤트에 기여한 금액입니다. 금액은 결제 통화의 마이크로(micro)입니다. 예를 들어 자금 지원자가 1달러 (1달러)를 제공했다면 snippet.amountMicros 속성 값은 1000000입니다.
snippet.currency string
결제 금액과 연결된 통화입니다. 값은 ISO 4217 통화 코드입니다.
snippet.displayString string
자금과 통화를 표시하는 문자열입니다(표시용). fanFundingEvents.list 요청에서 hl 매개변수로 애플리케이션 언어를 지정한 경우 표시 문자열은 해당 언어로 표시되도록 현지화됩니다. 예를 들어 영어의 경우 통화가 $1.50로 표시되지만 프랑스어의 경우 1,50$로 표시됩니다.