Smart chip

Panduan ini menjelaskan cara dan alasan penggunaan Google Sheets API untuk menambahkan dan mengelola smart chip di spreadsheet Anda.

Apa itu smart chip?

Dengan chip smart, Anda dapat memasukkan data interaktif yang kaya dari aplikasi Google Workspace lainnya langsung ke Spreadsheet. Chip smart memberi pengguna akses cepat ke informasi dan tindakan, mengubah link sel menjadi objek dinamis. Untuk mempelajari lebih lanjut, lihat Menyisipkan smart chip di Google Spreadsheet.

Menambahkan smart chip

Chip ditampilkan sebagai chip berjalan, yang merupakan bagian dari CellData, sehingga Anda dapat menyisipkan chip menggunakan metode spreadsheets.batchUpdate yang ada dengan memberikan UpdateCellsRequest atau AppendCellsRequest.

Permintaan harus menyertakan kolom chipRuns. Jalannya chip menjelaskan properti chip dan lokasinya dalam teks sel.

Saat menulis chipRuns, Anda juga harus memberikan userEnteredValue yang berisi karakter placeholder (@) untuk setiap chip yang ingin ditambahkan. Setiap run dalam array chipRuns akan sesuai dengan salah satu placeholder. Run yang tidak memiliki chip dapat dihilangkan saat menulis.

Contoh berikut menunjukkan cara menulis chip file, chip orang, dan teks biasa ke dalam satu sel, A1. * {JSON}

        {
          "updateCells": {
            "rows": [
              {
                "values": [
                  {
                    "userEnteredValue": {
                      "stringValue": "@ is the owner of @."
                    },
                    "chipRuns": [
                      {
                        "chip": {
                          "personProperties": {
                            "email": "johndoe@gmail.com",
                            "displayFormat": "DEFAULT"
                          }
                        }
                      },
                      {
                        "startIndex": 18,
                        "chip": {
                          "richLinkProperties": {
                            "uri": "https://docs.google.com/document/d/YOUR_DOCUMENT_ID/edit"
                          }
                        }
                      }
                    ]
                  }
                ]
              }
            ],
            "fields": "userEnteredValue,chipRuns",
            "range": {
              "startRowIndex": 0,
              "startColumnIndex": 0
            }
          }
        }

Mengonfigurasi properti chip

Objek chip dapat memiliki salah satu jenis properti berikut:

personProperties

Gunakan ini untuk membuat chip orang.

  • email: (Wajib) Alamat email orang yang akan ditautkan.
  • displayFormat: (Opsional) Format tampilan pilihan untuk nama orang. Dapat berupa salah satu dari hal berikut:
    • DEFAULT: Format "Nama Depan Nama Belakang" standar.
    • LAST_NAME_COMMA_FIRST_NAME: Format "Nama Belakang, Nama Depan".
    • EMAIL: Alamat email orang tersebut.

Gunakan ini untuk membuat chip link multimedia. Meskipun API dapat membaca link ke berbagai layanan Google (seperti YouTube atau Kalender), hanya link ke file Google Drive yang dapat ditulis sebagai chip.

  • uri: (Wajib) URI resource. Untuk penulisan, ini harus berupa link file Google Drive. URI tidak boleh melebihi 2000 byte.

Membaca smart chip

Untuk membaca data chip smart, gunakan metode spreadsheets.get dan sertakan sheets.data.rowData.values(chipRuns) dalam parameter kolom.

Array chipRuns dalam respons akan berisi objek untuk semua subbagian teks sel.

  • Eksekusi dengan chip: Bagian ini akan memiliki objek chip yang diisi dan berisi personProperties atau richLinkProperties.
  • Run tanpa chip: Bagian teks biasa juga akan memiliki objek run, tetapi kolom chip-nya akan kosong.

Untuk mendapatkan teks tampilan chip, tambahkan formattedValue sebagai kolom.

Memperbarui smart chip

Untuk memperbarui atau mengganti chip smart, Anda harus menimpa konten sel. Gunakan UpdateCellsRequest atau AppendCellsRequest yang sama seperti saat menambahkan chip, dengan memberikan userEnteredValue dan chipRun baru. Tindakan ini akan menggantikan chip yang ada di sel.

Menggunakan chip smart dengan fitur Spreadsheet lainnya

Tabel: Chip smart dapat digunakan sebagai jenis kolom tabel untuk melacak pemilik project (Chip orang), atau dokumen terkait (Chip file).

Filter: Anda dapat memfilter rentang berdasarkan nilai teks chip smart di dalamnya.