Comments

Eine comment-Ressource enthält Informationen zu einem einzelnen YouTube-Kommentar. Eine comment-Ressource kann einen Kommentar zu einem Video oder einem Kanal darstellen. Außerdem kann es sich um einen Kommentar der obersten Ebene oder eine Antwort auf einen Kommentar der obersten Ebene handeln.

Methoden

Die API unterstützt die folgenden Methoden für comments-Ressourcen:

list
Gibt eine Liste von Kommentaren zurück, die den API-Anfrageparametern entsprechen. Hier kannst du die Funktion ausprobieren.
insert
Erstellt eine Antwort auf einen vorhandenen Kommentar. Hinweis:Verwenden Sie zum Erstellen eines Kommentars der obersten Ebene die Methode commentThreads.insert. Jetzt testen
Aktualisieren
Ändert einen Kommentar. Hier kannst du die Funktion ausprobieren.
Delete
Löscht einen Kommentar. Hier kannst du die Funktion ausprobieren.
setModerationStatus
Legt den Moderationsstatus eines oder mehrerer Kommentare fest. Die API-Anfrage muss vom Inhaber des Kanals oder Videos autorisiert werden, der bzw. das mit den Kommentaren verknüpft ist. Hier kannst du die Funktion ausprobieren.

Ressourcendarstellung

Die folgende JSON-Struktur zeigt das Format einer comments-Ressource:

{
  "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
  }
}

Attribute

In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource enthalten sind:

Attribute
kind string
Gibt den Typ der API-Ressource an. Der Wert ist youtube#comment.
etag etag
Das ETag dieser Ressource.
id string
Die ID, die YouTube verwendet, um den Kommentar eindeutig zu identifizieren.
snippet object
Das snippet-Objekt enthält grundlegende Details zum Kommentar.
snippet.authorDisplayName string
Der Anzeigename des Nutzers, der den Kommentar gepostet hat.
snippet.authorProfileImageUrl string
Die URL für den Avatar des Nutzers, der den Kommentar gepostet hat.
snippet.authorChannelUrl string
Die URL des YouTube-Kanals des Verfassers des Kommentars, sofern verfügbar.
snippet.authorChannelId object
Dieses Objekt enthält Informationen zum YouTube-Kanal des Kommentarautors, sofern verfügbar.
snippet.authorChannelId.value string
Die ID des YouTube-Kanals des Verfassers des Kommentars, falls verfügbar.
snippet.channelId string
Die ID des YouTube-Kanals, der mit dem Kommentar verknüpft ist.
snippet.textDisplay string
Der Text des Kommentars. Der Text kann entweder als Nur-Text oder als HTML abgerufen werden. Sowohl die Methode comments.list als auch die Methode commentThreads.list unterstützen den Parameter textFormat, mit dem das ausgewählte Textformat angegeben wird.

Auch der Nur-Text kann sich vom ursprünglichen Kommentartext unterscheiden. So werden beispielsweise Videolinks durch Videotitel ersetzt.
snippet.textOriginal string
Der ursprüngliche, unformatierte Text des Kommentars, wie er ursprünglich gepostet oder zuletzt aktualisiert wurde. Der Originaltext wird nur an den authentifizierten Nutzer zurückgegeben, wenn er der Autor des Kommentars ist.
snippet.parentId string
Die eindeutige ID des übergeordneten Kommentars. Diese Property wird nur festgelegt, wenn der Kommentar als Antwort auf einen anderen Kommentar eingereicht wurde.
snippet.canRate boolean
Diese Einstellung gibt an, ob der aktuelle Betrachter den Kommentar bewerten kann.
snippet.viewerRating string
Die Bewertung, die der Zuschauer diesem Kommentar gegeben hat. Diese Eigenschaft gibt keine dislike-Bewertungen an. Dieses Verhalten kann sich jedoch ändern. In der Zwischenzeit ist der Property-Wert like, wenn der Zuschauer den Kommentar positiv bewertet hat. Der Wert ist in allen anderen Fällen none, auch wenn der Nutzer den Kommentar negativ bewertet oder nicht bewertet hat.

Gültige Werte für diese Property sind:
  • like
  • none
snippet.likeCount unsigned integer
Die Gesamtzahl der positiven Bewertungen, die der Kommentar erhalten hat.
snippet.moderationStatus string
Der Moderationsstatus des Kommentars. Diese Property wird nur zurückgegeben, wenn die API-Anfrage vom Inhaber des Kanals oder des Videos autorisiert wurde, zu dem die angeforderten Kommentare abgegeben wurden. Dieses Attribut wird auch nicht festgelegt, wenn im API-Aufruf der Filterparameter id verwendet wurde.

Gültige Werte für dieses Attribut sind:
  • heldForReview
  • likelySpam
  • published
  • rejected
snippet.publishedAt datetime
Datum und Uhrzeit der ursprünglichen Veröffentlichung des Kommentars. Der Wert wird im ISO 8601-Format angegeben.
snippet.updatedAt datetime
Datum und Uhrzeit der letzten Aktualisierung des Kommentars. Der Wert wird im ISO 8601-Format angegeben.