REST Resource: comments

Ressource: Kommentar

Ein Kommentar 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. Du kannst den Status ändern, 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 der Antworten geklärt.
anchor

string

Eine 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 Autor des Kommentars. Die E-Mail-Adresse und Berechtigungs-ID des Erstellers werden nicht ausgefüllt.

deleted

boolean

Nur Ausgabe. Wurde der Kommentar gelöscht? Wenn ein Kommentar gelöscht wurde, wird der Inhalt gelöscht. Dies ist nur ein Kommentar, der früher vorhanden war.

htmlContent

string

Nur Ausgabe. Inhalt für diesen Kommentar im HTML-Format.

content

string

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

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 in der angegebenen Datei.

list

Listet die Kommentare einer Datei auf.

patch

Aktualisiert einen vorhandenen Kommentar.

update

Aktualisiert einen vorhandenen Kommentar.