Membuat pintasan ke file Drive

Pintasan adalah file yang tertaut ke file atau folder lain di Google Drive. Pintasan memiliki karakteristik berikut:

  • Jenis MIME application/vnd.google-apps.shortcut. Untuk informasi selengkapnya, lihat Jenis MIME yang didukung Google Workspace & Google Drive.

  • ACL untuk pintasan mewarisi ACL dari induknya. ACL pintasan tidak dapat diubah secara langsung.

  • targetId yang mengarah ke file atau folder target, yang juga disebut sebagai "target".

  • targetMimeType yang menunjukkan jenis MIME untuk target. targetMimeType digunakan untuk menentukan ikon jenis yang akan ditampilkan. Jenis MIME target akan disalin ke kolom targetMimeType saat pintasan dibuat.

  • Kolom targetId dan targetMimeType adalah bagian dari kolom shortcutDetails dalam resource file.

  • Pintasan hanya dapat memiliki satu induk. Jika file pintasan diperlukan di lokasi Drive lain, file pintasan dapat disalin ke lokasi tambahan.

  • Saat target dihapus, atau saat pengguna saat ini kehilangan akses ke target, pintasan pengguna yang mengarah ke target akan berhenti berfungsi.

  • Judul pintasan dapat berbeda dari target. Saat pintasan dibuat, judul target digunakan sebagai judul pintasan. Setelah pembuatan, judul pintasan dan judul target dapat diubah secara independen. Jika nama target diubah, pintasan yang dibuat sebelumnya akan mempertahankan judul lama.

  • Jenis MIME pintasan bisa menjadi usang. Meskipun jarang terjadi, jenis MIME file blob akan berubah saat revisi jenis yang berbeda diupload, tetapi setiap pintasan yang mengarah ke file yang diperbarui akan mempertahankan jenis MIME aslinya. Misalnya, jika Anda mengupload file JPG ke Drive, lalu mengupload revisi AVI, Drive akan mengidentifikasi perubahan tersebut dan memperbarui thumbnail untuk file yang sebenarnya. Namun, pintasan tersebut tetap memiliki thumbnail JPG.

  • Di Google Account Data Export yang juga dikenal sebagai Google Takeout, pintasan direpresentasikan sebagai file bookmark Netscape yang berisi link ke target.

Untuk mengetahui informasi selengkapnya, lihat Menemukan file & folder dengan pintasan Google Drive .

Buat pintasan

Untuk membuat pintasan, tetapkan jenis MIME ke application/vnd.google-apps.shortcut, tetapkan targetId ke file atau folder yang akan ditautkan oleh pintasan, dan panggil files.create untuk membuat pintasan.

Contoh berikut menunjukkan cara membuat pintasan menggunakan library klien:

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);
      }
    }
  }
});

Ganti kode berikut:

  • FILE_NAME: nama file yang memerlukan pintasan.
  • SHORTCUT_NAME: nama untuk pintasan ini.

Secara default, pintasan dibuat di Drive Saya milik pengguna saat ini dan pintasan hanya dibuat untuk file atau folder yang dapat diakses oleh pengguna saat ini.

Telusuri pintasan

Untuk menelusuri pintasan, gunakan string kueri q dengan files.list untuk memfilter pintasan yang akan ditampilkan.

mimeType operator values

Dengan keterangan:

  • query_term adalah istilah atau kolom kueri yang akan ditelusuri. Untuk melihat istilah kueri yang dapat digunakan untuk memfilter drive bersama, lihat Istilah kueri penelusuran.
  • operator menentukan kondisi untuk istilah kueri. Untuk melihat operator yang dapat Anda gunakan dengan setiap istilah kueri, lihat Operator kueri.
  • nilai adalah nilai tertentu yang ingin Anda gunakan untuk memfilter hasil penelusuran.

Misalnya, string kueri berikut memfilter penelusuran untuk menampilkan semua pintasan ke file spreadsheet:

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