REST Resource: comments

Ressource: Kommentar

Ein Kommentar zu einer Datei.

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 (Reply)
    }
  ],
  "id": string,
  "kind": string,
  "createdTime": string,
  "modifiedTime": string,
  "resolved": boolean,
  "anchor": string,
  "author": {
    object (User)
  },
  "deleted": boolean,
  "htmlContent": string,
  "content": string,
  "quotedFileContent": {
    "mimeType": string,
    "value": string
  }
}
Felder
replies[]

object (Reply)

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

id

string

Nur Ausgabe. Die ID des Kommentars.

kind

string

Nur Ausgabe. Kennzeichnet, welche Art von Ressource dies ist. Wert: der feste String "drive#comment".

createdTime

string

Nur Ausgabe. Der Zeitpunkt, zu dem der Kommentar erstellt wurde (RFC 3339-Datum/Uhrzeit).

modifiedTime

string

Nur Ausgabe. Der Zeitpunkt, 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 der Antworten darauf gelöst wurde.

anchor

string

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

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. 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, der angezeigt werden soll, während htmlContent angezeigt wird.

quotedFileContent

object

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

quotedFileContent.mimeType

string

Der MIME-Typ des zitierten Inhalts.

quotedFileContent.value

string

Die zitierten Inhalte selbst. Wenn der Wert ü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 einer Datei auf.

update

Aktualisiert einen Kommentar mit Patch-Semantik.