Operasi tabel

Google Slides API memungkinkan Anda membuat dan mengedit tabel di halaman. Contoh di halaman ini menunjukkan beberapa operasi tabel umum menggunakan presentations.batchUpdate .

Contoh ini menggunakan variabel berikut:

  • PRESENTATION_ID—Menunjukkan tempat Anda menyediakan presentasi ID. Anda dapat temukan nilai untuk ID ini dari URL presentasi.
  • PAGE_ID—Menunjukkan tempat Anda memberikan objek halaman ID. Anda dapat mengambil nilai untuk ini dari URL atau dengan menggunakan permintaan baca API.
  • TABLE_ID—Menunjukkan tempat Anda menyediakan halaman ID objek elemen untuk tabel yang sedang Anda kerjakan. Anda dapat menetapkan ID ini untuk elemen yang Anda buat (dengan beberapa pembatasan) atau mengizinkan Slides API untuk otomatis membuatnya. ID Elemen dapat diambil melalui permintaan baca API.

Contoh ini disajikan sebagai permintaan HTTP agar tidak menggunakan bahasa yang netral. Untuk mempelajari cara mengimplementasikan update secara batch dalam berbagai bahasa menggunakan Google API library klien, lihat Menambahkan bentuk dan teks.

Membuat tabel

Hal berikut presentations.batchUpdate contoh kode menunjukkan cara menggunakan CreateTableRequest untuk menambahkan tabel ke slide yang ditentukan oleh PAGE_ID.

Tabel ini memiliki delapan baris dan lima kolom. Perhatikan bahwa Slides API mengabaikan kolom size atau transform apa pun yang disediakan sebagai bagian dari elementProperties Sebagai gantinya, API membuat tabel yang kira-kira berpusat pada slide dan berukuran untuk mengakomodasi jumlah baris dan kolom yang ditentukan, jika memungkinkan.

Berikut adalah protokol permintaan untuk membuat tabel:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createTable": {
        "objectId": TABLE_ID,
        "elementProperties": {
          "pageObjectId": PAGE_ID,
        },
        "rows": 8,
        "columns": 5
      }
    }
  ]
}

Menghapus baris atau kolom tabel

Hal berikut presentations.batchUpdate contoh kode menunjukkan cara menggunakan DeleteTableRowRequest untuk menghapus baris keenam. Lalu, LLM menggunakan DeleteTableColumnRequest untuk menghapus kolom keempat. Tabel tersebut ditetapkan oleh TABLE_ID. rowIndex dan columnIndex dalam cellLocation berbasis nol.

Berikut adalah protokol permintaan untuk menghapus baris atau kolom tabel:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "deleteTableRow": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 5
        }
      }
    },
    {
      "deleteTableColumn": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "columnIndex": 3
        }
      }
    }
  ]
}

Edit data tabel

Hal berikut presentations.batchUpdate contoh kode menunjukkan cara menggunakan DeleteTextRequest metode untuk menghapus semua teks di sel dalam textRange. Ini kemudian menggunakan InsertTextRequest untuk menggantinya dengan teks baru "Kangaroo".

Tabel ditentukan oleh TABLE_ID. Sel yang terdampak ada di dalam baris kelima dan kolom ketiga. rowIndex dan columnIndex dalam cellLocation berbasis nol.

Berikut adalah protokol permintaan untuk mengedit data tabel:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "deleteText": {
        "objectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 4,
          "columnIndex": 2
        },
        "textRange": {
          "type": "ALL",
        }
      }
    },
    {
      "insertText": {
        "objectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 4,
          "columnIndex": 2
        },
        "text": "Kangaroo",
        "insertionIndex": 0
      }
    }
  ]
}

Memformat baris header tabel

Hal berikut presentations.batchUpdate contoh kode menunjukkan cara menggunakan UpdateTableCellPropertiesRequest untuk memformat baris {i>header<i} dari elemen tabel, dalam tableRange, yang ditentukan oleh TABLE_ID. Lalu, LLM menggunakan TableCellProperties untuk menyetel warna latar belakang baris {i>header<i} ke hitam.

Setiap permintaan berikut menggunakan atribut UpdateTextStyleRequest metode untuk mengatur format teks dalam satu sel baris {i>header<i} menjadi tebal, putih 18-pt Font Cambria dalam textRange. Anda mengulangi permintaan ini untuk setiap sel tambahan di {i>header<i}.

rowIndex dan columnIndex dalam location dan cellLocation berbasis nol.

Berikut adalah protokol permintaan untuk memformat baris header tabel:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "updateTableCellProperties": {
        "objectId": TABLE_ID,
        "tableRange": {
          "location": {
            "rowIndex": 0,
            "columnIndex": 0
          },
          "rowSpan": 1,
          "columnSpan": 3
        },
        "tableCellProperties": {
          "tableCellBackgroundFill": {
            "solidFill": {
              "color": {
                "rgbColor": {
                  "red": 0.0,
                  "green": 0.0,
                  "blue": 0.0
                }
              }
            }
          }
        },
        "fields": "tableCellBackgroundFill.solidFill.color"
      }
    },
    {
      "updateTextStyle": {
        "objectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 0,
          "columnIndex": 0
        },
        "style": {
          "foregroundColor": {
            "opaqueColor": {
              "rgbColor": {
                "red": 1.0,
                "green": 1.0,
                "blue": 1.0
              }
            }
          },
          "bold": true,
          "fontFamily": "Cambria",
          "fontSize": {
            "magnitude": 18,
            "unit": "PT"
          }
        },
        "textRange": {
          "type": "ALL"
        },
        "fields": "foregroundColor,bold,fontFamily,fontSize"
      }
    },
    // Repeat the above request for each additional cell in the header row....
  ]
}

Berikut adalah tampilan baris header yang diformat setelah pembaruan ini:

Format hasil resep baris header.

Menyisipkan baris atau kolom tabel

Hal berikut presentations.batchUpdate contoh kode menunjukkan cara menggunakan InsertTableRowsRequest metode untuk menambahkan tiga baris di bawah baris keenam. Lalu, LLM menggunakan InsertTableColumnsRequest metode untuk menambahkan dua kolom di sebelah kiri kolom keempat dalam tabel yang sama.

Tabel ditentukan oleh TABLE_ID. rowIndex dan columnIndex dalam cellLocation berbasis nol.

Berikut adalah protokol permintaan untuk menyisipkan baris atau kolom tabel:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "insertTableRows": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 5
        },
        "insertBelow": true,
        "number": 3
      }
    },
    {
      "insertTableColumns": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "columnIndex": 3
        },
        "insertRight": false,
        "number": 2
      }
    }
  ]
}