Implementa la compatibilidad con unidades compartidas

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

Para comenzar, debes incluir el parámetro de consulta supportsAllDrives=true en tus solicitudes cuando la app realice las operaciones que se indican a continuación:

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

Aplicaciones que leen o modifican permisos, realizan un seguimiento de cambios o necesitan la búsqueda en múltiples corpus requiere la funcionalidad adicional de unidades compartidas. El resto de este documento destaca cambios adicionales necesarios para realizar estas tareas.

Cómo buscar contenido en una unidad compartida

Usa el método files.list para buscar unidades compartidas. En esta sección, se abordan los campos específicos de las unidades compartidas del files.list. Para buscar una unidad compartida, consulta Busca archivos y carpetas.

El método files.list contiene los siguientes elementos compartidos campos específicos de la unidad y modos de consulta:

• driveId: Es el ID de la unidad compartida que se buscará.

• includeItemsFromAllDrives: Indica si se deben incluir los elementos de la unidad compartida en los resultados. Si no están presentes o se establecen como falsos, se mostrarán los elementos de la unidad compartida no se devuelven.

• corpora: Cuerpos de elementos (archivos/documentos) para a la que se aplica la consulta. Los cuerpos admitidos son user, domain, drive y allDrives. Se prefiere user o drive o allDrives para mayor eficiencia.

• supportsAllDrives: Especifica si la aplicación solicitante admite en Mi unidad y en unidades compartidas. Si es falso, los elementos de la unidad compartida no se aplicarán incluido 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 archivos a los que accedió el usuario, incluidos los archivos de la unidad compartida y de Mi unidad.
true	drive	Consulta todos los elementos de la unidad compartida especificada. driveId debe especificarse en la solicitud.
true	allDrives	Consulta 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.
true	domain	Consulta archivos que se comparten con el dominio, incluidos los archivos de la unidad compartida y de Mi unidad.

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

Usa el método changes.list para hacer un seguimiento de los cambios en una unidad compartida. En esta sección, se abordan los campos específicos de las unidades compartidas del changes.list. Para obtener más información, consulta Realiza un seguimiento de los cambios de los usuarios y las unidades compartidas. El método changes.list contiene los siguientes elementos compartidos campos específicos de la unidad y modos de consulta:

• driveId: Es la unidad compartida desde la que se muestran cambios. Si especificada, los IDs de cambio hacen referencia a cambios realizados en la unidad compartida, no cambios en los archivos que se muestran al usuario. Cómo hacer referencia a una unidad compartida específica cambio, tanto el ID de la unidad compartida como el ID de cambio se deben usar como identificador.
• supportsAllDrives: Especifica si la aplicación solicitante admite unidades. Si es falso, los elementos de las unidades compartidas, incluidas las unidades compartidas y archivos dentro de una unidad compartida, no se devuelven.
• includeItemsFromAllDrives: Indica si se deben realizar cambios o archivos en la unidad compartida incluido en la lista de cambios.

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 realizados 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 el usuario es miembro.
true	Sí	Los cambios reflejan las modificaciones que se realizaron en la unidad compartida en particular y los elementos que contiene.

Para obtener detalles adicionales sobre el comportamiento del registro de cambios, consulta Registros de cambios.

Habilita la compatibilidad con unidades compartidas en la IU de Drive

Para acceder al contenido de la unidad compartida por medio de la IU de Drive, asegúrate de marcar las "Compatibilidad con unidades compartidas" en la Consola de APIs de Google. Para obtener más información, consulta Configura una integración con la IU de Drive.

Usa el selector de archivos con unidades compartidas

El selector de archivos permite seleccionar elementos en unidades compartidas. Para obtener detalles sobre cómo habilitar la compatibilidad con unidades compartidas y agregar la vista de unidades compartidas En el selector de archivos, consulta API de Google Picker.

Próximos pasos

Continúa a Administra unidades compartidas para ayuda para crear unidades compartidas y administrar sus permisos.