Créer un raccourci vers un fichier Drive

Les raccourcis sont des fichiers qui renvoient à d'autres fichiers ou dossiers dans Google Drive. Les raccourcis ont les caractéristiques suivantes:

  • Un type MIME application/vnd.google-apps.shortcut. Pour en savoir plus, consultez la section Types MIME compatibles avec Google Workspace et Google Drive.

  • La LCA d'un raccourci hérite de celle du parent. La LCA du raccourci ne peut pas être modifiée directement.

  • Un targetId pointant vers le fichier ou le dossier cible, également appelé "cible".

  • targetMimeType indiquant le type MIME de la cible. targetMimeType permet de déterminer l'icône de type à afficher. Le type MIME de la cible est copié dans le champ targetMimeType lors de la création du raccourci.

  • Les champs targetId et targetMimeType font partie du champ shortcutDetails de la ressource file.

  • Un raccourci ne peut avoir qu'un seul parent. Si un fichier de raccourci est nécessaire dans d'autres emplacements Drive, il peut être copié vers les emplacements supplémentaires.

  • Lorsque la cible est supprimée ou lorsque l'utilisateur actuel perd l'accès à celle-ci, le raccourci de l'utilisateur pointant vers la cible ne fonctionne plus.

  • Le titre d'un raccourci peut être différent de celui de la cible. Lorsqu'un raccourci est créé, le titre de la cible est utilisé comme titre du raccourci. Après la création, le titre du raccourci et le titre de la cible peuvent être modifiés indépendamment. Si le nom de la cible est modifié, les raccourcis créés précédemment conservent l'ancien titre.

  • Le type MIME d'un raccourci peut devenir obsolète. Bien que rare, le type MIME d'un fichier blob change lorsqu'une révision d'un autre type est importée. Toutefois, tous les raccourcis pointant vers le fichier mis à jour conservent le type MIME d'origine. Par exemple, si vous importez un fichier JPG dans Drive, puis que vous importez une révision AVI, Drive identifie la modification et met à jour la vignette du fichier. Toutefois, le raccourci continue d'avoir une vignette JPG.

  • Dans l'exportation des données de compte Google, également appelée Google Takeout, les raccourcis sont représentés par des fichiers de favoris Netscape contenant des liens vers la cible.

Pour en savoir plus, consultez Rechercher des fichiers et des dossiers à l'aide des raccourcis Google Drive.

Créer un raccourci

Pour créer un raccourci, définissez le type MIME sur application/vnd.google-apps.shortcut, définissez targetId sur le fichier ou le dossier vers lequel le raccourci doit être associé, puis appelez files.create pour créer un raccourci.

Les exemples suivants montrent comment créer un raccourci à l'aide d'une bibliothèque cliente:

Python

file_metadata = {
    'name': 'FILE_NAME',
    'mimeType': 'text/plain'
}
file = drive_service.files().create(body=file_metadata, fields='id').execute()
print('File ID: %s' % file.get('id'))
shortcut_metadata = {
     'Name': 'SHORTCUT_NAME',
     'mimeType': 'application/vnd.google-apps.shortcut',
     'shortcutDetails': {
        'targetId': file.get('id')
     }
}
shortcut = drive_service.files().create(body=shortcut_metadata,
                                    fields='id,shortcutDetails').execute()
print('File ID: %s, Shortcut Target ID: %s, Shortcut Target MIME type: %s' % (
    shortcut.get('id'),
    shortcut.get('shortcutDetails').get('targetId'),
    shortcut.get('shortcutDetails').get('targetMimeType')))

Node.js

var fileMetadata = {
  'name': 'FILE_NAME',
  'mimeType': 'text/plain'
};
drive.files.create({
  'resource': fileMetadata,
  'fields': 'id'
}, function (err, file) {
  if (err) {
    // Handle error
    console.error(err);
  } else {
    console.log('File Id: ' + file.id);
    shortcutMetadata = {
      'name': 'SHORTCUT_NAME',
      'mimeType': 'application/vnd.google-apps.shortcut'
      'shortcutDetails': {
        'targetId': file.id
      }
    };
    drive.files.create({
      'resource': shortcutMetadata,
      'fields': 'id,name,mimeType,shortcutDetails'
    }, function(err, shortcut) {
      if (err) {
        // Handle error
        console.error(err);
      } else {
        console.log('Shortcut Id: ' + shortcut.id +
                    ', Name: ' + shortcut.name +
                    ', target Id: ' + shortcut.shortcutDetails.targetId +
                    ', target MIME type: ' + shortcut.shortcutDetails.targetMimeType);
      }
    }
  }
});

Remplacez les éléments suivants :

  • FILE_NAME: nom du fichier nécessitant un raccourci.
  • SHORTCUT_NAME: nom de ce raccourci.

Par défaut, le raccourci est créé sur le dossier Mon Drive de l'utilisateur actuel, et les raccourcis ne sont créés que pour les fichiers ou les dossiers auxquels l'utilisateur actuel a accès.

Rechercher un raccourci

Pour rechercher un raccourci, utilisez la chaîne de requête q avec files.list pour filtrer les raccourcis à renvoyer.

mimeType operator values

Où :

  • query_term est le terme ou le champ de requête à rechercher. Pour afficher les termes de requête permettant de filtrer les Drive partagés, consultez la section Termes de requête de recherche.
  • operator spécifie la condition pour le terme de requête. Pour afficher les opérateurs que vous pouvez utiliser avec chaque terme de requête, consultez la section Opérateurs de requête.
  • values sont les valeurs spécifiques que vous souhaitez utiliser pour filtrer vos résultats de recherche.

Par exemple, la chaîne de requête suivante filtre la recherche pour renvoyer tous les raccourcis vers les fichiers de la feuille de calcul:

q: mimeType='application/vnd.google-apps.shortcut' AND shortcutDetails.targetMimeType='application/vnd.google-apps.spreadsheet'