Smart chip

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

Apa yang dimaksud dengan chip cerdas?

Dengan smart chip, Anda dapat menghadirkan data interaktif yang lengkap dari aplikasi Google Workspace lainnya langsung ke Spreadsheet. Smart chip 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 chip cerdas

Chip direpresentasikan sebagai chip run, yang merupakan bagian dari CellData, sehingga Anda dapat menyisipkan chip menggunakan metode spreadsheets.batchUpdate yang ada dengan menyediakan UpdateCellsRequest atau AppendCellsRequest.

Permintaan harus menyertakan kolom chipRuns. Chip run 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 Anda tambahkan. Setiap run dalam array chipRuns akan sesuai dengan salah satu placeholder. Run yang tidak di-chip dapat dihilangkan saat penulisan.

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 standar "Nama Depan Nama Belakang".
    • LAST_NAME_COMMA_FIRST_NAME: Format "Nama Belakang, Nama Depan".
    • EMAIL: Alamat email orang.

Gunakan ini untuk membuat chip link lengkap. 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 2.000 byte.

Membaca smart chip

Untuk membaca data smart chip, 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.

  • Run yang di-chip: Bagian ini akan memiliki objek chip yang diisi dan berisi personProperties atau richLinkProperties.
  • Run yang tidak di-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 chip cerdas

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

Menggunakan smart chip dengan fitur Spreadsheet lainnya

Tabel: Smart chip dapat digunakan sebagai jenis kolom tabel untuk melacak pemilik proyek (chip Orang), atau dokumen terkait (chip File).

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