Temel yazma

Google E-Tablolar API'sı hücrelere, aralıklara veya ve sayfaların tamamını kapsar. Bu sayfadaki örnekler, bazı durumlarda yaygın yazma işlemleri spreadsheets.values E-Tablolar API'sının kaynağı.

Hücre değerlerini yazmak için kullanılan spreadsheet.batchUpdate yöntemidir (hücre biçimlendirmesini eşzamanlı olarak güncellemek istiyorsanız bu yararlı olabilir) veya diğer mülklerde spreadsheets.values etkilemiyor. Örneğin, bir sayfaya kopyalayarak hem hücre formülünün hem de hücrenin daha fazla bilgi için UpdateCellsRequest bir spreadsheet.batchUpdate.

Ancak, basit değer yazma işlemleri için spreadsheets.values.update yöntemini veya spreadsheets.values.batchUpdate yöntemidir.

Bu örnekler, HTTP istekleri şeklinde sunulur. nötr. Farklı dillerde yazma işlemlerini nasıl uygulayacağınızı öğrenmek için daha fazla bilgi için Okuma ve hücreye yaz değerleri için de kullanılabilecektir.

Bu örneklerde SPREADSHEET_ID yer tutucusu, Burada elektronik tablonuz kimliği gösterilir. e-tablo URL'si. Yazılacak aralıklar A1 kullanılarak belirtilir notasyonu ile karşılaştırın. Sayfa1!A1:D5 gibi bir aralık örnek verilebilir.

Tek bir aralık yazma

Yeni, boş bir e-tablo ile başlayın ve spreadsheets.values.update kod örneği, değerlerin bir aralığa nasıl yazılacağını gösterir. İlgili içeriği oluşturmak için kullanılan ValueInputOption sorgusu parametresi gereklidir ve yazılan değerlerin ayrıştırılıp ayrıştırılmadığını belirler ( Örneğin, bir dizenin tarihe dönüştürülüp dönüştürülmediği).

İsteğin gövdesi, ValueRange yazılacak aralık değerlerini açıklayan nesne. İlgili içeriği oluşturmak için kullanılan majorDimension alanı dizilerin, satırlara göre düzenlenmiş değer listeleri olduğunu gösterir. Mevcut değerler hedef aralıktaki öğelerin üzerine yazılır.

İstek protokolü aşağıda gösterilmiştir.

PUT https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5?valueInputOption=VALUE_INPUT_OPTION
{
  "range": "Sheet1!A1:D5",
  "majorDimension": "ROWS",
  "values": [
    ["Item", "Cost", "Stocked", "Ship Date"],
    ["Wheel", "$20.50", "4", "3/1/2016"],
    ["Door", "$15", "2", "3/15/2016"],
    ["Engine", "$100", "1", "3/20/2016"],
    ["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"]
  ],
}

Yanıt, UpdateValuesResponse nesne olacaktır:

{
  "spreadsheetId": SPREADSHEET_ID,
  "updatedRange": "Sheet1!A1:D5",
  "updatedRows": 5,
  "updatedColumns": 4,
  "updatedCells": 20,
}

Elde edilen sayfa aşağıdaki gibi görünür:

A B C D
1 Öğe Maliyet Stokta Gönderim Tarihi
2 Tekerlek 20,50 TL 4 01.03.2016
3 Kapı Hong Kong doları 2 15.03.2016
4 Motor 100 ABD doları 1 20.03.2016
5 Toplam 135,5 TL 7 20.03.2016

Bir aralığa seçmeli yazma

Değerleri bir aralığa yazarken, mevcut bazı değerleri değiştirmekten kaçınmak mümkündür hücreleri için, ilgili dizi öğelerini null değerine ayarlayın. Ayrıca mümkünse tuşuna basarak bir hücreyi ona boş dize ("") yazarak temizleyin.

Yukarıdaki tarafından üretilen aynı verileri içeren bir sayfayla başlayarak örnek için aşağıdaki spreadsheets.values.update kod örneği, değerlerin B1:D4 aralığına, seçmeli olarak nasıl yazılacağını gösterir bazı hücreleri değiştirmeden bırakıp diğerlerini temizleyin. İlgili içeriği oluşturmak için kullanılan ValueInputOption sorgusu parametresi gereklidir ve yazılan değerlerin ayrıştırılıp ayrıştırılmadığını belirler ( Örneğin, bir dizenin tarihe dönüştürülüp dönüştürülmediği).

