อัปเกรดไฟล์แนบของลิงก์เป็นไฟล์แนบของส่วนเสริมของ Classroom

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

ภาพรวม

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

เมื่อครูตกลงที่จะอัปเกรดลิงก์ไปยังไฟล์แนบของส่วนเสริม ลิงก์ iframe การอัปเกรดจะเปิดขึ้นพร้อมพารามิเตอร์การค้นหาต่อไปนี้

  • courseId
  • itemId
  • itemType
  • addOnToken
  • urlToUpgrade
  • login_hint (ในกรณีที่ผู้ใช้ให้สิทธิ์แอปของคุณแล้วเท่านั้น)

พารามิเตอร์การค้นหา 4 รายการแรกจำลองพารามิเตอร์การค้นหาที่เปิดใน iframe การค้นพบไฟล์แนบ พารามิเตอร์การค้นหา urlToUpgrade เป็นพารามิเตอร์ใหม่และ ช่วยคุณประเมินว่าควรสร้างไฟล์แนบของส่วนเสริมอย่างไร จากนั้นคุณสามารถใช้ พารามิเตอร์การค้นหาอื่นๆ เพื่อตรวจสอบว่าผู้ใช้ลงชื่อเข้าใช้หรือไม่ และเรียกฟังก์ชัน CreateAddOnAttachment เมธอดสำหรับ courseWork, courseWorkMaterials หรือ announcements โดยอิงตามค่า itemType ใน iframe คุณสามารถ แสดงหน้าจอการโหลดเพื่อแจ้งให้ครูทราบว่าไฟล์แนบของส่วนเสริม กำลังสร้าง

เมื่อสร้างไฟล์แนบของส่วนเสริมแล้ว iframe จะปิดลงและ ครูสามารถดูไฟล์แนบในงานได้ตามปกติ

รายละเอียดการใช้งานทางเทคนิค

ส่วนนี้จะไฮไลต์รายละเอียดทางเทคนิคที่สำคัญสำหรับฟีเจอร์

อ่านพารามิเตอร์การค้นหา urlToUpgrade

พารามิเตอร์การค้นหา urlToUpgrade จะได้รับการเข้ารหัส URI เมื่อมีการส่งผ่านในลิงก์ อัปเกรด iframe คุณต้องถอดรหัส URL เพื่อให้ได้มาในรูปแบบเดิม ถ้า คุณใช้ JavaScript เช่น คุณสามารถใช้เมธอด decodeURIComponent() ให้ทำเช่นนั้นได้

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

รายละเอียดการกำหนดค่า

ต้องมีการกำหนดค่าต่อไปนี้เพื่อผสานรวมฟีเจอร์นี้เข้ากับ ส่วนเสริม:

  • URL สำหรับ iframe การอัปเกรดลิงก์: คือ URL ที่เปิดใน iframe เมื่อครูตกลงที่จะอัปเกรด

  • รูปแบบ URL ที่ Classroom ควรตรวจพบและพยายามดำเนินการ การอัปเกรด: รูปแบบ URL อาจประกอบด้วยโฮสต์และเส้นทางหลายเส้นทาง คำนำหน้า

    • คุณสามารถระบุรูปแบบ URL ได้หลายรูปแบบ
    • หากคุณไม่ใส่คำนำหน้าเส้นทาง URL ที่ตรงกับโฮสต์ สามารถอัปเกรดได้
    • อัปเกรดได้เฉพาะ URL ที่มีรูปแบบ https เท่านั้น
    • รูปแบบ URL ต้องไม่มี localhost
    • คำนำหน้าเส้นทางต้องไม่มีพารามิเตอร์การค้นหาหรือส่วนย่อยของ URL
    • ในขณะนี้ คำนำหน้าเส้นทางรองรับไวลด์การ์ดได้ แต่โฮสต์จะทำสิ่งต่อไปนี้ไม่ได้
      • example.com เป็นโฮสต์ที่ถูกต้อง และ /foo และ /bar/*/baz เป็นคำนำหน้าเส้นทางที่ถูกต้อง
      • example.*.host.com ไม่ใช่ โฮสต์ได้
    • ไวลด์การ์ดระหว่างคอมโพเนนต์คำนำหน้าเส้นทางจะตรงกับองค์ประกอบเดียวเท่านั้น คอมโพเนนต์เดียว และไม่ตรงกับคอมโพเนนต์หลายรายการที่คั่นด้วยเครื่องหมายทับ ลองใช้รูปแบบ URL ที่มีโฮสต์ example.com และคำนำหน้าเส้นทาง /bar/*/baz:
      • https://example.com/bar/123/baz ตรงกับ URL ที่ถูกต้อง รูปแบบ
      • https://example.com/bar/123/baz/456/789 ตรงกับ รูปแบบ URL
      • https://example.com/bar/123/456/baz ไม่ใช่การจับคู่ที่ถูกต้องสำหรับฟิลด์ รูปแบบ URL เนื่องจากไวลด์การ์ดในคำนำหน้าเส้นทางไม่ตรงกัน /123/456/

ขั้นตอนการพัฒนา

ส่ง URL ของ iframe และรูปแบบ URL ของการอัปเกรดลิงก์สำหรับการทดสอบหรือการใช้งานจริง โดยส่งอีเมลหา classroom-link-upgrade-external@google.com

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

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

จัดรูปแบบอีเมลให้รวมข้อมูลต่อไปนี้

Google Cloud Project number: GCP_PROJECT_NUMBER

Link Upgrade iframe URL: LINK_UPGRADE_IFRAME_URL

URL Patterns:
-   Host:HOST_1
-   Path prefixes:
  -   PATH_PREFIX_1
  -   PATH_PREFIX_2

-   Host:HOST_2
-   Path prefixes:
  -   PATH_PREFIX_3
  -   PATH_PREFIX_4

// add more hosts and path prefixes as needed

แทนที่ค่าต่อไปนี้

  • GCP_PROJECT_NUMBER: จำนวนโปรเจ็กต์ Google Cloud ที่เชื่อมโยงกับส่วนเสริมนั้นอยู่
  • LINK_UPGRADE_IFRAME_URL: URL ที่ควรเปิดใน iframe การอัปเกรดลิงก์
  • HOST_1: โฮสต์ที่ Classroom ควรตรวจพบ เฉพาะ รองรับชุดรูปแบบ https
  • PATH_PREFIX_1 และ PATH_PREFIX_2: เส้นทาง คำนำหน้าที่เชื่อมโยงกับ HOST_1 ที่ Classroom ควรตรวจพบและพยายามดำเนินการ เพื่ออัปเกรด
  • HOST_2: โฮสต์ที่ Classroom ควรตรวจพบ เฉพาะ รองรับชุดรูปแบบ https
  • PATH_PREFIX_3 และ PATH_PREFIX_4: เส้นทาง คำนำหน้าที่เชื่อมโยงกับ HOST_2 ที่ Classroom ควรตรวจพบและพยายามดำเนินการ เพื่ออัปเกรด

ต่อไปนี้คือคำแนะนำที่ควรพิจารณาเมื่อใช้ฟีเจอร์นี้

หลีกเลี่ยงงานเพิ่มสำหรับครู

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

ใส่ข้อความแสดงข้อผิดพลาดในการเข้าถึงที่ใช้งานง่าย

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