Membuat antarmuka Google Drive

Add-on Google Workspace dapat memberikan saat pengguna menggunakan Google Drive. Hal ini memungkinkan Anda memberi pengguna dengan informasi tambahan yang relevan, mengotomatiskan tugas, dan menghubungkan ke Google Drive.

Mengakses UI add-on

Anda dapat membuka Add-on Google Workspace di Google Drive jika ikonnya muncul di kolom ikon di sisi kanan antarmuka pengguna Drive. J Add-on Google Workspace dapat mendefinisikan antarmuka beranda, antarmuka pemilihan item, atau keduanya:

  • Jika pengguna mengeklik ikon {i>add-on<i} saat berada di Google Drive, add-on dijalankan drive.homepageTrigger yang sesuai {i>function<i} (jika ada). Fungsi ini membangun dan mengembalikan kartu halaman beranda ke Google Drive untuk ditampilkan. Jika tidak drive.homepageTrigger ditentukan, kartu halaman beranda generik akan ditampilkan.
  • Jika pengguna memilih satu atau beberapa item di Google Drive, lalu mengklik add-on ikon baru, atau memilih item saat add-on terbuka, add-on akan mengeksekusi drive.onItemsSelectedTrigger fungsi kontekstual (jika ada). Fungsi ini membuat Google Drive add-on "item dipilih" kontekstual antarmuka dan mengembalikannya ke Google Drive untuk ditampilkan.

Membuat antarmuka Drive add-on

Anda dapat membuat antarmuka yang memperluas Google Drive dengan mengikuti langkah:

  1. Tentukan apakah Anda ingin add-on memiliki akses khusus ke Drive halaman beranda Anda. Tentukan juga apakah Anda ingin menyediakan antarmuka kontekstual untuk saat pengguna memilih item Drive.
  2. Tambahkan atribut addOns.common dan addOns.drive kolom ke project skrip add-on manifes, termasuk semua cakupan Drive yang diperlukan.
  3. Jika Anda menyediakan halaman beranda khusus Drive, menerapkan drive.homepageTrigger fungsi untuk membangun antarmuka ini. Anda juga dapat memilih untuk menggunakan common.homepageTrigger untuk beberapa host Google Workspace.
  4. Jika menyediakan antarmuka pemilihan item kontekstual Drive, Anda harus mengimplementasikan drive.onItemsSelectedTrigger fungsi pemicu kontekstual untuk membangun antarmuka ini. Lihat Antarmuka kontekstual Drive untuk item yang dipilih) untuk mengetahui detailnya.
  5. Implementasikan fungsi callback terkait yang diperlukan untuk merespons permintaan pengguna Interaksi UI, seperti klik tombol.

Halaman beranda Drive

Google Drive mendukung penayangan Add-on Google Workspace halaman beranda. Untuk menampilkan halaman beranda umum add-on di Google Drive, cukup pastikan Anda melakukannya adalah kolom addOns.drive dalam manifes add-on.

Atau, tambahkan drive.homepageTrigger ke manifes add-on untuk menyediakan halaman beranda khusus Drive.

Dalam kedua kasus tersebut, Anda harus memberikan nama fungsi pemicu halaman beranda di project skrip add-on Anda. Fungsi ini otomatis dipanggil untuk membuat Halaman beranda Drive saat diperlukan. Anda harus mengimplementasikan fungsi ini untuk membangun dan tampilkan satu Card atau array Card berbagai objek yang membentuk beranda. Fungsi pemicu halaman beranda diberi objek peristiwa parameter yang berisi beberapa informasi umum seperti terkelola sepenuhnya. Anda dapat menggunakan data objek peristiwa untuk menyesuaikan konstruksi {i>homepage<i}.

Antarmuka kontekstual Drive untuk item yang dipilih

Google Drive mengandalkan pemicu kontekstual untuk menentukan antarmuka (jika ada) yang ditampilkan saat pengguna memilih satu atau beberapa item Google Drive. Jika pemicu diaktifkan, fungsi ini menjalankan fungsi pemicu kontekstual yang ditentukan oleh drive.onItemsSelectedTrigger.runFunction di manifes add-on.

Guna membuat antarmuka pemilihan item kontekstual untuk Drive, Anda harus melakukan berikut ini:

  1. Pastikan manifes add-on menyertakan https://www.googleapis.com/auth/drive.addons.metadata.readonly cakupan

  2. Pastikan manifes menyertakan drive.onItemsSelectedTrigger bagian.

  3. Implementasikan fungsi yang dinamai dalam drive.onItemsSelectedTrigger kolom tersebut. Fungsi ini menerima objek peristiwa sebagai argumen dan harus mengembalikan salah satu Objek Card atau array Objek Card.

  4. Seperti halnya kartu mana pun, Anda harus mengimplementasikan fungsi callback yang digunakan untuk menyediakan interaktivitas widget untuk antarmuka. Misalnya, jika Anda menyertakan tombol di antarmuka, harus ada lampiran Tindakan dan fungsi callback yang diimplementasikan yang berjalan saat tombol diklik.

Objek peristiwa

Objek peristiwa dibuat dan diteruskan ke drive.homepageTrigger atau drive.onItemsSelectedTrigger memicu fungsi ketika fungsi tersebut dipanggil. Fungsi pemicu dapat menggunakan informasi dalam objek peristiwa ini untuk menentukan cara membuat kartu add-on atau mengontrol perilaku add-on.

Struktur lengkap objek peristiwa dijelaskan dalam Objek peristiwa. Jika Drive adalah aplikasi host yang bertindak untuk add-on, objek peristiwa kontekstual sertakan Objek peristiwa Drive yang membawa informasi klien khusus Drive.

Objek peristiwa Drive kontekstual untuk pemicu pemilihan item menyertakan informasi tentang item yang telah dipilih pengguna saat pemicu diaktifkan. Saat pengguna memilih lebih dari satu item di Drive, salah satu item dianggap sebagai salah satu kepentingan utama; item ini disebut sebagai item kursor aktif.

Contoh berikut menunjukkan Objek peristiwa Drive yang diteruskan ke drive.onItemsSelectedTrigger {i>function<i}:

    {
      "commonEventObject": { ... },
      "drive": {
        "activeCursorItem":{
          "addonHasFileScopePermission": true,
          "id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
          "iconUrl": "https://drive-thirdparty.googleusercontent.com...",
          "mimeType":"application/pdf",
          "title":"How to get started with Drive"
        },
        "selectedItems": [
          {
            "addonHasFileScopePermission": true,
            "id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
            "iconUrl":"https://drive-thirdparty.googleusercontent.com...",
            "mimeType":"application/pdf",
            "title":"How to get started with Drive"
          },
          ...
        ]
      },
      ...
    }