CommentThreads

Eine commentThread-Ressource enthält Informationen zu einem YouTube-Kommentarthread, der einen Kommentar auf oberster Ebene und gegebenenfalls Antworten auf diesen Kommentar umfasst. Eine commentThread-Ressource kann Kommentare zu einem Video oder einem Kanal darstellen.

Sowohl der übergeordnete Kommentar als auch die Antworten sind comment-Ressourcen, die in der Ressource commentThread verschachtelt sind. Die Ressource commentThread enthält nicht unbedingt alle Antworten auf einen Kommentar. Mit der Methode comments.list kannst du alle Antworten für einen bestimmten Kommentar abrufen. Beachte außerdem, dass für einige Kommentare keine Antworten vorhanden sind.

Methoden

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

list
Gibt eine Liste von Kommentarthreads zurück, die den API-Anfrageparametern entsprechen. Hier kannst du die Funktion ausprobieren.
Einfügen
Es wird ein neuer Kommentar auf oberster Ebene erstellt. Wenn Sie einem vorhandenen Kommentar eine Antwort hinzufügen möchten, verwenden Sie stattdessen die Methode comments.insert. Jetzt ausprobieren.

Ressourcendarstellung

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

{
  "kind": "youtube#commentThread",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "videoId": string,
    "topLevelComment": comments Resource,
    "canReply": boolean,
    "totalReplyCount": unsigned integer,
    "isPublic": boolean
  },
  "replies": {
    "comments": [
      comments Resource
    ]
  }
}

Attribute

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

Attribute
kind string
Identifiziert den Typ der API-Ressource. Der Wert ist youtube#commentThread.
etag etag
Das ETag dieser Ressource.
id string
Die ID, mit der YouTube den Kommentarthread eindeutig identifiziert.
snippet object
Das Objekt snippet enthält grundlegende Details zum Kommentarthread. Sie enthält auch den Kommentar der obersten Ebene des Threads, eine comment-Ressource.
snippet.channelId string
Der YouTube-Kanal, der mit den Kommentaren im Thread verknüpft ist. Mit der Eigenschaft snippet.videoId wird das Video identifiziert.
  • Wenn sich die Kommentare auf ein Video beziehen, gibt der Wert den Kanal an, über den das Video hochgeladen wurde. Mit der Eigenschaft snippet.videoId wird das Video identifiziert.
  • Wenn sich die Kommentare auf den Kanal selbst beziehen, hat die Property snippet.videoId keinen Wert.
snippet.videoId string
Die ID des Videos, auf das sich die Kommentare beziehen, falls zutreffend. Wenn diese Property nicht vorhanden ist oder keinen Wert hat, gilt der Thread für den Kanal und nicht für ein bestimmtes Video.
snippet.topLevelComment object
Der oberste Kommentar im Thread. Der Wert des Attributs ist eine Ressource vom Typ comment.
snippet.canReply boolean
Diese Einstellung gibt an, ob der aktuelle Betrachter auf den Thread antworten kann.
snippet.totalReplyCount unsigned integer
Die Gesamtzahl der Antworten auf den Kommentar auf oberster Ebene.
snippet.isPublic boolean
Diese Einstellung gibt an, ob der Thread, einschließlich aller Kommentare und Antworten, für alle YouTube-Nutzer sichtbar ist.
replies object
Das replies-Objekt ist ein Container, der gegebenenfalls eine Liste der Antworten auf den Kommentar enthält. Die Property replies.comments stellt die Liste der Kommentare selbst dar.
replies.comments[] list
Eine Liste mit einer oder mehreren Antworten auf den obersten Kommentar. Jedes Element in der Liste ist eine comment-Ressource.

Die Liste enthält eine begrenzte Anzahl von Antworten. Wenn die Anzahl der Elemente in der Liste nicht dem Wert der Property snippet.totalReplyCount entspricht, ist die Liste der Antworten nur ein Teil der Gesamtzahl der Antworten, die für den obersten Kommentar verfügbar sind. Wenn Sie alle Antworten für den Kommentar der obersten Ebene abrufen möchten, müssen Sie die Methode comments.list aufrufen und mit dem Anfrageparameter parentId den Kommentar angeben, für den Sie die Antworten abrufen möchten.