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 |
Identyfikator użytkownika, do którego odnosi się to uprawnienie, i taki sam jak identyfikator |
name |
Tylko dane wyjściowe. Nazwa tego uprawnienia. |
type |
Typ 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 dozwolone są te wartości:
|
additionalRoles[] |
Dodatkowe role dla tego użytkownika. Obecnie dozwolona liczba to |
authKey |
Tylko dane wyjściowe. Rola wycofana. |
value |
Adres e-mail lub nazwa domeny elementu. Jest używane podczas wstawiania i nie jest wypełniane w odpowiedziach. Przy wysyłaniu żądania |
kind |
Tylko dane wyjściowe. To zawsze |
withLink |
Wskazuje, 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 powrotny do tego uprawnienia. |
emailAddress |
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 |
domain |
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 |
etag |
Tylko dane wyjściowe. Tag ETag uprawnienia. |
permissionDetails[] |
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 |
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:
|
permissionDetails[].role |
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:
|
permissionDetails[].additionalRoles[] |
Tylko dane wyjściowe. Dodatkowe role dla tego użytkownika. Obecnie jest dostępna tylko |
permissionDetails[].inheritedFrom |
Tylko dane wyjściowe. Identyfikator elementu, z którego dane uprawnienie jest dziedziczone. Jest to pole tylko z danymi wyjściowymi. |
permissionDetails[].inherited |
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 |
Godzina, o której to uprawnienie wygaśnie (data i godzina w RFC 3339). Terminy ważności mają następujące ograniczenia:
|
teamDrivePermissionDetails[] |
Tylko dane wyjściowe. Wycofane: użyj atrybutu |
teamDrivePermissionDetails[] |
Tylko dane wyjściowe. Wycofane: użyj atrybutu |
teamDrivePermissionDetails[] |
Tylko dane wyjściowe. Wycofane: użyj atrybutu |
teamDrivePermissionDetails[] |
Tylko dane wyjściowe. Wycofane: użyj atrybutu |
teamDrivePermissionDetails[] |
Tylko dane wyjściowe. Wycofane: użyj atrybutu |
teamDrivePermissionDetails[] |
Tylko dane wyjściowe. Wycofane: użyj atrybutu |
deleted |
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 |
Wskazuje widok danych 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 oczekującym właścicielem. Wartość podawana tylko w przypadku uprawnień typu |
Metody |
|
---|---|
|
Usuwa uprawnienia z pliku lub dysku współdzielonego. |
|
Pobiera uprawnienie na podstawie identyfikatora. |
|
Zwraca identyfikator uprawnień dla adresu e-mail. |
|
Wstawia uprawnienia do pliku lub dysku współdzielonego. |
|
Wyświetla listę uprawnień do pliku lub dysku współdzielonego. |
|
Aktualizuje uprawnienie za pomocą semantyki poprawki. |
|
Aktualizuje uprawnienie. |