ช่องป้อนข้อมูลที่อนุญาตให้ผู้ใช้ป้อนวันที่และเวลา
รองรับการตรวจสอบการส่งแบบฟอร์ม เมื่อตั้งค่า Action.setAllWidgetsAreRequired(allWidgetsAreRequired) เป็น
true หรือระบุวิดเจ็ตนี้ผ่าน Action.addRequiredWidget(requiredWidget) ระบบจะบล็อกการดำเนินการส่ง
เว้นแต่จะมีการเลือกค่า
พร้อมให้บริการสำหรับส่วนเสริมของ Google Workspace และแอป Google Chat
const dateTimePicker = CardService.newDateTimePicker() .setTitle('Enter the date and time.') .setFieldName('date_time_field') // Set default value as Jan 1, 2018, 3:00 AM UTC. Either a number or // string is acceptable. .setValueInMsSinceEpoch(1514775600) // EDT time is 5 hours behind UTC. .setTimeZoneOffsetInMins(-5 * 60) .setOnChangeAction( CardService.newAction().setFunctionName('handleDateTimeChange'), );
เมธอด
| วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
|---|---|---|
add | Widget | เพิ่มการดำเนินการของเหตุการณ์ที่ทำได้ในวิดเจ็ต |
set | Date | กำหนดชื่อฟิลด์ที่ระบุเครื่องมือเลือกนี้ในออบเจ็กต์เหตุการณ์ที่สร้างขึ้นเมื่อมีการโต้ตอบ UI |
set | Date | ในเอเจนต์ Google Workspace Studio ตัวแปร อินพุตจะยอมรับเอาต์พุตวันที่และเวลาจากขั้นตอนอื่นๆ ในเอเจนต์ |
set | Widget | กำหนดรหัสที่ไม่ซ้ำกันที่กำหนดให้ซึ่งใช้ระบุวิดเจ็ตที่จะเปลี่ยน |
set | Date | ตั้งค่า Action ที่สคริปต์จะดำเนินการเมื่อใดก็ตามที่อินพุตของเครื่องมือเลือกมีการเปลี่ยนแปลง |
set | Date | กำหนดจำนวนนาทีที่ควรชดเชยเขตเวลาจาก UTC |
set | Date | กำหนดชื่อที่แสดงเหนือช่องป้อนข้อมูล |
set | Date | กำหนดค่าที่กรอกไว้ล่วงหน้าที่จะตั้งค่าในช่องป้อนข้อมูล |
set | Date | กำหนดค่าที่กรอกไว้ล่วงหน้าที่จะตั้งค่าในช่องป้อนข้อมูล |
set | Widget | ตั้งค่าระดับการมองเห็นของวิดเจ็ต |
เอกสารโดยละเอียด
add
เพิ่มการดำเนินการของเหตุการณ์ที่ทำได้ในวิดเจ็ต
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
event | Event | Event ที่จะเพิ่ม |
รีเทิร์น
Widget — ออบเจ็กต์สำหรับการเชื่อมโยง
set
กำหนดชื่อฟิลด์ที่ระบุเครื่องมือเลือกนี้ในออบเจ็กต์เหตุการณ์ที่สร้างขึ้นเมื่อมีการโต้ตอบ UI ผู้ใช้จะเห็นชื่อฟิลด์ ต้องระบุ ชื่อฟิลด์ที่ระบุต้องไม่ซ้ำกัน
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
field | String | ชื่อที่จะกำหนดให้กับอินพุตนี้ |
รีเทิร์น
Date — เครื่องมือเลือกนี้ใช้สำหรับการเชื่อมโยง
set
ในเอเจนต์ Google Workspace Studio ตัวแปร อินพุตจะยอมรับเอาต์พุตวันที่และเวลาจากขั้นตอนอื่นๆ ในเอเจนต์ เช่น รับ เวลาที่ส่งข้อความ Gmail หรือวันที่ที่กำหนดเวลากิจกรรมในปฏิทิน
ใช้ได้เฉพาะกับส่วนเสริมของ Google Workspace ที่ขยาย Google Workspace Studio
const workflowDataSource = CardService.newWorkflowDataSource().setIncludeVariables(true); const hostAppDataSource = CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource); const dateTimePicker = CardService.newDateTimePicker() .setTitle('Enter the date and time.') .setFieldName('date_time_field') .setHostAppDataSource(hostAppDataSource);
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
host | Host | แหล่งข้อมูล |
รีเทิร์น
Date — เครื่องมือเลือกนี้ใช้สำหรับการเชื่อมโยง
set
กำหนดรหัสที่ไม่ซ้ำกันที่กำหนดให้ซึ่งใช้ระบุวิดเจ็ตที่จะเปลี่ยน การเปลี่ยนแปลงวิดเจ็ต รองรับเฉพาะในส่วนเสริม
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
id | String | รหัสของวิดเจ็ต โดยมีความยาวได้ไม่เกิน 64 อักขระและอยู่ในรูปแบบ `[a-zA-Z0-9-]+` |
รีเทิร์น
Widget - ออบเจ็กต์นี้สำหรับการเชื่อมโยง
set
ตั้งค่า Action ที่สคริปต์จะดำเนินการเมื่อใดก็ตามที่อินพุตของเครื่องมือเลือกมีการเปลี่ยนแปลง
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
action | Action | การดำเนินการที่ต้องทำ |
รีเทิร์น
Date — เครื่องมือเลือกนี้ใช้สำหรับการเชื่อมโยง
set
กำหนดจำนวนนาทีที่ควรชดเชยเขตเวลาจาก UTC หากตั้งค่าไว้ ระบบจะแสดงวันที่และเวลาในเขตเวลาที่ระบุ หากไม่ได้ตั้งค่าไว้ ระบบจะแสดงเวลาในเขตเวลาของผู้ใช้
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
time | Integer | จำนวนนาทีที่เขตเวลาออฟเซ็ตจาก UTC |
รีเทิร์น
Date — เครื่องมือเลือกนี้ใช้สำหรับการเชื่อมโยง
set
กำหนดชื่อที่แสดงเหนือช่องป้อนข้อมูล
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
title | String | ชื่อช่องป้อนข้อมูล |
รีเทิร์น
Date — เครื่องมือเลือกนี้ใช้สำหรับการเชื่อมโยง
set
กำหนดค่าที่กรอกไว้ล่วงหน้าที่จะตั้งค่าในช่องป้อนข้อมูล
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
value | Number | ค่าเริ่มต้นที่ป้อนเป็นตัวเลขในหน่วยมิลลิวินาทีตั้งแต่ Epoch โดยจะแสดงเป็นสตริงในพารามิเตอร์การเรียกกลับของแบบฟอร์มเสมอ |
รีเทิร์น
Date — เครื่องมือเลือกนี้ใช้สำหรับการเชื่อมโยง
set
กำหนดค่าที่กรอกไว้ล่วงหน้าที่จะตั้งค่าในช่องป้อนข้อมูล
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
value | String | ค่าเริ่มต้นที่วางไว้ในอินพุตเป็นสตริงในหน่วยมิลลิวินาทีตั้งแต่ Epoch โดยจะแสดงเป็นสตริงในพารามิเตอร์การเรียกกลับของแบบฟอร์มเสมอ |
รีเทิร์น
Date — เครื่องมือเลือกนี้ใช้สำหรับการเชื่อมโยง
set
ตั้งค่าระดับการมองเห็นของวิดเจ็ต ค่าเริ่มต้นคือ `VISIBLE`
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
visibility | Visibility | Visibility ของวิดเจ็ต |
รีเทิร์น
Widget — ออบเจ็กต์สำหรับการเชื่อมโยง