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,
  "name": string,
  "type": string,
  "role": string,
  "additionalRoles": [
    string
  ],
  "authKey": string,
  "value": string,
  "kind": string,
  "withLink": boolean,
  "photoLink": string,
  "selfLink": string,
  "emailAddress": string,
  "domain": string,
  "etag": string,
  "permissionDetails": [
    {
      "permissionType": string,
      "role": string,
      "additionalRoles": [
        string
      ],
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "expirationDate": string,
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "role": string,
      "additionalRoles": [
        string
      ],
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean
}
Pola
id

string

Identyfikator użytkownika, którego dotyczy to uprawnienie, i identyczny z identyfikatorem permissionId w zasobach Informacje i Pliki. Podczas wysyłania żądania drive.permissions.insert należy określić dokładnie jedno z pól id lub value, chyba że typem uprawnienia jest anyone. W takim przypadku zarówno id, jak i value są ignorowane.
name

string

Tylko dane wyjściowe. Nazwa tego uprawnienia.
type

string

Rodzaj konta. Dozwolone wartości to:

  • user
  • group
  • domain
  • anyone
role

string

Główna rola tego użytkownika. W przyszłości mogą być obsługiwane nowe wartości, ale obecnie są dozwolone:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • reader
additionalRoles[]

string

Dodatkowe role dla tego użytkownika. Obecnie dozwolony jest tylko format commenter, ale w przyszłości może być ich więcej.
authKey
(deprecated)

string

Tylko dane wyjściowe. Rola wycofana.
value

string

Adres e-mail lub nazwa domeny elementu. Jest ona używana podczas wstawiania i nie jest wypełniana w odpowiedziach. Podczas wysyłania żądania drive.permissions.insert należy określić dokładnie jedno z pól id lub value, chyba że typem uprawnienia jest anyone. W takim przypadku zarówno id, jak i value są ignorowane.
kind

string

Tylko dane wyjściowe. Jest to zawsze drive#permission.
emailAddress

string

Tylko dane wyjściowe. Adres e-mail użytkownika lub grupy, do których odnosi się to uprawnienie. Jest to pole przeznaczone tylko do danych wyjściowych, które jest dostępne, gdy typ uprawnienia to user lub group.
domain

string

Tylko dane wyjściowe. Nazwa domeny podmiotu, do którego odnosi się to uprawnienie. Jest to pole przeznaczone tylko do danych wyjściowych, które jest dostępne, gdy typ uprawnienia to user, group lub domain.
etag

string

Tylko dane wyjściowe. Wartość ETag uprawnienia.
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[].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
  • reader
permissionDetails[].additionalRoles[]

string

Tylko dane wyjściowe. Dodatkowe role dla tego użytkownika. Obecnie możliwy jest tylko commenter, ale w przyszłości może być ich więcej.
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[].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.
expirationDate

string

Godzina, o której to uprawnienie wygaśnie (RFC 3339 data i godzina). Daty ważności podlegają następującym ograniczeniom:

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

object

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

string

Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu permissionDetails/permissionType.
teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu permissionDetails/role.
teamDrivePermissionDetails[]
(deprecated).additionalRoles[]
(deprecated)

string

Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu permissionDetails/additionalRoles.
teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu permissionDetails/inheritedFrom.
teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu 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. Jedyną obsługiwaną wartością jest 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

delete

 usuwa uprawnienia do pliku lub dysku współdzielonego,

get

 Pobiera uprawnienia na podstawie identyfikatora.

getIdForEmail

 Zwraca identyfikator uprawnienia dla adresu e-mail.

insert

 Wstawia uprawnienia do pliku lub dysku współdzielonego.

list

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

patch

 Aktualizuje uprawnienie za pomocą semantyki poprawki.

update

 Aktualizuje uprawnienia.