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. Inoltre, il commento può essere 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
Restituisce un elenco di commenti che corrispondono ai parametri della 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.
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.

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 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 formato HTML o testo normale. (I metodi comments.list e commentThreads.list supportano entrambi un parametro textFormat, che specifica il formato di testo scelto.)

Anche il testo normale potrebbe differire dal testo del commento originale. Ad esempio, potrebbe sostituire i link ai video con i titoli dei video.
snippet.textOriginal string
Il testo originale non modificato 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 il visualizzatore corrente può valutare il commento.
snippet.viewerRating string
Il punteggio che lo spettatore ha assegnato 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 positivamente il commento. Il valore è none in tutti gli altri casi, incluso quello in cui l'utente ha assegnato al commento una valutazione negativa o non ha valutato il commento.

I valori validi per questa proprietà 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 del video su cui sono stati pubblicati i commenti richiesti. Inoltre, questa proprietà non viene impostata se la richiesta API ha utilizzato 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.