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 aplica a la v2. En esta sección, se incluye toda la información específica de la v2 y que es diferente de la que se muestra en páginas específicas de la guía de la v3. Para obtener el 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 entre la v2 y la v3 de la API de Drive.

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 la versión 2 y reemplaza estas secciones que se muestran para la versión 3:

Cómo enumerar y descargar revisiones individuales

Una vez que obtengas una lista de las revisiones de un archivo, puedes descargar el contenido de cualquier revisión 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 dependas de él para usarlo más tarde.

También puedes exportar la revisión en uno de los formatos compatibles si verificas la propiedad exportLinks.

Propiedades de archivos personalizadas

Además de la información de 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 con el 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.

Habilita la compatibilidad con unidades compartidas

Además de la información de la página Implementa la compatibilidad con viajes compartidos, 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.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 para las unidades compartidas. Para obtener una lista de los parámetros, consulta la sección Cómo hacer un seguimiento de los cambios en una unidad compartida.

Subir archivos

En la página Sube datos de archivos, observa que esta información es específica de la versión 2:

Tipos de importación a Documentos de Google

Cuando creas un archivo en Google Drive, puedes convertir algunos tipos de archivos en un archivo de Documentos, Hojas de cálculo o Presentaciones de Google. Incluye los parámetros de consulta convert files.insert y establece la propiedad mimeType (workspace_name) del archivo. Para obtener más información, consulta Cómo subir datos de archivos.

Cómo compartir archivos, carpetas y unidades

Ten en cuenta que, en la página Compartir archivos, carpetas y unidades, en la versión 3, solo un campo, role, especifica los roles efectivos para el usuario, el grupo o el dominio. En la versión 2, los campos role y additionalRoles de un permiso deben reflejar los roles efectivos que tiene el usuario, el grupo o el dominio para un elemento determinado.

Diferencias entre las búsquedas de la v2

El campo title de v2 es name en v3. Para ver ejemplos, consulta Cómo buscar archivos y carpetas.

El campo createdDate de v2 es createdTime en v3. Para ver ejemplos, consulta Cómo buscar recorridos compartidos.

El campo modifiedDate de v2 es modifiedTime en v3. El campo lastViewedByMeDate de v2 es viewedByMeTime en v3. Para obtener más información, consulta Términos y operadores de búsqueda.