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ızaurlFetchWhitelist
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 ancakhttps://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)