Sayfa işlemleri

Google Sheets API, sayfa oluşturmanıza, temizlemenize, kopyalamanıza, silmenize ve ayrıca özelliklerini kontrol edebilirler. Bu sayfadaki örneklerde, bazı ortak E-Tablolar işlemlerini Sheets API.

Bu örnekler, HTTP istekleri şeklinde sunulur. nötr. Bir toplu güncellemeyi farklı dillerde nasıl uygulayacağınızı öğrenmek için hakkında daha fazla bilgi edinmek için Güncelleme e-tablolar gibi).

Bu örneklerde SPREADSHEET_ID ve SHEET_ID yer tutucuları bu kimlikleri nereye sağlayacağınızı belirtir. E-tabloyu kimliği ekleyin. Şundan faydalanabilirsiniz: sayfa kimliğini değiştirmek için spreadsheets.get yöntemini kullanabilirsiniz. İlgili içeriği oluşturmak için kullanılan aralıklar A1 gösterimi kullanılarak belirtilir. örnek aralık Sayfa1!A1:D5'tir.

Sayfa ekle

Aşağıdakiler spreadsheets.batchUpdate kod örneği, AddSheetRequest bir e-tabloya sayfa eklemeyi, aynı zamanda başlığı, ızgara boyutunu ve sekme rengi.

Yanıt, AddSheetResponse, içeren bir nesne içerir (örneğin, oluşturulan e-tablonun özelliklerine SHEET_ID) tıklayın.

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "addSheet": {
        "properties": {
          "title": "Deposits",
          "gridProperties": {
            "rowCount": 20,
            "columnCount": 12
          },
          "tabColor": {
            "red": 1.0,
            "green": 0.3,
            "blue": 0.4
          }
        }
      }
    }
  ]
}

Biçimleri korurken tüm değerlerin bulunduğu bir sayfayı temizle

Aşağıdakiler spreadsheets.batchUpdate kod örneği, UpdateCellsRequest seçeneğini kullanabilirsiniz.

userEnteredValue alanı Karşılık gelen bir değer olmadığında, değerleri temizleme talimatı olarak yorumlanır değerindedir. Bu ayar diğer alanlarla da kullanılabilir. Örneğin, fields değeri şu şekilde değiştiriliyor: userEnteredFormat kaldırır Sheets API tarafından desteklenen tüm biçimlendirmeler işlemini yapar, ancak hücre değerlerini değiştirmeden bırakır.

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "updateCells": {
        "range": {
          "sheetId": SHEET_ID
        },
        "fields": "userEnteredValue"
      }
    }
  ]
}

Bir e-tablodan diğerine sayfa kopyalama

Aşağıdakiler spreadsheet.sheets.copyTo kod örneği, SHEET_ID tarafından belirtilen tek bir sayfanın nasıl kopyalanacağını gösterir başka bir e-tabloya kopyalamanız gerekir.

İstek gövdesindeki TARGET_SPREADSHEET_ID değişkeni hedef e-tablo. Kopya, tüm değerleri, biçimlendirmeyi, formülleri ve diğer özelliklerini de kullanabilirsiniz. Kopyalanan sayfanın başlığı "Kopyala ([orijinal sayfa başlığı]") yazın.

Yanıt, SheetProperties oluşturulan sayfanın özelliklerini açıklayan nesne.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/sheets/SHEET_ID:copyTo

{
  "destinationSpreadsheetId": "TARGET_SPREADSHEET_ID"
}

Sayfa silme

Aşağıdakiler spreadsheets.batchUpdate kod örneği, DeleteSheetRequest tuşuna basarak SHEET_ID ile belirtilen bir sayfayı silebilirsiniz.

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "deleteSheet": {
        "sheetId": SHEET_ID
      }
    }
  ]
}

Sayfa verilerini okuma

Aşağıdakiler spreadsheets.get kod örneği e-tablo mülk bilgilerinin nasıl alınacağını gösterir SHEET_ID tarafından belirtilen bir e-tablodan ve SPREADSHEET_ID. Bu yöntem genellikle belirli bir e-tablodaki sayfaların meta verileridir. Böylece, bu sayfaları hedeflemenize olanak tanır. fields sorgu parametresi yalnızca sayfa özelliğini belirtiyor (hücre değeri verileri veya e-tablonun tamamını) tıklayın.

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID?&fields=sheets.properties

Yanıt, Spreadsheet bulunan bir Sheet nesnesi SheetProperties öğeler. Belirli bir yanıt alanı varsayılan değere ayarlanırsa atlanır kullanıcı olabilir.

{
  "sheets": [
    {
      "properties": {
        "sheetId": SHEET_ID,
        "title": "Sheet1",
        "index": 0,
        "sheetType": "GRID",
        "gridProperties": {
          "rowCount": 100,
          "columnCount": 20,
          "frozenRowCount": 1
        }
        "tabColor": {
          "blue": 1.0
        }
      },
      ...
  ],
}