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 bei dem Kommentar um einen Originalkommentar oder eine Antwort auf einen Originalkommentar handeln.

Methoden

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

list
Gibt eine Liste von Kommentaren zurück, die den Parametern der API-Anfrage entsprechen. Hier kannst du die Funktion ausprobieren.
insert
Erstellt eine Antwort auf einen vorhandenen Kommentar. Hinweis:Wenn Sie einen Kommentar der obersten Ebene erstellen möchten, verwenden Sie die Methode commentThreads.insert. Jetzt ausprobieren
Aktualisierung
Ändert einen Kommentar. Hier kannst du die Funktion ausprobieren.
Delete
Löscht einen Kommentar. Hier kannst du die Funktion ausprobieren.
setModerationStatus
Legt den Moderationsstatus von einem oder mehreren Kommentaren 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,
    "imageUrl": string
  }
}

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 zur eindeutigen Identifizierung des Kommentars verwendet.
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 Kommentarautors, 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 Kommentarautors, sofern 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 comments.list- als auch die commentThreads.list-Methode unterstützen einen textFormat-Parameter, der das ausgewählte Textformat angibt.

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 Eigenschaft 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. Mit dieser Eigenschaft werden keine dislike-Bewertungen identifiziert. Dieses Verhalten kann sich jedoch ändern. In der Zwischenzeit ist der Eigenschaftswert like, wenn der Zuschauer den Kommentar positiv bewertet hat. In allen anderen Fällen ist der Wert 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 „Gefällt mir“-Angaben (positive 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, in 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
Das Datum und die Uhrzeit, zu der der Kommentar ursprünglich veröffentlicht wurde. 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.
snippet.imageUrl string
Die URL des Bildes oder animierten GIFs, das dem Kommentar angehängt ist, falls vorhanden. Diese Property ist nur vorhanden, wenn ein Kommentar ein Bild oder GIF enthält. Die URL wird als signierter Link mit einer Gültigkeitsdauer (Time-to-Live, TTL) von sechs Stunden bereitgestellt und läuft sechs Stunden nach dem Abrufen ab.