Si vous utilisez la version 2 de l'API Google Drive, la plupart 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, qui diffèrent de celles figurant sur des pages spécifiques du guide de la version 3. Pour obtenir le contexte complet, chaque sous-section contient un lien vers la page du guide correspondante.
Pour obtenir la liste complète des différences, consultez la documentation de référence de comparaison 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 fichiers, 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
](/drive/api/reference/rest/v2/revisions).
Google Drive génère cette URL éphémère lorsque vous demandez la révision.
Ne vous appuyez pas dessus pour une utilisation ultérieure.
Vous pouvez également exporter la révision dans l'un des formats compatibles en vérifiant la propriété exportLinks
.
Propriétés de fichier personnalisées
En plus des informations de 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 dans 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 de la page Implémenter la prise en charge de Drive partagé, remplacez ce champ supplémentaire trashedDate
par la version 2.
Dans Implémenter la prise en charge des Drive partagés, les méthodes suivantes nécessitent supportsAllDrives=true
lorsque vous travaillez avec le contenu des Drive partagés:
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
Les méthodes changes.get
et changes.list
comportent plusieurs paramètres spécifiques aux disques 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 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 documents Google Docs, Google Sheets ou Google Slides. Incluez les paramètres de requête convert
files.insert
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
Remarque : Sur la page Partager des fichiers, des dossiers et des Drive, dans la version 3, un seul champ, role
, 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 pour la version v2
Le champ title
de la version 2 est name
dans la version 3. Pour en savoir plus, 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 trajets 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.