Recurso: Permiso
Un permiso para un archivo. Un permiso concede a un usuario, grupo, dominio o al mundo acceso a un archivo o una jerarquía de carpetas.
Algunos métodos de recursos (como permissions.update
) requieren un permissionId
. Usa el método permissions.list
para recuperar el ID de un archivo, una carpeta o una unidad compartida.
Representación 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 } |
Campos | |
---|---|
id |
Es el ID del usuario al que hace referencia este permiso y es idéntico al |
name |
Solo salida. El nombre de este permiso. |
type |
El tipo de cuenta. Los valores permitidos son los siguientes:
|
role |
Es el rol principal de este usuario. Si bien es posible que en el futuro se admitan valores nuevos, actualmente se permiten los siguientes valores:
|
additionalRoles[] |
Roles adicionales para este usuario. Por el momento, solo se permiten |
authKey |
Solo salida. Ya no está disponible. |
value |
Es la dirección de correo electrónico o el nombre de dominio de la entidad. Se usa durante las inserciones y no se propaga en las respuestas. Cuando se realiza una solicitud |
kind |
Solo salida. Siempre es |
withLink |
Indica si el vínculo es necesario para este permiso. |
photoLink |
Solo salida. Un vínculo a la foto de perfil (si está disponible). |
selfLink |
Solo salida. Un vínculo a este permiso. |
emailAddress |
Solo salida. La dirección de correo electrónico del usuario o grupo al que hace referencia este permiso. Este es un campo de solo salida que está presente cuando el tipo de permiso es |
domain |
Solo salida. Es el nombre de dominio de la entidad a la que hace referencia este permiso. Este es un campo de solo salida que está presente cuando el tipo de permiso es |
etag |
Solo salida. La ETag del permiso. |
permissionDetails[] |
Solo salida. Detalles sobre si los permisos de este elemento de la unidad compartida son heredados o directamente en este elemento. Este es un campo de solo salida que está presente únicamente para los elementos de las unidades compartidas. |
permissionDetails[].permissionType |
Solo salida. Es el tipo de permiso de este usuario. Si bien es posible que se agreguen valores nuevos en el futuro, en este momento sucede lo siguiente:
|
permissionDetails[].role |
Solo salida. Es el rol principal de este usuario. Si bien es posible que se agreguen valores nuevos en el futuro, actualmente es posible hacer lo siguiente:
|
permissionDetails[].additionalRoles[] |
Solo salida. Roles adicionales para este usuario. Por el momento, solo es posible usar |
permissionDetails[].inheritedFrom |
Solo salida. El ID del elemento desde el que se hereda este permiso. Este es un campo de solo resultados. |
permissionDetails[].inherited |
Solo salida. Indica si este permiso es heredado. Este campo siempre se propaga. Este es un campo de solo resultados. |
expirationDate |
El momento en el que vencerá este permiso (fecha y hora de RFC 3339). Las fechas de vencimiento tienen las siguientes restricciones:
|
teamDrivePermissionDetails[] |
Solo salida. Obsoleto: usa |
teamDrivePermissionDetails[] |
Solo salida. Obsoleto: usa |
teamDrivePermissionDetails[] |
Solo salida. Obsoleto: usa |
teamDrivePermissionDetails[] |
Solo salida. Obsoleto: usa |
teamDrivePermissionDetails[] |
Solo salida. Obsoleto: usa |
teamDrivePermissionDetails[] |
Solo salida. Obsoleto: usa |
deleted |
Solo salida. Indica si se borró la cuenta asociada con este permiso. Este campo solo corresponde a los permisos de usuario y grupo. |
view |
Indica la vista para este permiso. Solo se propaga para los permisos que pertenecen a una vista. |
pendingOwner |
Si la cuenta asociada con este permiso es un propietario pendiente. Solo se propaga para los permisos de tipo |
Métodos |
|
---|---|
|
Borra un permiso de un archivo o una unidad compartida. |
|
Obtiene un permiso por ID. |
|
Muestra el ID de permiso de una dirección de correo electrónico. |
|
Inserta un permiso para un archivo o una unidad compartida. |
|
Muestra una lista con los permisos de un archivo o una unidad compartida. |
|
Actualiza un permiso mediante la semántica de parches. |
|
Actualiza un permiso. |