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.

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

string

Dodatkowe role tego użytkownika. Obecnie dozwolona jest tylko forma commenter, ale w przyszłości możemy obsługiwać więcej formatów.
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[].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
  • reader
permissionDetails[].additionalRoles[]

string

Tylko dane wyjściowe. Dodatkowe role tego użytkownika. Obecnie możliwe jest tylko commenter, ale w przyszłości możemy obsługiwać więcej formatów.
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[].inherited

boolean

Tylko dane wyjściowe. Określa, czy to uprawnienie jest dziedziczone. To pole jest zawsze wypełniane.
teamDrivePermissionDetails[]
(deprecated)

object

Tylko dane wyjściowe. Wycofane: użyj w zamian permissionDetails.
teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

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

string

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

string

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

string

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

boolean

Tylko dane wyjściowe. Wycofane: użyj w zamian permissionDetails/inherited.
id

string

Identyfikator użytkownika, do którego odnosi się to uprawnienie, identyczny z identyfikatorem permissionId w zasobach Informacje i Pliki. Podczas wysyłania żądania drive.permissions.insert należy podać dokładnie jedno z pol id lub value, chyba że typ uprawnienia to anyone. W takim przypadku zarówno id, jak i value są ignorowane.
name

string

Tylko dane wyjściowe. Nazwa tego uprawnienia.
type

string

Typ konta. Dozwolone wartości to:

  • user
  • group
  • domain
  • anyone
role

string

Podstawowa rola tego użytkownika. W przyszłości możemy obsługiwać nowe wartości, ale obecnie dozwolone są te:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • reader
authKey
(deprecated)

string

Tylko dane wyjściowe. Rola wycofana.
value

string

Adres e-mail lub nazwa domeny podmiotu. Jest on używany podczas wstawiania, ale nie jest wypełniany w odpowiedziach. Podczas wysyłania żądania drive.permissions.insert należy podać dokładnie jedno z pol id lub value, chyba że typ uprawnienia to anyone. W takim przypadku zarówno id, jak i value są ignorowane.
kind

string

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

string

Tylko dane wyjściowe. Adres e-mail użytkownika lub grupy, do których odnosi się to uprawnienie. To pole tylko do odczytu jest obecne, gdy typ uprawnień to user lub group.
domain

string

Tylko dane wyjściowe. Nazwa domeny elementu, do którego odnosi się to uprawnienie. To pole służy tylko do odczytu i jest obecne, gdy typ uprawnień to user, group lub domain.
etag

string

Tylko dane wyjściowe. ETag uprawnienia.
expirationDate

string

Czas, w którym to uprawnienie wygaśnie (format daty i godziny RFC 3339). Data ważności podlega następującym ograniczeniom:

  • Można je ustawić tylko w przypadku uprawnień użytkowników i grup.
  • Data musi być datą przyszłą
  • Data nie może przypadać w przyszłości dłuższej niż rok.
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

    jest obecnie obsługiwana tylko w przypadku folderów.

pendingOwner

boolean

czy konto powiązane z tym uprawnieniem jest właścicielem oczekującym. 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

delete

 Usuwa uprawnienia z pliku lub dysku współdzielonego.

get

 Pobiera uprawnienie według identyfikatora.

getIdForEmail

 Zwraca identyfikator uprawnień dla adresu e-mail.

insert

 Wstawia uprawnienia do pliku lub dysku współdzielonego.

list

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

patch

 Aktualizuje uprawnienie przy użyciu semantyki poprawki.

update

 Aktualizuje uprawnienie.