Proces sprawdzania aplikacji i wymagania dotyczące Google Workspace Marketplace

Aby udostępnić aplikację publicznie w Google Workspace Marketplace, Google sprawdza ją i informacje o niej pod kątem zgodności ze wskazówkami Google dotyczącymi projektowania, treści i stylu.

Gdy Google zweryfikuje Twoją aplikację, otrzymasz e-maila z informacją o tym, czy wymaga ona dalszych działań lub czy została zatwierdzona.

• Jeśli aplikacja wymaga dodatkowych działań – otrzymasz dokument weryfikacyjny z informacjami o tym, co wymaga poprawy. Rozwiąż problemy i ponownie prześlij aplikację do sprawdzenia.
• Jeśli zespół ds. weryfikacji zatwierdzi aplikację – zostanie ona automatycznie opublikowana, a Ty otrzymasz e-maila z powiadomieniem.

Przed przesłaniem aplikacji do sprawdzenia upewnij się, że jest ona gotowa do publikacji. Szczegółowe informacje znajdziesz w artykule Przygotowanie do procesu publikowania.

Czas trwania sprawdzania

Zwykle zajmuje to kilka dni. Czas oczekiwania zależy od tych czynników:

• Liczba aplikacji, które zostały ostatnio przesłane
• Ile dodatkowej pracy potrzebuje Twoja aplikacja

Częste powody, dla których aplikacja nie przechodzi weryfikacji

Weryfikacja OAuth:

• Nieprawidłowa konfiguracja ekranu zgody OAuth. Na przykład typ użytkownika jest ustawiony na Wewnętrzny lub stan publikowania to Testowanie.
• Aplikacja nie przeszła procesu weryfikacji OAuth.

Problemy z informacjami o aplikacji:

• Niewłaściwe użycie znaków towarowych Google w nazwie, logo lub opisie aplikacji. Więcej informacji znajdziesz we wskazówkach dotyczących budowania marki w Google Workspace Marketplace.
• Linki nie działają lub prowadzą do nieprawidłowych informacji. Na przykład link do polityki prywatności wskazuje stronę pomocy dla deweloperów.
• Zrzuty ekranu i obrazy mają niską jakość lub nie odzwierciedlają dokładnie funkcji aplikacji.

Gotowość aplikacji:

• Aplikacja jest nadal testowana i nie jest gotowa do publicznego użytku.
• Aplikacja zawiera błędy lub nie jest w pełni funkcjonalna.

Kryteria weryfikacji

Zanim prześlesz aplikację do sprawdzenia, upewnij się, że spełnia ona wszystkie wymagania i jest zgodna z zasadami programu Google Workspace Marketplace.

• Wymagania dotyczące wszystkich aplikacji
• Wymagania dotyczące określonych integracji aplikacji

Wymagania dotyczące wszystkich aplikacji

Aby śledzić wstępną ocenę, możesz skorzystać z pól wyboru. Usuwanie pól wyboru

