Les raccourcis sont des fichiers qui renvoient à d'autres fichiers ou dossiers sur Google Drive. Ils 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 types.La LCA d'un raccourci hérite de celle de son parent. Elle ne peut pas être modifiée directement.
Un
targetIdqui pointe vers le fichier ou le dossier cible, également appelé "cible".Un
targetMimeTypequi indique le type MIME de la cible. LetargetMimeTypepermet de déterminer l'icône de type à afficher. Le type MIME de la cible est copié dans le champtargetMimeTypelors de la création du raccourci.Les champs
targetIdettargetMimeTypefont partie du champshortcutDetailsdans la ressource de 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 que l'utilisateur actuel n'y a plus accès, le raccourci de l'utilisateur qui pointe vers la cible est rompu.
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éé, son titre et celui 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 cela soit rare, le type MIME d'un fichier blob change lorsqu'une révision d'un type différent 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 miniature du fichier réel. Toutefois, le raccourci continue d'avoir une miniature JPG.
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 le 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 :
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 Drive de l'utilisateur actuel et 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 est le terme ou le 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.
- operator spécifie la condition appliquée au terme de requête. Pour afficher les opérateurs que vous pouvez utiliser avec chaque terme de requête, consultez 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 des fichiers de feuille de calcul :
q: mimeType='application/vnd.google-apps.shortcut' AND shortcutDetails.targetMimeType='application/vnd.google-apps.spreadsheet'