Class TextRange

RentangTeks

Segmen konten teks Shape atau TableCell.

Jika Anda menggunakan metode yang mengedit cara teks menyesuaikan bentuk, semua setelan pengepasan otomatis yang diterapkan pada bentuk akan dinonaktifkan.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
appendParagraph(text)ParagraphMenambahkan paragraf di akhir rentang teks.
appendRange(textRange)TextRangeMenambahkan salinan rentang teks yang diberikan ke akhir rentang teks saat ini.
appendRange(textRange, matchSourceFormatting)TextRangeMenambahkan salinan rentang teks yang diberikan ke akhir rentang teks saat ini.
appendText(text)TextRangeMenambahkan teks di akhir rentang teks.
asRenderedString()StringMenampilkan teks yang dirender yang dibatasi oleh rentang bentuk atau sel tabel terkait dalam format yang sesuai untuk ditampilkan kepada pengguna akhir.
asString()StringMenampilkan teks mentah yang dibatasi oleh rentang bentuk atau sel tabel terkait ini.
clear()voidMenghapus teks yang dibatasi oleh rentang ini.
clear(startOffset, endOffset)voidMenghapus teks yang dibatasi oleh offset awal dan akhir dalam rentang.
find(pattern)TextRange[]Menampilkan semua rentang yang cocok dengan pola penelusuran dalam rentang teks saat ini.
find(pattern, startOffset)TextRange[]Menampilkan semua rentang yang cocok dengan pola penelusuran dalam rentang teks saat ini, dimulai dari offset awal.
getAutoTexts()AutoText[]Menampilkan teks otomatis dalam rentang teks saat ini.
getEndIndex()IntegerMenampilkan indeks berbasis 0 eksklusif untuk karakter terakhir dalam rentang ini.
getLength()IntegerMenampilkan jumlah karakter dalam rentang ini.
getLinks()TextRange[]Menampilkan kumpulan rentang teks yang sesuai dengan semua Links dalam rentang teks saat ini atau yang tumpang-tindih dengan rentang teks saat ini.
getListParagraphs()Paragraph[]Menampilkan paragraf dalam daftar yang tumpang-tindih dengan rentang teks saat ini.
getListStyle()ListStyleMenampilkan ListStyle rentang teks saat ini.
getParagraphStyle()ParagraphStyleMenampilkan ParagraphStyle rentang teks saat ini.
getParagraphs()Paragraph[]Menampilkan paragraf yang tumpang-tindih dengan rentang teks saat ini.
getRange(startOffset, endOffset)TextRangeMenampilkan TextRange baru yang mencakup sebagian rentang yang berasal darinya.
getRuns()TextRange[]Menampilkan rangkaian teks yang tumpang-tindih dengan rentang teks saat ini.
getStartIndex()IntegerMenampilkan indeks berbasis 0 inklusif untuk karakter pertama dalam rentang ini.
getTextStyle()TextStyleMenampilkan gaya teks rentang, atau null jika rentang kosong.
insertParagraph(startOffset, text)ParagraphMenyisipkan paragraf pada offset awal.
insertRange(startOffset, textRange)TextRangeMenyisipkan salinan rentang teks yang diberikan pada offset awal.
insertRange(startOffset, textRange, matchSourceFormatting)TextRangeMenyisipkan salinan rentang teks yang diberikan pada offset awal.
insertText(startOffset, text)TextRangeMenyisipkan teks pada offset awal.
isEmpty()BooleanMenampilkan true jika tidak ada karakter dalam rentang ini, dan menampilkan false jika ada.
replaceAllText(findText, replaceText)IntegerMengganti semua instance teks yang cocok dengan teks yang akan dicari dengan teks pengganti.
replaceAllText(findText, replaceText, matchCase)IntegerMengganti semua instance teks yang cocok dengan teks yang akan dicari dengan teks pengganti.
select()voidHanya memilih TextRange dalam presentasi aktif dan menghapus pilihan sebelumnya.
setText(newText)TextRangeMenetapkan teks yang dibatasi oleh rentang bentuk atau sel tabel terkait ini.

Dokumentasi mendetail

appendParagraph(text)

Menambahkan paragraf di akhir rentang teks. Paragraf mempertahankan gaya akhir rentang teks saat ini.

String teks yang diberikan ditambahkan sebagai paragraf dengan menambahkan setidaknya satu karakter baris baru di sekitarnya ke string.

