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. |