Diese Seite wurde von der Cloud Translation API übersetzt.

Comments

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: `like` `none`
`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: `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.