การสร้างอินเทอร์เฟซ Google ไดรฟ์

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

การเข้าถึง UI ของส่วนเสริม

คุณสามารถเปิดส่วนเสริม Google Workspace ได้ใน Google ไดรฟ์ หากไอคอนปรากฏใน ไอคอนทางด้านขวาของอินเทอร์เฟซผู้ใช้ไดรฟ์ ต ส่วนเสริมของ Google Workspace สามารถ กำหนดอินเทอร์เฟซของหน้าแรก อินเทอร์เฟซการเลือกรายการ หรือทั้งสองอย่าง

• หากผู้ใช้คลิกไอคอนส่วนเสริมขณะอยู่ใน Google ไดรฟ์ ส่วนเสริมจะดำเนินการ drive.homepageTrigger ที่เกี่ยวข้อง (หากมี) ฟังก์ชันนี้ สร้างและแสดงผลการ์ดหน้าแรก ไปยัง Google ไดรฟ์เพื่อแสดงผล หากไม่ใช่ drive.homepageTrigger มีการกำหนดฟังก์ชัน การ์ดหน้าแรกทั่วไปจะแสดงแทน
• หากผู้ใช้เลือกอย่างน้อย 1 รายการใน Google ไดรฟ์ แล้วคลิกส่วนเสริม หรือเลือกรายการต่างๆ ขณะที่ส่วนเสริมเปิดอยู่ ส่วนเสริมจะประมวลผล drive.onItemsSelectedTrigger บริบท (หากมี) ฟังก์ชันนี้จะสร้าง Google ไดรฟ์ของส่วนเสริม "รายการที่เลือก" ตามบริบท อินเทอร์เฟซ แล้วส่งกลับไปยัง Google ไดรฟ์เพื่อแสดงผล

การสร้างอินเทอร์เฟซส่วนเสริมของไดรฟ์

คุณสามารถสร้างอินเทอร์เฟซที่ขยาย Google ไดรฟ์ได้ โดยปฏิบัติตาม ขั้นตอน:

1. เลือกว่าต้องการให้ส่วนเสริมมีข้อมูลเฉพาะไดรฟ์หรือไม่ homepage รวมถึงตัดสินใจด้วยว่าคุณต้องการระบุอินเทอร์เฟซตามบริบทสำหรับเวลาที่ผู้ใช้ เลือกรายการในไดรฟ์
2. เพิ่ม addOns.common และ addOns.drive ช่องเพื่อ โปรเจ็กต์สคริปต์ส่วนเสริม ไฟล์ Manifest ซึ่งรวมถึง ต้องมีขอบเขตไดรฟ์
3. หากคุณระบุหน้าแรกสำหรับไดรฟ์โดยเฉพาะ ติดตั้งใช้งาน drive.homepageTrigger เพื่อสร้างอินเทอร์เฟซนี้ นอกจากนี้ คุณยังเลือกใช้ common.homepageTrigger ของโฮสต์ Google Workspace หลายรายการ
4. หากคุณจัดให้มีอินเทอร์เฟซการเลือกรายการตามบริบทของไดรฟ์ คุณต้อง ใช้ drive.onItemsSelectedTrigger ฟังก์ชันทริกเกอร์ตามบริบทเพื่อสร้างอินเทอร์เฟซนี้ โปรดดูอินเทอร์เฟซตามบริบทของไดรฟ์สำหรับรายการที่เลือก) เพื่อดูรายละเอียด
5. ใช้ฟังก์ชัน Callback ที่เกี่ยวข้องซึ่งจำเป็นต่อการตอบสนองคำสั่งของผู้ใช้ การโต้ตอบกับ UI เช่น การคลิกปุ่ม

หน้าแรกของไดรฟ์

Google ไดรฟ์รองรับการแสดงส่วนเสริมของ Google Workspace หน้าแรก หากต้องการแสดงหน้าแรกที่ใช้บ่อยของส่วนเสริมใน Google ไดรฟ์ โปรดตรวจสอบว่ามี เป็นช่อง addOns.drive ในไฟล์ Manifest ของส่วนเสริม

หรือเพิ่ม drive.homepageTrigger ลงในไฟล์ Manifest ของส่วนเสริมเพื่อระบุหน้าแรกสำหรับไดรฟ์โดยเฉพาะ

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

อินเทอร์เฟซตามบริบทของไดรฟ์สำหรับรายการที่เลือก

Google ไดรฟ์ใช้ทริกเกอร์ตามบริบทเพื่อกำหนดอินเทอร์เฟซ (หากมี) เพื่อแสดงเมื่อผู้ใช้เลือกรายการใน Google ไดรฟ์อย่างน้อย 1 รายการ เมื่อ ทริกเกอร์จะเริ่มทำงาน ทริกเกอร์จะเรียกใช้ฟังก์ชันทริกเกอร์ตามบริบทที่ระบุโดย drive.onItemsSelectedTrigger.runFunction ในไฟล์ Manifest ส่วนเสริม

หากต้องการสร้างอินเทอร์เฟซการเลือกรายการตามบริบทสำหรับไดรฟ์ คุณต้องดำเนินการต่อไปนี้ ดังต่อไปนี้:

1. ตรวจสอบว่าไฟล์ Manifest ของส่วนเสริมมี https://www.googleapis.com/auth/drive.addons.metadata.readonly ขอบเขต

2. ตรวจสอบว่าไฟล์ Manifest มี drive.onItemsSelectedTrigger

3. ใช้ฟังก์ชันที่มีชื่อใน drive.onItemsSelectedTrigger ด้วย ฟังก์ชันนี้ยอมรับออบเจ็กต์เหตุการณ์เป็นอาร์กิวเมนต์ และต้องส่งคอลัมน์ Card ออบเจ็กต์หรืออาร์เรย์ของ ออบเจ็กต์ Card รายการ

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

ออบเจ็กต์เหตุการณ์

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

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

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

หมายเหตุ: หากลักษณะการทำงานของส่วนเสริมจะใช้กับรายการที่เลือกหลายรายการ ใช้ข้อมูลที่ระบุไว้ใน drive.selectedItems ในออบเจ็กต์เหตุการณ์เพื่อระบุทั้งหมด

เมื่อส่วนเสริม ควรนำไปใช้กับรายการที่เลือกไว้รายการเดียวเท่านั้น ให้ใช้ข้อมูล ที่ระบุไว้ใน drive.activeCursorItem ของออบเจ็กต์เหตุการณ์เพื่อระบุรายการจาก ตัวเลือกทั้งหมด อย่าพยายามสรุปว่าจะใช้รายการใดจาก drive.selectedItems อาร์เรย์

ตัวอย่างต่อไปนี้แสดง ออบเจ็กต์เหตุการณ์ของไดรฟ์ ซึ่งส่งไปยัง drive.onItemsSelectedTrigger ฟังก์ชัน:

    {
      "commonEventObject": { ... },
      "drive": {
        "activeCursorItem":{
          "addonHasFileScopePermission": true,
          "id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
          "iconUrl": "https://drive-thirdparty.googleusercontent.com...",
          "mimeType":"application/pdf",
          "title":"How to get started with Drive"
        },
        "selectedItems": [
          {
            "addonHasFileScopePermission": true,
            "id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
            "iconUrl":"https://drive-thirdparty.googleusercontent.com...",
            "mimeType":"application/pdf",
            "title":"How to get started with Drive"
          },
          ...
        ]
      },
      ...
    }