Ta strona została przetłumaczona przez Cloud Translation API.

LiveChatMessages

liveChatMessage to zasób reprezentujący wiadomość na czacie na żywo w YouTube. Może on zawierać szczegóły dotyczące kilku rodzajów wiadomości, w tym nowo opublikowanej wiadomości tekstowej lub wydarzenia związanego z finansowaniem przez fanów.

Funkcja czatu na żywo jest domyślnie włączona w przypadku transmisji na żywo i jest dostępna, gdy wydarzenie na żywo jest aktywne. (Po zakończeniu wydarzenia czat na żywo nie jest już dostępny).

Metody

Interfejs API obsługuje te metody w przypadku zasobów liveChatMessages:

list: Wyświetla listę wiadomości na czacie na żywo dla konkretnego czatu. Wypróbuj teraz
streamList: Umożliwia połączenie strumieniowe z serwerem w celu odbierania wiadomości na czacie na żywo na określonym czacie z małym opóźnieniem. Wypróbuj teraz
wstaw: Dodaje wiadomość lub ankietę do czatu na żywo. Wypróbuj teraz
transition: Zmienia stan opublikowanej wiadomości. Wypróbuj teraz
usuń: Usuwa wiadomość z czatu. Żądanie do interfejsu API musi być autoryzowane przez właściciela kanału lub moderatora czatu na żywo. Wypróbuj teraz

Prezentacja zasobów

Poniższa struktura JSON przedstawia format zasobu liveChatMessages:

{
  "kind": "youtube#liveChatMessage",
  "etag": etag,
  "id": string,
  "snippet": {
    "type": string,
    "liveChatId": string,
    "authorChannelId": string,
    "publishedAt": datetime,
    "hasDisplayContent": boolean,
    "displayMessage": string,
    "fanFundingEventDetails": {
      "amountMicros": unsigned long,
      "currency": string,
      "amountDisplayString": string,
      "userComment": string
    },
    "textMessageDetails": {
      "messageText": string
    },
    "messageDeletedDetails": {
      "deletedMessageId": string
    },
    "userBannedDetails": {
      "bannedUserDetails": {
        "channelId": string,
        "channelUrl": string,
        "displayName": string,
        "profileImageUrl": string
      },
      "banType": string,
      "banDurationSeconds": unsigned long
    },
    "memberMilestoneChatDetails": {
      "userComment": string,
      "memberMonth": unsigned integer,
      "memberLevelName": string
    },
    "newSponsorDetails": {
      "memberLevelName": string,
      "isUpgrade": bool
    },
    "superChatDetails": {
      "amountMicros": unsigned long,
      "currency": string,
      "amountDisplayString": string,
      "userComment": string,
      "tier": unsigned integer
    },
    "superStickerDetails": {
      "superStickerMetadata": {
        "stickerId": string,
        "altText": string,
        "language": string
      },
      "amountMicros": unsigned long,
      "currency": string,
      "amountDisplayString": string,
      "tier": unsigned integer
    },
    "pollDetails": {
      "metadata": {
        "options": {
          "optionText": string,
          "tally": string,
        },
        "questionText": string,
        "status": enum
      },
    },
    "membershipGiftingDetails": {
      "giftMembershipsCount": integer,
      "giftMembershipsLevelName": string
    },
    "giftMembershipReceivedDetails": {
      "memberLevelName": string,
      "gifterChannelId": string,
      "associatedMembershipGiftingMessageId": string
    },
  },
  "authorDetails": {
    "channelId": string,
    "channelUrl": string,
    "displayName": string,
    "profileImageUrl": string,
    "isVerified": boolean,
    "isChatOwner": boolean,
    "isChatSponsor": boolean,
    "isChatModerator": boolean
  },
}

Właściwości

Poniższa tabela zawiera definicje właściwości, które pojawiają się w tym zasobie:

