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 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.

• Jika target dihapus, atau jika pengguna saat ini kehilangan akses ke target, pintasan pengguna yang mengarah ke target akan rusak.

• Judul pintasan dapat berbeda dari target. Saat pintasan dibuat, judul target 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 valid. Meskipun jarang terjadi, jenis MIME file blob berubah saat revisi jenis lain diupload, tetapi pintasan yang mengarah ke file yang diperbarui mempertahankan jenis MIME asli. Misalnya, jika Anda mengupload file JPG ke Drive, lalu mengupload revisi AVI, Drive akan mengidentifikasi perubahan dan memperbarui thumbnail untuk file sebenarnya. Namun, pintasan tersebut tetap memiliki thumbnail JPG.

• Di Ekspor Data Akun Google 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 harus ditautkan oleh pintasan, dan panggil files.create untuk membuat pintasan.

Contoh berikut menunjukkan cara membuat pintasan menggunakan library klien:

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

Ganti kode berikut:

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

Secara default, pintasan dibuat di Drive Saya pengguna saat ini dan pintasan hanya dibuat untuk file atau folder yang dapat diakses oleh 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:

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