Bu sayfa, Cloud Translation API ile çevrilmiştir.

Akıllı çipler

Bu kılavuzda, e-tablolarınıza akıllı çip eklemek ve bunları yönetmek için Google E-Tablolar API'sinin nasıl ve neden kullanılacağı açıklanmaktadır.

Akıllı çip nedir?

Akıllı çiplerle diğer Google Workspace uygulamalarındaki zengin ve etkileşimli verileri doğrudan E-Tablolar'a aktarabilirsiniz. Akıllı çipler, kullanıcılara bilgilere ve işlemlere hızlı erişim sağlayarak hücre bağlantısını dinamik bir nesneye dönüştürür. Daha fazla bilgi edinmek için Google E-Tablolar dosyanıza akıllı çip ekleme başlıklı makaleyi inceleyin.

Akıllı çip ekleme

Çipler, CellData'nın bir parçası olan çip çalıştırmaları olarak gösterilir. Bu nedenle, UpdateCellsRequest veya AppendCellsRequest sağlayarak mevcut spreadsheets.batchUpdate yöntemini kullanarak çip ekleyebilirsiniz.

İstek, chipRuns alanını içermelidir. Çip çalıştırma, bir çipin özelliklerini ve hücrenin metninde bulunduğu yeri açıklar.

chipRuns yazarken, eklemeyi planladığınız her çip için yer tutucu karakterler (@) içeren bir userEnteredValue de sağlamanız gerekir. chipRuns dizisindeki her çalıştırma, yer tutuculardan birine karşılık gelir. Çipli olmayan koşular yazma sırasında atlanabilir.

Aşağıdaki örnekte, bir dosya çipinin, bir kişi çipinin ve düz metnin tek bir hücreye (A1) nasıl yazılacağı gösterilmektedir. * {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
            }
          }
        }

Çip özelliklerini yapılandırma

Bir çip nesnesi aşağıdaki özellik türlerinden birine sahip olabilir:

personProperties

Bunu kullanarak kişi çipi oluşturun.

email: (Zorunlu) Bağlanılacak kişinin e-posta adresi.
displayFormat: (İsteğe bağlı) Kişinin adı için tercih edilen görüntüleme biçimi. Aşağıdakilerden biri olabilir:
- DEFAULT: Standart "Ad Soyadı" biçimi.
- LAST_NAME_COMMA_FIRST_NAME: "Soyadı, Adı" biçimi.
- EMAIL: Kişinin e-posta adresi.

richLinkProperties

Zengin bağlantı çipi oluşturmak için bunu kullanın. API, çeşitli Google hizmetlerine (ör. YouTube veya Takvim) giden bağlantıları okuyabilse de yalnızca Google Drive dosyalarına giden bağlantılar çip olarak yazılabilir.

uri: (Zorunlu) Kaynağın URI'si. Yazma için bu, bir Google Drive dosyası bağlantısı olmalıdır. URI'ler 2.000 baytı aşamaz.

Akıllı çip okuma

Akıllı çipin verilerini okumak için spreadsheets.get yöntemini kullanın ve alanlar parametresine sheets.data.rowData.values(chipRuns) değerini ekleyin.

Yanıttaki chipRuns dizisi, hücre metninin tüm alt bölümlerine ait nesneleri içerir.

Çipli koşular: Bu bölümlerde personProperties veya richLinkProperties içeren bir chip nesnesi bulunur.
Çiplenmemiş çalıştırmalar: Düz metin bölümlerinde de bir çalıştırma nesnesi bulunur ancak chip alanı boş olur.

Bir çipin görünen metnini almak için formattedValue öğesini alan olarak ekleyin.

Akıllı çip güncelleme

Akıllı çipleri güncellemek veya değiştirmek için hücrenin içeriğini üzerine yazmanız gerekir. Çip eklerken kullandığınız UpdateCellsRequest veya AppendCellsRequest ile aynı şekilde yeni bir userEnteredValue ve chipRun sağlayın. Bu işlem, hücredeki mevcut çipin yerini alır.