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:
API de Drive v3
files.getfiles.listfiles.createfiles.updatefiles.copyfiles.deletechanges.listchanges.getStartPageTokenpermissions.listpermissions.getpermissions.createpermissions.updatepermissions.delete
API de Drive v2
files.getfiles.listfiles.insertfiles.updatefiles.patchfiles.copyfiles.trashfiles.untrashfiles.deletefiles.touchchildren.insertparents.insertchanges.listchanges.getStartPageTokenchanges.getpermissions.listpermissions.getpermissions.insertpermissions.updatepermissions.patchpermissions.delete
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 establece como falso, 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 sonuser,domain,driveyallDrives. Se prefiereuserodriveoallDrivespara 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.