REST Resource: permissions

Zasób: Permission

Uprawnienia do pliku. Uprawnienie przyznaje użytkownikowi, grupie, domenie lub wszystkim osobom dostęp do pliku lub hierarchii folderów. Więcej informacji znajdziesz w artykule Udostępnianie plików, folderów i dysków.

Domyślnie żądania uprawnień zwracają tylko podzbiór pól. Uprawnienia kind, ID, type i role są zawsze zwracane. Aby pobrać określone pola, zapoznaj się z sekcją Zwracanie określonych pól.

Niektóre metody zasobów (np. permissions.update) wymagają permissionId. Aby pobrać identyfikator pliku, folderu lub dysku współdzielonego, użyj metody permissions.list.

Zapis JSON 
{
  "permissionDetails": [
    {
      "permissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "id": string,
  "displayName": string,
  "type": string,
  "kind": string,
  "photoLink": string,
  "emailAddress": string,
  "role": string,
  "allowFileDiscovery": boolean,
  "domain": string,
  "expirationTime": string,
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean,
  "inheritedPermissionsDisabled": boolean
}
Pola
permissionDetails[]

object

Tylko dane wyjściowe. Informacje o tym, czy uprawnienia do tego elementu są dziedziczone, czy są przypisane bezpośrednio do tego elementu.
permissionDetails[].permissionType

string

Tylko dane wyjściowe. Typ uprawnień tego użytkownika. Obsługiwane wartości to:

  • file
  • member
permissionDetails[].inheritedFrom

string

Tylko dane wyjściowe. Identyfikator elementu, z którego to uprawnienie jest dziedziczone. Ta wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.
permissionDetails[].role

string

Tylko dane wyjściowe. Główna rola tego użytkownika. Obsługiwane wartości to:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader

Więcej informacji znajdziesz w artykule Role i uprawnienia.
permissionDetails[].inherited

boolean

Tylko dane wyjściowe. Określa, czy to uprawnienie jest dziedziczone. To pole jest zawsze wypełnione. To pole jest tylko do odczytu.
teamDrivePermissionDetails[]
(deprecated)

object

Tylko dane wyjściowe. Wycofane: tylko dane wyjściowe. Zamiast niej używaj zasady permissionDetails.
teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

Wycofane: tylko dane wyjściowe. Zamiast niej używaj zasady permissionDetails/permissionType.
teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

Wycofane: tylko dane wyjściowe. Zamiast niej używaj zasady permissionDetails/inheritedFrom.
teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

Wycofane: tylko dane wyjściowe. Zamiast niej używaj zasady permissionDetails/role.
teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Wycofane: tylko dane wyjściowe. Zamiast niej używaj zasady permissionDetails/inherited.
id

string

Tylko dane wyjściowe. Identyfikator tego uprawnienia. Jest to unikalny identyfikator osoby, która otrzymała uprawnienia. Jest on publikowany w zasobie User jako permissionId. Identyfikatory należy traktować jako wartości nieprzejrzyste.
displayName

string

Tylko dane wyjściowe. „Czytelna” nazwa wartości uprawnienia. Poniżej znajdziesz listę przykładów dla każdego typu uprawnień:

  • user – imię i nazwisko użytkownika zgodnie z definicją konta Google, na przykład „Dana A.”;
  • group – nazwa grupy Google, np. „Administratorzy firmy”.
  • domain – ciąg tekstowy z nazwą domeny, na przykład „cymbalgroup.com”.
  • anyone – brak displayName.
type

string

Typ obdarowanego. Obsługiwane wartości to:

  • user
  • group
  • domain
  • anyone

Podczas tworzenia uprawnień, jeśli type ma wartość user lub group, musisz podać emailAddress użytkownika lub grupy. Jeśli wartość type to domain, musisz podać wartość domain. Jeśli type ma wartość anyone, nie musisz podawać żadnych dodatkowych informacji.
kind

string

Tylko dane wyjściowe. Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków "drive#permission".
emailAddress

string

Adres e-mail użytkownika lub grupy, do których odnosi się to uprawnienie.
role

string

Rola przyznana przez to uprawnienie. Obsługiwane wartości to:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader

Więcej informacji znajdziesz w artykule Role i uprawnienia.
allowFileDiscovery

boolean

Określa, czy uprawnienie umożliwia odnalezienie pliku za pomocą wyszukiwania. Dotyczy to tylko uprawnień typu domain lub anyone.
domain

string

Domena, do której odnosi się to uprawnienie.
expirationTime

string

Czas, w którym to uprawnienie wygaśnie (data i godzina w formacie RFC 3339). Czasy wygaśnięcia podlegają tym ograniczeniom:

  • Można je ustawić tylko w przypadku uprawnień użytkowników i grup.
  • Czas musi przypadać w przyszłości.
  • Czas nie może być oddalony o więcej niż rok w przyszłość.
deleted

boolean

Tylko dane wyjściowe. Informacja, czy konto powiązane z tym uprawnieniem zostało usunięte. To pole dotyczy tylko uprawnień typu user lub group.
view

string

Wskazuje widok tego uprawnienia. Wartość jest podawana tylko w przypadku uprawnień należących do widoku.

Obsługiwane wartości to published i metadata:

  • published: rola uprawnienia to publishedReader.
  • metadata: element jest widoczny tylko w widoku metadata, ponieważ ma ograniczony dostęp, a zakres ma co najmniej uprawnienia do odczytu folderu nadrzędnego. Widok metadata jest obsługiwany tylko w przypadku folderów.

Więcej informacji znajdziesz w artykule Wyświetlenia.
pendingOwner

boolean

od tego, czy konto powiązane z tym uprawnieniem jest oczekującym właścicielem. Wypełniane tylko w przypadku uprawnień typu user do plików, które nie znajdują się na dysku współdzielonym.
inheritedPermissionsDisabled

boolean

Gdy jest włączona opcja true, dostęp do elementu mają tylko organizatorzy, właściciele i użytkownicy z uprawnieniami dodanymi bezpośrednio do elementu.

Metody

create

 Tworzy uprawnienia do pliku lub dysku współdzielonego.

delete

 Usuwa uprawnienie.

get

 Pobiera uprawnienie według identyfikatora.

list

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

update

 Aktualizuje uprawnienie za pomocą semantyki poprawki.