REST Resource: comments

Ressource: Kommentar

Ein Kommentar zu einer Datei in Google Drive.

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

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

object (CommentReply)

Nur Ausgabe. Antworten auf diesen Beitrag.

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 der letzten Änderung an diesem Kommentar oder einer seiner Antworten.

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 Sie auf einen Kommentar mit dem gewünschten Status antworten.

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

string

Ein Bereich des Dokuments, der als JSON-String dargestellt wird. Weitere Informationen zum Definieren von Ankerattributen finden Sie unter Kommentare und Antworten hinzufügen.

author

object (User)

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

deleted

boolean

Nur Ausgabe. Gibt an, ob der Kommentar gelöscht wurde. Wenn ein Kommentar gelöscht wurde, wird der Inhalt entfernt und es wird nur noch angezeigt, dass es diesen Kommentar einmal gab.

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 die Bearbeitung von Kommentarinhalt 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 kommentierten Dateibereichs. Bei einer Textdatei wäre das beispielsweise der tatsächliche Text, auf den sich der Kommentar bezieht.

fileTitle

string

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

Methoden

delete

Löscht einen Kommentar.

get

Ruft einen Kommentar anhand der ID ab.

insert

Erstellt einen neuen Kommentar für die angegebene Datei.

list

Listet die Kommentare einer Datei auf.

patch

Aktualisiert einen vorhandenen Kommentar.

update

Aktualisiert einen vorhandenen Kommentar.