REST Resource: drives

Recurso: Drive

Es la representación de una unidad compartida.

Algunos métodos de recursos (como drives.update) requieren un driveId. Usa el método drives.list para recuperar el ID de una unidad compartida.

Representación JSON 
{
  "id": string,
  "name": string,
  "colorRgb": string,
  "kind": string,
  "backgroundImageLink": string,
  "capabilities": {
    "canAddChildren": boolean,
    "canComment": boolean,
    "canCopy": boolean,
    "canDeleteDrive": boolean,
    "canDownload": boolean,
    "canEdit": boolean,
    "canListChildren": boolean,
    "canManageMembers": boolean,
    "canReadRevisions": boolean,
    "canRename": boolean,
    "canRenameDrive": boolean,
    "canChangeDriveBackground": boolean,
    "canShare": boolean,
    "canChangeCopyRequiresWriterPermissionRestriction": boolean,
    "canChangeDomainUsersOnlyRestriction": boolean,
    "canChangeDriveMembersOnlyRestriction": boolean,
    "canChangeSharingFoldersRequiresOrganizerPermissionRestriction": boolean,
    "canResetDriveRestrictions": boolean,
    "canDeleteChildren": boolean,
    "canTrashChildren": boolean,
    "canChangeDownloadRestriction": boolean
  },
  "themeId": string,
  "backgroundImageFile": {
    "id": string,
    "xCoordinate": number,
    "yCoordinate": number,
    "width": number
  },
  "createdTime": string,
  "hidden": boolean,
  "restrictions": {
    "copyRequiresWriterPermission": boolean,
    "domainUsersOnly": boolean,
    "driveMembersOnly": boolean,
    "adminManagedRestrictions": boolean,
    "sharingFoldersRequiresOrganizerPermission": boolean,
    "downloadRestriction": {
      object (DownloadRestriction)
    }
  },
  "orgUnitId": string
}
Campos
id

string

Solo salida. Es el ID de esta unidad compartida, que también es el ID de la carpeta de nivel superior de esta unidad compartida.
name

string

Es el nombre de esta unidad compartida.
colorRgb

string

Color de esta unidad compartida como una cadena hexadecimal RGB. Solo se puede configurar en una solicitud de drive.drives.update que no establezca themeId.
kind

string

Solo salida. Identifica qué tipo de recurso es este. El valor es la cadena fija "drive#drive".
capabilities

object

Solo salida. Son las capacidades que tiene el usuario actual en esta unidad compartida.
capabilities.canAddChildren

boolean

Solo salida. Indica si el usuario actual puede agregar elementos secundarios a las carpetas de esta unidad compartida.
capabilities.canComment

boolean

Solo salida. Indica si el usuario actual puede agregar comentarios a los archivos de esta unidad compartida.
capabilities.canCopy

boolean

Solo salida. Indica si el usuario actual puede copiar archivos en esta unidad compartida.
capabilities.canDeleteDrive

boolean

Solo salida. Indica si el usuario actual puede borrar esta unidad compartida. Si intentas borrar la unidad compartida, es posible que la operación falle si hay elementos sin borrar en ella.
capabilities.canDownload

boolean

Solo salida. Indica si el usuario actual puede descargar archivos en esta unidad compartida.
capabilities.canEdit

boolean

Solo salida. Indica si el usuario actual puede editar archivos en esta unidad compartida.
capabilities.canListChildren

boolean

Solo salida. Indica si el usuario actual puede enumerar los elementos secundarios de las carpetas en esta unidad compartida.
capabilities.canManageMembers

boolean

Solo salida. Indica si el usuario actual puede agregar miembros a esta unidad compartida, quitarlos o cambiar su rol.
capabilities.canReadRevisions

boolean

Solo salida. Indica si el usuario actual puede leer el recurso de revisiones de los archivos de esta unidad compartida.
capabilities.canRename

boolean

Solo salida. Indica si el usuario actual puede cambiar el nombre de los archivos o las carpetas en esta unidad compartida.
capabilities.canRenameDrive

boolean

Solo salida. Indica si el usuario actual puede cambiar el nombre de esta unidad compartida.
capabilities.canChangeDriveBackground

boolean

Solo salida. Indica si el usuario actual puede cambiar el fondo de esta unidad compartida.
capabilities.canShare

boolean

Solo salida. Indica si el usuario actual puede compartir archivos o carpetas en esta unidad compartida.
capabilities.canChangeCopyRequiresWriterPermissionRestriction

boolean

Solo salida. Indica si el usuario actual puede cambiar la restricción de copyRequiresWriterPermission de esta unidad compartida.
capabilities.canChangeDomainUsersOnlyRestriction

boolean

Solo salida. Indica si el usuario actual puede cambiar la restricción de domainUsersOnly de esta unidad compartida.
capabilities.canChangeDriveMembersOnlyRestriction

boolean

Solo salida. Indica si el usuario actual puede cambiar la restricción de driveMembersOnly de esta unidad compartida.
capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction

boolean

Solo salida. Indica si el usuario actual puede cambiar la restricción de sharingFoldersRequiresOrganizerPermission de esta unidad compartida.
capabilities.canResetDriveRestrictions

