İzin Verilenler Listesi URL'leri

Komut dosyanız veya eklentiniz tarafından erişim için önceden onaylanan belirli URL'leri tanımlamak için izin verilenler listelerini kullanırsınız. İzin verilenler listeleri kullanıcı verilerinin korunmasına yardımcı olur. İzin verilenler listesi tanımladığınızda komut dosyası projeleri, izin verilenler listesine eklenmemiş URL'lere erişemez.

Bu alan, bir test dağıtımı yüklerken isteğe bağlıdır ancak sürümü olan bir dağıtım oluşturduğunuzda zorunludur.

Komut dosyanız veya eklentiniz aşağıdaki işlemleri gerçekleştirirken izin verilenler listeleri kullanırsınız:

  • Apps Komut Dosyası UrlFetch hizmetini kullanarak harici bir konumdan (HTTPS uç noktaları gibi) bilgi alır veya getirir. Getirmek üzere URL'leri izin verilenler listesine eklemek için manifest dosyanıza urlFetchWhitelist alanını ekleyin.
  • Kullanıcı işlemine yanıt olarak bir URL açar veya gösterir (Google'ın dışındaki görünen URL'leri açan veya görünen Google Workspace Eklentileri için gereklidir). URL'leri açmak üzere izin verilenler listesine eklemek için manifest dosyanıza addOns.common.openLinkUrlPrefixes alanını ekleyin.

İzin verilenler listenize ön ek ekleme

Manifest dosyanızda izin verilenler listeleri belirttiğinizde (addOns.common.openLinkUrlPrefixes veya urlFetchWhitelist alanını ekleyerek) URL öneklerinin listesini eklemeniz gerekir. Manifest'e eklediğiniz ön ekler aşağıdaki koşulları karşılamalıdır:

  • Her önek geçerli bir URL olmalıdır.
  • Her ön ek için http:// değil, https:// kullanılmalıdır.
  • Her önek, tam alan adına sahip olmalıdır.
  • Her ön ekin boş olmayan bir yolu olmalıdır. Örneğin, https://www.google.com/ geçerlidir ancak https://www.google.com geçerli değildir.
  • URL alt alan adı öneklerini eşleştirmek için joker karakterler kullanabilirsiniz.
  • Tüm bağlantıları eşleştirmek için addOns.common.openLinkUrlPrefixes alanında tek bir * joker karakteri kullanılabilir. Ancak bu, kullanıcının verilerini riske atabileceği ve eklenti incelemesi sürecini uzatabileceği için önerilmez. Joker karakterleri yalnızca eklenti işlevselliğiniz için gerekiyorsa kullanın.

Bir URL'nin izin verilenler listesindeki bir ön ekle eşleşip eşleşmediğini belirlerken aşağıdaki kurallar geçerli olur:

  • Yol eşleştirme büyük/küçük harfe duyarlıdır.
  • Önek, URL ile aynıysa eşleşmedir.
  • URL, ön ekin aynı veya bir alt öğesiyse eşleşmedir.

Örneğin, https://example.com/foo öneki aşağıdaki URL'lerle eşleşir:

  • https://example.com/foo
  • https://example.com/foo/
  • https://example.com/foo/bar
  • https://example.com/foo?bar
  • https://example.com/foo#bar

Joker karakter kullanma

Hem urlFetchWhitelist hem de addOns.common.openLinkUrlPrefixes alanları için alt alan adlarını eşleştirmek üzere tek bir joker karakter (*) kullanabilirsiniz. Birden çok alt alan adını eşleştirmek için birden fazla joker karakter kullanamazsınız. Joker karakter, URL'nin başındaki ön eki temsil etmelidir.

Örneğin, https://*.example.com/foo öneki aşağıdaki URL'lerle eşleşir:

  • https://subdomain.example.com/foo
  • https://any.number.of.subdomains.example.com/foo

https://*.example.com/foo öneki aşağıdaki URL'lerle eşleşmez:

  • https://subdomain.example.com/bar (sonek uyuşmazlığı)
  • https://example.com/foo (en az bir alt alan adı olmalıdır)

Manifest dosyanızı kaydetmeye çalışırken önek kurallarından bazıları zorunlu kılınır. Örneğin, aşağıdaki önekler kaydetmeye çalıştığınızda manifestinizde varsa hataya neden olur:

  • https://*.*.example.com/foo (birden fazla joker karakter kullanılamaz)
  • https://subdomain.*.example.com/foo (baştaki önek olarak joker karakterler kullanılmalıdır)