Comments

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.
  • Wenn es sich bei dem Kommentar um einen Kanalkommentar handelt, gibt diese Eigenschaft den Kanal an, um den es in dem Kommentar geht.
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:
  • like
  • none
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:
  • heldForReview
  • likelySpam
  • published
  • rejected
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.