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