REST Resource: comments

Ressource: Kommentar

Ein Kommentar zu einer Datei in Google Drive.

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
{
  "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 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. Sie können den Status ändern, indem Sie auf einen Kommentar antworten und den gewünschten Status angeben.

  • open – Der Kommentar ist noch offen.
  • resolved – Der Kommentar wurde durch eine Antwort beantwortet.
anchor

string

Ein Bereich des Dokuments, der als JSON-String dargestellt wird. Weitere Informationen zum Definieren von Ankereigenschaften findest du 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 die Berechtigungs-ID des Autors 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 ein Kommentar vorhanden war.

htmlContent

string

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

content

string

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

context

object

Der Kontext der Datei, auf die sich der Kommentar bezieht.

context.type

string

Der MIME-Typ des Kontext-Snippets.

context.value

string

Datendarstellung des Dateisegments, zu dem ein Kommentar verfasst wird. Bei einer Textdatei wäre das beispielsweise der 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 zu der angegebenen Datei.

list

Listet die Kommentare zu einer Datei auf.

patch

Aktualisiert einen vorhandenen Kommentar.

update

Aktualisiert einen vorhandenen Kommentar.