Si usas la versión 2 de la API de Google Drive, la mayor parte del contenido de la Guía de la API de Google Drive v3 también se refiere a la v2. Esta sección contiene toda la información que es específica de la versión 2 y diferente de lo que se muestra en páginas específicas de la guía de la versión 3. Para obtener contexto completo, cada subsección contiene el vínculo a la página de la guía correspondiente.
Para obtener una lista completa de las diferencias, consulta la referencia de comparación de las APIs de Drive v2 y v3.
Cómo descargar y publicar revisiones de archivos
En la página Descargar y publicar revisiones de archivos, la siguiente información es específica de v2 y reemplaza estas secciones que se muestran para v3:
Cómo enumerar y descargar revisiones individuales
Una vez que obtengas una lista de las revisiones de un archivo, puedes descargar su contenido enviando una solicitud GET
autorizada a su propiedad []downloadUrl
](/drive/api/reference/rest/v2/revisions).
Google Drive genera esta URL de corta duración cuando solicitas la revisión.
No confíe en ella para usarla más adelante.
También puedes exportar la revisión en uno de los formatos compatibles si verificas la propiedad exportLinks
.
Propiedades de los archivos personalizados
Además de la información de la página Agregar propiedades de archivos personalizados, la siguiente información es específica de la v2:
Se accede a las propiedades a través del recurso properties
.
Esta es la estructura de una propiedad típica que se podría usar para almacenar el ID de la base de datos de un archivo de Drive en el archivo.
{
'key': 'additionalID',
'value': 'ID',
'visibility': 'PRIVATE'
}
Para obtener más información sobre los límites, consulta properties
en la documentación de referencia.
Habilitar la compatibilidad con unidades compartidas
Además de la información de la página Implementa compatibilidad con unidades compartidas, reemplaza este campo adicional trashedDate
para la versión 2.
En Cómo implementar compatibilidad con unidades compartidas, los siguientes métodos requieren supportsAllDrives=true
cuando se trabaja con contenido de unidades compartidas:
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
Los métodos changes.get
y changes.list
tienen varios parámetros específicos de las unidades compartidas. Para obtener una lista de los parámetros, consulta la sección Realiza un seguimiento de los cambios en una unidad compartida.
Subir archivos
En la página Subir datos de archivos (Upload file data), ten en cuenta que esta información es específica de la versión 2:
Importar a Documentos de Google
Cuando creas un archivo en Google Drive, puedes convertir algunos tipos de archivos en Documentos de Google, Hojas de cálculo de Google o Presentaciones de Google. Incluye los parámetros de consulta files.insert
convert
y configura la propiedad mimeType
(workspace_name) del archivo. Para obtener más información, consulta Sube datos de archivos.
Comparte archivos, carpetas y unidades
Observa que, en la página Comparte archivos, carpetas y unidades, en la v3, solo un campo, role
, especifica roles efectivos para usuario, grupo o dominio. En la v2, necesitas que los campos role
y additionalRoles
de un permiso reflejen las funciones efectivas que tiene un usuario, grupo o dominio para un elemento determinado.
Diferencias en las búsquedas de la versión 2
El campo title
de la versión 2 es name
en la versión 3. Para ver ejemplos, consulta Busca archivos y carpetas.
El campo createdDate
de la versión 2 es createdTime
en la versión 3. Para ver ejemplos, consulta Busca unidades compartidas.
El campo modifiedDate
de la versión 2 es modifiedTime
en la versión 3. El campo lastViewedByMeDate
de la versión 2 es viewedByMeTime
en la versión 3. Para obtener más detalles, consulta Términos y operadores de búsqueda de Google.