Créer un raccourci vers un fichier Drive

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

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

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

• 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 fichier.

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

• Lorsque la cible est supprimée ou lorsque l'utilisateur actuel perd l'accès à la cible, le raccourci de l'utilisateur pointant vers la cible est interrompu.

• Le titre d'un raccourci peut être différent de la cible. Lorsqu'un raccourci est créé, le titre de la cible est utilisé comme titre du raccourci. Une fois le raccourci créé, vous pouvez modifier le titre du raccourci et celui de la cible 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, mais 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 une révision AVI, Drive identifie la modification et met à jour la vignette du fichier réel. Toutefois, le raccourci conserve une vignette JPG.

• Dans l'exportation des données du 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 grâce aux raccourcis Google Drive.

Important :Auparavant, le terme "raccourci" désignait les fichiers qui pointaient vers du contenu stocké par une application. Ce type de "raccourci" a été renommé raccourci tiers. Pour en savoir plus, consultez Créer un fichier de raccourci vers le contenu stocké par votre application.

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 auquel le raccourci doit être associé, puis appelez files.create pour créer un raccourci.

Remarque :Si vous utilisez la version 2 de l'API, utilisez files.insert.

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éé dans 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 à afficher.

mimeType operator values

Où :

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

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

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