Method: permissions.list

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

string

Token kontynuujący poprzednie żądanie listy na następnej stronie. Powinna mieć wartość nextPageToken z poprzedniej odpowiedzi.

supportsAllDrives

boolean

Określa, czy aplikacja, której dotyczy prośba, obsługuje zarówno Mój dysk, jak i dyski współdzielone.

supportsTeamDrives
(deprecated)

boolean

Wycofane: użyj atrybutu supportsAllDrives.

useDomainAdminAccess

boolean

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

string

Określa uprawnienia dodatkowego widoku danych, które 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 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.

kind

string

To zawsze drive#permissionList.

etag

string

Identyfikator ETag listy.

items[]

object (Permission)

Lista uprawnień.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu 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. Aby można było z nich korzystać, aplikacja musi przeprowadzić ocenę zabezpieczeń. Więcej informacji znajdziesz w przewodniku na temat autoryzacji.