Za pomocą list dozwolonych możesz wskazać określone adresy URL, które są wstępnie zatwierdzone przez skrypt lub dodatek. Listy dozwolonych pomagają chronić dane użytkowników. Gdy zdefiniujesz listę dozwolonych, projekty skryptów nie będą miały dostępu do adresów URL, które nie znajdują się na tej liście.
To pole jest opcjonalne podczas instalowania wdrożenia testowego, ale jest wymagane podczas tworzenia wdrożenia z różnymi wersjami.
Z list dozwolonych możesz korzystać, gdy skrypt lub dodatek wykonuje te działania:
- Pobiera informacje z lokalizacji zewnętrznej (np. punktów końcowych HTTPS) przy użyciu usługi Apps Script
UrlFetch
. Aby dodać adresy URL do listy dozwolonych pobierania, umieść w pliku manifestu poleurlFetchWhitelist
. - Otwiera lub wyświetla adres URL w odpowiedzi na działanie użytkownika (wymagane w przypadku dodatków do Google Workspace, które otwierają lub wyświetlają adresy URL spoza Google). Aby dodać adresy URL do listy dozwolonych, które można otwierać, umieść w pliku manifestu pole
addOns.common.openLinkUrlPrefixes
.
Dodawanie prefiksów do listy dozwolonych
Gdy określasz listy dozwolonych w pliku manifestu (za pomocą pola addOns.common.openLinkUrlPrefixes
lub urlFetchWhitelist
), musisz uwzględnić listę prefiksów adresów URL. Prefiksy dodane do pliku manifestu muszą spełniać te wymagania:
- Każdy prefiks musi być prawidłowym adresem URL.
- W każdym prefiksie musi znajdować się
https://
, a niehttp://
. - Każdy prefiks musi zawierać pełną domenę.
- Każdy prefiks nie może mieć pustej ścieżki. Na przykład
https://www.google.com/
jest prawidłowy, alehttps://www.google.com
już nie. - Do prefiksów subdomen adresu URL możesz używać symboli wieloznacznych.
- W polu
addOns.common.openLinkUrlPrefixes
można użyć jednego symbolu wieloznacznego*
, aby dopasować wszystkie linki, ale nie jest to zalecane, ponieważ może narazić dane użytkownika na ryzyko i wydłużyć proces sprawdzania dodatków. Symbolu wieloznacznego używaj tylko wtedy, gdy jest to wymagane przez Twój dodatek.
Podczas określania, czy adres URL pasuje do prefiksu na liście dozwolonych, obowiązują te reguły:
- W dopasowywaniu ścieżki wielkość liter ma znaczenie.
- Jeśli prefiks jest identyczny z adresem URL, zostaje dopasowany.
- Jeśli URL jest taki sam lub podrzędny względem prefiksu, zostaje dopasowany.
Na przykład prefiks https://example.com/foo
pasuje do tych adresów URL:
https://example.com/foo
https://example.com/foo/
https://example.com/foo/bar
https://example.com/foo?bar
https://example.com/foo#bar
Korzystanie z symboli wieloznacznych
Za pomocą jednego symbolu wieloznacznego (*
) możesz dopasować subdomenę w polach urlFetchWhitelist
i addOns.common.openLinkUrlPrefixes
. Nie można użyć więcej niż jednego symbolu wieloznacznego, aby dopasować wiele subdomen, i musi on odzwierciedlać początkowy prefiks adresu URL.
Na przykład prefiks https://*.example.com/foo
pasuje do tych adresów URL:
https://subdomain.example.com/foo
https://any.number.of.subdomains.example.com/foo
Prefiks https://*.example.com/foo
nie pasuje do tych adresów URL:
https://subdomain.example.com/bar
(niezgodność sufiksu)https://example.com/foo
(musi istnieć co najmniej jedna subdomena)
Niektóre reguły prefiksu są wymuszane podczas zapisywania pliku manifestu. Na przykład te prefiksy powodują błąd, jeśli występują w manifeście podczas próby zapisania:
https://*.*.example.com/foo
(nie można używać wielu symboli wieloznacznych)https://subdomain.*.example.com/foo
(symbol wieloznaczny musi być na początku prefiksu)