คุณใช้รายการที่อนุญาตเพื่อระบุ URL ที่เฉพาะเจาะจงซึ่งได้รับอนุมัติล่วงหน้าให้เข้าถึงได้ ตามสคริปต์หรือส่วนเสริมของคุณ รายการที่อนุญาตช่วยปกป้องผู้ใช้ data; เมื่อกำหนดรายการที่อนุญาต โปรเจ็กต์สคริปต์จะไม่มีสิทธิ์เข้าถึง URL ที่มี ไม่ได้อยู่ในรายการที่อนุญาต
ช่องนี้เป็นช่องที่ไม่บังคับเมื่อติดตั้งการทดสอบการทำให้ใช้งานได้ แต่ต้องระบุเมื่อ คุณสามารถสร้างการติดตั้งใช้งาน เวอร์ชันต่างๆ ได้
อนุญาตให้ใช้รายการที่อนุญาตเมื่อสคริปต์หรือส่วนเสริมทำงาน การดำเนินการต่อไปนี้
- ดึงหรือดึงข้อมูลจากตำแหน่งภายนอก (เช่น HTTPS
ปลายทาง) โดยใช้ Apps Script
UrlFetch
service. หากต้องการเพิ่ม 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
(ต้องใช้ไวลด์การ์ดเป็นคำนำหน้านำหน้า)