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 pertenece a la versión 2. Esta sección contiene toda la información específica de la versión 2 y de lo que se muestra en las páginas específicas de la guía de la versión 3. Para ver el contexto completo, cada subsección contiene el enlace a la página de la guía correspondiente.
Para obtener una lista completa de las diferencias, consulta la referencia de comparación de la API de Drive v2 y v3.
Descargar y publicar revisiones de archivos
En la página Descargar y publicar revisiones de archivos, la siguiente información es específica de la versión 2 y reemplaza estas secciones que se muestran para la versión 3:
Enumerar y descargar revisiones individuales
Cuando obtengas la lista de las revisiones de un archivo, podrás descargar el contenido de cualquier revisión. Para ello, envía 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íes en él para usarlo más adelante.
También puedes exportar la revisión en uno de los formatos admitidos. Para ello, marca la propiedad exportLinks.
Propiedades personalizadas de los archivos
Además de la información que aparece en la página Agregar propiedades de archivo personalizadas, la siguiente información es específica de la versión 2:
Se accede a las propiedades mediante el recurso properties.
Esta es la estructura de una propiedad típica que podría usarse 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 la compatibilidad con unidades compartidas, reemplaza este campo adicional trashedDate por la versión 2.
En Implementa la compatibilidad con unidades compartidas, los siguientes métodos requieren supportsAllDrives=true cuando se trabaja con contenido de unidades compartidas:
files.getfiles.listfiles.insertfiles.updatefiles.patchfiles.copyfiles.trashfiles.untrashfiles.deletefiles.touchchildren.insertparents.insertchanges.listchanges.getStartPageTokenchanges.getpermissions.listpermissions.getpermissions.insertpermissions.updatepermissions.patchpermissions.delete
Los métodos changes.get y changes.list tienen varios parámetros específicos de las unidades compartidas. Para obtener una lista de parámetros, consulta la sección Cómo realizar un seguimiento de los cambios en una unidad compartida.
Subir archivos
En la página Subir datos de archivos, ten en cuenta que esta información es específica de la versión 2:
Importar a tipos de Documentos de Google
Cuando creas un archivo en Google Drive, puedes convertir algunos tipos de archivo en un documento de Documentos de Google, Hojas de cálculo de Google o Presentaciones de Google. Incluye los parámetros de consulta files.insert convert y establece la propiedad mimeType (workspace_name) del archivo. Si deseas obtener más información, consulta Cómo subir datos de archivos.
Comparte archivos, carpetas y unidades
En la página Compartir archivos, carpetas y unidades, en la v3, solo un campo, role, especifica funciones efectivas para el usuario, el grupo o el dominio. En la versión 2, necesitas que los campos role y additionalRoles de un permiso reflejen las funciones eficaces que tiene el usuario, el grupo o el dominio para un elemento determinado.
Diferencias entre las búsquedas para la v2
El campo title de la versión 2 es name en la versión 3. Para ver ejemplos, consulta Cómo buscar 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.