CommentThreads

Zasób commentThread zawiera informacje o wątku komentarza w YouTube, który obejmuje komentarz najwyższego poziomu i odpowiedzi na ten komentarz (jeśli istnieją) Zasób commentThread reprezentuje komentarze do filmu.

Zarówno komentarz najwyższego poziomu, jak i odpowiedzi to w rzeczywistości zasoby commentzagnieżdżone w zasobie commentThread. Zasób commentThread nie musi zawierać wszystkich odpowiedzi na komentarz. Aby pobrać wszystkie odpowiedzi na konkretny komentarz, musisz użyć metody comments.list. Na niektóre komentarze nie ma odpowiedzi.

Metody

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

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

Reprezentowanie zasobu

Struktura JSON pokazuje 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
    ]
  }
}

Właściwości

Tabela poniżej zawiera właściwości widoczne w tym zasobie:

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartość wyniesie youtube#commentThread.
etag etag
Etag tego zasobu.
id string
Identyfikator, za pomocą którego YouTube jednoznacznie identyfikuje wątek komentarza.
snippet object
Obiekt snippet zawiera podstawowe informacje o wątku komentarza. Zawiera też komentarz najwyższego poziomu do wątku, który jest zasobem comment.
snippet.channelId string
Kanał w YouTube powiązany z komentarzami w wątku. Właściwość snippet.videoId identyfikuje film.
snippet.videoId string
Identyfikator filmu, którego dotyczą komentarze.
snippet.topLevelComment object
Komentarz najwyższego poziomu wątku. Wartość właściwości jest zasobem 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 odpowiedzi na komentarz najwyższego poziomu (co najmniej 1 odpowiedź). Każda pozycja na liście jest commentzasobem.

Lista zawiera ograniczoną liczbę odpowiedzi. O ile liczba elementów na liście nie jest równa wartości właściwości snippet.totalReplyCount, lista odpowiedzi stanowi tylko podzbiór łącznej liczby odpowiedzi dostępnych na komentarz 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, na który chcesz pobrać odpowiedzi.