참고: 지원 중단 공지입니다.
팬 자금지원 기능은 지원 중단되었으며 2017년 2월 28일에 팬 자금지원 API가 사용 중지됩니다. 이번 지원 중단 발표는 YouTube의 새로운 Super Chat 기능 출시와 동시에 제공됩니다.
팬 자금지원 기능은 지원 중단되었으며 2017년 2월 28일에 팬 자금지원 API가 사용 중지됩니다. 이번 지원 중단 발표는 YouTube의 새로운 Super Chat 기능 출시와 동시에 제공됩니다.
fanFundingEvent
리소스는 YouTube 채널의 팬 자금지원 이벤트를 나타냅니다. 팬 자금지원은 YouTube 크리에이터를 금전적으로 후원할 수 있는 방법입니다. 팬 자금지원 이벤트는 사용자가 채널에 일회성으로 자발적으로 결제하면 발생합니다. 팬 자금지원에 대해 자세히 알아보려면 YouTube 고객센터를 참조하세요.
방법
API는 fanFundingEvents
리소스에 다음 메서드를 지원합니다.
리소스 표현
다음 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$ 로 표시됩니다. |