- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Wypróbuj
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 |
Identyfikator pliku. |
Parametry zapytania
Parametry | |
---|---|
includeDeleted |
Określa, czy uwzględnić usunięte komentarze. Usunięte komentarze nie będą zawierać oryginalnej treści. |
pageSize |
Maksymalna liczba komentarzy zwracanych na stronę. |
pageToken |
Token kontynuacji poprzedniego żądania listy na następnej stronie. Należy ustawić wartość „nextPageToken” z poprzedniej odpowiedzi. |
startModifiedTime |
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 ( |
Pola | |
---|---|
kind |
Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków |
comments[] |
Lista komentarzy. Jeśli wartość NextPageToken jest wypełniona, ta lista może być niekompletna i należy pobrać dodatkową stronę wyników. |
nextPageToken |
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.