boolean

Solo salida. Indica si el usuario actual puede restablecer la configuración predeterminada de las restricciones de la unidad compartida.
capabilities.canDeleteChildren

boolean

Solo salida. Indica si el usuario actual puede borrar elementos secundarios de las carpetas de esta unidad compartida.
capabilities.canTrashChildren

boolean

Solo salida. Indica si el usuario actual puede enviar a la papelera elementos secundarios de carpetas en esta unidad compartida.
capabilities.canChangeDownloadRestriction

boolean

Solo salida. Indica si el usuario actual puede cambiar las restricciones de descarga aplicadas por el organizador de esta unidad compartida.
themeId

string

Es el ID del tema desde el que se establecerán la imagen y el color de fondo. El conjunto de driveThemes posibles se puede recuperar de una respuesta de drive.about.get. Cuando no se especifica en una solicitud de drive.drives.create, se elige un tema aleatorio desde el que se configuran la imagen y el color de fondo. Este es un campo de solo escritura; solo se puede establecer en solicitudes que no establecen colorRgb ni backgroundImageFile.
backgroundImageFile

object

Es un archivo de imagen y parámetros de recorte a partir de los cuales se establece una imagen de fondo para esta unidad compartida. Este es un campo de solo escritura; solo se puede configurar en solicitudes drive.drives.update que no establecen themeId. Cuando se especifica, se deben configurar todos los campos de backgroundImageFile.
backgroundImageFile.id

string

ID de un archivo de imagen en Google Drive que se usará para la imagen de fondo.
backgroundImageFile.xCoordinate

number

Es la coordenada X de la esquina superior izquierda del área de recorte en la imagen de fondo. Es un valor en el rango cerrado de 0 a 1. Este valor representa la distancia horizontal desde el lado izquierdo de toda la imagen hasta el lado izquierdo del área de recorte, dividida por el ancho de toda la imagen.
backgroundImageFile.yCoordinate

number

Es la coordenada Y de la esquina superior izquierda del área de recorte en la imagen de fondo. Es un valor en el rango cerrado de 0 a 1. Este valor representa la distancia vertical desde la parte superior de toda la imagen hasta la parte superior del área de recorte, dividida por la altura de toda la imagen.
backgroundImageFile.width

number

Ancho de la imagen recortada en el rango cerrado de 0 a 1. Este valor representa el ancho de la imagen recortada dividido por el ancho de la imagen completa. La altura se calcula aplicando una relación de aspecto de ancho a alto de 80 a 9. La imagen resultante debe tener al menos 1,280 píxeles de ancho y 144 píxeles de alto.
createdTime

string

Solo salida. Fecha y hora en que se creó la unidad compartida (fecha y hora según RFC 3339).
hidden

boolean

Indica si la unidad compartida está oculta en la vista predeterminada.
restrictions

object

Es un conjunto de restricciones que se aplican a esta unidad compartida o a los elementos que contiene. Ten en cuenta que no se pueden establecer restricciones cuando se crea una unidad compartida. Para agregar una restricción, primero crea una unidad compartida y, luego, usa drives.update para agregar restricciones.
restrictions.copyRequiresWriterPermission

boolean

Indica si se deben inhabilitar las opciones para copiar, imprimir o descargar archivos dentro de esta unidad compartida para los lectores y comentaristas. Cuando esta restricción se establece en true, anulará el campo con un nombre similar y lo establecerá en true para cualquier archivo dentro de esta unidad compartida.
restrictions.domainUsersOnly

boolean

Indica si el acceso a esta unidad compartida y a los elementos que contiene está restringido a los usuarios del dominio al que pertenece la unidad compartida. Otras políticas de uso compartido controladas fuera de esta unidad compartida pueden anular esta restricción.
restrictions.driveMembersOnly

boolean

Indica si el acceso a los elementos dentro de esta unidad compartida está restringido a sus miembros.
restrictions.adminManagedRestrictions

boolean

Indica si se requieren privilegios de administrador en esta unidad compartida para modificar las restricciones.
restrictions.sharingFoldersRequiresOrganizerPermission

boolean

Si es verdadero, solo los usuarios con el rol de organizador pueden compartir carpetas. Si es falso, los usuarios con el rol de organizador o de organizador de archivos pueden compartir carpetas.
restrictions.downloadRestriction

object (DownloadRestriction)

Restricciones de descarga aplicadas por los administradores de la unidad compartida.
orgUnitId

string

Solo salida. Es la unidad organizativa de esta unidad compartida. Este campo solo se propaga en las respuestas de drives.list cuando el parámetro useDomainAdminAccess se establece en true.

Métodos

create

 Crea una unidad compartida.

delete

 Borra de forma permanente una unidad compartida para la que el usuario es organizer.

get

 Obtiene los metadatos de una unidad compartida por ID.

hide

 Oculta una unidad compartida de la vista predeterminada.

list

Enumera las unidades compartidas del usuario.

unhide

 Restablece una unidad compartida a la vista predeterminada.

update

 Actualiza los metadatos de una unidad compartida.