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. Jest to zawsze drive#comment.

createdDate

string

Tylko dane wyjściowe. Data utworzenia pierwszego komentarza.

modifiedDate

string

Tylko dane wyjściowe. Data ostatniej modyfikacji tego komentarza lub jednej z odpowiedzi na nią.

fileId

string

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

status

string

Tylko dane wyjściowe. Stan tego komentarza. Możesz zmienić stan, publikując odpowiedź na komentarz.

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

string

Region dokumentu reprezentowany jako ciąg znaków JSON. Szczegółowe informacje o definiowaniu właściwości kotwic 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 będą wypełniane.

deleted

boolean

Tylko dane wyjściowe. Czy ten komentarz został usunięty. Jeśli komentarz został usunięty, jego zawartość zostanie wyczyszczona. Będzie to dotyczyć tylko istniejącego komentarza.

htmlContent

string

Tylko dane wyjściowe. Treść tego komentarza została sformatowana w formacie HTML.

content

string

Treść w postaci zwykłego tekstu użyta do utworzenia tego komentarza. Nie jest on bezpieczny dla języka HTML i powinny być tylko punktem wyjścia do wprowadzania zmian w treści komentarza.

context

object

Kontekst komentowanego pliku.

context.type

string

Typ MIME fragmentu kontekstu.

context.value

string

Reprezentacja danych segmentu komentowanego pliku. W przypadku pliku tekstowego jest to na przykład 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.