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.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 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.