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 |
Tylko dane wyjściowe. Identyfikator tego uprawnienia. Jest to unikalny identyfikator użytkownika, który jest opublikowany w zasobach użytkownika jako |
displayName |
Tylko dane wyjściowe. „ładna” nazwa wartości uprawnienia. Poniżej znajduje się lista przykładów poszczególnych typów uprawnień:
|
type |
Typ obdarowanego. Prawidłowe wartości to:
Podczas tworzenia uprawnienia, jeśli |
kind |
Tylko dane wyjściowe. Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków |
permissionDetails[] |
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 |
Tylko dane wyjściowe. Typ uprawnień tego użytkownika. W przyszłości możemy dodawać kolejne wartości, ale obecnie:
|
permissionDetails[].inheritedFrom |
Tylko dane wyjściowe. Identyfikator elementu, z którego odziedziczone są to uprawnienie. To pole jest przeznaczone tylko do danych wyjściowych. |
permissionDetails[].role |
Tylko dane wyjściowe. Główna rola tego użytkownika. W przyszłości możemy dodawać kolejne wartości, ale obecnie są to:
|
permissionDetails[].inherited |
Tylko dane wyjściowe. Czy to uprawnienie jest dziedziczone. To pole jest zawsze wypełnione. To pole jest przeznaczone tylko do danych wyjściowych. |
photoLink |
Tylko dane wyjściowe. Link do zdjęcia profilowego użytkownika, jeśli jest dostępne. |
emailAddress |
Adres e-mail użytkownika lub grupy, do których odnosi się to uprawnienie. |
role |
Rola przypisana przez to uprawnienie. W przyszłości mogą być obsługiwane nowe wartości, ale obecnie są dozwolone:
|
allowFileDiscovery |
Określa, czy uprawnienie umożliwia wykrycie pliku podczas wyszukiwania. Dotyczy to tylko uprawnień typu |
domain |
Domena, do której odnosi się to uprawnienie. |
expirationTime |
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:
|
teamDrivePermissionDetails[] |
Tylko dane wyjściowe. Wycofane: tylko dane wyjściowe. Użyj w zamian zasady |
teamDrivePermissionDetails[] |
Wycofane: tylko dane wyjściowe. Użyj w zamian zasady |
teamDrivePermissionDetails[] |
Wycofane: tylko dane wyjściowe. Użyj w zamian zasady |
teamDrivePermissionDetails[] |
Wycofane: tylko dane wyjściowe. Użyj w zamian zasady |
teamDrivePermissionDetails[] |
Wycofane: tylko dane wyjściowe. Użyj w zamian zasady |
deleted |
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 |
Wskazuje widok z tym uprawnieniem. Wartość podawana tylko w przypadku uprawnień należących do widoku. Jedyna obsługiwana wartość to „published”. |
pendingOwner |
Określa, czy konto powiązane z tym uprawnieniem jest oczekiwanym właścicielem. Wartość podawana tylko w przypadku uprawnień typu |
Metody |
|
---|---|
|
Tworzy uprawnienia do pliku lub dysku współdzielonego. |
|
Usuwa uprawnienie. |
|
Pobiera uprawnienia na podstawie identyfikatora. |
|
Wyświetla listę uprawnień pliku lub dysku współdzielonego. |
|
Aktualizuje uprawnienie z semantyką poprawki. |