Implementa la compatibilidad con unidades compartidas

Las unidades compartidas siguen diferentes modelos de organización, uso compartido y propiedad que Mi unidad. Si tu app creará y administrará archivos en unidades compartidas, debes implementar la compatibilidad con unidades compartidas en ella. La complejidad de la implementación depende de la funcionalidad de la app.

Para comenzar, debes incluir el parámetro de consulta supportsAllDrives=true en tus solicitudes cuando tu app realice las siguientes operaciones:

El parámetro supportsAllDrives=true informa a Google Drive que tu aplicación está diseñada para controlar archivos en unidades compartidas.

Las aplicaciones que leen o modifican permisos, hacen un seguimiento de los cambios o realizan búsquedas en varios corpus requieren capacidades adicionales de unidades compartidas. En el resto de este documento, se destacan los cambios adicionales necesarios para realizar estas tareas.

Cómo buscar contenido en una unidad compartida

Usa el list método en el files recurso para encontrar archivos de usuario en unidades compartidas. Para buscar una unidad compartida, consulta Cómo buscar unidades compartidas.

El método list contiene los siguientes parámetros de consulta específicos de la unidad compartida:

• driveId: Es el ID de la unidad compartida en la que se realizará la búsqueda.

• corpora: Son los cuerpos de los elementos (archivos o documentos) a los que se aplica la consulta. Los cuerpos admitidos son user, domain, drive y allDrives. Para obtener eficiencia, prefiere user o drive en lugar de allDrives. De forma predeterminada, el cuerpo se establece en user.

• includeItemsFromAllDrives: Indica si los elementos de Mi unidad y de la unidad compartida deben incluirse en los resultados. Si no está presente o se establece como falso, no se muestran los elementos de la unidad compartida.

• supportsAllDrives: Indica si la aplicación solicitante admite Mi unidad y la unidad compartida. Si es falso, los elementos de la unidad compartida no se incluyen en la respuesta.

Los siguientes modos de consulta son específicos de las unidades compartidas:

includeItemsFromAllDrives	corpora	Descripción de la consulta
true	user	Consulta los archivos a los que accedió el usuario, incluidos los archivos de la unidad compartida y de Mi unidad.
true	domain	Consulta los archivos que se comparten con el dominio, incluidos los archivos de la unidad compartida y de Mi unidad.
true	drive	Consulta todos los elementos de la unidad compartida especificada. El driveId debe especificarse en la solicitud.
true	allDrives	Consulta los archivos a los que accedió el usuario y todas las unidades compartidas de las que es miembro. Ten en cuenta que la respuesta puede incluir incompleteSearch:true, lo que indica que no se buscaron algunos corpus para esta solicitud.

Cómo hacer un seguimiento de los cambios en una unidad compartida

Usa el list método en el changes recurso para hacer un seguimiento de los cambios en una unidad compartida. Para obtener más información, consulta Cómo hacer un seguimiento de los cambios para usuarios y unidades compartidas.

El método list contiene los siguientes parámetros de consulta específicos de la unidad compartida:

• driveId: Es la unidad compartida de la que se muestran los cambios. Si se especifica, los IDs de cambio hacen referencia a los cambios en los elementos dentro de la unidad compartida que proporciona el estado actual de un archivo. Para hacer referencia a un cambio específico de la unidad compartida, se deben usar el ID de la unidad compartida y el ID de cambio como identificador.

• includeItemsFromAllDrives: Indica si los archivos o los cambios de la unidad compartida deben incluirse en la lista de cambios.

• supportsAllDrives: Indica si la aplicación solicitante admite unidades compartidas. Si es falso, no se muestran los elementos de la unidad compartida, incluidas las unidades compartidas y los archivos dentro de una unidad compartida.

Los siguientes modos de consulta son específicos de las unidades compartidas:

includeItemsFromAllDrives	driveId	Descripción de la consulta
true	No	Los cambios reflejan los cambios en los archivos dentro o fuera de las unidades compartidas a las que accedió el usuario, así como los cambios en las unidades compartidas de las que es miembro.
true	Sí	Los cambios reflejan los cambios en la unidad compartida específica que se especificó y los elementos dentro de esa unidad compartida.

Para obtener más detalles sobre el comportamiento del registro de cambios, consulta Cómo hacer un seguimiento de los cambios para usuarios y unidades compartidas.

Cómo habilitar la compatibilidad con unidades compartidas en la IU de Drive

Para acceder al contenido de la unidad compartida con la IU de Drive, asegúrate de que has marcado la casilla Compatibilidad con unidades compartidas en la pestaña Integración de la IU de Drive de la API de Google Drive en la consola de Google Cloud. Para obtener más información, consulta Cómo configurar una integración de la IU de Drive.

Cómo usar Google Picker con unidades compartidas

El Google Picker admite la selección de elementos en unidades compartidas. Para obtener detalles sobre cómo habilitar la compatibilidad con unidades compartidas y agregar vistas de unidades compartidas en el selector, consulta la API de Google Picker.

Temas relacionados

• Administra unidades compartidas