Guide de l'API Drive v2

Si vous utilisez la version 2 de l'API Google Drive, la majeure partie 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 et différentes de celles affichées sur 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 la section Comparatif des API Drive v2 et v3 reference.

Télécharger et publier des révisions de fichiers

Sur la page Télécharger et publier des révisions de fichiers page, 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 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 properties ressource.

Voici la structure d'une propriété typique 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 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 du contenu de 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 Drive partagés. Pour obtenir la liste des paramètres, consultez la section Suivre les modifications dans un Drive partagé.

Importer des fichiers

Sur la page Importer des données de fichier, notez que ces informations sont spécifiques à la version 2 :

Importer des types de documents 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 files.insert convert paramètres de requête 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

Notez que sur la page Partager des fichiers, des dossiers et des Drive , un seul champ, role, spécifie les rôles effectifs pour un utilisateur, un groupe ou un domaine dans la version 3. Dans la version 2, vous avez besoin des champs role et additionalRoles d'une autorisation pour refléter les rôles effectifs dont l'utilisateur, le groupe ou le domaine disposent pour un élément donné.

Différences entre les 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 Drive 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.