ชิปอัจฉริยะ

คำแนะนำนี้จะอธิบายวิธีและเหตุผลในการใช้ Google ชีต 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 ใหม่ การดำเนินการนี้จะแทนที่ชิปที่มีอยู่ในเซลล์

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

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

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