Una risorsa comment
contiene informazioni su un singolo commento di YouTube. Una risorsa comment
può rappresentare un commento su un video o un canale. Può trattarsi, inoltre, di un commento di primo livello o una risposta a un commento di primo livello.
Metodi
L'API supporta i seguenti metodi per le risorse comments
:
- list
- Restituisci un elenco di commenti che corrispondono ai parametri della richiesta API. Prova subito.
- inserire
- Crea una risposta a un commento esistente. Nota:per creare un commento di primo livello, utilizza il metodo
commentThreads.insert
. Prova subito. - aggiornamento
- Modifica un commento. Prova subito.
- elimina
- Elimina un commento. Prova subito.
- setModerationStatus
- Imposta lo stato di moderazione di uno o più commenti. La richiesta API deve essere autorizzata dal proprietario del canale o del video associato ai commenti. Prova subito.
- markAsSpam
- Nota: questo metodo è stato deprecato e non è più supportato.
- Esprime l'opinione del chiamante secondo cui uno o più commenti dovrebbero essere contrassegnati come spam.
Rappresentazione delle risorse
La seguente struttura JSON mostra il formato di una risorsa comments
:
{ "kind": "youtube#comment", "etag": etag, "id": string, "snippet": { "authorDisplayName": string, "authorProfileImageUrl": string, "authorChannelUrl": string, "authorChannelId": { "value": string }, "channelId": string, "textDisplay": string, "textOriginal": string, "parentId": string, "canRate": boolean, "viewerRating": string, "likeCount": unsigned integer, "moderationStatus": string, "publishedAt": datetime, "updatedAt": datetime } }
Proprietà
La tabella seguente definisce le proprietà visualizzate in questa risorsa:
Proprietà | |
---|---|
kind |
string Identifica il tipo di risorsa API. Il valore sarà youtube#comment . |
etag |
etag L'Etag di questa risorsa. |
id |
string L'ID utilizzato da YouTube per identificare in modo univoco il commento. |
snippet |
object L'oggetto snippet contiene i dettagli di base del commento. |
snippet.authorDisplayName |
string Il nome visualizzato dell'utente che ha pubblicato il commento. |
snippet.authorProfileImageUrl |
string L'URL dell'avatar dell'utente che ha pubblicato il commento. |
snippet.authorChannelUrl |
string L'URL del canale YouTube dell'autore del commento, se disponibile. |
snippet.authorChannelId |
object Questo oggetto racchiude informazioni sul canale YouTube dell'autore del commento, se disponibili. |
snippet.authorChannelId.value |
string L'ID del canale YouTube dell'autore del commento, se disponibile. |
snippet.channelId |
string L'ID del canale YouTube associato al commento. |
snippet.textDisplay |
string Il testo del commento. Il testo può essere recuperato in formato testo normale o HTML. I metodi comments.list e commentThreads.list supportano entrambi un parametro textFormat , che specifica il formato di testo scelto.Anche il testo normale può differire dal testo originale del commento. Ad esempio, potrebbero sostituire i link ai video con i titoli. |
snippet.textOriginal |
string Il testo originale non elaborato del commento così come è stato pubblicato inizialmente o per l'ultimo aggiornamento. Il testo originale viene restituito all'utente autenticato solo se è l'autore del commento. |
snippet.parentId |
string L'ID univoco del commento principale. Questa proprietà viene impostata solo se il commento è stato inviato come risposta a un altro commento. |
snippet.canRate |
boolean Questa impostazione indica se lo spettatore corrente può valutare il commento. |
snippet.viewerRating |
string La valutazione che lo spettatore ha assegnato al commento. Questa proprietà non identifica le valutazioni di dislike , anche se questo comportamento è soggetto a modifiche. Nel frattempo, il valore della proprietà è like se lo spettatore ha valutato positivamente il commento. Il valore è none in tutti gli altri casi, incluso l'utente che ha dato una valutazione negativa al commento o non lo ha valutato.I valori validi per questa struttura sono:
|
snippet.likeCount |
unsigned integer Il numero totale di Mi piace (valutazioni positive) ricevuti dal commento. |
snippet.moderationStatus |
string Lo stato di moderazione del commento. Questa proprietà viene restituita solo se la richiesta API è stata autorizzata dal proprietario del canale o dal video sul quale sono stati inseriti i commenti richiesti. Inoltre, questa proprietà non è impostata se la richiesta API utilizza il parametro di filtro id .I valori validi per questa proprietà sono:
|
snippet.publishedAt |
datetime La data e l'ora in cui il commento è stato pubblicato originariamente. Il valore è specificato nel formato ISO 8601. |
snippet.updatedAt |
datetime La data e l'ora dell'ultimo aggiornamento del commento. Il valore è specificato nel formato ISO 8601. |