Se usó la API de Cloud Translation para traducir esta página.

REST Resource: drives

Recurso: Drive
- Representación JSON
Métodos

Recurso: Drive

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 }, "themeId": string, "backgroundImageFile": { "id": string, "xCoordinate": number, "yCoordinate": number, "width": number }, "createdDate": string, "hidden": boolean, "restrictions": { "copyRequiresWriterPermission": boolean, "domainUsersOnly": boolean, "driveMembersOnly": boolean, "adminManagedRestrictions": boolean, "sharingFoldersRequiresOrganizerPermission": boolean }, "orgUnitId": string }

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
  },
  "themeId": string,
  "backgroundImageFile": {
    "id": string,
    "xCoordinate": number,
    "yCoordinate": number,
    "width": number
  },
  "createdDate": string,
  "hidden": boolean,
  "restrictions": {
    "copyRequiresWriterPermission": boolean,
    "domainUsersOnly": boolean,
    "driveMembersOnly": boolean,
    "adminManagedRestrictions": boolean,
    "sharingFoldersRequiresOrganizerPermission": boolean
  },
  "orgUnitId": string
}

Campos
`id`	`string` Solo salida. El ID de esta unidad compartida, que también es el ID de la carpeta de nivel superior en ella.
`name`	`string` El nombre de esta unidad compartida.
`colorRgb`	`string` El color de esta unidad compartida como una cadena hexadecimal RGB. Solo se puede establecer en una solicitud `drive.drives.update` en la que no se configura `themeId`.
`kind`	`string` Solo salida. Siempre es `drive#drive`
`backgroundImageLink`	`string` Solo salida. Es un vínculo de corta duración a la imagen de fondo de esta unidad compartida.
`capabilities`	`object` Solo salida. Funciones 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 comentar los archivos de esta unidad compartida.
`capabilities.canCopy`	`boolean` Solo salida. Indica si el usuario actual puede copiar archivos de 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 falle si hay elementos que no se enviaron a la papelera dentro de ella.
`capabilities.canDownload`	`boolean` Solo salida. Indica si el usuario actual puede descargar archivos de esta unidad compartida.
`capabilities.canEdit`	`boolean` Solo salida. Si el usuario actual puede editar archivos de esta unidad compartida
`capabilities.canListChildren`	`boolean` Solo salida. Indica si el usuario actual puede enumerar los elementos secundarios de las carpetas de esta unidad compartida.
`capabilities.canManageMembers`	`boolean` Solo salida. Indica si el usuario actual puede agregar miembros a esta unidad compartida, quitarlos o cambiar sus roles.
`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 de 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 `copyRequiresWriterPermission` de esta unidad compartida.
`capabilities.canChangeDomainUsersOnlyRestriction`	`boolean` Solo salida. Indica si el usuario actual puede cambiar la restricción `domainUsersOnly` de esta unidad compartida.
`capabilities.canChangeDriveMembersOnlyRestriction`	`boolean` Solo salida. Indica si el usuario actual puede cambiar la restricción `driveMembersOnly` de esta unidad compartida.
`capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction`	`boolean` Solo salida. Indica si el usuario actual puede cambiar la restricción `sharingFoldersRequiresOrganizerPermission` de esta unidad compartida.
`capabilities.canResetDriveRestrictions`	`boolean` Solo salida. Indica si el usuario actual puede restablecer las restricciones de la unidad compartida a la configuración predeterminada.
`capabilities.canDeleteChildren`	`boolean` Solo salida. Indica si el usuario actual puede borrar a los niños de las carpetas de esta unidad compartida.
`capabilities.canTrashChildren`	`boolean` Solo salida. Indica si el usuario actual puede eliminar a los elementos secundarios de las carpetas de esta unidad compartida.
`themeId`	`string` El ID del tema a partir del cual se configurarán la imagen de fondo y el color. El conjunto de `driveThemes` posibles se puede recuperar a partir de una respuesta `drive.about.get`. Cuando no se especifica en una solicitud `drive.drives.insert`, se elige un tema aleatorio a partir del cual se establecen la imagen de fondo y el color. Este es un campo de solo escritura. Solo se puede establecer en solicitudes que no tienen `colorRgb` ni `backgroundImageFile`.
`backgroundImageFile`	`object` Un archivo de imagen y parámetros de recorte a partir de los cuales se configura una imagen de fondo para esta unidad compartida. Este es un campo de solo escritura. Solo se puede establecer en solicitudes `drive.drives.update` en las que no se configura `themeId`. Cuando se especifica, se deben configurar todos los campos de `backgroundImageFile`.
`backgroundImageFile.id`	`string` El ID de un archivo de imagen en Google Drive que se usará como imagen de fondo.
`backgroundImageFile.xCoordinate`	`number` 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` 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 el lado superior de toda la imagen hasta el lado superior del área de recorte dividida por la altura de toda la imagen.
`backgroundImageFile.width`	`number` Es el 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 toda la imagen. La altura se calcula aplicando una relación de aspecto de ancho a altura de 80:9. La imagen resultante debe tener al menos 1280 píxeles de ancho y 144 píxeles de alto.
`createdDate`	`string` Solo salida. La hora en la que se creó la unidad compartida (fecha y hora RFC 3339).
`hidden`	`boolean` Si la unidad compartida está oculta de la vista predeterminada
`restrictions`	`object` Un conjunto de restricciones que se aplican a esta unidad compartida o a los elementos dentro de ella.
`restrictions.copyRequiresWriterPermission`	`boolean` Si las opciones de copiar, imprimir o descargar archivos de esta unidad compartida deben estar inhabilitadas para los lectores y los comentaristas. Cuando esta restricción se establece como `true`, se anulará el campo con nombre similar a `true` para cualquier archivo dentro de esta unidad compartida.
`restrictions.domainUsersOnly`	`boolean` Indica si el acceso a esta unidad compartida y a sus elementos está restringido a los usuarios del dominio al que pertenece la unidad compartida. Es posible que otras políticas de uso compartido controladas fuera de esta unidad compartida anulen esta restricción.
`restrictions.driveMembersOnly`	`boolean` Indica si el acceso a los elementos 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 esta opción se establece en "true", solo los usuarios con el rol de organizador podrán compartir carpetas. Si es falso, los usuarios con el rol de organizador o con el de organizador de archivos podrán compartir carpetas.
`orgUnitId`	`string` Solo salida. 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
`delete`	Borra de forma permanente una unidad compartida en 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.
`insert`	Crea una nueva unidad compartida.
`list`	Muestra una lista de las unidades compartidas del usuario.
`unhide`	Restablece una unidad compartida a la vista predeterminada.
`update`	Actualiza los metadatos de una unidad compartida.

REST Resource: drives

Recurso: Drive

Métodos

`delete`

`get`

`hide`

`insert`

`list`

`unhide`

`update`