REST Resource: comments

Ресурс: Комментарий

Комментарий к файлу на Google Диске.

Некоторые методы ресурсов (например, comments.update ) требуют commentId . Используйте метод comments.list для получения идентификатора комментария в файле.

JSON-представление
{
  "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
}
Поля
commentId

string

Только вывод. Идентификатор комментария.

kind

string

Только вывод. Это всегда drive#comment .

createdDate

string

Только вывод. Дата первого создания этого комментария.

modifiedDate

string

Только вывод. Дата последнего изменения этого комментария или любого из ответов на него.

fileId

string

Только вывод. Файл, к которому относится этот комментарий.

status

string

Только вывод. Статус этого комментария. Статус можно изменить, разместив ответ на комментарий с нужным статусом.

  • open — комментарий все еще открыт.
  • resolved — комментарий был разрешен одним из его ответов.
anchor

string

Область документа, представленная в виде строки JSON. Подробную информацию об определении свойств привязки см. в разделе Добавление комментариев и ответов .

replies[]

object ( CommentReply )

Только вывод. Ответы на этот пост.

author

object ( User )

Только вывод. Автор комментария. Адрес электронной почты автора и идентификатор разрешения не будут заполнены.

deleted

boolean

Только вывод. Был ли этот комментарий удален. Если комментарий был удален, его содержимое будет удалено, и это будет представлять собой только комментарий, который когда-то существовал.

htmlContent

string

Только вывод. Содержимое этого комментария в формате HTML.

content

string

Простое текстовое содержимое, использованное для создания этого комментария. Это небезопасно для HTML, и его следует использовать только в качестве отправной точки для редактирования содержимого комментария.

context

object

Контекст файла, который комментируется.

context.type

string

MIME-тип фрагмента контекста.

context.value

string

Представление данных сегмента комментируемого файла. Например, в случае текстового файла это будет фактический текст, о котором идет речь в комментарии.

fileTitle

string

Только вывод. Название файла, к которому относится этот комментарий.

Методы

delete

Удаляет комментарий.

get

Получает комментарий по идентификатору.

insert

Создает новый комментарий к данному файлу.

list

Перечисляет комментарии к файлу.

patch

Обновляет существующий комментарий.

update

Обновляет существующий комментарий.