Comments

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:
  • like
  • none
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:
  • heldForReview
  • likelySpam
  • published
  • rejected
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.