CommentThreads

Um recurso commentThread contém informações sobre uma conversa 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 em um vídeo.

O comentário de nível superior e as respostas são, na verdade, comment recursos aninhados no 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 oferece suporte aos seguintes métodos para recursos commentThreads:

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

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 desse recurso.
id string
O ID que o YouTube usa para identificar de forma exclusiva a conversa de comentários.
snippet object
O objeto snippet contém detalhes básicos sobre a conversa de comentários. Ela também contém o comentário de nível superior da conversa, 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 a que 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 leitor atual pode responder à conversa.
snippet.totalReplyCount unsigned integer
O número total de respostas enviadas em resposta ao comentário de nível superior.
snippet.isPublic boolean
Essa configuração indica se a conversa, incluindo todos os comentários e respostas de comentários dela, fica 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 lista de comentários em si.
replies.comments[] list
Uma lista com uma ou mais respostas para o comentário de nível superior. Cada item na lista é um recurso 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 será apenas um subconjunto do número total de respostas disponíveis para o comentário de nível superior. Para recuperar todas as respostas do 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.