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 potrebbe 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 di richiesta dell'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.
update
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.
Esprime l'opinione dell'utente che chiama secondo cui uno o più commenti devono essere segnalati 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 le 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. I metodi comments.list e commentThreads.list supportano entrambi un parametro textFormat, che specifica il formato di testo scelto.

Anche il testo normale può essere diverso 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 elaborato del commento così come è stato pubblicato inizialmente o aggiornato per 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 al commento una valutazione negativa o non ha assegnato alcuna valutazione.

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 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 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 per la prima volta. 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.