คุณใช้รายการที่อนุญาตเพื่อระบุ URL ที่เจาะจงซึ่งได้รับอนุมัติล่วงหน้าจากสคริปต์หรือส่วนเสริมให้เข้าถึงได้ รายการที่อนุญาตจะช่วยปกป้องข้อมูลผู้ใช้ เมื่อคุณกำหนดรายการที่อนุญาต โปรเจ็กต์สคริปต์จะเข้าถึง URL ที่ไม่ได้อยู่ในรายการที่อนุญาตไม่ได้
ช่องนี้ไม่บังคับเมื่อติดตั้งการทดสอบการทำให้ใช้งานได้ แต่จะต้องระบุเมื่อคุณสร้างการทำให้ใช้งานได้ที่มีเวอร์ชัน
คุณจะใช้รายการที่อนุญาตเมื่อสคริปต์หรือส่วนเสริมทำสิ่งต่อไปนี้ได้
- ดึงหรือดึงข้อมูลจากตำแหน่งภายนอก (เช่น ปลายทาง HTTPS) โดยใช้บริการ Apps Script
UrlFetch
หากต้องการเพิ่ม URL ลงในรายการที่อนุญาตสำหรับการดึงข้อมูล ให้ใส่ช่องurlFetchWhitelist
ในไฟล์ Manifest - เปิดหรือแสดง URL เพื่อตอบกลับการดำเนินการของผู้ใช้ (จำเป็นสำหรับส่วนเสริม Google Workspace ที่เปิดหรือแสดง URL ที่อยู่ภายนอก Google) หากต้องการเพิ่ม URL ในรายการที่อนุญาตสำหรับการเปิด ให้ใส่ช่อง
addOns.common.openLinkUrlPrefixes
ในไฟล์ Manifest
การเพิ่มคำนำหน้าลงในรายการที่อนุญาต
เมื่อระบุรายการที่อนุญาตในไฟล์ Manifest (โดยรวมช่อง addOns.common.openLinkUrlPrefixes
หรือ urlFetchWhitelist
) คุณจะต้องใส่รายการคำนำหน้า URL ด้วย คำนำหน้าที่คุณเพิ่มลงในไฟล์ Manifest ต้องเป็นไปตามข้อกำหนดต่อไปนี้
- คำนำหน้าแต่ละรายการต้องเป็น URL ที่ถูกต้อง
- คำนำหน้าแต่ละรายการต้องใช้
https://
ไม่ใช่http://
- คำนำหน้าแต่ละรายการต้องมีโดเมนแบบเต็ม
- คำนำหน้าแต่ละรายการต้องมีเส้นทางที่ไม่ว่างเปล่า ตัวอย่างเช่น
https://www.google.com/
ใช้ได้ แต่https://www.google.com
ไม่ถูกต้อง - คุณใช้ไวลด์การ์ดเพื่อจับคู่คำนำหน้าโดเมนย่อยของ URL ได้
- คุณจะใช้ไวลด์การ์ด
*
รายการเดียวในช่องaddOns.common.openLinkUrlPrefixes
เพื่อจับคู่ลิงก์ทั้งหมดก็ได้ แต่เราไม่แนะนำให้ทำเช่นนี้เนื่องจากอาจทำให้ข้อมูลผู้ใช้มีความเสี่ยงและจะทำให้กระบวนการตรวจสอบส่วนเสริมใช้เวลานานขึ้น โปรดใช้ไวลด์การ์ดในกรณีที่ฟังก์ชันของส่วนเสริมกำหนดให้ใช้เท่านั้น
กฎต่อไปนี้จะใช้เมื่อตัดสินว่า URL ตรงกับคำนำหน้าในรายการที่อนุญาตหรือไม่
- การจับคู่เส้นทางคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
- หากคำนำหน้าเหมือนกันกับ URL แสดงว่าเป็นการจับคู่
- หาก URL เหมือนกันหรือเป็น URL ย่อยของคำนำหน้า แสดงว่าเป็นรายการที่ตรงกัน
ตัวอย่างเช่น คำนำหน้า https://example.com/foo
ตรงกับ URL ต่อไปนี้
https://example.com/foo
https://example.com/foo/
https://example.com/foo/bar
https://example.com/foo?bar
https://example.com/foo#bar
การใช้ไวลด์การ์ด
คุณสามารถใช้อักขระไวลด์การ์ดเดี่ยว (*
) เพื่อจับคู่โดเมนย่อยสำหรับทั้งช่อง urlFetchWhitelist
และ addOns.common.openLinkUrlPrefixes
ได้ คุณใช้ไวลด์การ์ดมากกว่า 1 ตัวในการจับคู่โดเมนย่อยหลายรายการไม่ได้ และไวลด์การ์ดต้องนำหน้า URL นำหน้า
เช่น คำนำหน้า https://*.example.com/foo
จะตรงกับ URL ต่อไปนี้
https://subdomain.example.com/foo
https://any.number.of.subdomains.example.com/foo
คำนำหน้า https://*.example.com/foo
ไม่ตรงกับ URL ต่อไปนี้
https://subdomain.example.com/bar
(คำต่อท้ายไม่ตรงกัน)https://example.com/foo
(ต้องมีโดเมนย่อยอย่างน้อย 1 รายการ)
มีการบังคับใช้กฎคำนำหน้าบางข้อเมื่อคุณพยายามบันทึกไฟล์ Manifest ตัวอย่างเช่น คำนำหน้าต่อไปนี้ทำให้เกิดข้อผิดพลาดหากปรากฏในไฟล์ Manifest เมื่อคุณพยายามบันทึก
https://*.*.example.com/foo
(ห้ามใช้ไวลด์การ์ดหลายรายการ)https://subdomain.*.example.com/foo
(ไวลด์การ์ดต้องใช้เป็นคำนำหน้านำหน้า)