- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Wypróbuj
Wyświetla listę uprawnień do 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ń do zwrotu na stronie. Jeśli zasada nie jest ustawiona dla plików na dysku współdzielonym, zwracanych jest maksymalnie 100 wyników. Gdy ta opcja nie jest ustawiona dla plików, których nie ma na dysku współdzielonym, zwracana jest cała lista. |
pageToken |
Token kontynuujący poprzednie żądanie listy na następnej stronie. Należy ustawić wartość „nextPageToken” niż w przypadku poprzedniej odpowiedzi. |
supportsAllDrives |
Określa, czy aplikacja, której dotyczy prośba, obsługuje zarówno Mój dysk, jak i dyski współdzielone. |
supportsTeamDrives |
Wycofane: użyj atrybutu |
useDomainAdminAccess |
Wyślij prośbę jako administrator domeny. Jeśli ma wartość true (prawda), osoba zgłaszająca prośbę otrzyma dostęp, jeśli parametr identyfikatora pliku odnosi się do dysku współdzielonego, a osoba wysyłająca prośbę jest administratorem domeny, do której należy ten dysk. |
includePermissionsForView |
Określa uprawnienia dodatkowego widoku danych, które mają być uwzględnione w odpowiedzi. Tylko „opublikowane” jest obsługiwane. |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Lista uprawnień do 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 dla następnej strony uprawnień. To pole pozostanie puste, jeśli zostanie osiągnięty koniec listy uprawnień. Jeśli token zostanie z jakiegokolwiek powodu odrzucony, należy go unieważnić, a podział na strony powinien rozpocząć się od nowa 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 pole nextPageToken jest wypełnione, ta lista może być niekompletna i powinna zostać pobrana dodatkowa strona z wynikami. |
Zakresy autoryzacji
Wymaga jednego z tych zakresów protokołu 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.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ą ograniczone. Aby można było z nich korzystać, aplikacja musi przeprowadzić ocenę zabezpieczeń. Więcej informacji znajdziesz w przewodniku na temat autoryzacji.