- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Wypróbuj
Wyświetla listę uprawnień pliku lub dysku współdzielonego.
Żądanie HTTP
GET https://www.googleapis.com/drive/v3/files/{fileId}/permissions
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
fileId |
Identyfikator pliku lub dysku współdzielonego. |
Parametry zapytania
Parametry | |
---|---|
pageSize |
Maksymalna liczba uprawnień zwracanych na stronę. Jeśli nie skonfigurujesz tej zasady dla plików na dysku współdzielonym, zwróconych zostanie maksymalnie 100 wyników. Jeśli zasada nie jest skonfigurowana dla plików, których nie ma na dysku współdzielonym, zwracana jest cała lista. |
pageToken |
Token kontynuacji poprzedniego żądania listy na następnej stronie. Należy ustawić wartość „nextPageToken” z poprzedniej odpowiedzi. |
supportsAllDrives |
Określa, czy aplikacja żądająca obsługuje zarówno Mój dysk, jak i dyski współdzielone. |
supportsTeamDrives |
Wycofane: zamiast tego użyj elementu |
useDomainAdminAccess |
Wyślij żądanie jako administrator domeny. Jeśli zasada ma wartość Prawda, osoba wysyłająca prośbę otrzymuje dostęp, jeśli parametr identyfikatora pliku odnosi się do dysku współdzielonego, a zgłaszający jest administratorem domeny, do której należy ten dysk. |
includePermissionsForView |
Określa, które dodatkowe uprawnienia do widoku mają być uwzględnione w odpowiedzi. Obsługiwana jest tylko wartość „opublikowane”. |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Lista uprawnień pliku.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"nextPageToken": string,
"kind": string,
"permissions": [
{
object ( |
Pola | |
---|---|
nextPageToken |
Token strony następnej strony uprawnień. To pole będzie niedostępne po osiągnięciu końca listy uprawnień. 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ć. |
kind |
Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków |
permissions[] |
Lista uprawnień. Jeśli wartość NextPageToken jest wypełniona, ta lista może być niekompletna i należy pobrać dodatkową stronę wyników. |
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.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.photos.readonly
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.