REST Resource: permissions

Zasób: Permission

Uprawnienie 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 artykułem 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,
  "inheritedPermissionsDisabled": 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 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. Informacje o tym, czy uprawnienia do tego elementu są dziedziczone czy przypisane bezpośrednio do tego elementu.
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. Ta wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.
permissionDetails[].role

string

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

  • owner
  • 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ć podany w przyszłości.
  • Czas nie może być oddalony o więcej niż rok.
teamDrivePermissionDetails[]
(deprecated)

object

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

string

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

string

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

string

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

boolean

Wycofane: tylko dane wyjściowe. Zamiast tego użyj kolumny 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.

published

i

metadata

są jedynymi obsługiwanymi wartościami.

  • published

    : Rola uprawnienia to published_reader.

  • metadata

    : Element jest widoczny tylko w widoku metadanych, ponieważ ma ograniczony dostęp, a zakres ma co najmniej dostęp tylko do odczytu do elementu nadrzędnego. Uwaga:

    metadata

    widok jest obecnie obsługiwany tylko w przypadku folderów.

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.
inheritedPermissionsDisabled

boolean

Jeśli to pole ma wartość true, dostęp do elementu mają tylko organizatorzy, właściciele i użytkownicy z uprawnieniami dodanymi bezpośrednio do tego elementu.

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.