Veri işlemleri

Google Sheets API, e-tablolardaki verileri çeşitli yolları. E-Tablolar kullanıcı arayüzünde Sheets API. Bu sayfadaki örnekler, bu hedefe ulaşmak için E-Tablolar API'siyle kullanılan bazı yaygın e-tablo işlemleri.

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.

Aralığa veri doğrulama uygulama

Aşağıdakiler spreadsheets.batchUpdate kod örneği, SetDataValidationRequest öğesini kullanın. Burada "değer > 5", A1:D10 aralığındaki her hücreye.

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "setDataValidation": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 4
        },
        "rule": {
          "condition": {
            "type": "NUMBER_GREATER",
            "values": [
              {
                "userEnteredValue": "5"
              }
            ]
          },
          "inputMessage": "Value must be > 5",
          "strict": true
        }
      }
    }
  ]
}

Kopyala ve hücre biçimlendirmesini yapıştır

Aşağıdakiler spreadsheets.batchUpdate kod örneği, CopyPasteRequest yalnızca A1:D10 aralığındaki biçimlendirmeyi kopyalayıp F1:I10 aralığına yapıştırın yer alır. Bu yöntem PasteType sıralaması PASTE_FORMAT ile yalnızca biçimlendirmeyi ve veri doğrulamayı yapıştırın. İlgili içeriği oluşturmak için kullanılan A1:D10'daki orijinal değerler değişmez.

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "copyPaste": {
        "source": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 4
        },
        "destination": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 5,
          "endColumnIndex": 9
        },
        "pasteType": "PASTE_FORMAT",
        "pasteOrientation": "NORMAL"
      }
    }
  ]
}

Kes ve hücreleri yapıştır

Aşağıdakiler spreadsheets.batchUpdate kod örneği, CutPasteRequest. A1:D10 aralığını keser ve PasteType sıralaması değerlerini, formüllerini, biçimlendirmelerini ve birleştirmeleriniPASTE_NORMAL F1:I10 aralığını seçin. Orijinal kaynak aralık hücre içeriği: emin olun.

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "cutPaste": {
        "source": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 4
        },
        "destination": {
          "sheetId": SHEET_ID,
          "rowIndex": 0,
          "columnIndex": 5
        },
        "pasteType": "PASTE_NORMAL"
      }
    }
  ]
}

Bir aralığın üzerinde formül tekrarlama

Aşağıdakiler spreadsheets.batchUpdate kod örneği, RepeatCellRequest kullanarak =FLOOR(A1*PI()) formülünü B1:D10 aralığına kopyalayın. Formülün aralığı aralıktaki her satır ve sütun için hücrenin sol üst hücresini seçin. Örneğin, B1 hücresi =FLOOR(A1*PI()) formülüne sahipken, D6 hücresi =FLOOR(C6*PI()) formülüne sahiptir.

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "repeatCell": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 1,
          "endColumnIndex": 4
        },
        "cell": {
          "userEnteredValue": {
              "formulaValue": "=FLOOR(A1*PI())"
          }
        },
        "fields": "userEnteredValue"
      }
    }
  ]
}

Birden çok sıralama özelliğiyle aralıkları sıralama

Aşağıdakiler spreadsheets.batchUpdate kod örneği, SortRangeRequest için A1:D10 aralığını, önce B sütununa, ardından C sütununa göre sıralamak için önce azalan düzende, ardından D sütununa göre azalan düzende sıralayın.

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "sortRange": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 4
        },
        "sortSpecs": [
          {
            "dimensionIndex": 1,
            "sortOrder": "ASCENDING"
          },
          {
            "dimensionIndex": 2,
            "sortOrder": "DESCENDING"
          },
          {
            "dimensionIndex": 3,
            "sortOrder": "DESCENDING"
          }
        ]
      }
    }
  ]
}