REST Resource: permissions

Zasób: Permission

Uprawnienie do pliku. Uprawnienie zapewnia użytkownikowi, grupie, domenie lub światu dostęp do pliku lub hierarchii folderów.

Niektóre metody zasobów (takie jak 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. Jest to unikalny identyfikator użytkownika, który jest opublikowany w zasobach użytkownika jako permissionId. Identyfikatory powinny być traktowane jako wartości nieprzejrzyste.

displayName

string

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

  • user – imię i nazwisko użytkownika określone dla konta Google, np. „Jan Kowalski”.
  • group – nazwa grupy dyskusyjnej Google, na przykład „Administratorzy firmy”.
  • domain: ciąg znaków zawierający nazwę domeny, na przykład „firma.com”.
  • anyone – brak wartości displayName.
type

string

Typ obdarowanego. Prawidłowe wartości to:

  • user
  • group
  • domain
  • anyone

Podczas tworzenia uprawnienia, jeśli type ma wartość user lub group, musisz podać emailAddress dla użytkownika lub grupy. Jeśli type ma wartość 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óły dotyczące tego, czy uprawnienia do tego elementu na dysku współdzielonym są dziedziczone czy bezpośrednio do tego elementu. To pole jest przeznaczone tylko do danych wyjściowych, które jest dostępne 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ć kolejne wartości, ale obecnie:

  • file
  • member
permissionDetails[].inheritedFrom

string

Tylko dane wyjściowe. Identyfikator elementu, z którego odziedziczone są to uprawnienie. To pole jest przeznaczone tylko do danych wyjściowych.

permissionDetails[].role

string

Tylko dane wyjściowe. Główna rola tego użytkownika. W przyszłości możemy dodawać kolejne wartości, ale obecnie są to:

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

boolean

Tylko dane wyjściowe. Czy to uprawnienie jest dziedziczone. To pole jest zawsze wypełnione. To pole jest przeznaczone tylko do danych wyjściowych.

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 są dozwolone:

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

boolean

Określa, czy uprawnienie umożliwia wykrycie pliku podczas wyszukiwania. 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 (RFC 3339 data i godzina). Obowiązują następujące ograniczenia dotyczące okresu ważności:

  • Można je ustawiać tylko na poziomie uprawnień użytkownika i grupy.
  • Godzina musi przypadać w przyszłości.
  • Nie może być oddalony o więcej niż rok do przodu.
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 tymi uprawnieniami zostało usunięte. To pole dotyczy tylko uprawnień użytkownika i grupy.

view

string

Wskazuje widok z tym uprawnieniem. Wartość podawana tylko w przypadku uprawnień należących do widoku. Jedyna obsługiwana wartość to „published”.

pendingOwner

boolean

Określa, czy konto powiązane z tym uprawnieniem jest oczekiwanym właścicielem. Wartość podawana tylko w przypadku uprawnień typu user w przypadku plików, które nie znajdują się na dysku współdzielonym.

Metody

create

Tworzy uprawnienia do pliku lub dysku współdzielonego.

delete

Usuwa uprawnienie.

get

Pobiera uprawnienia na podstawie identyfikatora.

list

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

update

Aktualizuje uprawnienie z semantyką poprawki.