يمكنك استخدام القوائم المسموح بها لتحديد عناوين URL محدّدة تمت الموافقة مسبقًا على الوصول إليها من خلال النص البرمجي أو الإضافة. تساعد القوائم المسموح بها في حماية بيانات المستخدمين، فعند تحديد قائمة مسموح بها، لا يمكن لمشاريع النصوص البرمجية الوصول إلى عناوين URL التي لم تتم إضافتها إلى القائمة المسموح بها.
يكون هذا الحقل اختياريًا عند تثبيت نشر تجريبي، ولكنه مطلوب عند إنشاء عملية نشر بإصدارات.
يمكنك استخدام القوائم المسموح بها عندما ينفِّذ النص البرمجي أو الإضافة الإجراءات التالية:
- يسترد أو يجلب المعلومات من موقع خارجي (مثل نقاط نهاية HTTPS) باستخدام خدمة برمجة التطبيقات
UrlFetch
. لإضافة عناوين URL إلى القائمة المسموح بها لجلبها، عليك تضمين الحقلurlFetchWhitelist
في ملف البيان. - يؤدي هذا الإجراء إلى فتح عنوان URL أو عرضه استجابةً لإجراء المستخدم (مطلوب
لإضافات Google Workspace التي تفتح أو تعرض عناوين URL الخارجية عن Google). لإضافة عناوين URL إلى القائمة المسموح بها للفتح، أدرِج الحقل
addOns.common.openLinkUrlPrefixes
في ملف البيان.
إضافة بادئات إلى القائمة المسموح بها
عند تحديد القوائم المسموح بها في ملف البيان (من خلال تضمين الحقل
addOns.common.openLinkUrlPrefixes
أو urlFetchWhitelist
)، يجب
تضمين قائمة ببادئات عناوين URL. يجب أن تستوفي البادئات التي تضيفها إلى البيان
المتطلبات التالية:
- يجب أن تكون كل بادئة عنوان 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
. لا يمكنك استخدام أكثر من حرف بدل واحد لمطابقة نطاقات فرعية متعددة،
ويجب أن يمثل حرف البدل البادئة البادئة لعنوان 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
(يجب توفُّر نطاق فرعي واحد على الأقل)
يتم فرض بعض قواعد البادئة عند محاولة حفظ البيان. على سبيل المثال، تتسبب البادئات التالية في حدوث خطأ إذا كانت موجودة في ملف البيان عند محاولة الحفظ:
https://*.*.example.com/foo
(يُحظر استخدام تعدد أحرف البدل)https://subdomain.*.example.com/foo
(يجب استخدام أحرف البدل كبادئة بادئة)