Method: comments.list

Wyświetla listę komentarzy do pliku.

Żą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 uwzględnić usunięte komentarze. Usunięte komentarze nie będą zawierać oryginalnej treści.

pageSize

integer

Maksymalna liczba komentarzy zwracanych na stronę.

pageToken

string

Token kontynuacji poprzedniego żądania listy na następnej stronie. Należy ustawić wartość „nextPageToken” z poprzedniej odpowiedzi.

startModifiedTime

string

Minimalna wartość parametru „modifiedTime” dla komentarzy do wyników (RFC 3339 data i godzina).

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 wartość NextPageToken jest wypełniona, ta lista może być niekompletna i należy pobrać dodatkową stronę wyników.

nextPageToken

string

Token strony następnej strony komentarzy. Będzie jej brakować po osiągnięciu końca listy komentarzy. Jeśli token zostanie z jakiegokolwiek powodu odrzucony, należy go odrzucić i uruchomić ponownie podział na strony na pierwszej stronie 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.readonly

Niektóre zakresy są objęte ograniczeniami, a aplikacja może z nich korzystać dopiero po sprawdzeniu zabezpieczeń. Więcej informacji znajdziesz w przewodniku po autoryzacji.