REST Resource: permissions

Zasób: Permission

Uprawnienia do pliku. Uprawnienia przyznają użytkownikowi, grupie, domenie lub wszystkim użytkownikom dostęp do pliku lub hierarchii folderów.

Domyślnie prośby o przyznanie uprawnień zwracają tylko podzbiór pól. Rodzaj, identyfikator, typ i rola uprawnienia są zawsze zwracane. Aby pobrać określone pola, zapoznaj się z informacjami na stronie https://developers.google.com/drive/api/guides/fields-parameter.

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 
{
  "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. To jest unikalny identyfikator osoby, która otrzymała uprawnienia, i jest publikowany w Zasobach użytkownika jako permissionId. Identyfikatory powinny być traktowane jako wartości nieprzezroczyste.
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 „Jan Kowalski”;
  • group – nazwa grupy Google, np. „Administratorzy firmy”.
  • domain – ciąg tekstowy z nazwą domeny, na przykład „firma.pl”.
  • anyone – nie ma elementu displayName.
type

string

Typ podmiotu, któremu udzielono uprawnienia. Prawidłowe wartości to:

  • user
  • group
  • domain
  • anyone

Podczas tworzenia uprawnienia, jeśli type to user lub group, musisz podać emailAddress dla użytkownika lub grupy. Jeśli wartość type to domain, musisz podać wartość domain. W przypadku typu anyone nie trzeba podawać dodatkowych informacji.
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. Informacje o tym, czy uprawnienia dotyczące tego elementu na dysku współdzielonym zostały odziedziczone, czy są bezpośrednio przypisane do tego elementu. To pole wyjściowe jest obecne 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 dodać nowe wartości, ale obecnie dostępne są te:

  • file
  • member
permissionDetails[].inheritedFrom

string

Tylko dane wyjściowe. Identyfikator elementu, z którego to uprawnienie jest dziedziczone. To pole służy tylko do wyświetlania danych.
permissionDetails[].role

string

Tylko dane wyjściowe. Podstawowa rola tego użytkownika. W przyszłości możemy dodać nowe wartości, ale obecnie dostępne są te:

  • 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. To pole służy tylko do wyświetlania danych.
emailAddress

string

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

string

Rola przyznana przez to uprawnienie. W przyszłości możemy obsługiwać nowe wartości, ale obecnie dozwolone są te:

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

boolean

Określa, czy uprawnienie umożliwia znalezienie pliku w wyszukiwarce. 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 (format daty i godziny RFC 3339). Czasy ważności mają te ograniczenia:

  • Można je ustawić tylko w przypadku uprawnień użytkowników i grup.
  • Czas musi być w przyszłości.
  • Czas nie może być oddalony o więcej niż rok do przodu.
teamDrivePermissionDetails[]
(deprecated)

object

Tylko dane wyjściowe. Wycofane: tylko dane wyjściowe. Zamiast tego użyj pola permissionDetails.
teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

Wycofane: tylko dane wyjściowe. Zamiast tego użyj pola permissionDetails/permissionType.
teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

Wycofane: tylko dane wyjściowe. Zamiast tego użyj pola permissionDetails/inheritedFrom.
teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

Wycofane: tylko dane wyjściowe. Zamiast tego użyj pola permissionDetails/role.
teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Wycofane: tylko dane wyjściowe. Zamiast tego użyj pola permissionDetails/inherited.
deleted

boolean

Tylko dane wyjściowe. Czy konto powiązane z tym uprawnieniem zostało usunięte. To pole dotyczy tylko uprawnień użytkowników i grup.
view

string

Wskazuje widok tego uprawnienia. Wartość jest podawana tylko w przypadku uprawnień należących do widoku. Jedyną obsługiwaną wartością jest „published”.
pendingOwner

boolean

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

Metody

create

 Tworzy uprawnienia do pliku lub dysku współdzielonego.

delete

 Usuwanie uprawnienia.

get

 Pobiera uprawnienie według identyfikatora.

list

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

update

 Aktualizuje uprawnienie z semantyką poprawki.