Właściwości
`kind`	`string` Określa typ zasobu interfejsu API. Wartość będzie wynosić `youtube#liveChatMessage`.
`etag`	`etag` Tag ETag tego zasobu.
`id`	`string` Identyfikator przypisany przez YouTube, który jednoznacznie identyfikuje wiadomość.
`snippet`	`object` Obiekt `snippet` zawiera podstawowe informacje o wiadomości na czacie.
`snippet.type`	`string` Typ wiadomości. Ta właściwość jest zawsze obecna, a jej wartość określa, które pola znajdują się w zasobie. Prawidłowe wartości tej właściwości to: `chatEndedEvent` – czat został zakończony i nie można już wstawiać po nim żadnych wiadomości. Nastąpi to automatycznie po pewnym czasie od zakończenia transmisji. Ten typ wiadomości nie jest wysyłany w przypadku czatów na żywo podczas domyślnej transmisji na kanale. `messageDeletedEvent` – wiadomość została usunięta przez moderatora. Pole `author` zawiera dane moderatora. To wydarzenie nie zawiera żadnych treści do wyświetlenia. `sponsorOnlyModeEndedEvent` – czat nie jest już w trybie tylko dla wspierających, co oznacza, że użytkownicy, którzy nie są wspierającymi, mogą teraz wysyłać wiadomości. To wydarzenie nie zawiera żadnych treści do wyświetlenia. `sponsorOnlyModeStartedEvent` – czat został przełączony w tryb tylko dla sponsorów, co oznacza, że tylko sponsorzy mogą wysyłać wiadomości. To wydarzenie nie ma treści do wyświetlenia. `newSponsorEvent` – nowy użytkownik zasponsorował kanał, do którego należy czat na żywo. Pola `author` zawierają nowe dane sponsora. `memberMilestoneChatEvent` – użytkownik wysłał wiadomość na czacie dla wspierających osiągających kolejny próg. `superChatEvent` – użytkownik kupił superczat. `superStickerEvent` – użytkownik kupił supernaklejkę. `textMessageEvent` – użytkownik wysłał SMS-a. `tombstone` – nagrobek oznacza, że wiadomość o tym identyfikatorze i czasie publikacji istniała, ale została usunięta. Nie jest wysyłany po usunięciu wiadomości, ale wskazuje miejsce, w którym znajdowała się ona przed usunięciem. Ten typ wiadomości zawiera tylko pola `snippet.liveChatId`, `snippet.type` i `snippet.publishedAt`. `userBannedEvent` – użytkownik został zablokowany przez moderatora. Pole `author` zawiera dane moderatora. `membershipGiftingEvent` – użytkownik kupił wspieranie dla innych widzów. `giftMembershipReceivedEvent` – użytkownik otrzymał wspieranie kanału w prezencie. `pollDetails` – użytkownik utworzył ankietę na żywo.
`snippet.liveChatId`	`string` Identyfikator, który jednoznacznie określa czat na żywo, z którym jest powiązana wiadomość. Identyfikator czatu na żywo powiązanego z transmisją jest zwracany we właściwości `snippet.liveChatId` zasobu `liveBroadcast`.
`snippet.authorChannelId`	`string` Identyfikator użytkownika, który napisał wiadomość. To pole jest wypełniane tylko w przypadku tych typów wiadomości: Jeśli typ wiadomości to `textMessageEvent`, wartość właściwości identyfikuje użytkownika, który napisał wiadomość. Jeśli typ wiadomości to `fanFundingEvent`, wartość właściwości identyfikuje użytkownika, który sfinansował transmisję. Jeśli typ wiadomości to `messageDeletedEvent`, wartość właściwości identyfikuje moderatora, który usunął wiadomość. Jeśli typ wiadomości to `newSponsorEvent`, wartość właściwości identyfikuje użytkownika, który właśnie został sponsorem. Jeśli typ wiadomości to `memberMilestoneChatEvent`, wartość właściwości określa członka, który wysłał wiadomość. Jeśli typ wiadomości to `userBannedEvent`, wartość właściwości identyfikuje moderatora, który zablokował użytkownika. Jeśli typ wiadomości to `membershipGiftingEvent`, wartość właściwości identyfikuje użytkownika, który kupił prezent w postaci subskrypcji. Jeśli typ wiadomości to `giftMembershipReceivedEvent`, wartość właściwości identyfikuje użytkownika, który otrzymał prezent w postaci subskrypcji. Jeśli typ wiadomości to `pollEvent`, wartość właściwości identyfikuje użytkownika, który utworzył ankietę na żywo.
`snippet.publishedAt`	`datetime` Data i godzina pierwotnego opublikowania wiadomości. Wartość jest podana w formacie ISO 8601 (`YYYY-MM-DDThh:mm:ss.sZ`).
`snippet.hasDisplayContent`	`boolean` Wskazuje, czy wiadomość zawiera treść wyświetlaną, która powinna być wyświetlana użytkownikom.
`snippet.displayMessage`	`string` Zawiera ciąg znaków wyświetlany użytkownikom. To pole nie występuje, jeśli typ wiadomości to `chatEndedEvent` lub `tombstone`.
`snippet.fanFundingEventDetails`	`object` Uwaga: ten obiekt i jego właściwości podrzędne zostały wycofane. Od 28 lutego 2017 r. `liveChatMessage`zasoby nie będą już zwracać szczegółów dotyczących wydarzeń związanych z finansowaniem przez fanów . Ten obiekt zawiera szczegóły dotyczące wydarzenia związanego z finansowaniem. Występuje tylko wtedy, gdy typ wiadomości to `fanFundingEvent`.
`snippet.fanFundingEventDetails.amountMicros`	`unsigned long` Uwaga: ta właściwość została wycofana. Wartość funduszu.
`snippet.fanFundingEventDetails.currency`	`string` Uwaga: ta właściwość została wycofana. Waluta, w której utworzono fundusz.
`snippet.fanFundingEventDetails.amountDisplayString`	`string` Uwaga: ta właściwość została wycofana. Renderowany ciąg tekstowy, który wyświetla użytkownikowi kwotę środków i walutę.
`snippet.fanFundingEventDetails.userComment`	`string` Uwaga: ta właściwość została wycofana. Komentarz dodany przez użytkownika do tego wydarzenia związanego z finansowaniem przez fanów.
`snippet.textMessageDetails`	`object` Ten obiekt zawiera szczegółowe informacje o wiadomości tekstowej. Występuje tylko wtedy, gdy typ wiadomości to `textMessageEvent`.
`snippet.textMessageDetails.messageText`	`string` Wiadomość użytkownika.
`snippet.messageDeletedDetails`	`object` Ten obiekt zawiera szczegółowe informacje o wiadomości usuniętej przez moderatora czatu lub właściciela kanału transmisji na żywo. Występuje tylko wtedy, gdy typ wiadomości to `messageDeletedEvent`.
`snippet.messageDeletedDetails.deletedMessageId`	`string` Identyfikator, który jednoznacznie identyfikuje usuniętą wiadomość. Wartość jest taka sama jak wartość właściwości `id` w przypadku oryginalnej wiadomości tekstowej. Jeśli na przykład obiekt `textMessageEvent` ma wartość właściwości `id` równą `123`, a ta wiadomość zostanie później usunięta, wartość `snippet.messageDeletedDetails.deletedMessageId` będzie dla niej równa `123`. Jeśli po pobraniu wiadomości na czacie zapisujesz je w pamięci podręcznej, użyj wartości tej właściwości, aby zidentyfikować wiadomość, która nie powinna być już wyświetlana.
`snippet.userBannedDetails`	`object` Ten obiekt zawiera szczegółowe informacje o użytkowniku, który został zablokowany na czacie. Zawiera też szczegółowe informacje o samej blokadzie. Użytkownicy mogą zostać zablokowani na czacie na stałe lub tymczasowo.
`snippet.userBannedDetails.bannedUserDetails`	`object` Ten obiekt zawiera informacje o zablokowanym użytkowniku.
`snippet.userBannedDetails.bannedUserDetails.channelId`	`string` Identyfikator kanału YouTube zablokowanego użytkownika.
`snippet.userBannedDetails.bannedUserDetails.channelUrl`	`string` Adres URL kanału YouTube zablokowanego użytkownika.
`snippet.userBannedDetails.bannedUserDetails.displayName`	`string` Wyświetlana nazwa kanału użytkownika, który został zbanowany.
`snippet.userBannedDetails.bannedUserDetails.profileImageUrl`	`string` Awatar kanału YouTube zablokowanego użytkownika.
`snippet.userBannedDetails.banType`	`string` Rodzaj blokady. Prawidłowe wartości tego atrybutu to: nie można zmienić tymczasowy,
`snippet.userBannedDetails.banDurationSeconds`	`unsigned long` Czas trwania blokady. Ta właściwość jest obecna tylko wtedy, gdy wartość właściwości `snippet.userBannedDetails.banType` to `temporary`.
`snippet.memberMilestoneChatDetails`	`object` Ten obiekt zawiera szczegółowe informacje o zdarzeniu etapu Member. Występuje tylko wtedy, gdy typ wiadomości to `memberMilestoneChatEvent`.
`snippet.memberMilestoneChatDetails.userComment`	`string` Komentarz dodany przez wspierającego do tej wiadomości od wspierającego z okazji osiągnięcia kolejnego progu. To pole jest puste w przypadku wiadomości bez komentarza od członka.
`snippet.memberMilestoneChatDetails.memberMonth`	`unsigned integer` Łączna liczba miesięcy (zaokrąglona w górę), w których widz wspierał kanał, co uprawnia go do wysłania tej wiadomości. Jest to taka sama liczba miesięcy, jaka jest wyświetlana użytkownikom YouTube.
`snippet.memberMilestoneChatDetails.memberLevelName`	`string` Nazwa poziomu, na którym widz jest członkiem. Nazwy poziomów są określane przez kanał w YouTube, który oferuje wspieranie. W niektórych sytuacjach to pole nie jest wypełnione.
`snippet.newSponsorDetails`	`object` Ten obiekt zawiera szczegółowe informacje o zdarzeniu ogłoszenia o nowym członku. Jest to ustawiane tylko wtedy, gdy typ to `newSponsorEvent`. „Członek” to określenie „sponsora”.
`snippet.newSponsorDetails.memberLevelName`	`string` Nazwa poziomu, na którym widz jest członkiem. Nazwy poziomów są określane przez kanał w YouTube, który oferuje wspieranie. W niektórych sytuacjach to pole nie jest wypełnione.
`snippet.newSponsorDetails.isUpgrade`	`bool` Wskazuje, czy widz właśnie przeszedł na wyższy poziom. W przypadku widzów, którzy w momencie zakupu nie byli wspierającymi, wartość pola to `false`.
`snippet.superChatDetails`	`object` Ten obiekt zawiera szczegóły dotyczące superczatu. Występuje tylko wtedy, gdy typ wiadomości to `superChatEvent`.
`snippet.superChatDetails.amountMicros`	`unsigned long` Kwota zakupu w milionowych częściach waluty zakupu. Jeśli na przykład kwota zakupu wynosi 1 PLN, wartość właściwości `snippet.amountMicros` to `1000000`.
`snippet.superChatDetails.currency`	`string` Waluta, w której dokonano zakupu. Wartość jest kodem waluty w formacie ISO 4217.
`snippet.superChatDetails.amountDisplayString`	`string` Ciąg znaków, np. `$1.00`, który zawiera kwotę zakupu i walutę. Ciąg znaków jest przeznaczony do wyświetlania użytkownikowi.
`snippet.superChatDetails.userComment`	`string` Komentarz dodany przez użytkownika do tego zdarzenia superczatu.
`snippet.superChatDetails.tier`	`unsigned integer` Poziom płatnej wiadomości. Pamiętaj, że w zasobie `superChatEvent` właściwość `snippet.messageType` zawiera tę wartość. Poziom jest określany na podstawie kwoty wydanej na zakup wiadomości. Określa też kolor, którym wiadomość jest wyróżniana w interfejsie czatu na żywo, maksymalną długość wiadomości i czas, przez jaki wiadomość jest przypięta do paska. Poziomy superczatu są opisane w Centrum pomocy YouTube. (Szczegóły zakupu superczatu znajdziesz w rozwijanej sekcji). Na tej liście poziom z najniższą kwotą zakupu to poziom 1, kolejny najniższy to poziom 2 itd.
`snippet.superStickerDetails`	`object` Ten obiekt zawiera szczegóły zdarzenia związanego z supernaklejką. Występuje tylko wtedy, gdy typ wiadomości to `superStickerEvent`.
`snippet.superStickerDetails.superStickerMetadata`	`object` Szczegóły supernaklejki.
`snippet.superStickerDetails.superStickerMetadata.stickerId`	`string` Unikalny identyfikator obrazu naklejki. Pamiętaj, że obraz jest wyświetlany jako część wiadomości z naklejką Super Sticker tylko wtedy, gdy użytkownicy wyświetlają okno czatu w YouTube. Adres URL obrazu nie jest jednak dostępny za pomocą interfejsu API. W tym pliku CSV znajdziesz informacje o tym, które identyfikatory naklejek są powiązane z poszczególnymi supernaklejkami.
`snippet.superStickerDetails.superStickerMetadata.altText`	`string` Ciąg tekstowy opisujący naklejkę. Pole `snippet.superStickerDetails.superStickerMetadata.language` określa język tekstu. Podczas wywoływania metody `liveChatMessages.list` ustaw wartość parametru hl na wybrany język tekstu.
`snippet.superStickerDetails.superStickerMetadata.language`	`string` Język wartości właściwości `snippet.superStickerDetails.superStickerMetadata.altText`.
`snippet.superStickerDetails.amountMicros`	`unsigned long` Kwota zakupu w milionowych częściach waluty zakupu. Jeśli na przykład kwota zakupu wynosi 1 PLN, wartość właściwości `snippet.amountMicros` to `1000000`.
`snippet.superStickerDetails.currency`	`string` Waluta, w której dokonano zakupu. Wartość jest kodem waluty w formacie ISO 4217.
`snippet.superStickerDetails.amountDisplayString`	`string` Ciąg znaków, np. `$1.00`, który zawiera kwotę zakupu i walutę. Ciąg znaków jest przeznaczony do wyświetlania użytkownikowi.
`snippet.superStickerDetails.tier`	`unsigned integer` Poziom płatnej wiadomości. Pamiętaj, że w zasobie `superChatEvent` właściwość `snippet.messageType` zawiera tę wartość. Poziom jest określany na podstawie kwoty wydanej na zakup wiadomości. Określa też kolor, którym wyróżniona jest wiadomość w interfejsie czatu na żywo, maksymalną długość wiadomości i czas, przez jaki wiadomość jest przypięta do paska. Poziomy superczatu, które obejmują też supernaklejki, są opisane w Centrum pomocy YouTube. (Szczegóły zakupu superczatu znajdziesz w rozwijanej sekcji). Na tej liście poziom z najniższą kwotą zakupu to poziom 1, kolejny najniższy to poziom 2 itd.
`snippet.pollDetails`	`object` Ten obiekt zawiera szczegółowe informacje o zdarzeniu związanym z ankietą. Występuje tylko wtedy, gdy typ wiadomości to `pollEvent`.
`snippet.pollDetails.metadata`	`object` Szczegóły dotyczące wydarzenia związanego z ankietą.
`snippet.pollDetails.metadata.options`	`object` Opcje w ankiecie na żywo.
`snippet.pollDetails.metadata.options.optionText`	`string` Tekst opcji ankiety na żywo.
`snippet.pollDetails.metadata.options.tally`	`string` Liczba głosów oddanych na opcję w ankiecie na żywo. Liczba jest widoczna tylko wtedy, gdy żądanie interfejsu API jest autoryzowane przez właściciela kanału.
`snippet.pollDetails.metadata.questionText`	`string` Tekst pytania w ankiecie na żywo.
`snippet.pollDetails.metadata.status`	`enum` Stan wydarzenia z ankietą na żywo. Prawidłowe wartości tego atrybutu to: `unknown` `active` `closed`
`snippet.membershipGiftingDetails`	`object` Ten obiekt zawiera szczegółowe informacje o zdarzeniu związanym z podarowaniem subskrypcji. Jest on widoczny tylko wtedy, gdy `message type` ma wartość `membershipGiftingEvent`.
`snippet.membershipGiftingDetails.giftMembershipsCount`	`integer` Liczba zakupionych przez użytkownika subskrypcji w prezencie.
`snippet.membershipGiftingDetails.giftMembershipsLevelName`	`string` Nazwa poziomu wspierania, który został kupiony przez użytkownika. Nazwy poziomów są określane przez kanał w YouTube, który oferuje wspieranie. W niektórych sytuacjach to pole nie jest wypełnione.
`snippet.giftMembershipReceivedDetails`	`object` Ten obiekt zawiera szczegóły zdarzenia Gift Membership Received (Otrzymano subskrypcję w prezencie). Jest on widoczny tylko wtedy, gdy `message type` ma wartość `giftMembershipReceivedEvent`.
`snippet.giftMembershipReceivedDetails.memberLevelName`	`string` Nazwa poziomu, na którym widz jest członkiem. Odpowiada to `snippet.membershipGiftingDetails.giftMembershipsLevelName` powiązanej wiadomości o prezencie w postaci członkostwa. Nazwy poziomów są określane przez kanał w YouTube, który oferuje wspieranie. W niektórych sytuacjach to pole nie jest wypełnione.
`snippet.giftMembershipReceivedDetails.gifterChannelId`	`string` Identyfikator użytkownika, który kupił prezent w postaci subskrypcji. Odpowiada to `snippet.authorChannelId` powiązanej wiadomości o prezencie w postaci członkostwa.
`snippet.giftMembershipReceivedDetails.associatedMembershipGiftingMessageId`	`string` Identyfikator wiadomości o prezencie w postaci subskrypcji, która jest powiązana z tą subskrypcją. Ten identyfikator będzie zawsze odnosić się do wiadomości, której pole `type` ma wartość `membershipGiftingEvent`.
`authorDetails`	`object` Obiekt `authorDetails` zawiera dodatkowe informacje o użytkowniku, który opublikował ten komunikat.
`authorDetails.channelId`	`string` Identyfikator kanału autora w YouTube.
`authorDetails.channelUrl`	`string` Adres URL kanału autora w YouTube.
`authorDetails.displayName`	`string` Wyświetlana nazwa kanału autora w YouTube.
`authorDetails.profileImageUrl`	`string` Adres URL awatara kanału autora w YouTube.
`authorDetails.isVerified`	`boolean` Ta wartość wskazuje, czy tożsamość autora została zweryfikowana przez YouTube.
`authorDetails.isChatOwner`	`boolean` Ta wartość wskazuje, czy autor jest właścicielem czatu na żywo.
`authorDetails.isChatSponsor`	`boolean` Ta wartość wskazuje, czy autor jest sponsorem czatu na żywo.
`authorDetails.isChatModerator`	`boolean` Ta wartość wskazuje, czy autor jest moderatorem czatu na żywo.

LiveChatMessages Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Metody

Prezentacja zasobów

Właściwości

LiveChatMessages