Method: comments.list

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

Wymagany: parametr fields musi być ustawiony. Aby zwrócić dokładnie te pola, których potrzebujesz, zapoznaj się z artykułem Zwracanie konkretnych 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 uwzględniać usunięte komentarze. Usunięte komentarze nie będą zawierać oryginalnej treści.
pageSize

integer

Maksymalna liczba komentarzy do zwrócenia na stronie.
pageToken

string

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

string

Minimalna wartość parametru „modifiedTime” w przypadku komentarzy do wyników (data i godzina w formacie 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 
{
  "comments": [
    {
      object (Comment)
    }
  ],
  "kind": string,
  "nextPageToken": string
}
Pola
comments[]

object (Comment)

Lista komentarzy. Jeśli pole nextPageToken jest wypełnione, ta lista może być niekompletna i należy pobrać dodatkową stronę wyników.
kind

string

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

string

Token strony z następną stroną komentarzy. Jeśli lista komentarzy się skończyła, ten element nie będzie widoczny. Jeśli token zostanie odrzucony z jakiegokolwiek powodu, należy go odrzucić, a stronicowanie należy rozpocząć od pierwszej strony wyników. Token strony jest zwykle ważny przez kilka godzin. Jeśli jednak dodasz lub usuniesz nowe produkty, 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 aplikacja mogła ich używać. Więcej informacji znajdziesz w przewodniku po autoryzacji.