İsteğin gövdesi, ValueRange yazılacak aralık değerlerini açıklayan nesne. İlgili içeriği oluşturmak için kullanılan majorDimension alanı dizilerin, sütuna göre düzenlenmiş değer listeleri olduğunu gösterir.

İstek protokolü aşağıda gösterilmiştir.

PUT https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!B1?valueInputOption=VALUE_INPUT_OPTION
{
  "range": "Sheet1!B1",
  "majorDimension": "COLUMNS",
  "values": [
    [null,"$1","$2", ""],
    [],
    [null,"4/1/2016", "4/15/2016", ""]
  ]
}

Buradaki values alanında, aralıktaki her bir sütunda yapılan değişiklikler listelenir. İlgili içeriği oluşturmak için kullanılan ilk dizi, B1'in değiştirilmeyeceğini gösterir (null dizisi nedeniyle) öğesi), B4 ise temizlenir (boş dize). B2 ve B3'ün değerleri vardır güncellendi. Üçüncü dizi, D sütununda aynı işlemleri gerçekleştirirken ikinci boş dizi, C sütununun değiştirilmeyeceğini gösterir.

Yanıt, UpdateValuesResponse nesne gibi kullanabilirsiniz:

{
  "spreadsheetId": SPREADSHEET_ID,
  "updatedRange": "Sheet1!B1:D5",
  "updatedRows": 3,
  "updatedColumns": 2,
  "updatedCells": 6,
}

Elde edilen sayfa aşağıdaki gibi görünür:

A B C D
1 Öğe Maliyet Stokta Gönderim Tarihi
2 Tekerlek 1,00 ABD doları 4 01.04.2016
3 Kapı 2 ABD doları 2 15.04.2016
4 Motor 1
5 Toplam 3,00 ABD doları 7 15.04.2016

"Toplamlar"ın satırı, bu istek tarafından doğrudan değiştirilmese de Değişir.

Birden fazla aralığa yazma

Boş bir sayfa ile başlayarak, spreadsheets.values.batchUpdate kod örneği, değerlerin Sheet1!A1:A4 ve Sayfa1!B1:D2. Hedef aralıktaki mevcut değerlerin üzerine yazılır. İstek gövdesinde bir ValueInputOption nesne giriş verilerinin ve bir dizi veri türünün nasıl yorumlanacağını ValueRange nesneleri ifade eder. İlgili içeriği oluşturmak için kullanılan majorDimension alanı dahil edilen dizilerin sütun veya satır dizileri olarak yorumlanıp yorumlanmayacağını belirler.

İstek protokolü aşağıda gösterilmiştir.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchUpdate
{
  "valueInputOption": "VALUE_INPUT_OPTION",
  "data": [
    {
      "range": "Sheet1!A1:A4",
      "majorDimension": "COLUMNS",
      "values": [
        ["Item", "Wheel", "Door", "Engine"]
      ]
    },
    {
      "range": "Sheet1!B1:D2",
      "majorDimension": "ROWS",
      "values": [
        ["Cost", "Stocked", "Ship Date"],
        ["$20.50", "4", "3/1/2016"]
      ]
    }
  ]
}

Yanıt, güncellenen hücre istatistiklerini listeleyen bir nesneden oluşur. ve bir dizi UpdateValuesResponse nesne olacaktır. Örneğin:

{
  "spreadsheetId": SPREADSHEET_ID,
  "totalUpdatedRows": 4,
  "totalUpdatedColumns": 4,
  "totalUpdatedCells": 10,
  "totalUpdatedSheets": 1,
  "responses": [
    {
      "spreadsheetId": SPREADSHEET_ID,
      "updatedRange": "Sheet1!A1:A4",
      "updatedRows": 4,
      "updatedColumns": 1,
      "updatedCells": 4,
    },
    {
      "spreadsheetId": SPREADSHEET_ID,
      "updatedRange": "Sheet1!B1:D2",
      "updatedRows": 2,
      "updatedColumns": 3,
      "updatedCells": 6,
    }
  ],
}

