CommentThreads

Zasób commentThread zawiera informacje na temat wątku komentarza w YouTube, który składa się z komentarza najwyższego poziomu i ewentualnych odpowiedzi do tego komentarza. Zasób commentThread może reprezentować komentarze do filmu lub kanału.

Zarówno komentarz najwyższego poziomu, jak i odpowiedzi są comment zasobami umieszczonymi w zasobie commentThread. Zasób commentThread nie musi zawierać wszystkich odpowiedzi na komentarz. Jeśli chcesz pobrać wszystkie odpowiedzi na dany komentarz, musisz użyć metody comments.list. Pamiętaj też, że niektóre komentarze nie zawierają odpowiedzi.

Metody

Interfejs API obsługuje następujące metody w przypadku zasobów commentThreads:

list
Zwraca listę wątków komentarzy, które pasują do parametrów żądania do interfejsu API. Wypróbuj teraz
wstaw
Tworzy nowy komentarz najwyższego poziomu. Aby dodać odpowiedź do istniejącego komentarza, użyj metody comments.insert. Wypróbuj teraz

Reprezentowanie zasobów

Struktura JSON poniżej przedstawia format zasobu commentThreads:

{
  "kind": "youtube#commentThread",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "videoId": string,
    "topLevelComment": comments Resource,
    "canReply": boolean,
    "totalReplyCount": unsigned integer,
    "isPublic": boolean
  },
  "replies": {
    "comments": [
      comments Resource
    ]
  }
}

Usługi

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

Usługi
kind string
Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#commentThread.
etag etag
Otagowanie tego zasobu.
id string
Identyfikator, który jest używany przez YouTube do jednoznacznego identyfikowania wątku komentarza.
snippet object
Obiekt snippet zawiera podstawowe informacje o wątku komentarza. Zawiera również komentarz najwyższego poziomu wątku, który jest zasobem comment.
snippet.channelId string
Kanał YouTube powiązany z komentarzami w wątku. (Właściwość snippet.videoId identyfikuje film).
  • Jeżeli komentarz dotyczy filmu, wartością jest kanał, który przesłał film. (Właściwość snippet.videoId identyfikuje film).
  • Jeśli komentarze dotyczą samego kanału, właściwość snippet.videoId nie ma wartości.
snippet.videoId string
Identyfikator filmu, do którego odnoszą się komentarze. Jeśli ta właściwość jest niedostępna lub nie ma wartości, wątek odnosi się do kanału, a nie do konkretnego filmu.
snippet.topLevelComment object
Komentarz najwyższego poziomu wątku. Wartość właściwości to zasób comment.
snippet.canReply boolean
To ustawienie wskazuje, czy bieżący widz może odpowiedzieć w wątku.
snippet.totalReplyCount unsigned integer
Łączna liczba odpowiedzi przesłanych w odpowiedzi na komentarz najwyższego poziomu.
snippet.isPublic boolean
To ustawienie wskazuje, czy wątek, w tym wszystkie komentarze i odpowiedzi na komentarze, jest widoczny dla wszystkich użytkowników YouTube.
replies object
Obiekt replies to kontener zawierający listę odpowiedzi na komentarz (jeśli istnieją). Właściwość replies.comments reprezentuje listę komentarzy.
replies.comments[] list
Lista co najmniej 1 odpowiedzi na komentarz najwyższego poziomu. Każda pozycja na liście jest zasobem comment.

Lista zawiera ograniczoną liczbę odpowiedzi. Jeśli liczba elementów na liście nie jest równa wartości właściwości snippet.totalReplyCount, lista stanowi tylko podzbiór łącznej liczby odpowiedzi dostępnych dla komentarza najwyższego poziomu. Aby pobrać wszystkie odpowiedzi na komentarz najwyższego poziomu, musisz wywołać metodę comments.list i użyć parametru żądania parentId, aby wskazać komentarz, którego dotyczy ten komentarz.