Membuat pintasan ke file Drive

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

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

  • ACL untuk pintasan mewarisi ACL induk. ACL pintasan tidak dapat diubah secara langsung.

  • targetId yang mengarah ke file atau folder target, 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 boleh 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 akan digunakan sebagai judul pintasan. Setelah dibuat, judul pintasan dan judul target dapat diubah secara terpisah. Jika nama target diubah, pintasan yang dibuat sebelumnya akan mempertahankan judul lama.

  • Jenis MIME pintasan dapat menjadi tidak berlaku. 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 akan terus memiliki thumbnail JPG.

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

Untuk 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 dengan 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 My Drive pengguna saat ini dan pintasan hanya dibuat untuk file atau folder yang aksesnya dimiliki pengguna saat ini.

Menelusuri 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.
  • values adalah nilai spesifik 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'