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 nieproszoną wiadomość powitalną za każdym razem, gdy użytkownik rozpoczyna rozmowę na czacie 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 reaguje na polecenia wypowiadane w pokoju lub w czacie bezpośrednim.
• Wiadomości muszą być poprawne pod względem ortografii, interpunkcji i gramatyki. Nie mogą zawierać treści szkodliwych, obraźliwych ani zniesławiających.
• Wiadomości zawierają 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, korzystając z menu Wyświetl użytkownika.
• Aplikacja informuje użytkownika o wszystkim, co jest potrzebne do interakcji z aplikacją.
• Format kart używany przez aplikację jest zgodny z wymaganiami Google. Zobacz, jak tworzyć interaktywne karty.
• 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. To jedyny sposób, aby aplikacja wiedziała, że musi odpowiedzieć.
• 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 bezpośrednich.

• 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. Zobacz Jak przesłać prośbę o weryfikację.
• Jeśli aplikacja korzysta z zakresów z ograniczeniami, musi przejść ocenę zabezpieczeń. Zobacz 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.

• Dodatki zawierają oczekiwane i wymagane działania oraz wszystkie narzędzia potrzebne do wykonania danego procesu. 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ą jego utworzenie.
• Dodatek ma elementy menu na karcie dodatki.
• Nawet jeśli dodatek zawiera tylko funkcje niestandardowe, musi mieć odpowiednią dokumentację.
• Dodatek prawidłowo używa funkcji onInstall() i onOpen() do wypełniania menu. Elementy menu są wypełniane podczas pierwszego 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 V8 Apps Script. 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 należy unikać, a jeśli to niemożliwe, należy je odpowiednio zarządzać:
  • 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ą w prosty sposób, co użytkownik musi zrobić, aby go rozwiązać;
  • Jeśli użytkownik robi coś nie tak, wyświetla się przycisk, który pozwala rozwiązać problem.
  • Więcej informacji znajdziesz w  przewodniku dotyczącym 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. Nie używaj terminów technicznych ani ż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  wytycznymi dotyczącymi interfejsu użytkownika w przypadku 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 tylko jedno okno naraz. Nie nakłada się na inne okna ani nie otwiera wielu okien dialogowych jednocześnie.
• Interfejs dodatku mieści się w przypisanych mu miejscach:
  • Tekst i etykiety nie są obcinane przez „…”
  • Użytkownik nie musi zbyt często przewijać w poziomie.
  • Szerokość treści nie przekracza 300 pikseli, więc nie ma paska przewijania poziomego.
• Dodatek wymaga potwierdzenia lub wyświetla ostrzeżenia w przypadku wszystkich działań poufnych. 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 mógł potwierdzić działanie.

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

• Użytkownicy nie mogą wywoływać działań wielokrotnie podczas ich wczytywania. Na przykład przyciski są wyłączone lub ukryte, gdy wczytywane jest działanie.

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 konferencyjnego nie może zawierać słów „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 uporządkowanych danych 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 zapewnia rozwiązania do rozmów wideo, tworzenie konferencji 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 do dodatku i ścieżki użytkownika muszą działać, nawet jeśli pliki cookie innych firm są wyłączone.
• Dodatek musi zapewniać funkcje związane z obsługą lub uczestnictwem w spotkaniu.
• 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 funkcji dla wielu graczy, dodatek musi umożliwiać wszystkim uczestnikom współpracę nad treściami, nawet jeśli uprawnienia nie są ustawione z wyprzedzeniem. Zmiana uprawnień musi być dostępna podczas sesji wspólnego modyfikowania dodatku.
• Wtyczka 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.
• Wtyczka nie może udostępniać funkcji zapraszania bota ani polegać na obecności bota 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 iframe w dodatkach do Meet) działa prawidłowo. Na przykład: nie ma duplikatów elementów, a 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 zewnętrznego, na której wyraźnie widać, że usługa zewnętrzna działa poza Google Workspace.
• Interfejs dodatku mieści się w przypisanych mu miejscach:
  • Tekst i etykiety nie są obcinane przez „…”
  • Użytkownik nie musi dużo przewijać w kierunku pionowym.
  • Szerokość treści nie przekracza 300 pikseli, aby nie było paska przewijania poziomego.
• Kod dodatku nie używa nadmiernie bibliotek, ponieważ mogą one obniżać wydajność dodatku.

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 innej firmy (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 Wyświetlanie podgląd linku za pomocą elementów inteligentnych.

Dodatki do Dysku

• Jeśli aplikacja przechowuje pliki na Dysku, umożliwia użytkownikom wybranie folderu lub tworzy i ponownie używa folderu konkretnej 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.
• W opisie dodatku w Google Workspace Marketplace należy podać informacje o wymaganiach dotyczących licencji i subskrypcji, które mogą być wymagane do korzystania z dodatku. Jeśli dodatek ma płatny poziom, strona na platformie Marketplace musi zawierać link do strony internetowej z dodatkowymi informacjami o cenach lub sposobie kontaktu ze sprzedawcą.
• Jeśli użytkownik nie jest jeszcze zalogowany, dodatek musi wyświetlić prośbę o zalogowanie się jednym dotknięciem, która znajduje się w sekcji Wyświetlanie Google One Tap, oraz opcję „Zaloguj się przez Google”, która znajduje się w sekcji Uwierzytelnianie. Oprócz mechanizmu „Zaloguj się przez Google” mogą być dostępne inne opcje logowania.
• Dodatek musi mieć układ 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 zawierać przewijania poziomego w ramce 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 jednoosobowych 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) Wybór treści powinien odbywać się za pomocą interfejsu przeglądania treści, w którym wyświetlane są ostatnio używane treści.
• (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 używa calendar.conferenceSolution, logo rozwiązania konferencyjnego musi spełniać wymagania calendar.logoUrl. Zobacz zasob 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 pliku manifestu dodatku należy podać odpowiednie adresy URL logo w ciemnym trybie.

Dodatki do Dysku

• (zalecane) Jeśli chcesz otrzymywać metadane w ograniczonym zakresie, dodatek musi obejmować zakresdrive.addons.metadata.readonly.

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