REST Resource: permissions

Zasób: Permission

Uprawnienia do pliku. Uprawnienie zapewnia użytkownikowi, grupie, domenie lub światowym dostęp do pliku bądź hierarchii folderów.

Niektóre metody zasobów (takie jak permissions.update) wymagają permissionId. Użyj metody permissions.list, aby pobrać identyfikator pliku, folderu lub dysku współdzielonego.

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, do którego odnosi się to uprawnienie, i taki sam jak identyfikator permissionId w zasobach Informacje i Pliki. Przy wysyłaniu żądania drive.permissions.insert musisz podać dokładnie jedno z pól 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

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

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

string

Dodatkowe role dla tego użytkownika. Obecnie dozwolona liczba to commenter, ale w przyszłości możemy dodać ich więcej.

authKey
(deprecated)

string

Tylko dane wyjściowe. Rola wycofana.

value

string

Adres e-mail lub nazwa domeny elementu. Jest używane podczas wstawiania i nie jest wypełniane w odpowiedziach. Przy wysyłaniu żądania drive.permissions.insert musisz podać dokładnie jedno z pól 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. To 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 zawiera tylko dane wyjściowe, które występuje, gdy typ uprawnienia to user lub group.

domain

string

Tylko dane wyjściowe. Nazwa domeny elementu, do którego odnosi się to uprawnienie. To pole zawiera tylko dane wyjściowe, które występuje, gdy typ uprawnienia to user, group lub domain.

etag

string

Tylko dane wyjściowe. Tag ETag uprawnienia.

permissionDetails[]

object

Tylko dane wyjściowe. Szczegółowe informacje o tym, czy uprawnienia do tego elementu na dysku współdzielonym są dziedziczone czy bezpośrednio do niego. To jest pole przeznaczone tylko do danych wyjściowych, które występuje 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ć nowe wartości, ale obecnie możliwe są następujące przypadki:

  • file
  • member
permissionDetails[].role

string

Tylko dane wyjściowe. Główna rola tego użytkownika. W przyszłości możemy dodawać nowe wartości, ale obecnie możliwe są następujące przypadki:

  • organizer
  • fileOrganizer
  • writer
  • reader
permissionDetails[].additionalRoles[]

string

Tylko dane wyjściowe. Dodatkowe role dla tego użytkownika. Obecnie jest dostępna tylko commenter, ale w przyszłości możemy dodać ich więcej.

permissionDetails[].inheritedFrom

string

Tylko dane wyjściowe. Identyfikator elementu, z którego dane uprawnienie jest dziedziczone. Jest to pole tylko z danymi wyjściowymi.

permissionDetails[].inherited

boolean

Tylko dane wyjściowe. Określa, czy to uprawnienie jest dziedziczone. To pole jest zawsze wypełniane. Jest to pole tylko z danymi wyjściowymi.

expirationDate

string

Godzina, o której to uprawnienie wygaśnie (data i godzina w RFC 3339). Terminy ważności mają następujące ograniczenia:

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

object

Tylko dane wyjściowe. Wycofane: użyj atrybutu permissionDetails.

teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

Tylko dane wyjściowe. Wycofane: użyj atrybutu permissionDetails/permissionType.

teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

Tylko dane wyjściowe. Wycofane: użyj atrybutu permissionDetails/role.

teamDrivePermissionDetails[]
(deprecated).additionalRoles[]
(deprecated)

string

Tylko dane wyjściowe. Wycofane: użyj atrybutu permissionDetails/additionalRoles.

teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

Tylko dane wyjściowe. Wycofane: użyj atrybutu permissionDetails/inheritedFrom.

teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj atrybutu permissionDetails/inherited.

deleted

boolean

Tylko dane wyjściowe. Określa, czy konto powiązane z tym uprawnieniem zostało usunięte. To pole dotyczy tylko uprawnień użytkownika i grupy.

view

string

Wskazuje widok danych 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 oczekującym właścicielem. Wartość podawana tylko w przypadku uprawnień typu user dotyczących plików, których nie ma na dysku współdzielonym.

Metody

delete

Usuwa uprawnienia z pliku lub dysku współdzielonego.

get

Pobiera uprawnienie na podstawie identyfikatora.

getIdForEmail

Zwraca identyfikator uprawnień dla adresu e-mail.

insert

Wstawia uprawnienia do pliku lub dysku współdzielonego.

list

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

patch

Aktualizuje uprawnienie za pomocą semantyki poprawki.

update

Aktualizuje uprawnienie.