CommentThreads

Um recurso commentThread contém informações sobre uma sequência de comentários do YouTube, que compreende um comentário de nível superior e respostas, se houver, a esse comentário. O recurso commentThread representa os comentários de um vídeo.

O comentário de nível superior e as respostas são, na verdade, recursos comment aninhados no recurso commentThread. O recurso commentThread não contém necessariamente todas as respostas a um comentário, e você precisa usar o método comments.list se quiser recuperar todas as respostas de um comentário específico. Alguns comentários não têm respostas.

Métodos

A API é compatível com os seguintes métodos para recursos commentThreads:

list
Retorna uma lista de linhas de execução de comentários que correspondem aos parâmetros da solicitação da API. Faça um teste agora.
inserir
Cria um novo comentário de nível superior. Para responder a um comentário já existente, use o método comments.insert. Faça um teste agora.

Representação de recurso

A estrutura JSON mostra o formato de um recurso 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
    ]
  }
}

Propriedades

A tabela a seguir define as propriedades que aparecem neste recurso:

Propriedades
kind string
Identifica o tipo de recurso da API. O valor será youtube#commentThread.
etag etag
A Etag deste recurso.
id string
O ID que o YouTube usa para identificar de forma exclusiva a sequência de comentários.
snippet object
O objeto snippet contém detalhes básicos sobre a sequência de comentários. Ele também contém o comentário de nível superior da linha de execução, que é um recurso comment.
snippet.channelId string
O canal do YouTube associado aos comentários na conversa. A propriedade snippet.videoId identifica o vídeo.
snippet.videoId string
O ID do vídeo ao qual os comentários se referem.
snippet.topLevelComment object
O comentário de nível superior da conversa. O valor da propriedade é um recurso comment.
snippet.canReply boolean
Essa configuração indica se o espectador atual pode responder à conversa.
snippet.totalReplyCount unsigned integer
O número total de respostas enviadas em resposta ao comentário da parte superior.
snippet.isPublic boolean
Esta configuração indica se a conversa, incluindo todos os comentários e respostas a comentários, está visível para todos os usuários do YouTube.
replies object
O objeto replies é um contêiner que contém uma lista de respostas ao comentário, se houver. A propriedade replies.comments representa a própria lista de comentários.
replies.comments[] list
Uma lista de uma ou mais respostas ao comentário da parte superior. Cada item na lista é um recurso do comment.

A lista contém um número limitado de respostas e, a menos que o número de itens na lista seja igual ao valor da propriedade snippet.totalReplyCount, a lista de respostas é apenas um subconjunto do número total de respostas disponíveis para o comentário de nível superior. Para recuperar todas as respostas ao comentário de nível superior, chame o método comments.list e use o parâmetro de solicitação parentId para identificar o comentário para o qual você quer recuperar respostas.