REST Resource: comments

Zasób: Comment

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. To 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 dowolnej na jego odpowiedzi.

fileId

string

Tylko dane wyjściowe. Plik, którego dotyczy ten komentarz.

status

string

Tylko dane wyjściowe. Stan tego komentarza. Stan można zmienić, publikując odpowiedź na komentarz o wybranym stanie.

  • open – komentarz jest nadal otwarty.
  • resolved – komentarz został zakończony przez jedną z odpowiedzi.
anchor

string

Region dokumentu przedstawiony jako ciąg 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 tego posta.

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. Wskazuje, czy ten komentarz został usunięty. Jeśli komentarz został usunięty, jego zawartość zostanie wyczyszczona, a widoczny będzie tylko ten, który istniał.

htmlContent

string

Tylko dane wyjściowe. Sformatowana zawartość HTML dla tego komentarza.

content

string

Zapisany zwykłym tekstem, który został użyty do utworzenia tego komentarza. Plik nie jest bezpieczny dla kodu HTML i powinien służyć jedynie jako punkt wyjścia do edytowania treści komentarza.

context

object

Kontekst pliku, którego dotyczy komentarz.

context.type

string

Typ MIME fragmentu kodu kontekstu.

context.value

string

Reprezentacja danych segmentu skomentowanego pliku. W przypadku pliku tekstowego jest to rzeczywisty tekst, którego dotyczy komentarz.

fileTitle

string

Tylko dane wyjściowe. Tytuł pliku, którego dotyczy ten komentarz.

Metody

delete

Usuwa komentarz.

get

Pobiera komentarz według identyfikatora.

insert

Tworzy nowy komentarz do danego pliku.

list

Wyświetla listę komentarzy do pliku.

patch

Aktualizuje istniejący komentarz.

update

Aktualizuje istniejący komentarz.