Tablolar

Bu kılavuzda, e-tablolarınızda tablo oluşturmak için Google Sheets API'nin nasıl ve neden kullanılacağı açıklanmaktadır.

Tablo nedir?

Tablolarla, veri aralıklarına otomatik olarak biçim ve yapı uygulayarak veri oluşturmayı basitleştirebilir ve verileri tekrar tekrar biçimlendirme, girme ve güncelleme ihtiyacını azaltabilirsiniz.

Tablolarda üstbilgiler, altbilgiler, sütun türleri, filtreler, görünümler, tablo referansları ve tablo adları gibi birçok özellik bulunur. Daha fazla bilgi için özellik duyurusunu inceleyin ve E-Tablolar'da tabloları kullanma hakkında bilgi edinin.

Proje takibi, etkinlik planlama ve envanter yönetimi gibi görevler için tabloları kullanabilirsiniz.

Tablo ekleyin

Tablo eklemek için batchUpdate yöntemini kullanın ve addTable isteği gönderin. Bu isteği, e-tabloya tablo eklemek için kullanırsınız.

Aşağıdaki örnekte, belirtilen range konumunda "Proje İzleyici" adlı bir tablo oluşturulur ve bu tabloda 2 ayarlanmış sütun bulunur. İlk sütunda yüzde sütunu, ikinci sütunda ise açılır liste sütunu türü.

{
  "addTable": {
    "table": {
      "name": "Project Tracker",
      "tableId": "123",
      "range": {
        "sheetId": 0,
        "startColumnIndex": 0,
        "endColumnIndex": 5,
        "startRowIndex": 0,
        "endRowIndex": 5,
      },
      "columnProperties": [
        {
          "columnIndex": 0,
          "columnName": "Column 1",
          "columnType": "PERCENT"
        },
        {
          "columnIndex": 1,
          "columnName": "Column 2",
          "columnType": "DROPDOWN",
          "dataValidationRule": {
            "condition": {
              "type": "ONE_OF_LIST",
              "values": [
                {
                  "userEnteredValue": "Not Started"
                },
                {
                  "userEnteredValue": "In Progress"
                },
                {
                  "userEnteredValue": "Complete"
                }
              ]
            }
          }
        }
      ],
    }
  }
}

Sütun türleri

Tablolarda sayısal, tarih, açılır liste, akıllı çip, onay kutusu gibi sütun türleri bulunur. Derecelendirme ve onay kutusu sütun türleri sırasıyla 0 ve YANLIŞ varsayılan değerleriyle doldurulur.

Açılır liste sütun türü, çip açılır listesi oluşturur. Bir sütun türü açılır liste olarak ayarlanırsa sütunun dataValidationRule değeri ONE_OF_LIST koşuluyla ayarlanmalıdır. Diğer sütun türleri, `dataValidationRule` alanını ayarlamamalıdır.

Tabloyu güncelleme

spreadsheets.batchUpdate yöntemini kullanın ve UpdateTableRequest sağlayın.

Tablo boyutunu değiştirme

Tablonun yeni satır/sütun eklemesi gereken range değerini değiştirmek için UpdateTableRequest yöntemini kullanın.

Tabloya yeni bir satır veya sütun eklemeniz gerekiyorsa InsertRangeRequest veya InsertDimensionRequest'i kullanın.

Bir tablo satırını silmeniz gerekiyorsa DeleteRangeRequest'i kullanabilirsiniz. Aksi takdirde, e-tablodan bir satırın tamamını silmek için DeleteDimensionRequest'i kullanabilirsiniz.

Altbilgisi olmayan mevcut bir tabloyu altbilgi eklemek için güncelliyorsanız range 1 satır genişler. Altbilgi içeren mevcut bir tabloyu güncellerken altbilgiyi kaldırırsanız range 1 satır küçülür.

Tabloya değer ekleme

Tablonun sonuna satır eklemek için tableId ile AppendCellsRequest'i kullanın. Bu işlev, değerleri ilk boş satıra ekler ve tam satırların yanı sıra altbilgileri dikkate alır. Boş satır yoksa bu işlem, tablonun sonuna ve varsa herhangi bir altbilgiden önce satır ekler.

Tablo silme

spreadsheets.batchUpdate yöntemini kullanın ve DeleteTableRequest sağlayın. Tablonun tamamını ve içeriğini silmek için DeleteTableRequest'i kullanın.

Tablo biçimlendirmesini kaldırmak ancak verileri korumak için DeleteBandingRequest'i kullanın.

Tabloları diğer E-Tablolar özellikleriyle kullanma

Tabloların destek verileri olmasını sağlayan diğer API özellikleri arasında filtreler, filtre görünümleri ve korunan aralıklar yer alır.