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 diferente de lo 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 de la API de Drive v2 y v3.

Descarga y publica revisiones de archivos

En la página Descarga y publica revisiones de archivos , la siguiente información es específica de la v2 y reemplaza estas secciones que se muestran para la v3:

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](/workspace/drive/api/reference/rest/v2/revisions). Google Drive genera esta URL de corta duración cuando solicitas la revisión. No confíes en ella para usarla más adelante.

También puedes exportar la revisión en uno de los formatos compatibles. Para ello, consulta la propiedad exportLinks.

Propiedades de archivos personalizadas

Además de la información de la página Agrega propiedades de archivos personalizadas, la siguiente información es específica de la v2:

Se accede a las propiedades con el properties recurso.

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 por la v2.

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 de las unidades compartidas. Para obtener una lista de 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, ten en cuenta que esta información es específica de la v2:

Importar a tipos de Documentos de Google

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

Comparte archivos, carpetas y unidades

Ten en cuenta que, en la página Comparte archivos, carpetas y unidades , en la v3, solo un campo, role, especifica los roles efectivos para el usuario, el grupo o el dominio. En la v2, necesitas los campos role y additionalRoles de un permiso para reflejar los roles efectivos que el usuario, el grupo o el dominio tienen para un elemento determinado.

Diferencias en las consultas de búsqueda para la v2

El campo title de la v2 es name en la v3. Para ver ejemplos, consulta Busca archivos y carpetas.

El campo createdDate de la v2 es createdTime en la v3. Para ver ejemplos, consulta Busca unidades compartidas.

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