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 |
Identyfikator użytkownika, którego dotyczy to uprawnienie, i identyczny z identyfikatorem |
name |
Tylko dane wyjściowe. Nazwa tego uprawnienia. |
type |
Rodzaj konta. Dozwolone wartości to:
|
role |
Główna rola tego użytkownika. W przyszłości mogą być obsługiwane nowe wartości, ale obecnie są dozwolone:
|
additionalRoles[] |
Dodatkowe role dla tego użytkownika. Obecnie dozwolony jest tylko format |
authKey |
Tylko dane wyjściowe. Rola wycofana. |
value |
Adres e-mail lub nazwa domeny elementu. Jest ona używana podczas wstawiania i nie jest wypełniana w odpowiedziach. Podczas wysyłania żądania |
kind |
Tylko dane wyjściowe. Jest to zawsze |
withLink |
Określa, czy link jest wymagany w przypadku tego uprawnienia. |
photoLink |
Tylko dane wyjściowe. link do zdjęcia profilowego (jeśli jest dostępny); |
selfLink |
Tylko dane wyjściowe. Link zwrotny do informacji o uprawnieniach. |
emailAddress |
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 |
domain |
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 |
etag |
Tylko dane wyjściowe. Wartość ETag uprawnienia. |
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[].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[].additionalRoles[] |
Tylko dane wyjściowe. Dodatkowe role dla tego użytkownika. Obecnie możliwy jest tylko |
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[].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. |
expirationDate |
Godzina, o której to uprawnienie wygaśnie (RFC 3339 data i godzina). Daty ważności podlegają następującym ograniczeniom:
|
teamDrivePermissionDetails[] |
Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu |
teamDrivePermissionDetails[] |
Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu |
teamDrivePermissionDetails[] |
Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu |
teamDrivePermissionDetails[] |
Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu |
teamDrivePermissionDetails[] |
Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu |
teamDrivePermissionDetails[] |
Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu |
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. Jedyną obsługiwaną wartością jest |
pendingOwner |
Określa, czy konto powiązane z tym uprawnieniem jest oczekiwanym właścicielem. Wartość podawana tylko w przypadku uprawnień typu |
Metody |
|
---|---|
|
usuwa uprawnienia do pliku lub dysku współdzielonego, |
|
Pobiera uprawnienia na podstawie identyfikatora. |
|
Zwraca identyfikator uprawnienia dla adresu e-mail. |
|
Wstawia uprawnienia do pliku lub dysku współdzielonego. |
|
Wyświetla listę uprawnień pliku lub dysku współdzielonego. |
|
Aktualizuje uprawnienie za pomocą semantyki poprawki. |
|
Aktualizuje uprawnienia. |