REST Resource: comments

Ressource: Kommentar

Kommentare zu einer Datei in Google Drive

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

JSON-Darstellung
{
  "commentId": string,
  "kind": string,
  "createdDate": string,
  "modifiedDate": string,
  "fileId": string,
  "status": string,
  "anchor": string,
  "replies": [
    {
      object (CommentReply)
    }
  ],
  "author": {
    object (User)
  },
  "deleted": boolean,
  "selfLink": string,
  "htmlContent": string,
  "content": string,
  "context": {
    "type": string,
    "value": string
  },
  "fileTitle": string
}
Felder
commentId

string

Nur Ausgabe Die ID des Kommentars.

kind

string

Nur Ausgabe Dies ist immer drive#comment.

createdDate

string

Nur Ausgabe Das Datum, an dem dieser Kommentar zum ersten Mal erstellt wurde.

modifiedDate

string

Nur Ausgabe Das Datum, an dem dieser Kommentar oder eine seiner Antworten zuletzt geändert wurde.

fileId

string

Nur Ausgabe Die Datei, auf die sich dieser Kommentar bezieht.

status

string

Nur Ausgabe Der Status dieses Kommentars. Der Status kann geändert werden, indem du eine Antwort auf einen Kommentar mit dem gewünschten Status postest.

  • open: Der Kommentar ist noch offen.
  • resolved: Der Kommentar wurde durch eine Antwort geklärt.
anchor

string

Region des Dokuments, die als JSON-String dargestellt wird. Weitere Informationen zum Definieren von Ankereigenschaften finden Sie unter Kommentare und Antworten hinzufügen.

replies[]

object (CommentReply)

Nur Ausgabe Antworten auf diesen Beitrag.

author

object (User)

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

deleted

boolean

Nur Ausgabe Gibt an, ob dieser Kommentar gelöscht wurde. Wenn ein Kommentar gelöscht wurde, werden auch die Inhalte gelöscht. Dabei handelt es sich lediglich um einen Kommentar, der einmal existiert hat.

htmlContent

string

Nur Ausgabe HTML-formatierter Inhalt für diesen Kommentar.

content

string

Der Nur-Text-Inhalt, der zum Erstellen dieses Kommentars verwendet wurde. Dies ist nicht HTML-sicher und sollte nur als Ausgangspunkt für Änderungen am Inhalt eines Kommentars verwendet werden.

context

object

Der Kontext der Datei, die kommentiert wird.

context.type

string

Der MIME-Typ des Kontext-Snippets.

context.value

string

Datendarstellung des Segments der Datei, das kommentiert wird Bei einer Textdatei wäre dies beispielsweise der Text, um den es im Kommentar geht.

fileTitle

string

Nur Ausgabe Der Titel der Datei, auf die sich dieser Kommentar bezieht.

Methoden

delete

Löscht einen Kommentar.

get

Ruft einen Kommentar nach ID ab.

insert

Erstellt einen neuen Kommentar zur angegebenen Datei.

list

Listet die Kommentare einer Datei auf.

patch

Aktualisiert einen vorhandenen Kommentar.

update

Aktualisiert einen vorhandenen Kommentar.