Class Browser

เบราว์เซอร์

คลาสนี้ให้สิทธิ์เข้าถึงกล่องโต้ตอบที่เฉพาะเจาะจงสำหรับ Google ชีต

เมธอดในคลาสนี้ใช้ได้ในบริบทของสเปรดชีต Google เท่านั้น โปรดใช้กล่องโต้ตอบของ Google Workspace แทน

ดูเพิ่มเติม

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้ประเภทคำอธิบาย
ButtonsButtonSet

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
inputBox(prompt)String|nullแสดงกล่องโต้ตอบที่มีช่องป้อนข้อความในเบราว์เซอร์ของผู้ใช้
inputBox(prompt, buttons)String|nullแสดงกล่องโต้ตอบที่มีช่องป้อนข้อความในเบราว์เซอร์ของผู้ใช้
inputBox(title, prompt, buttons)String|nullแสดงกล่องโต้ตอบที่มีช่องป้อนข้อความในเบราว์เซอร์ของผู้ใช้
msgBox(prompt)String|nullแสดงกล่องโต้ตอบที่มีข้อความที่ระบุและปุ่ม "ตกลง" ในเบราว์เซอร์ของผู้ใช้
msgBox(prompt, buttons)String|nullแสดงกล่องโต้ตอบพร้อมข้อความที่ระบุและปุ่มที่ระบุในเบราว์เซอร์ของผู้ใช้
msgBox(title, prompt, buttons)String|nullแสดงกล่องโต้ตอบที่มีชื่อ ข้อความ และปุ่มที่ระบุในเบราว์เซอร์ของผู้ใช้

เอกสารโดยละเอียด

inputBox(prompt)

แสดงกล่องโต้ตอบที่มีช่องป้อนข้อความในเบราว์เซอร์ของผู้ใช้

เมธอด inputBox จะแสดงกล่องป้อนข้อมูลฝั่งไคลเอ็นต์ซึ่งแสดงข้อความที่ระบุต่อผู้ใช้ โปรดทราบว่าฟังก์ชันนี้จะทำให้สคริปต์ฝั่งเซิร์ฟเวอร์ถูกระงับ ระบบจะกลับมาทำงานต่อโดยอัตโนมัติหลังจากที่ผู้ใช้ปิดกล่องโต้ตอบ แต่การเชื่อมต่อ JDBC จะไม่คงอยู่ตลอดการระงับ 

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name');
 เราไม่แนะนำให้ใช้วิธีนี้ แต่ให้ใช้พรอมต์ UI แทน

พารามิเตอร์

ชื่อประเภทคำอธิบาย
promptStringข้อความที่จะแสดงในกล่องโต้ตอบ

รีเทิร์น

String|null - ข้อความที่ผู้ใช้ป้อน (หรือ "ยกเลิก" สำหรับกล่องโต้ตอบที่ถูกยกเลิกหรือปิด)

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

inputBox(prompt, buttons)

แสดงกล่องโต้ตอบที่มีช่องป้อนข้อความในเบราว์เซอร์ของผู้ใช้

เมธอด inputBox จะแสดงกล่องป้อนข้อมูลฝั่งไคลเอ็นต์ที่แสดงพรอมต์ที่ระบุต่อผู้ใช้ และมีตัวเลือกปุ่มที่จะแสดง โปรดทราบว่าฟังก์ชันนี้จะทำให้สคริปต์ฝั่งเซิร์ฟเวอร์ถูกระงับ โดยจะกลับมาทำงานอีกครั้งโดยอัตโนมัติหลังจากที่ผู้ใช้ปิดกล่องโต้ตอบ แต่การเชื่อมต่อ JDBC จะไม่คงอยู่ตลอดระยะเวลาการระงับ 

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);
 เราไม่แนะนำให้ใช้วิธีนี้ แต่ให้ใช้พรอมต์ UI แทน

พารามิเตอร์

ชื่อประเภทคำอธิบาย
promptStringข้อความที่จะแสดงในกล่องโต้ตอบ
buttonsButtonSetประเภทปุ่มที่จะใช้

รีเทิร์น

String|null - ข้อความที่ผู้ใช้ป้อน (หรือ "ยกเลิก" สำหรับกล่องโต้ตอบที่ถูกยกเลิกหรือปิด)

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

inputBox(title, prompt, buttons)

แสดงกล่องโต้ตอบที่มีช่องป้อนข้อความในเบราว์เซอร์ของผู้ใช้

เมธอด inputBox จะแสดงกล่องป้อนข้อมูลฝั่งไคลเอ็นต์พร้อมชื่อที่ระบุ ซึ่งจะแสดงพรอมต์ที่ระบุต่อผู้ใช้ และมีตัวเลือกปุ่มที่จะแสดง โปรดทราบว่าฟังก์ชันนี้จะทำให้สคริปต์ฝั่งเซิร์ฟเวอร์ถูกระงับ โดยจะกลับมาทำงานต่อโดยอัตโนมัติหลังจากที่ผู้ใช้ ปิดกล่องโต้ตอบ แต่การเชื่อมต่อ JDBC จะไม่คงอยู่ตลอดระยะเวลาการระงับ 

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox(
    'ID Check',
    'Enter your name',
    Browser.Buttons.OK_CANCEL,
);
 เราไม่แนะนำให้ใช้วิธีนี้ แต่ให้ใช้พรอมต์ UI แทน

