İzin Verilenler Listesi URL'leri

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

Bu alan, test dağıtımı yüklediğinizde isteğe bağlıdır ancak sürümlü dağıtım oluşturduğunuzda gereklidir.

Komut dosyanız veya eklentiniz aşağıdaki işlemleri gerçekleştirdiğinde izin verilenler listelerini 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 dosyasına eklediğiniz ön ekler aşağıdaki koşulları karşılamalıdır:

  • Her ön ek 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ı ön eklerini 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. Yalnızca eklenti işleviniz gerektiriyorsa joker karakter 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ştirmesi büyük/küçük harfe duyarlıdır.
  • Önek, URL ile aynıysa eşleşmedir.
  • URL aynıysa veya ön ekin alt öğesiyse eşleşme vardır.

Ö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ştaki ön ekini 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 (ek uyuşmazlığı)
  • https://example.com/foo (en az bir alt alan adı bulunmalıdır)

Ön ek kurallarının bazıları, manifest dosyanızı kaydetmeye çalıştığınızda uygulanır. Örneğin, kaydetmeye çalıştığınızda manifest dosyanızda aşağıdaki ön ekler varsa hata oluşur:

  • https://*.*.example.com/foo (birden fazla joker karakter kullanılamaz)
  • https://subdomain.*.example.com/foo (joker karakterler, ön ek olarak kullanılmalıdır)