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 zu einem Kanal darstellen. Außerdem kann es sich um einen Kommentar auf oberster Ebene oder um eine Antwort auf einen Kommentar auf oberster 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:Verwenden Sie die Methode commentThreads.insert, um einen Kommentar auf oberster Ebene zu erstellen. Jetzt testen
aktualisieren: bearbeitet einen Kommentar. Hier kannst du die Funktion ausprobieren.
Delete: Löst einen Kommentar. Hier kannst du die Funktion ausprobieren.
setModerationStatus: Legt den Moderationsstatus eines oder mehrerer Kommentare fest. Die API-Anfrage muss vom Inhaber des Kanals oder des Videos autorisiert werden, mit dem die Kommentare verknüpft sind. Hier kannst du die Funktion ausprobieren.
markAsSpam: Hinweis:Diese Methode wurde eingestellt und wird nicht mehr unterstützt.; Der Anrufer ist der Meinung, dass ein oder mehrere Kommentare als Spam gekennzeichnet 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 sind die Eigenschaften aufgeführt, 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, sofern verfügbar.
`snippet.authorChannelId`	`object` Dieses Objekt enthält Informationen zum YouTube-Kanal des Kommentarautors, sofern verfügbar.
`snippet.authorChannelId.value`	`string` Die ID des YouTube-Kanals des Kommentarautors, sofern 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 als Nur-Text oder als HTML-Text abgerufen werden. Die Methoden `comments.list` und `commentThreads.list` unterstützen beide den Parameter `textFormat`, mit dem das ausgewählte Textformat angegeben wird. Sogar der reine Text kann sich vom ursprünglichen Kommentartext unterscheiden. So werden beispielsweise Videolinks möglicherweise durch Videotitel ersetzt.
`snippet.textOriginal`	`string` Der ursprüngliche, rohe Text des Kommentars, wie er ursprünglich gepostet oder zuletzt aktualisiert wurde. Der ursprüngliche Text wird nur an den authentifizierten Nutzer zurückgegeben, wenn er der Autor des Kommentars ist.
`snippet.parentId`	`string` Die eindeutige ID des übergeordneten Kommentars. Diese Property wird nur festgelegt, wenn der Kommentar als Antwort auf einen anderen Kommentar gepostet wurde.
`snippet.canRate`	`boolean` Diese Einstellung gibt an, ob der aktuelle Betrachter den Kommentar bewerten kann.
`snippet.viewerRating`	`string` Die Bewertung, die der Zuschauer diesem Kommentar gegeben hat. Diese Eigenschaft gibt keine `dislike`-Bewertungen an. Dieses Verhalten kann sich jedoch ändern. In der Zwischenzeit ist der Property-Wert `like`, wenn der Zuschauer den Kommentar positiv bewertet hat. In allen anderen Fällen ist der Wert `none`, auch wenn der Nutzer dem Kommentar eine negative Bewertung gegeben oder ihn nicht bewertet hat. Gültige Werte für diese Property sind: `like` `none`
`snippet.likeCount`	`unsigned integer` Die Gesamtzahl der Likes (positiven Bewertungen), die der Kommentar erhalten hat.
`snippet.moderationStatus`	`string` Der Moderationsstatus des Kommentars. Diese Property wird nur zurückgegeben, wenn die API-Anfrage vom Inhaber des Kanals oder des Videos autorisiert wurde, zu dem die angeforderten Kommentare gepostet wurden. Außerdem wird diese Eigenschaft nicht festgelegt, wenn in der API-Anfrage der Filterparameter `id` verwendet wurde. Gültige Werte für diese Eigenschaft sind: `heldForReview` `likelySpam` `published` `rejected`
`snippet.publishedAt`	`datetime` Das Datum und die Uhrzeit, zu der der Kommentar ursprünglich veröffentlicht wurde. 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.