REST Resource: comments

Zasób: komentarz

Komentarz do pliku na Dysku Google.

Niektóre metody zasobów (takie jak comments.update) wymagają commentId. Aby pobrać identyfikator komentarza w pliku, użyj metody comments.list.

Zapis 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
}
Pola
commentId

string

Tylko dane wyjściowe. Identyfikator komentarza.

kind

string

Tylko dane wyjściowe. Jest ona zawsze drive#comment.

createdDate

string

Tylko dane wyjściowe. Data utworzenia tego komentarza.

modifiedDate

string

Tylko dane wyjściowe. Data ostatniej modyfikacji tego komentarza lub odpowiedzi na niego.

fileId

string

Tylko dane wyjściowe. Plik, do którego odnosi się komentarz.

status

string

Tylko dane wyjściowe. Stan tego komentarza. Stan można zmienić, publikując odpowiedź na komentarz z żądanym stanem.

  • open – komentarz jest nadal otwarty.
  • resolved – komentarz został zamknięty dzięki jednej z odpowiedzi.
anchor

string

Region dokumentu reprezentowany jako ciąg znaków JSON. Szczegółowe informacje o definiowaniu właściwości kotwicy znajdziesz w artykule Dodawanie komentarzy i odpowiedzi.

replies[]

object (CommentReply)

Tylko dane wyjściowe. odpowiedzi na ten post.

author

object (User)

Tylko dane wyjściowe. Autor komentarza. Adres e-mail autora i identyfikator uprawnień nie zostaną wypełnione.

deleted

boolean

Tylko dane wyjściowe. określa, czy ten komentarz został usunięty. Jeśli komentarz został usunięty, jego treść zostanie usunięta i będzie on tylko wskazywał, że kiedyś istniał.

htmlContent

string

Tylko dane wyjściowe. Treść tego komentarza w formacie HTML.

content

string

Treść w postaci zwykłego tekstu użyta do utworzenia tego komentarza. Nie jest to bezpieczny kod HTML i należy go używać tylko jako punktu wyjścia do wprowadzania zmian w treści komentarza.

context

object

Kontekst pliku, którego dotyczy komentarz.

context.type

string

Typ MIME fragmentu kontekstowego.

context.value

string

Dane dotyczące segmentu pliku, do którego dodano komentarz. W przypadku pliku tekstowego będzie to na przykład sam tekst, do którego odnosi się komentarz.

fileTitle

string

Tylko dane wyjściowe. Tytuł pliku, do którego odnosi się komentarz.

Metody

delete

Usuwa komentarz.

get

Pobiera komentarz według identyfikatora.

insert

Tworzy nowy komentarz do danego pliku.

list

Wyświetla komentarze do pliku.

patch

Zaktualizuj istniejący komentarz.

update

Zaktualizuj istniejący komentarz.