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 Smart Chips können Sie umfangreiche, interaktive Daten aus anderen Google Workspace-Anwendungen direkt in Google Sheets einfügen. Mit Smart Chips haben Nutzer schnellen Zugriff auf Informationen und Aktionen. Ein Zellenlink wird so in ein dynamisches Objekt umgewandelt. Weitere Informationen zum Einfügen von Smartchips in Google Sheets

Smartchip hinzufügen

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

Die Anfrage muss das Feld chipRuns enthalten. Ein Chip-Lauf beschreibt die Eigenschaften eines Chips und seine Position im Text der Zelle.

Wenn Sie chipRuns schreiben, müssen Sie auch ein userEnteredValue angeben, das Platzhalterzeichen (@) für jeden Chip enthält, den Sie hinzufügen möchten. Jede Ausführung im chipRuns-Array entspricht einem der Platzhalter. Läufe ohne Chip können beim Schreiben ausgelassen 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-Attribute konfigurieren

Ein Chip-Objekt kann einen der folgenden Attributtypen haben:

personProperties

Damit können Sie einen Personen-Chip erstellen.

  • email: (Erforderlich) Die E-Mail-Adresse der Person, die verknüpft werden soll.
  • displayFormat: (Optional) Das bevorzugte Anzeigeformat für den Namen der Person. Kann eines der Folgenden sein:
    • DEFAULT: Standardformat „Vorname Nachname“.
    • LAST_NAME_COMMA_FIRST_NAME: Format „Nachname, Vorname“.
    • EMAIL: Die E-Mail-Adresse der Person.

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

  • uri: (Erforderlich) Der URI der Ressource. Für das Schreiben muss es sich um einen Link zu einer Google Drive-Datei handeln. URIs dürfen nicht länger als 2.000 Byte sein.

Smartchip lesen

Verwenden Sie zum Lesen der Daten eines Smartchips die Methode spreadsheets.get und fügen Sie sheets.data.rowData.values(chipRuns) in den Parameter „fields“ ein.

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

  • Abschnitte mit Chipping: Diese Abschnitte enthalten ein ausgefülltes chip-Objekt mit personProperties oder richLinkProperties.
  • Nicht gechippte Läufe: Abschnitte mit Nur-Text haben auch ein Laufobjekt, dessen Feld chip jedoch leer ist.

Wenn Sie den Anzeigetext eines Chips abrufen möchten, fügen Sie formattedValue als Feld hinzu.

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 eine neue userEnteredValue und chipRun an. Dadurch wird der vorhandene Chip in der Zelle ersetzt.

Smartchips mit anderen Google Tabellen-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 darin enthaltenen Smart Chips filtern.