Method: comments.list

Wyświetla listę komentarzy do pliku.

Żądanie HTTP

GET https://www.googleapis.com/drive/v2/files/{fileId}/comments

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
fileId

string

Identyfikator pliku.

Parametry zapytania

Parametry
includeDeleted

boolean

Jeśli ustawienie jest skonfigurowane, zwracane są wszystkie komentarze i odpowiedzi, w tym usunięte komentarze i odpowiedzi (z usuniętymi treściami).

maxResults

integer

Maksymalna liczba dyskusji do uwzględnienia w odpowiedzi, używana do stronicowania.

pageToken

string

Token kontynuacji używany do przeglądania dużych zbiorów wyników. Aby wyświetlić następną stronę wyników, ustaw ten parametr na wartość „nextPageToken” niż w przypadku poprzedniej odpowiedzi.

updatedMin

string

Zwrócone zostaną tylko dyskusje, które zostały zaktualizowane po tej sygnaturze czasowej. Sformatowana jako sygnatura czasowa RFC 3339.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Lista komentarzy do pliku na Dysku Google.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "kind": string,
  "selfLink": string,
  "nextLink": string,
  "items": [
    {
      object (Comment)
    }
  ],
  "nextPageToken": string
}
Pola
kind

string

To zawsze drive#commentList.

items[]

object (Comment)

Lista komentarzy. Jeśli pole nextPageToken jest wypełnione, ta lista może być niekompletna i powinna zostać pobrana dodatkowa strona z wynikami.

nextPageToken

string

Token następnej strony komentarzy. Nie będzie ona widoczna, jeśli dotarliśmy do końca listy komentarzy. Jeśli token zostanie z jakiegokolwiek powodu odrzucony, należy go unieważnić, a podział na strony powinien rozpocząć się od nowa na pierwszej stronie wyników.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.readonly

Niektóre zakresy są ograniczone. Aby można było z nich korzystać, aplikacja musi przeprowadzić ocenę zabezpieczeń. Więcej informacji znajdziesz w przewodniku na temat autoryzacji.