Elde edilen sayfa aşağıdaki gibi görünür:

A B C D
1 Öğe Maliyet Stokta Gönderim Tarihi
2 Tekerlek 20,50 TL 4 01.03.2016
3 Kapı
4 Motor
5

Değerleri ayrıştırmadan yazma

Boş bir sayfa ile başlayarak, spreadsheets.values.update kod örneği, değerlerin Sheet1!A1:E1 aralığına nasıl yazılacağını gösterir. RAW ValueInputOption sorgu parametresini kullanarak, yazılan dizelerin formül olarak ayrıştırılmasını engelleyebilir, booleler veya sayılar. Bunlar dize olarak görünür ve metin hizalaması hizalanır tıklayın.

İsteğin gövdesi, ValueRange yazılacak aralık değerlerini açıklayan nesne. İlgili içeriği oluşturmak için kullanılan majorDimension alanı dizilerin, satırlara göre düzenlenmiş değer listeleri olduğunu gösterir. Mevcut değerler hedef aralıktaki öğelerin üzerine yazılır.

İstek protokolü aşağıda gösterilmiştir.

PUT https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:E1?valueInputOption=RAW
{
  "range": "Sheet1!A1:E1",
  "majorDimension": "ROWS",
  "values": [
    ["Data", 123.45, true, "=MAX(D2:D4)", "10"]
  ],
}

Yanıt, UpdateValuesResponse nesne gibi kullanabilirsiniz:

{
  "spreadsheetId": SPREADSHEET_ID,
  "updatedRange": "Sheet1!A1:E1",
  "updatedRows": 1,
  "updatedColumns": 5,
  "updatedCells": 5,
}

Elde edilen sayfa aşağıdaki gibi görünür:

A B C D E
1 Veriler 123,45 DOĞRU =MAK(D2:D4) 10
2

Not: "TRUE" ortalanmış ve bir boole değeridir, "123.45" ise doğru sayı olduğu için iki yana yaslandı ve "10" iki yana yaslanmış olarak bırakılmaktadır çünkü dize. Formül ayrıştırılmaz ve aynı zamanda bir dize olarak görünür.

Değer ekleyin

Aşağıdaki tablo gibi bir sayfayla başlayın:

A B C D
1 Öğe Maliyet Stokta Gönderim Tarihi
2 Tekerlek 20,50 TL 4 01.03.2016
3

Aşağıdakiler spreadsheets.values.append kod örneği, 3. satırdan başlayarak iki yeni değer satırının nasıl ekleneceğini göstermektedir. İlgili içeriği oluşturmak için kullanılan ValueInputOption sorgusu parametresi gereklidir ve yazılan değerlerin ayrıştırılıp ayrıştırılmadığını belirler ( Örneğin, bir dizenin tarihe dönüştürülüp dönüştürülmediği).

İsteğin gövdesi, ValueRange yazılacak aralık değerlerini açıklayan nesne. İlgili içeriği oluşturmak için kullanılan majorDimension alanı dizilerin, satırlara göre düzenlenmiş değer listeleri olduğunu gösterir.

İstek protokolü aşağıda gösterilmiştir.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:E1:append?valueInputOption=VALUE_INPUT_OPTION
{
  "range": "Sheet1!A1:E1",
  "majorDimension": "ROWS",
  "values": [
    ["Door", "$15", "2", "3/15/2016"],
    ["Engine", "$100", "1", "3/20/2016"],
  ],
}

Yanıt, AppendValuesResponse nesne gibi kullanabilirsiniz:

{
  "spreadsheetId": SPREADSHEET_ID,
  "tableRange": "Sheet1!A1:D2",
  "updates": {
    "spreadsheetId": SPREADSHEET_ID,
    "updatedRange": "Sheet1!A3:D4",
    "updatedRows": 2,
    "updatedColumns": 4,
    "updatedCells": 8,
  }
}

Elde edilen sayfa aşağıdaki gibi görünür:

A B C D
1 Öğe Maliyet Stokta Gönderim Tarihi
2 Tekerlek 20,50 TL 4 01.03.2016
3 Kapı Hong Kong doları 2 15.03.2016
4 Motor 100 ABD doları 1 20.03.2016
5