Kategoria	Kryteria
Nazwa aplikacji	Nie ma innych stron aplikacji o takiej nazwie. Nazwa nie zawiera numeru wersji. Nazwa jest zgodna z nazwą na ekranie zgody OAuth. Nazwa nie jest niejasna ani zbyt ogólna. Nazwa może mieć maksymalnie 50 znaków. (Zalecane) Nazwa powinna być zapisana wielkimi literami. (Zalecane) W nazwie nie ma znaków interpunkcyjnych, a zwłaszcza nawiasów.
Informacje o programistach	Nazwa dewelopera i witryna dewelopera zawierają poprawne informacje o deweloperze i prowadzą do niego. Ze względu na przepisy dotyczące ochrony konsumentów należy poinformować konsumentów z Europejskiego Obszaru Gospodarczego (EOG), czy sprzedawca w Google Workspace Marketplace jest przedsiębiorcą czy podmiotem niebędącym przedsiębiorcą: Przedsiębiorca to osoba, która działa w celach związanych z handlem, firmą, rzemiosłem lub zawodem, albo działa w imieniu przedsiębiorcy lub w jego imieniu. Osoba niebędąca przedsiębiorcą – osoba niebędąca przedsiębiorcą (konsument) to osoba, która działa w celach niezawodowych. Jeśli nie określono inaczej, na stronie informacji o aplikacji pojawi się komunikat „Stan przedsiębiorcy nieokreślony”.
Opis aplikacji	Wszystkie podane linki działają i wskazują prawidłowe informacje. Na przykład link do polityki prywatności prowadzi do strony z opisem polityki prywatności. Jeśli aplikacja wchodzi w interakcję z usługą innej firmy, opis zawiera opis działania tej usługi i sposobów interakcji z nią oraz opcjonalnie link do odpowiedniej strony. Krótkie i szczegółowe opisy są zrozumiałe. Krótkie i szczegółowe opisy nie są identyczne. (Zalecane) Informacje o cenach są kompletne i dokładne. (Zalecane) Pełny zestaw atrybutów w poszczególnych językach (nazwa, krótki opis i szczegółowy opis) jest poprawnie zdefiniowany, bez niezgodności języka.
Funkcjonalność	Nie ma oczywistych błędów, a wszystkie działania, w tym przypadki skrajne, są w pełni funkcjonalne. Czasem wczytywania zarządza się za pomocą wskaźników wczytywania. Aplikacja demonstruje przejrzyste interakcje z interfejsami API Google. Aplikacja udostępnia nowe lub rozszerzone funkcje, które nie odpowiadają funkcjom dostępnym w usługach Google. Aplikacja nie jest przeznaczona do celów reklamowych ani spamowania. Aplikacja jest w pełni funkcjonalna i nie jest przeznaczona do testów – nie jest w trakcie opracowywania. Jeśli aplikacja wchodzi w interakcję z funkcjami dostępnymi dla użytkowników wersji płatnej, zespół Google ds. sprawdzania otrzyma konto testowe w systemie dewelopera.
Interfejs użytkownika	Aplikacja, w tym jej nazwa, nie wykorzystuje zasobów marki Google, znaków towarowych ani treści z elementami marki Google. Zobacz wskazówki dotyczące budowania marki w Google Workspace Marketplace. Autoryzacja i zalogowanie się są wymagane tylko raz. Aplikacja używa logowania jednokrotnego 1 kliknięciem lub logowania jednokrotnego typu zero-click. Gdy administrator przyzna uprawnienia do zakresów OAuth 2.0 w domenie, poszczególni użytkownicy nie zostaną ponownie poproszeni o przyznanie uprawnień zakresu. Użytkownicy nie muszą podawać danych logowania po zalogowaniu się na swoje konta Google. W tym celu muszą kliknąć przycisk „Zaloguj się przez Google”. Pojęcia związane z etykietami przycisków, elementami menu, tytułami i innymi elementami aplikacji są spójne, oczywiste i zrozumiałe. Na przykład zamiast Tak lub Nie etykiety odnoszą się do nazw działań, takich jak Usuń czy Anuluj. Jeśli musisz się zalogować, funkcja wylogowania działa prawidłowo. Tokeny zostaną unieważnione, a logowanie można zaczynać od początku. W przypadku działań zawsze wyświetlane są informacje zwrotne, np. z potwierdzeniem lub komunikatami o błędach. Nie ma uszkodzonych linków do zdjęć ani niewyraźnych obrazów.
Grafika	Ikony mają prawidłowy rozmiar, są kwadratowe i mają przezroczyste tło. Patrz Zasoby graficzne. Ikona prawidłowo odzwierciedla nazwę lub funkcje aplikacji. Ikona jest kolorowa (bez skali szarości). Ikona nie zawiera znaków towarowych Google. Zrzuty ekranu i obrazy nie są rozmyte, trudne do odczytania ani nieodpowiednie. Dokładnie przedstawiają aplikację. (Zalecane) Zrzuty ekranu wyraźnie pokazują, jak używać aplikacji i jak ona działa.
OAuth	Aplikacja przeszła weryfikację OAuth i używa najwęższych dostępnych zakresów OAuth, a wszystkie zakresy integrują się prawidłowo z interfejsami API usług Google.