Jika string teks yang diberikan berisi karakter baris baru (sehingga terdiri dari beberapa paragraf), paragraf terakhir yang ditambahkan akan ditampilkan.

Parameter

NamaJenisDeskripsi
textStringString yang akan ditambahkan sebagai paragraf.

Pulang pergi

Paragraph — Paragraph yang ditambahkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

appendRange(textRange)

Menambahkan salinan rentang teks yang diberikan ke akhir rentang teks saat ini.

Pemformatan teks yang disisipkan cocok dengan teks sumber.

Parameter

NamaJenisDeskripsi
textRangeTextRangeRentang teks yang akan ditambahkan.

Pulang pergi

TextRange — Rentang teks yang mewakili teks yang ditambahkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

appendRange(textRange, matchSourceFormatting)

Menambahkan salinan rentang teks yang diberikan ke akhir rentang teks saat ini.

Jika disetel agar sesuai dengan pemformatan teks tujuan, AutoText dalam rentang teks yang diberikan akan diganti dengan nilai yang dirender. Selain itu, elemen non-teks apa pun dalam rentang teks yang diberikan tidak ditambahkan.

Parameter

NamaJenisDeskripsi
textRangeTextRangeRentang teks yang akan ditambahkan.
matchSourceFormattingBooleanJika true, cocokkan pemformatan teks sumber; jika false, cocokkan pemformatan teks tujuan.

Pulang pergi

TextRange — Rentang teks yang mewakili teks yang ditambahkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

appendText(text)

Menambahkan teks di akhir rentang teks. Teks mempertahankan gaya akhir teks yang ada.

Parameter

NamaJenisDeskripsi
textStringString yang akan ditambahkan.

Pulang pergi

TextRange — Rentang teks yang mewakili teks yang ditambahkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

asRenderedString()

Menampilkan teks yang dirender yang dibatasi oleh rentang bentuk atau sel tabel terkait dalam format yang sesuai untuk ditampilkan kepada pengguna akhir.

Elemen AutoText, seperti nomor slide yang dibuat, diganti dengan nilai yang dirender. Elemen non-teks dalam rentang akan dihilangkan.

Pulang pergi

String — Teks yang dirender dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

asString()

Menampilkan teks mentah yang dibatasi oleh rentang bentuk atau sel tabel terkait ini.

Elemen AutoText seperti nomor slide yang dibuat dan elemen non-teks apa pun dalam rentang akan diganti dengan karakter Unicode U+E907.

Pulang pergi

String — Teks mentah dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

clear()

Menghapus teks yang dibatasi oleh rentang ini.

Karena seluruh teks dalam Shape atau TableCell harus diakhiri dengan baris baru, baris baru terakhir dalam teks tidak dihapus.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

clear(startOffset, endOffset)

Menghapus teks yang dibatasi oleh offset awal dan akhir dalam rentang.

Karena teks harus diakhiri dengan baris baru, baris baru terakhir dalam teks tidak dihapus meskipun tercakup oleh offset yang diberikan.

Parameter

NamaJenisDeskripsi
startOffsetIntegerJumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif rentang yang akan dihapus. Offset awal harus sama dengan atau lebih besar dari 0 dan kurang dari atau sama dengan endOffset. startOffset juga harus lebih kecil dari panjang rentang saat ini.
endOffsetIntegerJumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks akhir eksklusif rentang yang akan dihapus. endOffset harus sama dengan atau lebih besar dari startOffset. endOffset juga harus lebih kecil atau sama dengan panjang rentang saat ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

find(pattern)

Menampilkan semua rentang yang cocok dengan pola penelusuran dalam rentang teks saat ini. Penelusuran peka huruf besar/kecil.

Parameter

NamaJenisDeskripsi
patternStringPola ekspresi reguler yang akan ditelusuri; semua garis miring terbalik dalam pola harus dilepaskan.

Pulang pergi

TextRange[] — Daftar rentang teks.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

find(pattern, startOffset)

Menampilkan semua rentang yang cocok dengan pola penelusuran dalam rentang teks saat ini, dimulai dari offset awal. Penelusuran peka huruf besar/kecil.

Parameter

NamaJenisDeskripsi
patternStringPola ekspresi reguler yang akan ditelusuri; semua garis miring terbalik dalam pola harus dilepaskan.
startOffsetIntegerJumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif rentang yang akan ditelusuri. startOffset juga harus lebih kecil dari panjang rentang saat ini.

