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 einem Kanal darstellen. Außerdem kann der Kommentar ein Kommentar auf oberster Ebene oder eine Antwort auf einen Kommentar auf oberster Ebene sein.

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.
insert: Damit wird eine Antwort auf einen vorhandenen Kommentar erstellt. Hinweis: Verwenden Sie die Methode commentThreads.insert, um einen Kommentar auf oberster Ebene zu erstellen. Jetzt ausprobieren
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 Videos autorisiert werden, 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.; 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 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, die YouTube zur eindeutigen Identifizierung des Kommentars verwendet.
`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 entweder als Nur-Text oder HTML abgerufen werden. Die Methoden `comments.list` und `commentThreads.list` unterstützen beide den Parameter `textFormat`, der das ausgewählte Textformat angibt. Selbst der Nur-Text kann vom ursprünglichen Kommentartext abweichen. 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` Mit dieser Einstellung kannst du festlegen, ob der aktuelle Zuschauer den Kommentar bewerten darf.
`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 lautet 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 „Mag ich“-Bewertungen (positive Bewertungen), die der Kommentar erhalten hat.
`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 gesendet wurden. Außerdem ist 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` 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.