Si vous utilisez la version 2 de l'API Google Drive, la majeure partie du contenu du Guide de l'API Google Drive v3 concerne également la version 2. Cette section contient toutes les informations spécifiques à la version 2 et différentes de celles présentées dans des pages spécifiques du guide de la version 3. Pour obtenir un contexte complet, chaque sous-section contient un lien vers la page de guide correspondante.
Pour obtenir la liste complète des différences, consultez la documentation de référence sur le comparatif des API Drive v2 et v3.
Télécharger et publier les révisions de fichiers
Sur la page Télécharger et publier les révisions de fichiers, les informations suivantes sont spécifiques à la version 2 et remplacent les sections suivantes pour la version 3:
Répertorier 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](/drive/api/reference/rest/v2/revisions).
Google Drive génère cette URL éphémère lorsque vous demandez la révision.
Ne l'utilisez pas pour une utilisation ultérieure.
Vous pouvez également exporter la révision dans l'un des formats acceptés en cochant la propriété exportLinks.
Propriétés de fichier personnalisées
En plus des informations disponibles sur la page Ajouter des propriétés de fichier personnalisées, les informations suivantes sont spécifiques à la version 2:
Vous pouvez accéder aux propriétés à l'aide de la ressource properties.
Il s'agit de la structure d'une propriété classique pouvant être utilisée pour y stocker l'ID de base de données d'un fichier Drive.
{
'key': 'additionalID',
'value': 'ID',
'visibility': 'PRIVATE'
}
Pour en savoir plus sur les limites, consultez la section properties dans la documentation de référence.
Activer la compatibilité avec les Drive partagés
En plus des informations figurant sur la page Implémenter la compatibilité avec les Drive 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 utilisez le 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 Drive partagés. Pour obtenir la liste des paramètres, consultez la section Suivre les modifications sur un Drive partagé.
Importer des fichiers
Sur la page Importer des données de fichier, notez que les informations suivantes sont spécifiques à la version 2:
Importer dans les types Google Docs
Lorsque vous créez un fichier dans Google Drive, vous pouvez convertir certains types de fichiers en documents Google Docs, Google Sheets ou Google Slides. Incluez les paramètres de requête convert files.insert et définissez la propriété (workspace_name) mimeType du fichier. Pour en savoir plus, consultez la section 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, un seul champ, role, dans la version 3, spécifie les rôles effectifs pour l'utilisateur, le groupe ou le domaine. Dans la version 2, les champs role et additionalRoles d'une autorisation doivent refléter les rôles effectifs de l'utilisateur, du groupe ou du domaine pour un élément donné.
Différences entre les requêtes de recherche dans la version 2
Dans la version 2, le champ title est name. Pour obtenir des exemples, consultez la section Rechercher des fichiers et des dossiers.
Dans la version 2, le champ createdDate est createdTime. Pour obtenir des exemples, consultez Rechercher des Drive partagés.
Dans la version 2, le champ modifiedDate est modifiedTime. Dans la version 2, le champ lastViewedByMeDate est viewedByMeTime. Pour en savoir plus, consultez la section Termes de requête et opérateurs de recherche.