이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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$`로 표시됩니다.