พารามิเตอร์

ชื่อประเภทคำอธิบาย
titleStringชื่อของกล่องโต้ตอบ
promptStringข้อความที่จะแสดงในกล่องโต้ตอบ
buttonsButtonSetประเภทปุ่มที่จะใช้

รีเทิร์น

String|null - ข้อความที่ผู้ใช้ป้อน (หรือ "ยกเลิก" สำหรับกล่องโต้ตอบที่ถูกยกเลิกหรือปิด)

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

msgBox(prompt)

แสดงกล่องโต้ตอบที่มีข้อความที่ระบุและปุ่ม "ตกลง" ในเบราว์เซอร์ของผู้ใช้

เมธอด msgBox จะแสดงกล่องข้อความฝั่งไคลเอ็นต์ที่แสดงข้อความที่ระบุต่อผู้ใช้ โปรดทราบว่าวิธีนี้จะทำให้สคริปต์ฝั่งเซิร์ฟเวอร์ถูกระงับ ระบบจะกลับมาทำงานต่อโดยอัตโนมัติหลังจากที่ผู้ใช้ปิดกล่องโต้ตอบ แต่การเชื่อมต่อ JDBC จะไม่คงอยู่ตลอดการระงับ 

// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');
 เราไม่แนะนำให้ใช้วิธีนี้ แต่ให้ใช้กล่องโต้ตอบการแจ้งเตือนใน UI แทน

พารามิเตอร์

ชื่อประเภทคำอธิบาย
promptStringข้อความที่จะแสดงในกล่องโต้ตอบ

รีเทิร์น

String|null — ข้อความตัวพิมพ์เล็กของปุ่มที่ผู้ใช้คลิก (หรือ "ยกเลิก" สำหรับกล่องโต้ตอบที่ปิด)

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

msgBox(prompt, buttons)

แสดงกล่องโต้ตอบพร้อมข้อความที่ระบุและปุ่มที่ระบุในเบราว์เซอร์ของผู้ใช้

เมธอด msgBox จะแสดงกล่องข้อความฝั่งไคลเอ็นต์ที่แสดงข้อความที่ระบุต่อ ผู้ใช้ และเสนอตัวเลือกปุ่มที่จะแสดง โปรดทราบว่าวิธีนี้จะทําให้สคริปต์ฝั่งเซิร์ฟเวอร์ถูกระงับ โดยจะกลับมาทำงานอีกครั้งโดยอัตโนมัติหลังจากที่ผู้ใช้ปิดกล่องโต้ตอบ แต่การเชื่อมต่อ JDBC จะไม่คงอยู่ตลอดระยะเวลาการระงับ 

// The code below displays "hello world" in a dialog box with OK and Cancel
// buttons.
Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);
 เราไม่แนะนำให้ใช้วิธีนี้ แต่ให้ใช้กล่องโต้ตอบการแจ้งเตือนใน UI แทน

พารามิเตอร์

ชื่อประเภทคำอธิบาย
promptStringข้อความที่จะแสดงในกล่องโต้ตอบ
buttonsButtonSetประเภทปุ่มที่จะใช้

รีเทิร์น

String|null — ข้อความตัวพิมพ์เล็กของปุ่มที่ผู้ใช้คลิก (หรือ "ยกเลิก" สำหรับกล่องโต้ตอบที่ปิด)

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

msgBox(title, prompt, buttons)

แสดงกล่องโต้ตอบที่มีชื่อ ข้อความ และปุ่มที่ระบุในเบราว์เซอร์ของผู้ใช้

เมธอด msgBox จะแสดงกล่องข้อความฝั่งไคลเอ็นต์พร้อมชื่อที่ระบุ ซึ่งจะแสดงข้อความที่ระบุต่อผู้ใช้ และมีปุ่มให้เลือกแสดง โปรดทราบว่า เมธอดนี้จะทําให้สคริปต์ฝั่งเซิร์ฟเวอร์ถูกระงับ โดยจะกลับมาทำงานต่อโดยอัตโนมัติหลังจากที่ผู้ใช้ ปิดกล่องโต้ตอบ แต่การเชื่อมต่อ JDBC จะไม่คงอยู่ตลอดระยะเวลาการระงับ 

// The code below displays "hello world" in a dialog box with a custom title and
// Yes and No buttons
Browser.msgBox('Greetings', 'hello world', Browser.Buttons.YES_NO);
 เราไม่แนะนำให้ใช้วิธีนี้ แต่ให้ใช้กล่องโต้ตอบการแจ้งเตือนใน UI แทน

พารามิเตอร์

ชื่อประเภทคำอธิบาย
titleStringชื่อกล่องโต้ตอบ
promptStringข้อความที่จะแสดงในกล่องโต้ตอบ
buttonsButtonSetประเภทปุ่มที่จะใช้

รีเทิร์น

String|null — ข้อความตัวพิมพ์เล็กของปุ่มที่ผู้ใช้คลิก (หรือ "ยกเลิก" สำหรับกล่องโต้ตอบที่ปิด)

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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