ชิปอัจฉริยะ

คู่มือนี้อธิบายวิธีและเหตุผลในการใช้ Google Sheets API เพื่อเพิ่มและจัดการชิปอัจฉริยะในสเปรดชีต

ชิปอัจฉริยะคืออะไร

ชิปอัจฉริยะช่วยให้คุณนำข้อมูลแบบอินเทอร์แอกทีฟที่สมบูรณ์จากแอปพลิเคชันอื่นๆ ของ Google Workspace มายังชีตได้โดยตรง ชิปอัจฉริยะช่วยให้ผู้ใช้เข้าถึงข้อมูลและการดำเนินการได้อย่างรวดเร็ว โดยจะเปลี่ยนลิงก์ของเซลล์ให้เป็นออบเจ็กต์แบบไดนามิก ดูข้อมูลเพิ่มเติมได้ที่แทรกชิปอัจฉริยะใน Google ชีต

เพิ่มชิปอัจฉริยะ

ชิปจะแสดงเป็นชิปรัน ซึ่งเป็นส่วนหนึ่งของ CellData คุณจึงสามารถแทรกชิปโดยใช้วิธี spreadsheets.batchUpdate ที่มีอยู่ได้โดยระบุ UpdateCellsRequest หรือ AppendCellsRequest

คำขอต้องมีช่อง chipRuns การเรียกใช้ชิปจะอธิบายพร็อพเพอร์ตี้ของชิปและตำแหน่งของชิปภายในข้อความของเซลล์

เมื่อเขียน chipRuns คุณต้องระบุ userEnteredValue ที่มีอักขระตัวยึดตำแหน่ง (@) สำหรับชิปแต่ละตัวที่ต้องการเพิ่มด้วย การเรียกใช้แต่ละครั้งในอาร์เรย์ chipRuns จะสอดคล้องกับตัวยึดตำแหน่งตัวใดตัวหนึ่ง การวิ่งที่ไม่ได้ติดชิปสามารถละเว้นได้เมื่อเขียน

ตัวอย่างต่อไปนี้แสดงวิธีเขียนชิปไฟล์ ชิปบุคคล และข้อความธรรมดาลงในเซลล์เดียวคือ 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
            }
          }
        }

กำหนดค่าพร็อพเพอร์ตี้ของชิป

ออบเจ็กต์ชิปอาจมีพร็อพเพอร์ตี้ประเภทใดประเภทหนึ่งต่อไปนี้

personProperties

ใช้เพื่อสร้างชิปบุคคล

  • email: (ต้องระบุ) อีเมลของบุคคลที่จะลิงก์
  • displayFormat: (ไม่บังคับ) รูปแบบการแสดงชื่อบุคคลที่ต้องการ อาจมีสถานะใดสถานะหนึ่งดังต่อไปนี้
    • DEFAULT: รูปแบบ "ชื่อ นามสกุล" มาตรฐาน
    • LAST_NAME_COMMA_FIRST_NAME: รูปแบบ "นามสกุล ชื่อ"
    • EMAIL: อีเมลของบุคคล

ใช้เพื่อสร้างชิปลิงก์สมบูรณ์ แม้ว่า API จะอ่านลิงก์ไปยังบริการต่างๆ ของ Google (เช่น YouTube หรือปฏิทิน) ได้ แต่จะเขียนลิงก์ไปยังไฟล์ใน Google ไดรฟ์เป็นชิปได้เท่านั้น

  • uri: (ต้องระบุ) URI ของทรัพยากร สำหรับการเขียน ลิงก์นี้ต้องเป็นลิงก์ไฟล์ใน Google ไดรฟ์ URI ต้องมีขนาดไม่เกิน 2,000 ไบต์

อ่านชิปอัจฉริยะ

หากต้องการอ่านข้อมูลของชิปอัจฉริยะ ให้ใช้เมธอด spreadsheets.get และรวม sheets.data.rowData.values(chipRuns) ไว้ในพารามิเตอร์ฟิลด์

chipRuns อาร์เรย์ในการตอบกลับจะมีออบเจ็กต์สำหรับส่วนย่อยทั้งหมดของข้อความในเซลล์

  • การวิ่งที่มีการบันทึกข้อมูล: ส่วนเหล่านี้จะมีออบเจ็กต์ chip ที่มีข้อมูลซึ่งมี personProperties หรือ richLinkProperties
  • การเรียกใช้ที่ไม่มีชิป: ส่วนข้อความธรรมดาก็จะมีออบเจ็กต์การเรียกใช้ด้วย แต่ฟิลด์ chip จะว่างเปล่า

หากต้องการรับข้อความที่แสดงของชิป ให้เพิ่ม formattedValue เป็นฟิลด์

อัปเดตชิปอัจฉริยะ

หากต้องการอัปเดตหรือแทนที่ชิปอัจฉริยะ คุณต้องเขียนทับเนื้อหาของเซลล์ ใช้ UpdateCellsRequest หรือ AppendCellsRequest เดียวกันกับที่ใช้ในการเพิ่มชิป โดยระบุ userEnteredValue และ chipRun ใหม่ การดำเนินการนี้จะแทนที่ชิปที่มีอยู่ในเซลล์

ใช้ชิปอัจฉริยะกับฟีเจอร์อื่นๆ ของชีต

ตาราง: คุณใช้ชิปอัจฉริยะเป็นประเภทคอลัมน์ตารางเพื่อติดตามเจ้าของโปรเจ็กต์ (ชิปบุคคล) หรือเอกสารที่เกี่ยวข้อง (ชิปไฟล์) ได้

ตัวกรอง: คุณกรองช่วงตามค่าข้อความของชิปอัจฉริยะภายในช่วงได้