Method: comments.list

Wyświetla komentarze do pliku. Więcej informacji znajdziesz w artykule Zarządzanie komentarzami i odpowiedziami.

Wymagane: parametr fields musi być ustawiony. Aby zwrócić konkretne pola, zapoznaj się z artykułem Zwracanie określonych pól.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
fileId

string

Identyfikator pliku.

Parametry zapytania

Parametry
includeDeleted

boolean

Określa, czy mają być uwzględniane usunięte komentarze. Usuwane komentarze nie będą zawierać pierwotnej treści.
pageSize

integer

Maksymalna liczba komentarzy do zwrócenia na stronie.
pageToken

string

Token do kontynuowania poprzedniego żądania listy na następnej stronie. Wartość tego parametru powinna być taka sama jak wartość parametru „nextPageToken” z poprzedniej odpowiedzi.
startModifiedTime

string

Minimalna wartość atrybutu „modifiedTime” w komentarzach do wyników (format daty i godziny według specyfikacji RFC 3339).

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

lista komentarzy do pliku,

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

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

string

Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków "drive#commentList".
comments[]

object (Comment)

Lista komentarzy. Jeśli parametr nextPageToken jest wypełniony, lista może być niekompletna i należy pobrać kolejną stronę wyników.
nextPageToken

string

Token strony z informacjami o następnej stronie komentarzy. Nie będzie widoczny, jeśli osiągnięto koniec listy komentarzy. Jeśli token zostanie odrzucony z jakiegokolwiek powodu, należy go odrzucić i ponowić podział na strony, zaczynając od pierwszej strony wyników. Token strony jest zwykle ważny przez kilka godzin. Jeśli jednak dodasz lub usuniesz nowe elementy, oczekiwane wyniki mogą się różnić.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • 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 i wymagają oceny bezpieczeństwa, aby można było ich używać w aplikacji. Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.