Eine comment
-Ressource enthält Informationen zu einem einzelnen YouTube-Kommentar. Eine comment
-Ressource kann einen Kommentar zu einem Video oder einem Kanal darstellen. Außerdem kann es sich bei dem Kommentar um einen Top-Level-Kommentar oder um eine Antwort auf einen Top-Level-Kommentar handeln.
Methoden
Die API unterstützt die folgenden Methoden für comments
-Ressourcen:
- list
- Gibt eine Liste von Kommentaren zurück, die mit den API-Anfrageparametern übereinstimmen. Hier kannst du die Funktion ausprobieren.
- einfügen
- Antwort auf einen vorhandenen Kommentar erstellen Hinweis: Verwenden Sie zum Erstellen eines Kommentars auf oberster Ebene die Methode
commentThreads.insert
. Jetzt ausprobieren - aktualisieren
- Ändert einen Kommentar. Hier kannst du die Funktion ausprobieren.
- delete
- Löscht einen Kommentar. Hier kannst du die Funktion ausprobieren.
- setModerationStatus
- Legt den Moderationsstatus für einen oder mehrere Kommentare fest. Die API-Anfrage muss vom Inhaber des mit den Kommentaren verknüpften Kanals oder Videos autorisiert werden. Hier kannst du die Funktion ausprobieren.
- markAsSpam
- Hinweis: Diese Methode wurde verworfen und wird nicht mehr unterstützt.
- Drückt die Meinung des Aufrufers aus, dass mindestens ein Kommentar als Spam gemeldet werden sollte
Ressourcendarstellung
Die folgende JSON-Struktur zeigt das Format einer comments
-Ressource:
{ "kind": "youtube#comment", "etag": etag, "id": string, "snippet": { "authorDisplayName": string, "authorProfileImageUrl": string, "authorChannelUrl": string, "authorChannelId": { "value": string }, "channelId": string, "textDisplay": string, "textOriginal": string, "parentId": string, "canRate": boolean, "viewerRating": string, "likeCount": unsigned integer, "moderationStatus": string, "publishedAt": datetime, "updatedAt": datetime } }
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#comment . |
etag |
etag Das ETag dieser Ressource. |
id |
string Die ID, mit der YouTube den Kommentar eindeutig identifiziert. |
snippet |
object Das Objekt snippet enthält grundlegende Details zum Kommentar. |
snippet.authorDisplayName |
string Anzeigename des Nutzers, der den Kommentar gepostet hat |
snippet.authorProfileImageUrl |
string Die URL für den Avatar des Nutzers, der den Kommentar gepostet hat. |
snippet.authorChannelUrl |
string Die URL des YouTube-Kanals des Verfassers des Kommentars, falls verfügbar. |
snippet.authorChannelId |
object Dieses Objekt enthält Informationen zum YouTube-Kanal des Verfassers des Kommentars, falls verfügbar. |
snippet.authorChannelId.value |
string Die ID des YouTube-Kanals des Kommentarautors, falls verfügbar. |
snippet.channelId |
string Die ID des YouTube-Kanals, der mit dem Kommentar verknüpft ist.
|
snippet.textDisplay |
string Der Text des Kommentars. Der Text kann entweder als Nur-Text oder HTML abgerufen werden. Die Methoden comments.list und commentThreads.list unterstützen beide einen textFormat -Parameter, der das gewünschte Textformat angibt.Hinweis: Auch der reine Text kann vom ursprünglichen Kommentartext abweichen. So können beispielsweise Videolinks durch Videotitel ersetzt werden. |
snippet.textOriginal |
string Der ursprüngliche Rohtext des Kommentars, so wie er ursprünglich gepostet oder zuletzt aktualisiert wurde Der Originaltext wird nur zurückgegeben, wenn er für den authentifizierten Nutzer zugänglich ist. Dies ist nur dann garantiert, wenn der Nutzer der Autor des Kommentars ist. |
snippet.parentId |
string Die eindeutige ID des übergeordneten Kommentars. Diese Eigenschaft ist nur festgelegt, wenn der Kommentar als Antwort auf einen anderen Kommentar gesendet wurde. |
snippet.canRate |
boolean Über diese Einstellung wird angegeben, ob der aktuelle Zuschauer den Kommentar bewerten darf. |
snippet.viewerRating |
string Die Bewertung, die der Zuschauer für diesen Kommentar abgegeben hat. Hinweis: Für diese Property werden derzeit keine dislike -Bewertungen identifiziert. Dieses Verhalten kann sich jedoch ändern. In der Zwischenzeit lautet der Attributwert like , wenn der Zuschauer den Kommentar positiv bewertet hat. In allen anderen Fällen ist der Wert none , einschließlich des Nutzers, der den Kommentar negativ oder nicht bewertet hat.Gültige Werte für diese Unterkunft sind:
|
snippet.likeCount |
unsigned integer Die Gesamtzahl der „Mag ich“-Bewertungen (positive Bewertungen) für den Kommentar. |
snippet.moderationStatus |
string Der Moderationsstatus des Kommentars. Diese Eigenschaft wird nur zurückgegeben, wenn die API-Anfrage vom Inhaber des Kanals oder des Videos autorisiert wurde, zu dem die angeforderten Kommentare verfasst wurden. Beachten Sie außerdem, dass dieses Attribut nicht festgelegt ist, wenn in der API-Anfrage der Filterparameter id verwendet wurde.Gültige Werte für dieses Attribut sind:
|
snippet.publishedAt |
datetime Datum und Uhrzeit der ursprünglichen Veröffentlichung des Kommentars. Der Wert wird im ISO 8601-Format angegeben. |
snippet.updatedAt |
datetime Datum und Uhrzeit der letzten Aktualisierung des Kommentars. Der Wert wird im ISO 8601-Format angegeben. |