Operasi baris & kolom

Google Sheets API memungkinkan Anda menambahkan, menghapus, dan memanipulasi baris dan kolom di spreadsheet. Contoh di halaman ini mengilustrasikan cara melakukan beberapa operasi baris dan kolom umum dengan Sheets API.

Contoh ini disajikan dalam bentuk permintaan HTTP agar netral terhadap bahasa. Untuk mempelajari cara menerapkan kumpulan update dalam berbagai bahasa menggunakan library klien Google API, lihat Memperbarui spreadsheet.

Dalam contoh ini, placeholder SPREADSHEET_ID dan SHEET_ID menunjukkan tempat Anda akan memberikan ID tersebut. Anda dapat menemukan ID spreadsheet di URL spreadsheet. Anda bisa mendapatkan ID sheet menggunakan metode spreadsheets.get. Rentang ditentukan menggunakan notasi A1. Contoh rentang adalah Sheet1!A1:D5.

Menyesuaikan lebar kolom atau tinggi baris

Contoh kode spreadsheets.batchUpdate berikut menunjukkan cara menggunakan UpdateDimensionPropertiesRequest untuk memperbarui properti lebar kolom A menjadi 160 piksel. Permintaan kedua memperbarui properti tinggi baris dari tiga baris pertama menjadi 40 piksel. Kolom dimension menentukan apakah operasi berlaku untuk kolom atau baris sheet.

Protokol permintaan ditampilkan di bawah.

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

{
  "requests": [
    {
      "updateDimensionProperties": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 0,
          "endIndex": 1
        },
        "properties": {
          "pixelSize": 160
        },
        "fields": "pixelSize"
      }
    },
    {
      "updateDimensionProperties": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        },
        "properties": {
          "pixelSize": 40
        },
        "fields": "pixelSize"
      }
    }
  ]
}

Menambahkan baris atau kolom kosong

Contoh kode spreadsheets.batchUpdate berikut menunjukkan cara menggunakan AppendDimensionRequest untuk menambahkan baris dan kolom. Permintaan pertama menambahkan tiga baris kosong ke akhir sheet, sedangkan permintaan kedua menambahkan satu kolom kosong. Kolom dimension menentukan apakah operasi berlaku untuk kolom atau baris sheet.

Protokol permintaan ditampilkan di bawah.

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

{
  "requests": [
    {
      "appendDimension": {
        "sheetId": SHEET_ID,
        "dimension": "ROWS",
        "length": 3
      }
    },
    {
      "appendDimension": {
        "sheetId": SHEET_ID,
        "dimension": "COLUMNS",
        "length": 1
      }
    }
  ]
}

Mengubah ukuran kolom secara otomatis

Contoh kode spreadsheets.batchUpdate berikut menunjukkan cara menggunakan AutoResizeDimensionsRequest untuk mengubah ukuran kolom A:C, berdasarkan ukuran konten kolom. Kolom dimension menunjukkan bahwa operasi berlaku untuk kolom sheet.

Protokol permintaan ditampilkan di bawah.

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

{
  "requests": [
    {
      "autoResizeDimensions": {
        "dimensions": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    }
  ]
}

Mengubah ukuran baris secara otomatis

Contoh kode berikut spreadsheets.batchUpdate menunjukkan cara menggunakan AutoResizeDimensionsRequest untuk menghapus tinggi baris dari tiga baris pertama. Tinggi baris kemudian akan bertambah secara dinamis berdasarkan konten sel di setiap baris. Kolom dimension menunjukkan bahwa operasi berlaku untuk baris sheet.

Protokol permintaan ditampilkan di bawah.

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

{
  "requests": [
    {
      "autoResizeDimensions": {
        "dimensions": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    }
  ]
}

Menghapus baris atau kolom

Contoh kode spreadsheets.batchUpdate berikut menunjukkan cara menggunakan DeleteDimensionRequest untuk menghapus tiga baris pertama dalam sheet. Permintaan kedua menghapus kolom B:D. Kolom dimension menentukan apakah operasi berlaku untuk kolom atau baris sheet.

Protokol permintaan ditampilkan di bawah.

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

{
  "requests": [
    {
      "deleteDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    },
    {
      "deleteDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 1,
          "endIndex": 4
        }
      }
    },
  ],
}

Menyisipkan baris atau kolom kosong

Contoh kode berikut spreadsheets.batchUpdate menunjukkan cara menggunakan InsertDimensionRequest untuk menyisipkan kolom atau baris pada indeks tertentu (seperti menambahkan baris kosong di bagian atas sheet). Permintaan pertama menyisipkan dua kolom kosong di kolom C. Permintaan kedua menyisipkan tiga baris kosong yang dimulai dari baris 1.

Kolom dimension menentukan apakah operasi berlaku untuk kolom atau baris sheet.

Jika benar (true), kolom inheritFromBefore akan memberi tahu Sheets API untuk memberikan properti yang sama kepada kolom atau baris baru seperti baris atau kolom sebelumnya dan jika salah (false), untuk mewarisi dari dimensi setelah kolom atau baris baru. inheritFromBefore tidak dapat bernilai benar (true) jika menyisipkan baris di baris 1 atau kolom di kolom A.

Protokol permintaan ditampilkan di bawah.

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

{
  "requests": [
    {
      "insertDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 2,
          "endIndex": 4
        },
        "inheritFromBefore": true
      }
    },
    {
      "insertDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        },
        "inheritFromBefore": false
      }
    },
  ],
}

Memindahkan baris atau kolom

Contoh kode spreadsheets.batchUpdate berikut menunjukkan cara menggunakan MoveDimensionRequest untuk memindahkan kolom A ke posisi kolom D. Permintaan kedua memindahkan baris 5–10 ke posisi baris 20.

Kolom dimension menentukan apakah operasi berlaku untuk kolom atau baris sheet. Kolom destinationIndex menentukan tempat untuk memindahkan data sumber menggunakan indeks awal berbasis nol.

Protokol permintaan ditampilkan di bawah.

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

{
  "requests": [
    {
      "moveDimension": {
        "source": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 0,
          "endIndex": 1
        },
        "destinationIndex": 3
      }
    },
    {
      "moveDimension": {
        "source": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 4,
          "endIndex": 10
        },
        "destinationIndex": 19
      }
    },
  ],
}