يمكنك استخدام القوائم المسموح بها لتحديد عناوين URL محدّدة تمت الموافقة مسبقًا على وصولها من خلال النص البرمجي أو الإضافة. تساعد القوائم المسموح بها في حماية بيانات المستخدمين، فعند تحديد قائمة مسموح بها، لا يمكن لمشاريع النصوص البرمجية الوصول إلى عناوين URL غير المدرَجة في القائمة المسموح بها.
يُعدّ هذا الحقل اختياريًا عند تثبيت نشر تجريبي، ولكنّه مطلوب عند إنشاء عملية نشر متعدّدة الإصدارات.
يتم استخدام القوائم المسموح بها عندما ينفِّذ النص البرمجي أو الإضافة الإجراءات التالية:
- يسترد أو يجلب المعلومات من موقع خارجي (مثل نقاط نهاية HTTPS) باستخدام خدمة
"برمجة تطبيقات Google"
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 هو نفسه أو عنصر ثانوي للبادئة، يكون العنوان مطابقًا.
على سبيل المثال، تتطابق البادئة 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
(يجب استخدام أحرف البدل كبادئة)