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 {i>shortcut<i} mewarisi ACL dari induk. ACL pintasan tidak dapat diubah secara langsung.

  • targetId yang menunjuk 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 dapat memiliki satu induk. Jika file pintasan diperlukan di lokasi Drive lainnya, file pintasan dapat disalin ke lokasi tambahan.

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

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

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

  • Di Ekspor Data Akun Google yang juga dikenal sebagai Google Takeout, pintasan ditampilkan 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 harus 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 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 kueri atau kolom yang bisa 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 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'