Si vous utilisez la version 2 de l'API Google Drive, la plupart du contenu du Guide de l'API Google Drive v3 s'applique également à la version 2. Cette section contient toutes les informations spécifiques à la version 2, qui diffèrent de celles présentées dans les pages spécifiques du guide de la version 3. Pour obtenir le contexte complet, chaque sous-section contient le lien vers la page du guide correspondante.
Pour obtenir la liste complète des différences, consultez le comparatif entre les versions 2 et 3 de l'API Drive.
Télécharger et publier des révisions de fichiers
Sur la page Télécharger et publier les révisions de fichier, les informations suivantes sont spécifiques à la version 2 et remplacent les sections affichées pour la version 3 :
Lister et télécharger des révisions individuelles
Une fois que vous avez obtenu la liste des révisions d'un fichier, vous pouvez télécharger le contenu de n'importe quelle révision en envoyant une requête GET autorisée à sa propriété []downloadUrl](/workspace/drive/api/reference/rest/v2/revisions).
Google Drive génère cette URL éphémère lorsque vous demandez la révision.
Ne comptez pas sur elle pour une utilisation ultérieure.
Vous pouvez également exporter la révision dans l'un des formats compatibles en cochant la propriété exportLinks.
Propriétés de fichier personnalisées
En plus des informations sur la page Ajouter des propriétés de fichier personnalisées, les informations suivantes sont spécifiques à la version 2 :
Les propriétés sont accessibles à l'aide de la ressource properties.
Il s'agit de la structure d'une propriété type qui peut être utilisée pour stocker l'ID de base de données d'un fichier Drive sur le fichier.
{
'key': 'additionalID',
'value': 'ID',
'visibility': 'PRIVATE'
}
Pour en savoir plus sur les limites, consultez properties dans la documentation de référence.
Activer la compatibilité avec les Drive partagés
En plus des informations sur la page Implémenter la prise en charge des lecteurs partagés, remplacez ce champ supplémentaire trashedDate pour la version 2.
Dans Implémenter la compatibilité avec les Drive partagés, les méthodes suivantes nécessitent supportsAllDrives=true lorsque vous travaillez avec du contenu de Drive partagés :
files.getfiles.listfiles.insertfiles.updatefiles.patchfiles.copyfiles.trashfiles.untrashfiles.deletefiles.touchchildren.insertparents.insertchanges.listchanges.getStartPageTokenchanges.getpermissions.listpermissions.getpermissions.insertpermissions.updatepermissions.patchpermissions.delete
Les méthodes changes.get et changes.list comportent plusieurs paramètres spécifiques aux lecteurs partagés. Pour obtenir la liste des paramètres, consultez la section Suivre les modifications d'un Drive partagé.
Importer des fichiers
Sur la page Importer des données de fichiers, notez que ces informations sont spécifiques à la version 2 :
Types d'importation dans Google Docs
Lorsque vous créez un fichier dans Google Drive, vous pouvez convertir certains types de fichiers en document Google Docs, Google Sheets ou Google Slides. Incluez les paramètres de requête files.insert convert et définissez la propriété mimeType (workspace_name) du fichier. Pour en savoir plus, consultez Importer des données de fichier.
Partager des fichiers, des dossiers et des Drive
Sur la page Partager des fichiers, des dossiers et des Drive, notez que dans la version 3, un seul champ, role, spécifie les rôles effectifs pour un utilisateur, un groupe ou un domaine. Dans la version 2, les champs role et additionalRoles d'une autorisation doivent refléter les rôles effectifs dont dispose l'utilisateur, le groupe ou le domaine pour un élément donné.
Différences au niveau des requêtes de recherche pour la version 2
Le champ title de la version 2 est name dans la version 3. Pour obtenir des exemples, consultez Rechercher des fichiers et des dossiers.
Le champ createdDate de la version 2 est createdTime dans la version 3. Pour obtenir des exemples, consultez Rechercher des lecteurs partagés.
Le champ modifiedDate de la version 2 est modifiedTime dans la version 3. Le champ lastViewedByMeDate de la version 2 est viewedByMeTime dans la version 3. Pour en savoir plus, consultez Termes et opérateurs de requête de recherche.