Eine comment
-Ressource enthält Informationen zu einem einzelnen YouTube-Kommentar. Eine comment
-Ressource kann einen Kommentar zu einem Video oder Kanal darstellen. Außerdem kann es sich bei dem Kommentar um einen Kommentar der obersten Ebene oder eine Antwort auf einen Kommentar der obersten Ebene handeln.
Methoden
Die API unterstützt die folgenden Methoden für comments
-Ressourcen:
- list
- Gibt eine Liste von Kommentaren zurück, die den API-Anfrageparametern entsprechen. Hier kannst du die Funktion ausprobieren.
- insert
- Erstellt eine Antwort auf einen vorhandenen Kommentar. Hinweis:Wenn Sie einen Kommentar auf oberster Ebene erstellen möchten, verwenden Sie die Methode
commentThreads.insert
. Jetzt ausprobieren - Update
- Ä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 Kanals oder Videos autorisiert werden, der bzw. das mit den Kommentaren verknüpft ist. Hier kannst du die Funktion ausprobieren.
- markAsSpam
- Hinweis:Diese Methode wurde eingestellt und wird nicht mehr unterstützt.
- Drückt aus, dass ein oder mehrere Kommentare des Anrufers als Spam markiert werden sollten.
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 snippet -Objekt enthält grundlegende Details zum Kommentar. |
snippet.authorDisplayName |
string Der 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 Kommentarautors, falls verfügbar. |
snippet.authorChannelId.value |
string Die ID des YouTube-Kanals des Verfassers des Kommentars, 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. Sowohl die Methoden comments.list als auch commentThreads.list unterstützen einen textFormat -Parameter, mit dem das ausgewählte Textformat angegeben wird.Auch der unformatierte Text kann vom ursprünglichen Kommentartext abweichen. So können beispielsweise Videolinks durch Videotitel ersetzt werden. |
snippet.textOriginal |
string Der ursprüngliche Text des Kommentars, so wie er ursprünglich gepostet oder zuletzt aktualisiert wurde. Der Originaltext wird nur an den authentifizierten Nutzer zurückgegeben, wenn er der Verfasser 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 eingereicht wurde. |
snippet.canRate |
boolean Über diese Einstellung wird festgelegt, ob der aktuelle Zuschauer den Kommentar bewerten darf. |
snippet.viewerRating |
string Die Bewertung, die der Zuschauer für diesen Kommentar abgegeben hat. Diese Property identifiziert keine dislike -Bewertungen. Dieses Verhalten kann sich jedoch ändern. In der Zwischenzeit ist der Property-Wert like , wenn der Betrachter den Kommentar positiv bewertet hat. In allen anderen Fällen lautet der Wert none , einschließlich des Nutzers, der den Kommentar negativ bewertet hat oder den Kommentar 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 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. Außerdem wird dieses Attribut nicht festgelegt, 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. |