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