Smart chips

In dieser Anleitung wird beschrieben, wie und warum Sie die Google Sheets API verwenden, um Smartchips in Ihre Tabellen einzufügen und zu verwalten.

Was ist ein Smartchip?

Mit Smartchips können Sie umfangreiche, interaktive Daten aus anderen Google Workspace-Anwendungen direkt in Google Sheets einfügen. Smartchips bieten Nutzern schnellen Zugriff auf Informationen und Aktionen und verwandeln einen Zellenlink in ein dynamisches Objekt. Weitere Informationen finden Sie unter Smartchips in Google Sheets.

Smartchip hinzufügen

Chips werden als Chip-Ausführungen dargestellt, die Teil von CellData sind. Sie können also einen Chip mit der vorhandenen Methode spreadsheets.batchUpdate einfügen, indem Sie eine UpdateCellsRequest oder AppendCellsRequest angeben.

Die Anfrage muss das Feld chipRuns enthalten. Eine Chip-Ausführung beschreibt die Eigenschaften eines Chips und seine Position im Text der Zelle.

Wenn Sie chipRuns schreiben, müssen Sie auch einen userEnteredValue angeben, der Platzhalterzeichen (@) für jeden Chip enthält, den Sie hinzufügen möchten. Jede Ausführung im Array chipRuns entspricht einem der Platzhalter. Nicht mit Chips versehene Ausführungen können beim Schreiben weggelassen werden.

Im folgenden Beispiel wird gezeigt, wie ein Datei-Chip, ein Personen-Chip und Nur-Text in eine einzelne Zelle (A1) geschrieben werden. * {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
            }
          }
        }

Chip-Eigenschaften konfigurieren

Ein Chip-Objekt kann einen der folgenden Eigenschaftstypen haben:

personProperties

Hiermit erstellen Sie einen Personen-Chip.

  • email: (Erforderlich) Die E-Mail-Adresse der Person, mit der eine Verknüpfung erstellt werden soll.
  • displayFormat: (Optional) Das bevorzugte Anzeigeformat für den Namen der Person. Mögliche Werte:
    • DEFAULT: Standardformat „Vorname Nachname“.
    • LAST_NAME_COMMA_FIRST_NAME: Format „Nachname, Vorname“.
    • EMAIL: Die E-Mail-Adresse der Person.

Hiermit erstellen Sie einen Rich-Link-Chip. Die API kann zwar Links zu verschiedenen Google-Diensten (z. B. YouTube oder Google Kalender) lesen, aber nur Links zu Google Drive-Dateien können als Chips geschrieben werden.

  • uri: (Erforderlich) Der URI der Ressource. Beim Schreiben muss dies ein Link zu einer Google Drive-Datei sein. URIs dürfen nicht mehr als 2.000 Byte umfassen.

Smartchip lesen

Verwenden Sie die spreadsheets.get-Methode, um die Daten eines Smartchips zu lesen, und fügen Sie sheets.data.rowData.values(chipRuns) im Parameter „fields“ ein.

Das Array chipRuns in der Antwort enthält Objekte für alle Unterabschnitte des Zellentexts.

  • Mit Chips versehene Ausführungen: Diese Abschnitte haben ein ausgefülltes chip-Objekt, das entweder personProperties oder richLinkProperties enthält.
  • Nicht mit Chips versehene Ausführungen: Abschnitte mit Nur-Text haben auch ein Ausführungsobjekt, aber das Feld chip ist leer.

Fügen Sie formattedValue als Feld hinzu, um den Anzeigetext eines Chips abzurufen.

Smartchip aktualisieren

Wenn Sie einen Smartchip aktualisieren oder ersetzen möchten, müssen Sie den Inhalt der Zelle überschreiben. Verwenden Sie dieselbe UpdateCellsRequest oder AppendCellsRequest wie beim Hinzufügen eines Chips und geben Sie einen neuen userEnteredValue und chipRun an. Dadurch wird der vorhandene Chip in der Zelle ersetzt.

Smartchips mit anderen Sheets-Funktionen verwenden

Tabellen: Smartchips können als Tabellenspaltentyp verwendet werden, um Projektinhaber (Personen-Chip) oder zugehörige Dokumente (Datei-Chip) zu verfolgen.

Filter: Sie können Bereiche nach dem Textwert der Smartchips darin filtern.