Pulang pergi

TextRange[] — Daftar rentang teks.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getAutoTexts()

Menampilkan teks otomatis dalam rentang teks saat ini.

Pulang pergi

AutoText[] — Daftar teks otomatis.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getEndIndex()

Menampilkan indeks berbasis 0 eksklusif untuk karakter terakhir dalam rentang ini. Jika indeks awal dan akhir sama, rentang dianggap kosong.

Pulang pergi

Integer — Indeks akhir rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getLength()

Menampilkan jumlah karakter dalam rentang ini.

Pulang pergi

Integer — Jumlah karakter dalam rentang ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

Menampilkan kumpulan rentang teks yang sesuai dengan semua Links dalam rentang teks saat ini atau yang tumpang-tindih dengan rentang teks saat ini.

Setiap rentang yang ditampilkan dijamin mencakup satu link saat dibuat. Modifikasi teks dapat menyebabkan link tidak lagi merepresentasikan tepat satu link.

Setiap Link pada rentang yang ditampilkan dapat diakses melalui TextStyle.getLink(). 

// Accesses the first link on a TextRange object.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
const linkTextRange = textRange.getLinks()[0];
const textStyle = linkTextRange.getTextStyle();
Logger.log(textStyle.hasLink());   // logs 'true'
const link = textStyle.getLink();  // Link object

Pulang pergi

TextRange[] — Daftar rentang teks.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getListParagraphs()

Menampilkan paragraf dalam daftar yang tumpang-tindih dengan rentang teks saat ini.

Pulang pergi

Paragraph[] — Daftar paragraf dalam daftar.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getListStyle()

Menampilkan ListStyle rentang teks saat ini.

Pulang pergi

ListStyle — Gaya daftar rentang teks saat ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getParagraphStyle()

Menampilkan ParagraphStyle rentang teks saat ini.

Pulang pergi

ParagraphStyle — Gaya paragraf rentang teks saat ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getParagraphs()

Menampilkan paragraf yang tumpang-tindih dengan rentang teks saat ini.

Pulang pergi

Paragraph[] — Daftar paragraf.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getRange(startOffset, endOffset)

Menampilkan TextRange baru yang mencakup sebagian rentang yang berasal darinya.

Parameter

NamaJenisDeskripsi
startOffsetIntegerJumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif rentang yang ditampilkan. Offset awal harus sama dengan atau lebih besar dari 0 dan kurang dari atau sama dengan endOffset. startOffset juga harus lebih kecil dari panjang rentang saat ini.
endOffsetIntegerJumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks akhir eksklusif rentang yang ditampilkan. endOffset harus sama dengan atau lebih besar dari startOffset. endOffset juga harus lebih kecil atau sama dengan panjang rentang saat ini.

Pulang pergi

TextRange — Rentang teks baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getRuns()

Menampilkan rangkaian teks yang tumpang-tindih dengan rentang teks saat ini. Jalankan teks adalah segmen teks tempat semua karakter memiliki gaya teks yang sama.

Setiap rentang yang ditampilkan hanya dijamin mencakup satu kali proses saat dibuat. Modifikasi teks atau gaya dapat menyebabkannya tidak lagi merepresentasikan tepat satu kali proses.

Pulang pergi

TextRange[] — Daftar rentang teks.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getStartIndex()

Menampilkan indeks berbasis 0 inklusif untuk karakter pertama dalam rentang ini. Jika indeks awal dan akhir sama, rentang dianggap kosong.

Pulang pergi

Integer — Indeks awal rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getTextStyle()

Menampilkan gaya teks rentang, atau null jika rentang kosong.

Pulang pergi

TextStyle — Gaya teks rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertParagraph(startOffset, text)

Menyisipkan paragraf pada offset awal. Paragraf mempertahankan gaya rentang teks saat ini di offset awal.

String teks yang diberikan disisipkan sebagai paragraf dengan menambahkan setidaknya satu karakter baris baru di sekitarnya ke string.

Jika string teks yang diberikan berisi karakter baris baru (sehingga terdiri dari beberapa paragraf), paragraf terakhir yang ditambahkan akan ditampilkan.

Parameter

NamaJenisDeskripsi
startOffsetIntegerJumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif teks yang akan disisipkan.
textStringString yang akan disisipkan.

Pulang pergi

Paragraph — Paragraph yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertRange(startOffset, textRange)

