Guía de la versión 2 de la API de Drive

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.