CommentThreads

Eine commentThread-Ressource enthält Informationen zu einem YouTube-Kommentarthread, der einen Kommentar auf oberster Ebene und, falls vorhanden, Antworten auf diesen Kommentar umfasst. Eine commentThread-Ressource steht für Kommentare zu einem Video.

Sowohl der Kommentar auf oberster Ebene als auch die Antworten sind eigentlich comment-Ressourcen, die in der Ressource commentThread 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. Auf einige Kommentare kann nicht geantwortet werden.

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
Erstellt einen neuen Kommentar auf oberster Ebene. Wenn Sie auf einen vorhandenen Kommentar eine Antwort hinzufügen möchten, verwenden Sie stattdessen die Methode comments.insert. Jetzt testen

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, die YouTube zur eindeutigen Identifizierung des Kommentarthreads verwendet.
snippet object
Das Objekt snippet enthält grundlegende Details zum Kommentarthread. Sie enthält auch den Kommentar der obersten Ebene 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 Die Eigenschaft snippet.videoId identifiziert das Video.
snippet.videoId string
Die ID des Videos, auf das sich die Kommentare beziehen.
snippet.topLevelComment object
Der übergeordnete Kommentar des Threads. Der Wert des Attributs ist eine comment-Ressource.
snippet.canReply boolean
Diese Einstellung gibt an, ob der aktuelle Zuschauer auf den Thread antworten kann.
snippet.totalReplyCount unsigned integer
Die Gesamtzahl der Antworten, die als Antwort auf den Kommentar auf oberster Ebene gesendet wurden.
snippet.isPublic boolean
Diese Einstellung gibt an, ob der Thread, einschließlich aller Kommentare und Kommentarantworten, 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, sofern vorhanden. Das Attribut replies.comments stellt die Liste der Kommentare selbst dar.
replies.comments[] list
Eine Liste mit einer oder mehreren Antworten auf den Kommentar auf oberster Ebene. 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 Eigenschaft snippet.totalReplyCount entspricht, ist die Antwortliste nur eine Teilmenge der Gesamtzahl der Antworten, die für den Kommentar auf oberster Ebene verfügbar sind. Wenn Sie alle Antworten für den Kommentar der obersten Ebene abrufen möchten, rufen Sie die Methode comments.list auf und verwenden Sie den Anfrageparameter parentId, um den Kommentar zu identifizieren, für den Sie Antworten abrufen möchten.