Method: permissions.list

Wyświetla uprawnienia pliku lub dysku współdzielonego.

Żądanie HTTP

GET https://www.googleapis.com/drive/v2/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
maxResults

integer

Maksymalna liczba uprawnień do zwrócenia na stronie. Jeśli nie jest ustawiona dla plików na dysku współdzielonym, zwracanych jest maksymalnie 100 wyników. Jeśli nie jest ustawiona w przypadku plików, które nie znajdują się na dysku współdzielonym, zwracana jest cała lista.
pageToken

string

Token umożliwiający kontynuowanie poprzedniego żądania listy na następnej stronie. Powinna być ustawiona na 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

Wystaw prośbę jako administrator domeny. Jeśli wartość to „true”, wnioskodawca otrzyma dostęp, jeśli parametr fileId odnosi się do dysku współdzielonego, a wnioskodawca jest administratorem domeny, do której należy dysk współdzielony.
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ń powiązanych z plikiem.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "items": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string
}
Pola
items[]

object (Permission)

Lista uprawnień.
nextPageToken

string

Token strony z uprawnieniami do następnej strony. To pole będzie nieobecne, jeśli osiągnięto koniec listy uprawnień. Jeśli token zostanie odrzucony z jakiegokolwiek powodu, należy go odrzucić, a stronicowanie należy rozpocząć od pierwszej strony wyników.
kind

string

Zawsze jest to drive#permissionList.
etag

string

ETag listy.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/docs
  • 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 ich używać. Więcej informacji znajdziesz w przewodniku po autoryzacji.