Method: permissions.list

Wyświetla listę uprawnień 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ń 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

string

Token kontynuacji poprzedniego żądania listy na następnej stronie. Powinien mieć wartość nextPageToken z poprzedniej odpowiedzi.

supportsAllDrives

boolean

Określa, czy aplikacja żądająca obsługuje zarówno Mój dysk, jak i dyski współdzielone.

supportsTeamDrives
(deprecated)

boolean

Wycofane: zamiast tego użyj elementu supportsAllDrives.

useDomainAdminAccess

boolean

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

string

Określa, które dodatkowe uprawnienia do 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
{
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "items": [
    {
      object (Permission)
    }
  ]
}
Pola
nextPageToken

string

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.

kind

string

Jest to zawsze drive#permissionList.

etag

string

Wartość ETag listy.

items[]

object (Permission)

Lista uprawnień.

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.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.