Dodatkowe wymagania dotyczące integracji określonych aplikacji

Wybierz integracje aplikacji uwzględnione w informacjach o aplikacji, aby wyświetlić odpowiednie kryteria sprawdzania. Możesz klikać nazwy kolumn, aby posortować kryteria, np. według kategorii.

Aby śledzić wstępną ocenę, możesz skorzystać z pól wyboru. Usuwanie pól wyboru

Dodatek do Google Workspace Dodatek do edytora Aplikacja internetowa Aplikacja Dysk Aplikacja Google Chat

Integracja aplikacji	Kategoria	Kryteria
Aplikacja Google Chat	Nazwa	Przyciski umożliwiające komunikację z aplikacją są dostępne w opisie. Nazwa aplikacji zaczyna się od A–Z (wielkie litery) lub 0–9. Nie może zaczynać się od symbolu.
Aplikacja Google Chat	Interfejs użytkownika	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 o wysyłaniu wiadomości na karcie głównej aplikacji. Aplikacja obsługuje polecenie „Pomoc” i pomaga użytkownikom rozpocząć korzystanie z aplikacji. Więcej informacji znajdziesz w artykule Odpowiadanie na polecenia po ukośniku. Aplikacja zawsze reaguje, gdy ktoś coś mówi w pokoju lub na czacie. Wiadomości zawierają prawidłową pisownię, wielkość liter, interpunkcję i gramatykę. Wiadomości nie zawierają szkodliwych, obraźliwych ani obraźliwych treści. Wiadomości mają jasne, zwięzłe i spójne formatowanie tekstu lub kart zgodnie z wymaganiami Google. Jeśli odpowiedź trwa dłużej niż 2 sekundy, aplikacja wysyła komunikat z wyjaśnieniem opóźnienia. Aplikacje wysyłające powiadomienia umożliwiają użytkownikom ich wyłączanie. Użytkownicy mogą dodać aplikację do pokoju za pomocą @wzmianek. 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 nią. Format kart używany w aplikacji spełnia wymagania Google. Zobacz Tworzenie kart interaktywnych. Aplikacja jest dostępna za pomocą opcji Znajdź aplikacje w menu czatu. Zewnętrzne adresy URL, z którymi aplikacja wchodzi w interakcje, nie należą do środowiska testowego ani programistycznego. @Wzmianka jest wymagana w każdej wiadomości skierowanej 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 linków oferuje trafne, uzupełniające informacje dotyczące wiadomości użytkownika. Na przykład wyświetlenie podglądu linku do umowy sprzedaży dodaje takie informacje jak konto, kwota i etap. Deweloper jest powiązany z domeną, której dotyczy podgląd. Więcej informacji znajdziesz w sekcji Podgląd linków. (Zalecane) Aby umożliwić administratorom Workspace instalowanie aplikacji w imieniu użytkowników w organizacji, musi ona mieć możliwość odbierania i wysyłania wiadomości na czacie.
Aplikacja Google Chat	Grafika	Aplikacja ma rozpoznawalny i wyraźny awatar.
Aplikacja Dysk Google	Funkcjonalność	Aplikacja nie korzysta z rozszerzeń przeglądarki Chrome do obsługi funkcji przez bezpośrednie manipulowanie kodem HTML Dysku. Jeśli Twoja aplikacja używa zakresów wrażliwych lub zakresów z ograniczeniami, musi przejść weryfikację OAuth. Dowiedz się, jak przesłać prośbę o weryfikację. Jeśli Twoja aplikacja używa zakresów z ograniczeniami, musi też przejść ocenę zabezpieczeń. Zapoznaj się z sekcją Dlaczego potrzebna jest ocena zabezpieczeń.
Aplikacja Dysk Google	Interfejs użytkownika	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 pobiera plików do folderu Mój dysk użytkownika. Aplikacja przechowuje na Dysku tylko pliki powiązane z udokumentowaną funkcją aplikacji.
Dodatek do edytora	Funkcjonalność	Dodatek zawiera oczekiwane i wymagane działania oraz wszystkie narzędzia niezbędne do wykonania przepływu pracy. Na przykład: Jeśli dodatek zastosuje styl do całego dokumentu, będzie mógł zastosować styl tylko do zaznaczonego tekstu. Jeśli dodatek przesyła dane z arkusza kalkulacyjnego do pliku danych usługi internetowej, zawiera link do tego pliku, który ułatwia nawigację. Jeśli dodatek wymaga od użytkownika posiadania konta, udostępnia linki lub informacje, które ułatwiają jego utworzenie. Na karcie Dodatki dodatku znajdują się pozycje menu. Nawet jeśli dodatek jest tylko funkcjami niestandardowymi, nadal zawiera odpowiednią dokumentację. Dodatek prawidłowo używa elementów onInstall() i onOpen() do wypełniania menu. Pozycje menu zapełniają się podczas instalowania dodatku i otwierania innego pliku. Patrz: Autoryzacja 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.
Dodatek do edytora	Interfejs użytkownika	Dodatek zawiera wszystkie informacje niezbędne do zrozumienia usługi i korzystania z niej. Kod dodatku nie używa zbyt wielu bibliotek, ponieważ biblioteki mogą spowodować utratę jego wydajności. W miarę możliwości unikaj błędów i zarządzaj nimi prawidłowo. Jeśli nie, to: Komunikaty o błędach są wyświetlane w oknie dialogowym, a nie w alercie JavaScriptu ani na domyślnym czerwonym pasku. Informują one o problemie i wyjaśniają, co użytkownik musi zrobić, aby go rozwiązać. Jeśli jest to możliwe, jeśli użytkownik robi coś nie tak, wyświetla się przycisk, który rozwiązuje 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: Jest zawsze jasne, co należy zrobić i jak to zrobić. Dodatek jest łatwo dostępny i prosty w obsłudze. Należy unikać terminów technicznych i żargonu. Przepływy pracy są przejrzyste i uproszczone. Użytkownik i znajdujące się w nim treści są tak bezpieczne, jak to możliwe. Dodatek jest zgodny z przewodnikiem po stylu UI dotyczący dodatków do edytora i wykorzystuje pakiet CSS dla dodatków do edytora. Dodatek używa tylko 1 działania głównego w kolorze niebieskim na wyświetlacz. Dodatek wyświetla jedno okno naraz. Nie nakładają się na siebie ani nie ma otwartych wielu okien jednocześnie. Interfejs dodatku ściśle mieści się w przydzielonych obszarach: Tekst i etykiety nie są obcięte znakiem „...” Użytkownik nie musi często przewijać w pionie. 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ć całą zawartość arkusza kalkulacyjnego, użytkownik otrzymuje ostrzeżenie i potwierdza działanie, zanim to nastąpi. Możesz tego uniknąć, zmieniając projekt. Na przykład dodatek do Arkuszy Google, który importuje dane, stwarza ryzyko zastąpienia istniejących treści. Możesz usunąć to ryzyko, tworząc arkusz danych jako działanie domyślne. Użytkownicy nie mogą aktywować działań wielokrotnie podczas wczytywania działania. Na przykład przyciski są wyłączone lub ukryte podczas wczytywania działania.
Dodatek do Google Workspace	Nazwa	Dodatki do Kalendarza Jeśli dodatek używa calendar.name lub common.name, nazwa w pliku manifestu jest taka sama jak nazwa na stronie 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 używa calendar.conferenceSolution, nazwa rozwiązania konferencyjnego nie przekracza 30 znaków.
Dodatek do Google Workspace	Funkcjonalność	Dodatek używa odpowiednich widżetów, aby zapewnić odpowiednią funkcjonalność. Za pomocą przełącznika możesz na przykład wybrać wartość logiczną. Dodatki do Kalendarza Kalendarze pomocnicze i przekazywanie dostępu są obsługiwane, a jeśli nie są obsługiwane, można nimi zarządzać w sposób płynny. Na przykład utworzenie rozmowy wideo nie zakończy się niepowodzeniem, jeśli podczas tworzenia wydarzenia użytkownik wybierze inny kalendarz, do którego ma uprawnienia do edycji. Wydarzenia cykliczne działają prawidłowo. Jeśli dodatek używa calendar.conferenceSolution, udostępniane jest co najmniej 1 rozwiązanie konferencyjne. Jeśli dodatek zapewnia rozwiązania do obsługi rozmów wideo, używane są odpowiednie pola danych rozmów wideo. Na przykład linki do rozmów wideo, numery telefonów, linki SIP, kody dostępu i inne obsługiwane atrybuty korzystają z pól uporządkowanych danych i nie ma ich w polu uwag. Jeśli dodatek udostępnia rozwiązania do obsługi rozmów wideo, edytuje tylko szczegóły rozmowy i nie zmienia żadnych innych pól wydarzeń. 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. Podano pełną domenę. Ścieżka nie jest pusta. Na przykład wartość https://altostrat/ jest prawidłowa, ale https://altostrat już nie. W UrlFetchApp nie można używać symboli wieloznacznych.
Dodatek do Google Workspace	Interfejs użytkownika	Dodatek ma stronę główną. Jeśli Twój dodatek do Google Workspace jest przekształconym dodatkiem do Gmaila, stosowana jest domyślna strona główna. Karta z dodatkiem działa prawidłowo. Na przykład nie ma zduplikowanych kart, a przyciski Wstecz, Odśwież i Zaktualizuj działają odpowiednio. Gdy użytkownik autoryzuje dodatek, wyświetli mu się dostosowana karta strony głównej z powitaniem użytkownika z przyciskiem logowania (w razie potrzeby), logo i krótkim opisem dodatku. Uruchomienie przycisku logowania spowoduje wyświetlenie dostosowanej strony logowania dostarczonej przez zewnętrznego dostawcę, która wyraźnie wskazuje, że poza Google Workspace działa usługa innej firmy. Interfejs dodatku ściśle mieści się w przydzielonych obszarach: Tekst i etykiety nie są obcięte znakiem „...” Użytkownik nie musi często przewijać w pionie. 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 obsługi rozmów wideo, utworzone rozmowy wideo są prawidłowe i wyświetlają się prawidłowo na stronie internetowej innej firmy. Dodatki do Dokumentów Jeśli dodatek wyświetla podgląd linków z domeny innej firmy (elementów inteligentnych): Podgląd linków zapewnia użytkownikowi trafne, dodatkowe informacje. Na przykład wyświetlenie podglądu linku do umowy sprzedaży dodaje takie informacje jak konto, kwota i etap. Deweloper jest powiązany z domeną, której dotyczy podgląd. 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 pobiera plików do folderu Mój dysk użytkownika. Dodatek przechowuje na Dysku tylko te pliki, które są powiązane z jego udokumentowaną funkcjonalnością. Dodatki do Gmaila Dodatek nie wspomina o rozszerzeniach do przeglądarki Chrome ani nie zawiera linków do nich bez uzasadnienia. Menu Więcej działań zawiera działania uniwersalne, które działają prawidłowo. Na przykład Wyloguj się, Informacje, Pomoc itp.
Dodatek do Google Workspace	Grafika	Dodatki do Kalendarza Logo rozwiązania do obsługi rozmów wideo jest publicznym adresem URL. Zobacz Dodawanie logo rozwiązań do obsługi konferencji. Jeśli dodatek używa calendar.conferenceSolution, logo rozwiązania do obsługi konferencji jest zgodne z wymaganiami calendar.logoUrl. Zobacz Zasób pliku manifestu Kalendarza. Jeśli dodatek używa calendar.logoUrl lub common.logoUrl, logo jest takie samo jak ikona na stronie z informacjami o aplikacji. Jeśli dodatek używa calendar.logoUrl lub common.logoUrl, adres URL logo zaczyna się tak: https://lh3.googleusercontent.com/
Dodatek do Google Workspace	OAuth	Dodatki do Dysku (Zalecane) Jeśli chcesz otrzymywać ograniczone metadane, dodatek obejmuje zakres drive.addons.metadata.readonly.
Aplikacja internetowa	Funkcjonalność	Adres URL uniwersalnej nawigacji wskazuje aplikację internetową. Prosta strona internetowa bez funkcji nie jest uznawana za aplikację internetową.