عناوين URL المدرَجة في القائمة المسموح بها

يمكنك استخدام القوائم المسموح بها لتحديد عناوين 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 (يجب استخدام أحرف البدل كبادئة)