REST Resource: comments

Ressource: Kommentar

Ein Kommentar zu einer Datei.

Für einige Ressourcenmethoden (z. B. comments.update) ist eine commentId erforderlich. Verwenden Sie die Methode comments.list, um die ID für einen Kommentar in einer Datei abzurufen.

JSON-Darstellung
{
  "id": string,
  "kind": string,
  "createdTime": string,
  "modifiedTime": string,
  "resolved": boolean,
  "anchor": string,
  "replies": [
    {
      object (Reply)
    }
  ],
  "author": {
    object (User)
  },
  "deleted": boolean,
  "htmlContent": string,
  "content": string,
  "quotedFileContent": {
    "mimeType": string,
    "value": string
  }
}
Felder
id

string

Nur Ausgabe. Die ID des Kommentars.

kind

string

Nur Ausgabe. Gibt an, um welche Art von Ressource es sich handelt. Wert: der feste String "drive#comment".

createdTime

string

Nur Ausgabe. Die Uhrzeit, zu der der Kommentar erstellt wurde (Datum und Uhrzeit im RFC 3339-Format).

modifiedTime

string

Nur Ausgabe. Das Datum und die Uhrzeit, zu dem der Kommentar oder eine seiner Antworten zuletzt geändert wurde (RFC 3339-Datum/-Uhrzeit).

resolved

boolean

Nur Ausgabe. Ob der Kommentar durch eine Antwort geklärt wurde.

anchor

string

Ein Bereich des Dokuments, der als JSON-String dargestellt wird. Weitere Informationen zum Definieren von Ankereigenschaften findest du unter Kommentare und Antworten verwalten.

replies[]

object (Reply)

Nur Ausgabe. Die vollständige Liste der Antworten auf den Kommentar in chronologischer Reihenfolge.

author

object (User)

Nur Ausgabe. Der Autor des Kommentars. Die E-Mail-Adresse und die Berechtigungs-ID des Autors werden nicht ausgefüllt.

deleted

boolean

Nur Ausgabe. Gibt an, ob der Kommentar gelöscht wurde. Ein gelöschter Kommentar hat keinen Inhalt.

htmlContent

string

Nur Ausgabe. Der Inhalt des Kommentars mit HTML-Formatierung.

content

string

Der Klartextinhalt des Kommentars. In diesem Feld wird der Inhalt festgelegt, während htmlContent angezeigt werden sollte.

quotedFileContent

object

Der Dateiinhalt, auf den sich der Kommentar bezieht, in der Regel innerhalb der Ankerregion. Bei einer Textdatei wäre dies beispielsweise der Text an der Stelle des Kommentars.

quotedFileContent.mimeType

string

Der MIME-Typ des zitierten Inhalts.

quotedFileContent.value

string

Der zitierte Inhalt selbst. Wenn dieser Parameter über die API festgelegt wird, wird er als Nur-Text interpretiert.

Methoden

create

Erstellt einen Kommentar zu einer Datei.

delete

Löscht einen Kommentar.

get

Ruft einen Kommentar anhand der ID ab.

list

Listet die Kommentare zu einer Datei auf.

update

Aktualisiert einen Kommentar mit Patch-Semantik.