Method: permissions.list

Wyświetla uprawnienia 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

string

Identyfikator pliku lub dysku współdzielonego.

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba zwracanych uprawnień na stronę. Jeśli nie ustawisz go dla plików na dysku współdzielonym, zwróci się maksymalnie 100 wyników. Jeśli nie jest ustawiony w przypadku plików, które nie znajdują się na dysku współdzielonym, zwrócona zostanie cała lista.
pageToken

string

Token do kontynuowania poprzedniego żądania listy na następnej stronie. Wartość tego parametru powinna być taka sama jak wartość parametru „nextPageToken” z poprzedniej odpowiedzi.
supportsAllDrives

boolean

Czy aplikacja przesyłająca żądanie obsługuje zarówno Mój Dysk, jak i dyski współdzielone.
supportsTeamDrives
(deprecated)

boolean

Wycofane: użyj w zastępstwie tego supportsAllDrives.
useDomainAdminAccess

boolean

Przesyłanie prośby przez administratora domeny. Jeśli ta opcja jest ustawiona na wartość true, użytkownikowi zostanie przyznany dostęp, jeśli parametr identyfikatora pliku odnosi się do dysku współdzielonego, a użytkownik jest administratorem domeny, do której należy ten dysk.
includePermissionsForView

string

Określa, które uprawnienia dodatkowego widoku należy uwzględnić w odpowiedzi. Obsługiwana jest tylko opcja „opublikowano”.

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 (Permission)
    }
  ]
}
Pola
nextPageToken

string

Token strony dla następnej strony uprawnień. To pole nie będzie widoczne, jeśli osiągnięto koniec listy uprawnień. Jeśli token zostanie odrzucony z jakiegokolwiek powodu, należy go odrzucić i ponowić pobieranie stron od pierwszej strony 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

string

Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków "drive#permissionList".
permissions[]

object (Permission)

Lista uprawnień. Jeśli parametr nextPageToken jest wypełniony, lista może być niekompletna i należy pobrać kolejną 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.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 i wymagają oceny bezpieczeństwa, aby aplikacja mogła z nich korzystać. Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.