Proces sprawdzania aplikacji i wymagania dotyczące Google Workspace Marketplace

• Przyciski do komunikacji z aplikacją są dostępne w opisie.
• Nazwa aplikacji zaczyna się od litery A–Z (wielkie litery) lub cyfry 0–9. Nie może zaczynać się od symbolu.

• Aplikacja wysyła niepotwierdzoną wiadomość powitalną za każdym razem, gdy użytkownik rozpocznie czat lub aplikacja zostanie dodana do pokoju. Wiadomość powitalna różni się od polecenia „Pomoc”. Więcej informacji znajdziesz w artykule Tworzenie strony głównej aplikacji Google Chat.
• Aplikacja obsługuje polecenie „Pomoc” i ułatwia użytkownikom rozpoczęcie korzystania z aplikacji. Więcej informacji znajdziesz w artykule Odpowiedzi na znaki slash.
• Aplikacja zawsze odpowiada, gdy mówisz w pokoju lub czacie bezpośrednim.
• Wiadomości muszą być napisane poprawną pisownią, z odpowiednim użyciem wielkich liter, znaków interpunkcyjnych i gramatyki. Nie mogą zawierać materiałów szkodliwych, obraźliwych ani zniesławiających.
• Wiadomości muszą zawierać tekst lub karty o jasnym, zwięzłym i spójnym formacie zgodnie z wymaganiami Google.
• Jeśli odpowiedź zajmie więcej niż 2 sekundy, aplikacja wyśle wiadomość z wyjaśnieniem opóźnienia.
• Aplikacje, które wysyłają powiadomienia, umożliwiają użytkownikom wyłączenie powiadomień.
• Użytkownicy mogą dodać aplikację do pokoju za pomocą @wzmianki.
• Użytkownicy mogą usunąć aplikację z pokoju za pomocą menu Wyświetl uczestnika.
• Aplikacja informuje użytkownika o wszystkim, co jest potrzebne do interakcji z aplikacją.
• Format kart używany w aplikacji spełnia wymagania Google. Zobacz Tworzenie kart interaktywnych.
• Aplikację można znaleźć w opcji Znajdź aplikacje w menu Google Chat.
• Zewnętrzne adresy URL, z którymi aplikacja wchodzi w interakcję, nie należą do środowiska przejściowego ani programistycznego.
• @wzmianka jest wymagana w każdej wiadomości do aplikacji w pokojach. Jest to jedyny sposób, w jaki aplikacja wie, że musi zareagować.
• Jeśli aplikacja Google Chat wyświetla podgląd linków z domeny innej firmy:
  • Podgląd linku zawiera przydatne, dodatkowe informacje do wiadomości użytkownika. Na przykład wyświetlenie podglądu linku do umowy sprzedaży powoduje dodanie informacji takich jak konto, kwota i etap.
  • Deweloper jest powiązany z domeną wyświetlaną w podglądzie.

  Więcej informacji znajdziesz w artykule Podgląd linków.

• (zalecane) Aby umożliwić administratorom Google Workspace instalowanie Twojej aplikacji w imieniu użytkowników w organizacji, aplikacja musi mieć możliwość wysyłania i odbierania wiadomości na czacie.

• Aplikacja ma rozpoznawalny i czytelny awatar.

• Aplikacja nie korzysta z rozszerzeń przeglądarki Chrome do obsługi funkcji poprzez bezpośrednią manipulację kodem HTML Dysku.
• Jeśli Twoja aplikacja korzysta z zakresów wrażliwych lub z ograniczeniem, musi przejść weryfikację OAuth. Dowiedz się, jak przesłać prośbę o weryfikację.
• Jeśli aplikacja korzysta z zakresów z ograniczeniami, musi przejść ocenę bezpieczeństwa. Zapoznaj się z artykułem Dlaczego potrzebna jest ocena bezpieczeństwa.

• Jeśli aplikacja przechowuje pliki na Dysku, umożliwia użytkownikom wybranie folderu lub tworzy i ponowne użycie folderu konkretnej aplikacji. Dane konfiguracji mogą być przechowywane w folderze danych aplikacji. Aplikacja nie przenosi plików do folderu Mój dysk użytkownika.
• Aplikacja przechowuje na Dysku tylko pliki związane z dokumentowaną funkcją aplikacji.

• Dodatek zawiera oczekiwane i wymagane działania oraz wszystkie narzędzia niezbędne do wykonania przepływu pracy. Na przykład:
  • Jeśli wtyczka stosuje stylizację do całego dokumentu, możesz wybrać opcję zastosowania stylizacji tylko do wybranego tekstu.
  • Jeśli dodatek przesyła dane arkusza kalkulacyjnego do pliku danych usługi internetowej, zawiera on link do tego pliku, aby ułatwić nawigację.
  • Jeśli wtyczka wymaga, aby użytkownik miał konto, udostępnia linki lub informacje, które ułatwiają utworzenie konta, jeśli użytkownik go nie ma.
