REST Resource: permissions

Zasób: Permission

Uprawnienia do pliku. Uprawnienie zapewnia użytkownikowi, grupie, domenie lub światowym dostęp do pliku bądź hierarchii folderów.

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

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

string

Tylko dane wyjściowe. Identyfikator tego uprawnienia. Jest to unikalny identyfikator obdarowanego, który jest opublikowany w zasobach użytkownika jako permissionId. Identyfikatory powinny być traktowane jako wartości nieprzezroczyste.

displayName

string

Tylko dane wyjściowe. „urocze” nazwa wartości uprawnienia. Poniżej znajduje się lista przykładów poszczególnych typów uprawnień:

  • user – pełne imię i nazwisko użytkownika zgodnie z definicją podaną na koncie Google, na przykład „Jan Kowalski”.
  • group – nazwa grupy dyskusyjnej Google, na przykład „Administratorzy firmy”.
  • domain – nazwa domeny z ciągiem znaków, na przykład „firma.com”.
  • anyone – brak elementu displayName.
type

string

Rodzaj beneficjenta. Prawidłowe wartości to:

  • user
  • group
  • domain
  • anyone

Jeśli podczas tworzenia uprawnienia type ma wartość user lub group, musisz podać emailAddress dla użytkownika lub grupy. Jeśli type to domain, musisz podać domain. W przypadku typu anyone nie są wymagane dodatkowe informacje.

kind

string

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

permissionDetails[]

object

Tylko dane wyjściowe. Szczegółowe informacje o tym, czy uprawnienia do tego elementu na dysku współdzielonym są dziedziczone czy bezpośrednio do niego. To jest pole przeznaczone tylko do danych wyjściowych, które występuje tylko w przypadku elementów na dysku współdzielonym.

permissionDetails[].permissionType

string

Tylko dane wyjściowe. Typ uprawnień tego użytkownika. W przyszłości możemy dodawać nowe wartości, ale obecnie możliwe są następujące przypadki:

  • file
  • member
permissionDetails[].inheritedFrom

string

Tylko dane wyjściowe. Identyfikator elementu, z którego dane uprawnienie jest dziedziczone. Jest to pole tylko z danymi wyjściowymi.

permissionDetails[].role

string

Tylko dane wyjściowe. Główna rola tego użytkownika. W przyszłości możemy dodawać nowe wartości, ale obecnie możliwe są następujące przypadki:

  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
permissionDetails[].inherited

boolean

Tylko dane wyjściowe. Określa, czy to uprawnienie jest dziedziczone. To pole jest zawsze wypełniane. Jest to pole tylko z danymi wyjściowymi.

emailAddress

string

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

role

string

Rola przypisana przez to uprawnienie. W przyszłości mogą być obsługiwane nowe wartości, ale obecnie dozwolone są te wartości:

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

boolean

Określa, czy uprawnienie umożliwia znalezienie pliku przez wyszukiwanie. Dotyczy to tylko uprawnień typu domain lub anyone.

domain

string

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

expirationTime

string

Godzina, o której to uprawnienie wygaśnie (data i godzina w RFC 3339). Terminy ważności mają następujące ograniczenia:

  • Można je ustawiać tylko dla uprawnień użytkownika i grupy.
  • Godzina musi przypadać w przyszłości.
  • Godzina nie może być oddalona o więcej niż rok w przyszłość.
teamDrivePermissionDetails[]
(deprecated)

object

Tylko dane wyjściowe. Wycofane: tylko dane wyjściowe. Użyj w zamian zasady permissionDetails.

teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

Wycofane: tylko dane wyjściowe. Użyj w zamian zasady permissionDetails/permissionType.

teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

Wycofane: tylko dane wyjściowe. Użyj w zamian zasady permissionDetails/inheritedFrom.

teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

Wycofane: tylko dane wyjściowe. Użyj w zamian zasady permissionDetails/role.

teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Wycofane: tylko dane wyjściowe. Użyj w zamian zasady permissionDetails/inherited.

deleted

boolean

Tylko dane wyjściowe. Określa, czy konto powiązane z tym uprawnieniem zostało usunięte. To pole dotyczy tylko uprawnień użytkownika i grupy.

view

string

Wskazuje widok danych z tym uprawnieniem. Wartość podawana tylko w przypadku uprawnień należących do widoku. 'opublikowana' to jedyna obsługiwana wartość.

pendingOwner

boolean

Określa, czy konto powiązane z tym uprawnieniem jest oczekującym właścicielem. Wartość podawana tylko w przypadku uprawnień typu user dotyczących plików, których nie ma na dysku współdzielonym.

Metody

create

Tworzy uprawnienia do pliku lub dysku współdzielonego.

delete

Usuwa uprawnienie.

get

Pobiera uprawnienie na podstawie identyfikatora.

list

Wyświetla listę uprawnień do pliku lub dysku współdzielonego.

update

Aktualizuje uprawnienie za pomocą semantyki poprawki.