การดําเนินการในปฏิทิน

ออบเจ็กต์ Action ช่วยให้คุณสร้างลักษณะการทำงานแบบอินเทอร์แอกทีฟ ในส่วนเสริมของ Google Workspace ได้ โดยจะกำหนด สิ่งที่เกิดขึ้นเมื่อผู้ใช้โต้ตอบกับวิดเจ็ต (เช่น ปุ่ม) ใน UI ของส่วนเสริม

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

เช่น สมมติว่าคุณต้องการปุ่มที่สร้างและแสดงการ์ดใหม่เมื่อ คลิก โดยคุณต้องสร้างวิดเจ็ตปุ่มใหม่และใช้ฟังก์ชันตัวแฮนเดิลวิดเจ็ตปุ่ม setOnClickAction(action) เพื่อตั้งค่าActionการสร้างการ์ด Action ที่คุณกำหนดจะระบุฟังก์ชันเรียกกลับของ Apps Script ซึ่งจะทำงานเมื่อมีการคลิกปุ่ม ในกรณีนี้ คุณ จะใช้ฟังก์ชันเรียกกลับเพื่อสร้างการ์ดที่ต้องการและแสดงผลออบเจ็กต์ ActionResponse ออบเจ็กต์การตอบกลับจะบอกให้ส่วนเสริมแสดงการ์ดที่ฟังก์ชัน การเรียกกลับสร้างขึ้น

หน้านี้จะอธิบายการดำเนินการของวิดเจ็ตที่เฉพาะเจาะจงของปฏิทินที่คุณสามารถรวมไว้ในส่วนเสริมได้

การโต้ตอบกับ Google ปฏิทิน

ส่วนเสริม Google Workspace ที่ขยายปฏิทินสามารถรวมการดำเนินการของวิดเจ็ตที่เจาะจงปฏิทินเพิ่มเติมได้ การดำเนินการเหล่านี้ต้องใช้ฟังก์ชันเรียกกลับของ การดำเนินการที่เชื่อมโยง เพื่อส่งคืนออบเจ็กต์การตอบกลับเฉพาะทาง

การดำเนินการที่พยายาม	ฟังก์ชัน Callback ควรแสดงผล
การเพิ่มผู้เข้าร่วม	CalendarEventActionResponse
การตั้งค่าข้อมูลการประชุม	CalendarEventActionResponse
การเพิ่มไฟล์แนบ	CalendarEventActionResponse

หากต้องการใช้การดำเนินการของวิดเจ็ตและออบเจ็กต์การตอบกลับเหล่านี้ สิ่งต่อไปนี้ทั้งหมดต้องเป็นจริง

• ระบบจะทริกเกอร์การดำเนินการขณะที่ผู้ใช้เปิดกิจกรรมในปฏิทิน
• ฟิลด์ไฟล์ Manifest ของส่วนเสริม Google Workspace addOns.calendar.currentEventAccess ตั้งค่าเป็น WRITE หรือ READ_WRITE
• ส่วนเสริมมี https://www.googleapis.com/auth/calendar.addons.current.event.write ขอบเขตปฏิทิน

ระบบจะไม่บันทึกการเปลี่ยนแปลงที่ฟังก์ชันการเรียกกลับของการดำเนินการทำจนกว่าผู้ใช้จะบันทึก กิจกรรมในปฏิทิน

เพิ่มผู้เข้าร่วมด้วยฟังก์ชันการเรียกกลับ

ตัวอย่างต่อไปนี้แสดงวิธีสร้างปุ่มที่เพิ่มผู้เข้าร่วมที่เฉพาะเจาะจง ลงในกิจกรรมในปฏิทินที่กำลังแก้ไข ตัวอย่างนี้ใช้โครงสร้างการ์ดพื้นฐาน ดังนี้

/**
 * Build a basic card with a button that sends a notification.
 * This function is called as part of the eventOpenTrigger that builds
 * a UI when the user opens an event.
 *
 * @param e The event object passed to eventOpenTrigger function.
 * @return {Card}
 */
function buildSimpleCard(e) {
  var buttonAction = CardService.newAction()
      .setFunctionName('onAddAttendeesButtonClicked');
  var button = CardService.newTextButton()
      .setText('Add new attendee')
      .setOnClickAction(buttonAction);

  // Check the event object to determine if the user can add
  // attendees and disable the button if not.
  if (!e.calendar.capabilities.canAddAttendees) {
    button.setDisabled(true);
  }

  // ...continue creating card sections and widgets, then create a Card
  // object to add them to. Return the built Card object.
}