• Dodatek ma elementy menu na karcie dodatki.
• Nawet jeśli dodatek jest tylko funkcjami niestandardowymi, nadal zawiera odpowiednią dokumentację.
• Dodatek prawidłowo wypełnia menu za pomocą funkcji onInstall() i onOpen(). Pozycje menu zapełniają się podczas instalowania dodatku i otwierania innego pliku. Zobacz autoryzację dodatku Edytor.
• Tryby autoryzacji są prawidłowo skonfigurowane. Zobacz Tryby autoryzacji.
• Dodatek musi być zaimplementowany w środowisku wykonawczym Apps Script w wersji V8. Więcej informacji znajdziesz w omówieniu środowiska wykonawczego V8.

• W dodatku znajdują się wszystkie informacje potrzebne do podstawowego zrozumienia produktu i sposobów jego wykorzystania.
• Kod dodatku nie używa nadmiernie bibliotek, ponieważ mogą one obniżać wydajność dodatku.
• Błędy są unikane, a jeśli to niemożliwe, są odpowiednio zarządzane:
  • Komunikaty o błędach są wyświetlane w oknie dialogowym, a nie w alertach JavaScript ani na domyślnym czerwonym pasku. informują o problemie i opisują, co użytkownik musi zrobić, aby go rozwiązać, w prosty sposób;
  • Jeśli użytkownik robi coś nie tak, wyświetla się przycisk, który pozwala rozwiązać problem.
  • Więcej informacji znajdziesz w przewodniku stylów dodatków.
• Linki do stron zewnętrznych otwierają się w nowych oknach i są prawidłowe.
• Dodatek jest intuicyjny i dobrze zaprojektowany. Oznacza to, że:
  • Zawsze wiadomo, co i jak należy zrobić.
  • Wtyczka jest dostępna i łatwa do zrozumienia. Należy unikać terminów technicznych i żargonu.
  • Przepływy pracy są jasne i w jak największym stopniu ułatwione.
  • Użytkownik i jego treści są w jak największym stopniu chronieni.
• Dodatek jest zgodny z  przewodnikiem po stylu interfejsu użytkownika dotyczącym dodatków do edytora i korzysta z  pakietu CSS dla dodatków do edytora.
• Dodatek używa tylko 1 niebieskiego głównego działania na wyświetlacz.
• Dodatek wyświetla jedno okno naraz. Nie nakłada się na inne okna ani nie otwiera kilku okien jednocześnie.
• Interfejs dodatku ściśle mieści się w przydzielonych obszarach:
  • Tekst i etykiety nie są obcinane przez „…”
  • Użytkownik nie musi zbyt często przewijać w poziomie.
  • Szerokość treści nie przekracza 300 p, dlatego nie ma poziomego paska przewijania.
• Dodatek wymaga potwierdzenia lub wyświetla ostrzeżenia w przypadku wszystkich działań związanych z danymi poufnymi. Jeśli na przykład dodatek ma zastąpić wszystkie treści w arkuszu kalkulacyjnym, użytkownik zostanie o tym ostrzeżony i będzie musiał potwierdzić tę czynność.

  Możesz uniknąć tego wymagania, wprowadzając zmiany w projektie. Na przykład dodatek do Arkuszy Google, który importuje dane, stwarza ryzyko zastąpienia istniejących treści. Możesz usunąć ryzyko, tworząc arkusz danych jako domyślne działanie.

• Użytkownicy nie mogą aktywować działań wielokrotnie podczas wczytywania działania. Podczas wczytywania działania przyciski są na przykład wyłączone lub ukryte.

Dodatki do Kalendarza

• Jeśli dodatek używa calendar.name lub common.name, nazwa w pliku manifestu jest identyczna z nazwą podaną w informacjach o aplikacji.
• Jeśli dodatek używa calendar.conferenceSolution, nazwa rozwiązania do obsługi konferencji nie zawiera słowa „Kalendarz Google”.
• (zalecane) Jeśli dodatek korzysta z calendar.conferenceSolution, nazwa rozwiązania konferencyjnego nie może przekraczać 30 znaków.

• Dodatek używa odpowiednich widżetów (lub interfejsu iframe w dodatkach do Meet) do obsługi wybranej funkcji. Użyj na przykład przełącznika do wybrania wartości logicznej.

Dodatki do Kalendarza

