CommentThreads

Eine commentThread-Ressource enthält Informationen zu einem YouTube-Kommentarthread, der aus einem Kommentar der obersten Ebene und den Antworten auf diesen Kommentar besteht. Eine commentThread-Ressource steht für Kommentare zu einem Video.

Sowohl der Kommentar der obersten Ebene als auch die Antworten sind comment-Ressourcen, die in der commentThread-Ressource verschachtelt sind. Die Ressource commentThread enthält nicht unbedingt alle Antworten auf einen Kommentar. Sie müssen die Methode comments.list verwenden, wenn Sie alle Antworten auf einen bestimmten Kommentar abrufen möchten. Für einige Kommentare gibt es keine Antwort.

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.
insert
Zum Erstellen eines neuen Kommentars auf oberster Ebene. Wenn Sie eine Antwort zu einem vorhandenen Kommentar hinzufügen möchten, verwenden Sie stattdessen die Methode comments.insert. Jetzt ausprobieren

Ressourcendarstellung

Die 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. Außerdem enthält es den Top-Level-Kommentar des Threads, bei dem es sich um eine comment-Ressource handelt.
snippet.channelId string
Der YouTube-Kanal, der mit den Kommentaren im Thread verknüpft ist. Das Attribut snippet.videoId identifiziert das Video.
snippet.videoId string
Die ID des Videos, auf das sich die Kommentare beziehen.
snippet.topLevelComment object
Der Kommentar der obersten Ebene des Threads. Der Wert des Attributs ist eine comment-Ressource.
snippet.canReply boolean
Diese Einstellung gibt an, ob der aktuelle Betrachter auf die Unterhaltung antworten kann.
snippet.totalReplyCount unsigned integer
Die Gesamtzahl der Antworten, die auf den Kommentar der obersten Ebene beantwortet wurden.
snippet.isPublic boolean
Mit dieser Einstellung wird festgelegt, ob der Thread einschließlich aller Kommentare und Antworten auf Kommentare für alle YouTube-Nutzer sichtbar ist.
replies object
Das replies-Objekt ist ein Container, der eine Liste von Antworten auf den Kommentar enthält, falls vorhanden. Das Attribut replies.comments steht für die Liste der Kommentare selbst.
replies.comments[] list
Eine Liste mit mindestens einer Antwort auf den Kommentar der obersten Ebene. Jeder Eintrag in der Liste ist eine comment-Ressource.

Die Liste enthält eine begrenzte Anzahl von Antworten. Sofern die Anzahl der Elemente in der Liste nicht dem Wert der Eigenschaft snippet.totalReplyCount entspricht, ist die Liste der Antworten nur eine Teilmenge der Gesamtzahl der Antworten, die für den Kommentar der obersten Ebene verfügbar sind. Um alle Antworten für den Kommentar der obersten Ebene abzurufen, müssen Sie die Methode comments.list aufrufen und den Anfrageparameter parentId verwenden, um den Kommentar zu identifizieren, für den Sie Antworten abrufen möchten.