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:

  • Un type MIME application/vnd.google-apps.shortcut. Pour plus d'informations, consultez la page Google Workspace MIME pris en charge par Google Drive différents types d'appareil.

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

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

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

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

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

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

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

  • Le type MIME d'un raccourci peut devenir obsolète. Bien que rare, la méthode MIME d'un fichier blob modifications de type lorsqu'une révision d'un type différent est importée, mais que les raccourcis pointant vers le fichier mis à jour conservent le type MIME d'origine. Pour Par exemple, si vous importez un fichier JPG dans Drive, AVI, Drive identifie la modification et met à jour pour le fichier en question. Cependant, le fichier JPG est toujours au format JPG miniature.

  • Dans les données du compte Google Exporter également connu sous le nom de Google Takeout, les raccourcis sont représentés par Netscape des fichiers de favoris contenant des liens vers la cible.

Pour en savoir plus, consultez la section Rechercher des fichiers et dossiers avec Google Drive raccourcis pour en savoir plus.

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 le raccourci doit être associé à l'élément et appeler 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 la page My Drive et les raccourcis ne sont créés que pour les fichiers ou les dossiers pour auquel 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 vers retour.

mimeType operator values

Où :

  • query_term est le terme ou le champ de requête à rechercher. Pour afficher la requête permettant de filtrer les Drive partagés, consultez Requête de recherche conditions d'utilisation.
  • operator spécifie la condition du terme de requête. Pour voir quels que vous pouvez utiliser avec chaque terme de requête, consultez Opérateurs de requête.
  • values correspond aux valeurs spécifiques que vous souhaitez utiliser pour filtrer votre recherche. résultats.

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

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