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. |