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 versión 2, que es diferente de la que se muestra en las páginas específicas de la guía de la versión 3. 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 comparativa entre las versiones 2 y 3 de la API de Drive.

Cómo descargar y publicar revisiones de archivos

En la página Descarga y publica 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, podrás descargar el contenido de cualquier revisión enviando una solicitud GET autorizada a su propiedad []downloadUrl](/workspace/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 adelante.

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 que se encuentra en la página Cómo 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 unidades compartidas, reemplaza este campo adicional trashedDate para la versión 2.

En Implement shared drive support, 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 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 documento de Documentos, Hojas de cálculo o Presentaciones de Google. Incluye los parámetros de consulta files.insert convert y establece la propiedad (workspace_name) mimeType del archivo. Para 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 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 el usuario, el grupo o el dominio tienen para un elemento determinado.

Diferencias en las búsquedas para la versión 2

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 Cómo buscar 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.