Créer un raccourci vers un fichier Drive

Les raccourcis sont des fichiers qui renvoient vers d'autres fichiers ou dossiers sur 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 la LCA du parent. Il n'est pas possible de modifier directement la LCA du raccourci.

• 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 lorsque le raccourci est créé.

• 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 requis dans d'autres emplacements Drive, il peut être copié dans ces emplacements supplémentaires.

• Lorsque la cible est supprimée ou que l'utilisateur actuel perd l'accès à la cible, 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. 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 cela soit 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 une révision AVI, Drive identifie la modification et met à jour la miniature du fichier. Toutefois, le raccourci continue d'avoir une miniature JPG.

• Dans l'exportation des données de votre compte Google, également appelée Google Takeout, les raccourcis sont représentés sous forme de 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.

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 pointer, 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 :

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')))

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. Les raccourcis ne sont créés que pour les fichiers ou 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 correspond au terme ou au champ de requête sur lequel effectuer la recherche. Pour afficher les termes de requête qui peuvent être utilisés pour filtrer les Drive partagés, consultez Termes de requête de recherche.
• L'opérateur spécifie la condition du terme de requête. Pour savoir quels opérateurs vous pouvez utiliser avec chaque terme de requête, consultez 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'