Method: comments.list

Wyświetla komentarze 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 ta opcja jest ustawiona, zwracane są wszystkie komentarze i odpowiedzi, w tym usunięte komentarze i odpowiedzi (z usuniętą treścią).
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 uzyskać następną stronę wyników, ustaw ten parametr na wartość „nextPageToken” z poprzedniej odpowiedzi.
updatedMin

string

Zostaną zwrócone tylko dyskusje, które zostały zaktualizowane po tej sygnaturze czasowej. Sformatowany 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 
{
  "items": [
    {
      object (Comment)
    }
  ],
  "kind": string,
  "selfLink": string,
  "nextLink": string,
  "nextPageToken": string
}
Pola
items[]

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

Zawsze jest to 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.

Zakresy autoryzacji

Wymaga jednego z tych zakresów 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 i wymagają oceny bezpieczeństwa, aby aplikacja mogła ich używać. Więcej informacji znajdziesz w przewodniku po autoryzacji.