Menyisipkan salinan rentang teks yang diberikan pada offset awal.

Pemformatan teks yang disisipkan cocok dengan teks sumber.

Parameter

NamaJenisDeskripsi
startOffsetIntegerJumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif teks yang akan disisipkan.
textRangeTextRangeRentang teks yang akan disisipkan.

Pulang pergi

TextRange — Rentang teks yang merepresentasikan teks yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertRange(startOffset, textRange, matchSourceFormatting)

Menyisipkan salinan rentang teks yang diberikan pada offset awal.

Jika disetel agar sesuai dengan pemformatan teks tujuan, AutoText dalam rentang teks yang diberikan akan diganti dengan nilai yang dirender. Selain itu, elemen non-teks apa pun dalam rentang teks yang diberikan tidak disisipkan.

Parameter

NamaJenisDeskripsi
startOffsetIntegerJumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif teks yang akan disisipkan.
textRangeTextRangeRentang teks yang akan disisipkan.
matchSourceFormattingBooleanJika true, cocokkan pemformatan teks sumber; jika false, cocokkan pemformatan teks tujuan.

Pulang pergi

TextRange — Rentang teks yang merepresentasikan teks yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertText(startOffset, text)

Menyisipkan teks pada offset awal. Teks mempertahankan gaya teks yang ada di offset awal.

Parameter

NamaJenisDeskripsi
startOffsetIntegerJumlah karakter setelah indeks awal rentang teks saat ini yang digunakan untuk menentukan indeks awal inklusif teks yang akan disisipkan.
textStringString yang akan disisipkan.

Pulang pergi

TextRange — Rentang teks yang merepresentasikan teks yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isEmpty()

Menampilkan true jika tidak ada karakter dalam rentang ini, dan menampilkan false jika ada.

Pulang pergi

Boolean — true jika tidak ada karakter dalam rentang ini, dan menampilkan false jika tidak.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceAllText(findText, replaceText)

Mengganti semua instance teks yang cocok dengan teks yang akan dicari dengan teks pengganti. Penelusuran tidak peka huruf besar/kecil.

Parameter

NamaJenisDeskripsi
findTextStringTeks yang akan dicari.
replaceTextStringTeks yang akan menggantikan teks yang cocok.

Pulang pergi

Integer — jumlah kemunculan yang berubah

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceAllText(findText, replaceText, matchCase)

Mengganti semua instance teks yang cocok dengan teks yang akan dicari dengan teks pengganti.

Parameter

NamaJenisDeskripsi
findTextStringTeks yang akan dicari.
replaceTextStringTeks yang akan menggantikan teks yang cocok.
matchCaseBooleanJika true, penelusuran peka huruf besar/kecil; jika false, penelusuran tidak peka huruf besar/kecil.

Pulang pergi

Integer — jumlah kemunculan yang berubah

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

select()

Hanya memilih TextRange dalam presentasi aktif dan menghapus pilihan sebelumnya.

Skrip hanya dapat mengakses pilihan pengguna yang menjalankan skrip, dan hanya jika skrip terikat ke presentasi.

Page induk dari Shape atau TableCell yang sesuai ditetapkan sebagai current page selection. Shape atau TableCell ditetapkan sebagai selected page element.

    Selection dapat berupa dua jenis:
    • 1. Rentang teks, gunakan pilihan pada TextRange yang tidak kosong untuk memilih rentang karakter.
    • 2. Posisi kursor, gunakan TextRange kosong untuk menempatkan kursor pada indeks yang diinginkan. 
      const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.getText().setText('Hello');
// Range selection: Select the text range "He".
shape.getText().getRange(0, 2).select();
// Cursor selection: Place the cursor after "H" like "H|ello".
shape.getText().getRange(1, 1).select();

      Otorisasi

      Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

      • https://www.googleapis.com/auth/presentations.currentonly
      • https://www.googleapis.com/auth/presentations

    setText(newText)

    Menetapkan teks yang dibatasi oleh rentang bentuk atau sel tabel terkait ini. Teks mempertahankan gaya awal teks yang ada.

    Parameter

    NamaJenisDeskripsi
    newTextStringString yang akan disetel sebagai teks baru.

    Pulang pergi

    TextRange — Rentang teks yang merepresentasikan teks yang ditetapkan.

    Otorisasi

    Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

    • https://www.googleapis.com/auth/presentations.currentonly
    • https://www.googleapis.com/auth/presentations