• Kalendarze pomocnicze i przekazywanie obowiązków są obsługiwane, a jeśli nie są obsługiwane, są zarządzane w łagodny sposób. Na przykład tworzenie konferencji nie zakończy się niepowodzeniem, jeśli użytkownik podczas tworzenia wydarzenia wybierze inny kalendarz, do którego ma uprawnienia do edycji.
• Wydarzenia cykliczne działają prawidłowo.
• Jeśli dodatek używa calendar.conferenceSolution, musi zawierać co najmniej 1 rozwiązanie do obsługi rozmów wideo.
• Jeśli dodatek udostępnia rozwiązania do rozmów wideo, używane są odpowiednie pola danych rozmów wideo. Na przykład linki do konferencji wideo, numery telefonów, linki SIP, kody dostępu i inne obsługiwane atrybuty korzystają z pól danych uporządkowanych i nie są podawane w polu notatek.
• Jeśli dodatek udostępnia rozwiązania dotyczące konferencji, może edytować tylko szczegóły konferencji, a nie inne pola wydarzenia.
• Jeśli dodatek udostępnia rozwiązania do obsługi rozmów wideo, tworzenie rozmowy wideo trwa mniej niż 5 sekund.

Dodatki do Gmaila

Jeśli dodatek używa UrlFetchApp lub OpenLinkUrl:

• Adres URL jest prawidłowy.
• Adres URL używa protokołu HTTPS, a nie HTTP.
• W przypadku domeny pełnej.
• Ścieżka nie jest pusta. Na przykład:https://altostrat/ jest prawidłowy, ale https://altostrat nie jest.
• W sekcji UrlFetchApp nie można używać symboli wieloznacznych.

Dodatki do Meet

• Logowanie się w ramach dodatku i ścieżki użytkowników muszą działać nawet wtedy, gdy wyłączone są pliki cookie innych firm.
• Dodatek musi zapewniać funkcje związane ze spotkaniem lub z jego udziałem.
• Dodatek nie może wykonywać żadnych czynności, które powodują, że użytkownicy opuszczają spotkanie, takich jak odświeżanie przeglądarki.
• Jeśli korzystasz z trybu wieloosobowego, dodatek musi umożliwiać wszystkim uczestnikom współpracę nad treściami, nawet jeśli uprawnienia nie zostały wcześniej określone. Zmiana uprawnień musi być dostępna podczas sesji wspólnego modyfikowania dodatku.
• Dodatek musi obsługiwać anulowanie procesu uruchamiania działania i umożliwiać użytkownikowi ponowne zainicjowanie rozpoczęcia działania z aplikacji.
• Dodatek musi zawierać panel boczny do logowania i konfigurowania aktywności.
• Dodatek nie może oferować funkcji zapraszania bota ani polegać na jego obecności na spotkaniu

• Dodatek ma stronę główną. Jeśli Twój dodatek Google Workspace to przekonwertowany dodatek Gmail, zostanie zastosowana domyślna strona główna.
• Karta dodatku (lub interfejs z elementami iframe w dodatkach do Meet) działa prawidłowo. Na przykład: nie ma duplikatów elementów; przyciski Wstecz, Odśwież i Aktualizuj działają prawidłowo.
• Gdy użytkownik autoryzuje dodatek, wyświetla się spersonalizowana karta główna (strona internetowa w dodatkach do Meet) z przyciskiem logowania (w razie potrzeby), logo i krótkim opisem dodatku.
  • Jeśli klikniesz przycisk logowania, otworzy się spersonalizowana strona logowania dostawcy, na której wyraźnie widać, że usługa działa poza Google Workspace.
• Interfejs dodatku ściśle mieści się w przydzielonych obszarach:
  • Tekst i etykiety nie są obcinane przez „…”
  • Użytkownik nie musi zbyt często przewijać w poziomie.
  • Szerokość treści nie przekracza 300p, więc nie ma poziomego paska przewijania.
• Kod dodatku nie używa zbyt wielu bibliotek, ponieważ biblioteki mogą spowodować utratę jego wydajności.

Dodatki do Kalendarza

• Jeśli dodatek zapewnia rozwiązania do prowadzenia rozmów wideo, utworzone konferencje są prawidłowe i wyświetlają się prawidłowo na stronie internetowej firmy zewnętrznej.

Dodatki do Dokumentów

Jeśli dodatki wyświetlają podgląd linków z domeny zewnętrznej (elementy inteligentne):

• Podglądy linków zawierają przydatne, dodatkowe informacje dla użytkownika. Na przykład wyświetlenie podglądu linku do umowy sprzedaży powoduje dodanie informacji takich jak konto, kwota i etap.
• Deweloper jest powiązany z domeną wyświetlaną w podglądzie.

