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

SuperChatEvents

superChatEvent 리소스는 YouTube 실시간 스트림 중에 팬이 구매한 Super Chat 메시지를 나타냅니다. YouTube 실시간 채팅 스트림에서 Super Chat은 다음과 같은 두 가지 면에서 다른 메시지와 차별화됩니다.

Super Chat은 색상으로 강조표시됩니다.
Super Chat은 일정 시간 동안 티커에 고정됩니다.

Super Chat 색상, 티커에 고정되는 시간, 최대 메시지 길이는 모두 구매액에 따라 결정됩니다. Super Chat에 대해 자세히 알아보려면 YouTube 고객센터를 참조하세요.

방법

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

list: 지난 30일간 채널의 실시간 스트림에서 발생한 Super Chat 이벤트를 나열합니다. 지금 사용해보기

리소스 표현

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

{
  "kind": "youtube#superChatEvent",
  "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,
    "messageType": unsigned integer,
    "isSuperStickerEvent": boolean,
    "superStickerMetadata": {
      "stickerId": string,
      "altText": string,
      "language": string
    }
  }
}

속성

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

속성
`kind`	`string` API 리소스의 유형을 식별합니다. 값은 `youtube#superChatEvent`입니다.
`etag`	`etag` 이 리소스의 Etag입니다.
`id`	`string` YouTube가 Super Chat 이벤트를 고유하게 식별하기 위해 할당하는 ID입니다.
`snippet`	`object` `snippet` 객체에는 Super Chat 이벤트에 대한 기본 세부정보가 포함되어 있습니다.
`snippet.channelId`	`string` Super Chat 이벤트와 연결된 실시간 스트림을 방송하는 채널을 식별하는 YouTube 채널 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` Super Chat을 구매한 날짜 및 시간입니다. 값은 ISO 8601(`YYYY-MM-DDThh:mm:ss.sZ`) 형식으로 지정됩니다.
`snippet.amountMicros`	`unsigned long` 구매 통화의 마이크로( 구매 단위)입니다. 예를 들어 구매 금액이 1달러인 경우 `snippet.amountMicros` 속성 값은 `1000000`입니다.
`snippet.currency`	`string` 구매에 사용된 통화입니다. 값은 ISO 4217 통화 코드입니다.
`snippet.displayString`	`string` 구매 금액과 통화를 표시하는 문자열(예: `$1.00`)입니다. 표시 문자열은 `hl` 요청 매개변수로 지정된 언어의 규칙에 따라 형식이 지정됩니다. 기본적으로 표시 문자열의 형식은 영어와 같습니다. 예를 들어 문자열의 형식은 기본적으로 `$1,00`이 아닌 `$1.00` 형식입니다.
`snippet.messageType`	`unsigned integer` 유료 메시지의 등급입니다. `liveChatMessage` 리소스가 Super Chat 메시지를 식별하면 `snippet.superChatDetails.tier` 속성에 이 값이 포함됩니다. 등급은 메시지를 구매하는 데 지출한 금액을 기준으로 합니다. 또한 실시간 채팅 UI에서 메시지를 강조표시하는 데 사용되는 색상, 최대 메시지 길이, 메시지가 티커에 고정되는 시간도 결정됩니다. Super Chat 등급은 YouTube 고객센터에 설명되어 있습니다. Super Chat 구매 세부정보에 관한 확장형 섹션을 참고하세요. 이 목록에서 구매 금액이 가장 낮은 등급은 1등급이고, 2등급은 2등급입니다.
`snippet.isSuperStickerEvent`	`boolean` 리소스가 Super Sticker인지 여부를 나타내며, 연결된 이미지가 있는 특정 유형의 Super Chat 메시지입니다. 이 필드의 값이 `true`이면 `superStickerMetadata` 필드에 이미지를 표시하는 데 사용할 수 있는 정보가 포함됩니다.
`snippet.superStickerMetadata`	`object` Super Sticker에 관한 세부정보 이 객체는 `snippet.isSuperStickerEvent` 필드의 값이 `true`인 경우에만 반환됩니다.
`snippet.superStickerMetadata.stickerId`	`string` 스티커 이미지를 식별하는 고유 ID입니다. 이미지는 사용자가 YouTube에서 채팅 창을 볼 때만 Super Sticker 메시지의 일부로 표시됩니다. 그러나 이미지 URL은 API를 통해 사용할 수 없습니다.
`snippet.superStickerMetadata.altText`	`string` 스티커를 설명하는 텍스트 문자열입니다. `snippet.superStickerMetadata.language` 필드는 텍스트의 언어를 나타냅니다. `superChatEvents.list` 메서드를 호출할 때 hl 매개변수 값을 원하는 텍스트 언어로 설정합니다.
`snippet.superStickerMetadata.language`	`string` `snippet.superStickerMetadata.altText` 속성 값의 언어입니다. Super Sticker에서도 텍스트가 표시되면 이 언어로 된 텍스트입니다.