Una risorsa comment
contiene informazioni su un singolo commento di YouTube. Una risorsa comment
può rappresentare un commento su un video o un canale. Inoltre, il commento potrebbe essere un commento di primo livello o una risposta a un commento di livello superiore.
Metodi
L'API supporta i seguenti metodi per le risorse comments
:
- list
- Restituisci un elenco di commenti che corrispondono ai parametri di richiesta API. Prova subito.
- insert
- Crea una risposta a un commento esistente. Nota: per creare un commento di primo livello, utilizza il metodo
commentThreads.insert
. Prova subito. - aggiorna
- 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 ritirato e non è più supportato. di Gemini Advanced.
- Esprime l'opinione del chiamante secondo cui uno o più commenti dovrebbero essere segnalati come spam.
Rappresentazione della risorsa
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 contiene 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 testo normale o HTML. Entrambi i metodi comments.list e commentThreads.list supportano un parametro textFormat , che specifica il formato di testo scelto.Anche il testo normale può differire dal testo originale del commento. Ad esempio, potrebbe sostituire i link ai video con i titoli dei video. |
snippet.textOriginal |
string Il testo originale non elaborato del commento, così come è stato pubblicato inizialmente o aggiornato l'ultima volta. 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 l'utente che sta guardando il video può valutare il commento. |
snippet.viewerRating |
string Il punteggio assegnato dal visualizzatore a questo commento. Questa proprietà non identifica le valutazioni dislike , anche se questo comportamento è soggetto a modifiche. Nel frattempo, il valore della proprietà è like se lo spettatore ha valutato il commento in modo positivo. Il valore è none in tutti gli altri casi, ad esempio se l'utente ha assegnato una valutazione negativa al commento o non lo ha valutato.I valori validi per questa proprietà sono:
|
snippet.likeCount |
unsigned integer Il numero totale di Mi piace (valutazioni positive) ricevuti dal commento. |
snippet.moderationStatus |
string Lo stato della moderazione del commento. Questa proprietà viene restituita solo se la richiesta API è stata autorizzata dal proprietario del canale o del video su cui sono stati pubblicati i commenti richiesti. Inoltre, questa proprietà non è impostata se la richiesta API ha utilizzato il parametro del 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. |