Więcej informacji znajdziesz w artykule o wyświetlaniu podglądu linków z elementami inteligentnymi.

Dodatki do Dysku

• Jeśli aplikacja przechowuje pliki na Dysku, pozwala użytkownikom wybrać folder lub tworzy i wykorzystuje ponownie folder aplikacji. Dane konfiguracji mogą być przechowywane w folderze danych aplikacji. Aplikacja nie przenosi plików do folderu Mój dysk użytkownika.
• Dodatek przechowuje na Dysku tylko pliki związane z dokumentowaną funkcją dodatku.

Dodatki do Gmaila

• Dodatek nie zawiera wzmianki o rozszerzeniach do przeglądarki Chrome ani linków do nich bez uzasadnienia.
• Menu Więcej czynnościmore_vert zawiera uniwersalne czynności, które działają prawidłowo. Na przykład: wylogowanie, informacje, pomoc itp.

Dodatki do Meet

• Jeśli dodatek wymaga licencji lub subskrypcji: użytkownik musi zobaczyć przyjazny komunikat, gdy nie ma licencji.
• Jeśli użytkownik nie może korzystać z dodatku z powodu problemu z licencją, komunikat o błędzie musi wyraźnie podawać przyczynę, dla której nie można go używać, oraz sugerować sposób rozwiązania problemu.
• Informacje o dodatku w Google Workspace Marketplace muszą zawierać szczegółowe informacje o wymaganiach dotyczących licencji i subskrypcji, które mogą być wymagane do korzystania z dodatku. Jeśli dodatek jest w wersji płatnej, informacje o nim w Marketplace muszą zawierać link do strony internetowej z dodatkowymi informacjami o cenie lub o sposobie skontaktowania się ze sprzedawcą.
• Jeśli użytkownik nie jest jeszcze zalogowany, dodatek musi wyświetlić potwierdzenie logowania jednym dotknięciem dostępne na stronie Wyświetl Google One Tap oraz opcję „Zaloguj się przez Google” na stronie Uwierzytelnianie. Oprócz mechanizmu „Zaloguj się przez Google” mogą być dostępne inne opcje logowania.
• Dodatek musi mieć projekt elastyczny, który może dostosować zawartość do różnych rozmiarów.
• Ścieżki użytkownika w dodatku muszą działać, nawet jeśli pliki cookie innych firm są wyłączone.
• Dodatek nie może mieć przewijania poziomego w elemencie iframe.
• Jeśli dodatek ma korzystać z głównej sceny, musi być przeznaczony do rozgrywki wieloosobowej i umożliwiać manipulowanie treściami przez wielu uczestników jednocześnie. W przypadku gier dla 1 gracza deweloper powinien użyć panelu bocznego.
• (zalecane) Dodatek powinien wyświetlać, kim jest zalogowany użytkownik.
• (zalecane) Wybór lokalizacji: język powinien być określony na podstawie ustawień lokalizacji w przeglądarce (jeśli są dostępne).
• (Zalecane) Treści należy wybrać przez interfejs przeglądania treści z ostatnio używanymi materiałami.
• (zalecane) Jeśli panel boczny nie jest już potrzebny, dodatek powinien zamknąć panel boczny po przejściu do głównego etapu.

Dodatki do Kalendarza

• Logo rozwiązania do konferencji to publiczny adres URL. Zobacz: Prześlij logo rozwiązania konferencyjnego.
• Jeśli dodatek korzysta z calendar.conferenceSolution, logo rozwiązania konferencyjnego musi spełniać wymagania calendar.logoUrl. Zobacz Zasób pliku manifestu Kalendarza.
• Jeśli dodatek używa calendar.logoUrl lub common.logoUrl, logo jest identyczne z ikoną podaną na stronie aplikacji.
• Jeśli dodatek używa adresu calendar.logoUrl lub common.logoUrl, adres URL logo zaczyna się tak: https://lh3.googleusercontent.com/

Dodatki do Meet

• Logo marki rozszerzenia musi mieć rozmiar i styl, które pozwolą na jego rozpoznanie w panelu bocznym Meet.
• W manifest dodatku należy podać odpowiednie adresy URL logo w ciemnym trybie.

Dodatki do Dysku

• (Zalecane) Jeśli chcesz otrzymywać ograniczone metadane, dodatek obejmuje zakres drive.addons.metadata.readonly.

• Uniwersalny adres URL nawigacji prowadzi do aplikacji internetowej. Prosta strona internetowa bez funkcji nie jest uważana za aplikację internetową.