CommentThreads

Zasób commentThread zawiera informacje o wątku komentarzy w YouTube, który składa się z komentarza najwyższego poziomu oraz ewentualnych odpowiedzi na ten komentarz. Zasób commentThread reprezentuje komentarze do filmu.

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

Metody

Interfejs API obsługuje te metody 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 teraz

Reprezentacja 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

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

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartością będzie youtube#commentThread.
etag etag
ETag tego zasobu.
id string
Identyfikator, którego YouTube używa do jednoznacznego identyfikowania wątku komentarza.
snippet object
Obiekt snippet zawiera podstawowe informacje o wątku komentarza. Zawiera też 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.
snippet.videoId string
Identyfikator filmu, którego dotyczą komentarze.
snippet.topLevelComment object
Komentarz najwyższego poziomu wątku. Wartością właściwości jest zasób comment.
snippet.canReply boolean
To ustawienie określa, czy obecny przeglądający może odpowiadać na wątek.
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, wraz ze wszystkimi zawartymi w nim komentarzami i odpowiedziami 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 z 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 odpowiedzi jest tylko podzbiorem łącznej liczby odpowiedzi dostępnych na komentarz najwyższego poziomu. Aby pobrać wszystkie odpowiedzi dotyczące komentarza najwyższego poziomu, musisz wywołać metodę comments.list i użyć parametru żądania parentId, aby wskazać komentarz, do którego chcesz pobrać odpowiedzi.