Method: permissions.list

Wyświetla listę uprawnień do pliku lub dysku współdzielonego. Więcej informacji znajdziesz w artykule Udostępnianie plików, folderów i dysków.

Żą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 uprawnień do zwrócenia. Usługa może zwrócić mniej niż ta wartość.

Jeśli nie zostanie określona, w przypadku dysków współdzielonych zostanie zwróconych maksymalnie 100 uprawnień, a w przypadku dysków innych niż współdzielone – cała lista uprawnień.

Maksymalna wartość to 100. Wartości powyżej 100 zostaną przekształcone w 100.
pageToken

string

Token do kontynuowania poprzedniego żądania listy na następnej stronie. Należy ustawić wartość nextPageToken z poprzedniej odpowiedzi.
supportsAllDrives

boolean

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

boolean

Wycofana: zamiast niej używaj zasady supportsAllDrives.
useDomainAdminAccess

boolean

Wyślij żądanie jako administrator domeny.

Jeśli to ustawienie ma wartość true i są spełnione te dodatkowe warunki, osoba wysyłająca prośbę uzyskuje dostęp:

  1. Parametr identyfikatora pliku odnosi się do dysku współdzielonego.
  2. Osoba wysyłająca prośbę jest administratorem domeny, do której należy dysk współdzielony.

Więcej informacji znajdziesz w artykule Zarządzanie dyskami współdzielonymi jako administrator domeny.
includePermissionsForView

string

Określa, które uprawnienia do dodatkowego widoku mają być uwzględnione w odpowiedzi. Obsługiwana jest tylko wartość published.

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 
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
Pola
permissions[]

object (Permission)

Lista uprawnień. Jeśli pole nextPageToken jest wypełnione, ta lista może być niekompletna i należy pobrać dodatkową stronę wyników.
nextPageToken

string

Token strony z uprawnieniami na następnej stronie. To pole będzie nieobecne, jeśli osiągnięto koniec listy uprawnień. Jeśli token zostanie z jakiegoś powodu odrzucony, należy go odrzucić, a stronicowanie należy rozpocząć od pierwszej strony wyników. Token strony jest zwykle ważny przez kilka godzin. Jeśli jednak dodasz lub usuniesz nowe produkty, oczekiwane wyniki mogą się różnić.
kind

string

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

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