/**
 * Callback function for a button action. Adds attendees to the
 * Calendar event being edited.
 *
 * @param {Object} e The action event object.
 * @return {CalendarEventActionResponse}
 */
function onAddAttendeesButtonClicked (e) {
  return CardService.newCalendarEventActionResponseBuilder()
      .addAttendees(["[e-mail]", "[e-mail]"])
      .build();
}

ตั้งค่าข้อมูลการประชุมด้วยฟังก์ชันการเรียกกลับ

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

ตัวอย่างต่อไปนี้แสดงวิธีสร้างปุ่มที่ตั้งค่าข้อมูลการประชุมสำหรับ กิจกรรมที่กำลังแก้ไข

/**
 * Build a basic card with a button that sends a notification.
 * This function is called as part of the eventOpenTrigger that builds
 * a UI when the user opens a Calendar event.
 *
 * @param e The event object passed to eventOpenTrigger function.
 * @return {Card}
 */
function buildSimpleCard(e) {
  var buttonAction = CardService.newAction()
      .setFunctionName('onSaveConferenceOptionsButtonClicked')
      .setParameters(
        {'phone': "1555123467", 'adminEmail': "[e-mail]"});
  var button = CardService.newTextButton()
      .setText('Add new attendee')
      .setOnClickAction(buttonAction);

  // Check the event object to determine if the user can set
  // conference data and disable the button if not.
  if (!e.calendar.capabilities.canSetConferenceData) {
    button.setDisabled(true);
  }

  // ...continue creating card sections and widgets, then create a Card
  // object to add them to. Return the built Card object.
}

/**
 * Callback function for a button action. Sets conference data for the
 * Calendar event being edited.
 *
 * @param {Object} e The action event object.
 * @return {CalendarEventActionResponse}
 */
function onSaveConferenceOptionsButtonClicked(e) {
  var parameters = e.commonEventObject.parameters;

  // Create an entry point and a conference parameter.
  var phoneEntryPoint = ConferenceDataService.newEntryPoint()
    .setEntryPointType(ConferenceDataService.EntryPointType.PHONE)
    .setUri('tel:' + parameters['phone']);

  var adminEmailParameter = ConferenceDataService.newConferenceParameter()
      .setKey('adminEmail')
      .setValue(parameters['adminEmail']);

  // Create a conference data object to set to this Calendar event.
  var conferenceData = ConferenceDataService.newConferenceDataBuilder()
      .addEntryPoint(phoneEntryPoint)
      .addConferenceParameter(adminEmailParameter)
      .setConferenceSolutionId('myWebScheduledMeeting')
      .build();

  return CardService.newCalendarEventActionResponseBuilder()
      .setConferenceData(conferenceData)
      .build();
}

เพิ่มไฟล์แนบด้วยฟังก์ชันเรียกกลับ

ตัวอย่างต่อไปนี้แสดงวิธีสร้างปุ่มที่จะเพิ่มไฟล์แนบใน กิจกรรมในปฏิทินที่กำลังแก้ไข

/**
 * Build a basic card with a button that creates a new attachment.
 * This function is called as part of the eventAttachmentTrigger that
 * builds a UI when the user goes through the add-attachments flow.
 *
 * @param e The event object passed to eventAttachmentTrigger function.
 * @return {Card}
 */
function buildSimpleCard(e) {
  var buttonAction = CardService.newAction()
      .setFunctionName('onAddAttachmentButtonClicked');
  var button = CardService.newTextButton()
      .setText('Add a custom attachment')
      .setOnClickAction(buttonAction);

  // Check the event object to determine if the user can add
  // attachments and disable the button if not.
  if (!e.calendar.capabilities.canAddAttachments) {
    button.setDisabled(true);
  }

  // ...continue creating card sections and widgets, then create a Card
  // object to add them to. Return the built Card object.
}

/**
 * Callback function for a button action. Adds attachments to the
 * Calendar event being edited.
 *
 * @param {Object} e The action event object.
 * @return {CalendarEventActionResponse}
 */
function onAddAttachmentButtonClicked(e) {
  return CardService.newCalendarEventActionResponseBuilder()
           .addAttachments([
             CardService.newAttachment()
               .setResourceUrl("https://example.com/test")
               .setTitle("Custom attachment")
               .setMimeType("text/html")
               .setIconUrl("https://example.com/test.png")
           ])
      .build();
}

ตั้งค่าไอคอนไฟล์แนบ

ไอคอนไฟล์แนบต้องโฮสต์บนโครงสร้างพื้นฐานของ Google ดูรายละเอียดได้ที่ ระบุไอคอนไฟล์แนบ