Las unidades compartidas siguen diferentes modelos de organización, uso compartido y propiedad de Mi unidad. Si tu app creará y administrará archivos en unidades compartidas, debes implementar la compatibilidad con unidades compartidas. La complejidad de la implementación depende de su funcionalidad.
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.get
files.list
files.create
files.update
files.copy
files.delete
changes.list
changes.getStartPageToken
permissions.list
permissions.get
permissions.create
permissions.update
permissions.delete
API de Drive v2
files.get
files.list
files.insert
files.update
files.patch
files.copy
files.trash
files.untrash
files.delete
files.touch
children.insert
parents.insert
changes.list
changes.getStartPageToken
changes.get
permissions.list
permissions.get
permissions.insert
permissions.update
permissions.patch
permissions.delete
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 necesitan buscar en varios corpus requieren funciones adicionales de las unidades compartidas. En el resto de este documento, se destacan los cambios adicionales necesarios para realizar estas tareas.
Busca 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 la unidad compartida en el método files.list
. Para buscar unidades compartidas, consulta Cómo buscar archivos y carpetas.
El método files.list
contiene los siguientes campos específicos de unidades compartidas y modos de consulta:
driveId
: Es el ID de la unidad compartida en la que se realizará la búsqueda.includeItemsFromAllDrives
: Indica si los elementos de la unidad compartida deben incluirse en los resultados. Si no está presente o se establece como falsa, no se muestran los elementos de la unidad compartida.corpora
: Cuerpos de elementos (archivos/documentos) a los que se aplica la consulta. Los cuerpos admitidos sonuser
,domain
,drive
yallDrives
. Prefiereuser
odrive
en lugar deallDrives
para lograr una mayor eficiencia.supportsAllDrives
: Indica si la aplicación solicitante admite Mi unidad y unidades compartidas. 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 |
drive |
Consulta todos los elementos de la unidad compartida especificada. Se debe especificar el driveId en la solicitud. |
true |
allDrives |
Consulta los archivos a los que accedió el usuario y todas las unidades compartidas en las que es miembro. Ten en cuenta que la respuesta puede incluir incompleteSearch : true , lo que indica que no se buscaron algunos contenidos para esta solicitud. |
true |
domain |
Consulta los archivos que se comparten con el dominio, incluidos los archivos de la unidad compartida y de Mi unidad. |
Haz un seguimiento de los cambios de 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 la unidad compartida en el método changes.list
. Para obtener más información, consulta Cómo realizar un seguimiento de los cambios de los usuarios y las unidades compartidas.
El método changes.list
contiene los siguientes campos específicos de unidades compartidas y modos de consulta:
driveId
: Es la unidad compartida desde la que se muestran los cambios. Si se especifican, los IDs de cambio hacen referencia a los cambios dentro de la unidad compartida, no a los cambios en los archivos que se muestran al usuario. Para hacer referencia a un cambio específico de la unidad compartida, se deben usar el ID de la unidad compartida y el ID del cambio como identificador.supportsAllDrives
: Indica si la aplicación solicitante admite unidades compartidas. Si es falso, no se mostrarán los elementos de la unidad compartida, incluidos los archivos y las unidades compartidas.includeItemsFromAllDrives
: Indica si los archivos o los cambios de la unidad compartida deben incluirse 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 en las que es miembro. |
true |
Sí | Los cambios reflejan los cambios realizados en la unidad compartida específica que se especificó y los elementos incluidos en ella. |
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 mediante la IU de Drive, asegúrate de haber marcado la “Compatibilidad con unidades compartidas” en la Consola de API 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 admite la selección de 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 la API de selector de Google.
Próximos pasos
Ve a Administra unidades compartidas y obtén ayuda para crear unidades compartidas y administrar sus permisos.