Wymagania dotyczące oprogramowania sprzęgającego partnera

Zapoznaj się z artykułem Omówienie publikowania, aby poznać korzyści płynące z opublikowania oprogramowania sprzęgającego i poznać wymagany poziom zaangażowania. Aby można było opublikować oprogramowanie sprzęgające partnera, oprogramowanie sprzęgające musi spełniać wszystkie wymagania opisane poniżej.

Google Apps Script

Przed przesłaniem oprogramowania sprzęgającego do sprawdzenia wykonaj te czynności w Apps Script:

  1. Przyznaj uprawnienia do wyświetlania projektu Apps Script następującym osobom:
  2. Utwórz wdrożenie o nazwie Production i zaktualizuj wdrożenie Production do wersji kodu, którą chcesz opublikować.
  3. Sprawdź, czy wdrożenie aplikacji Production zostało zaktualizowane do wersji kodu, którą chcesz sprawdzić.
  4. Upewnij się, że plik manifestu jest widoczny w Apps Script. Po lewej stronie kliknij Ustawienia projektu . Zaznacz pole wyboru Pokaż plik manifestu „appsscript.json” w edytorze.

Plik manifestu

Dodaj te informacje do pliku manifestu oprogramowania sprzęgającego i upewnij się, że projekt Apps Script jest skonfigurowany tak, aby wyświetlać w edytorze plik manifestu appsscript.json.

Więcej informacji znajdziesz w dokumentacji pliku manifestu społecznościowego oprogramowania sprzęgającego.

dataStudio

  1. description powinna zawierać informacje i instrukcje, dzięki którym poznasz podstawowe informacje o oprogramowaniu sprzęgającym i sposobie jego używania. Oprogramowanie sprzęgające z niejasnymi i niepełnymi opisami będzie odrzucane.
  2. addOnUrl powinna być dedykowaną hostowaną stroną oprogramowania sprzęgającego (najlepiej hostowaną we własnej domenie). Strona musi zawierać:
    • Polityka prywatności i Warunki korzystania z usługi lub link do tych treści w tej samej domenie co addOnUrl.
    • Szczegółowe informacje, które musi znać użytkownik, aby móc korzystać z oprogramowania sprzęgającego.
    • link do rejestracji, jeśli do korzystania z oprogramowania sprzęgającego wymagane jest konto.
    • Treść hostowana najlepiej w Twojej domenie. Hosting na serwerze https://sites.google.com/ jest niedozwolony.
    • Zobacz przykładowe strony obecnych partnerów: Funnel, Supermetrics, CallRail.
  3. supportUrl powinna być hostowaną stroną, aby zapewnić obsługę oprogramowania sprzęgającego. Nie może to być link e-mail ani mailto.
  4. logoUrl powinna wskazywać obraz statyczny hostowany przez Ciebie. Nie możesz używać obrazów wyświetlanych przez usługi Google w domenach takich jak *.gstatic.com, *.ggpht.com, *.google.com, *.googleusercontent.com. Korzystanie z Google Cloud Storage do wyświetlania obrazów z domeny *.googleapis.com jest dopuszczalne i zalecane.
    • Oprogramowanie sprzęgające z animowanymi ikonami będzie odrzucane. Używaj statycznych obrazów.
    • Zalecamy użycie obrazu o rozmiarze co najmniej 48 x 48 pikseli.
    • Unikaj obrazów zawierających tylko tekst, które są trudne do odczytania po zmniejszeniu do 48 × 48 pikseli.
  5. Wypełnij właściwość sources wszystkimi źródłami, z którymi łączy się oprogramowanie sprzęgające. Więcej informacji znajdziesz w sekcji Źródła w pliku manifestu.
    • Istniejącą listę źródeł możesz wyświetlić w Repozytorium rejestru danych. Jeśli źródło, z którym się łączysz, nie istnieje w repozytorium, wyślij żądanie pull do repozytorium rejestru danych, aby dodać źródło. Jeśli źródeł w Twoim pliku manifestu nie ma w repozytorium, oprogramowanie sprzęgające nie przejdzie procesu weryfikacji.
    • To są dodatkowe metadane oprogramowania sprzęgającego, które zostaną zindeksowane na potrzeby funkcji wyszukiwania w galerii. Oprogramowanie sprzęgające będzie widoczne w wynikach wyszukiwania, gdy użytkownicy będą szukać określonego źródła w galerii.
  6. Podaj wartości shortDescription, authType, feeType, privacyPolicyUrl i termsOfServiceUrl.
  7. name powinna bezpośrednio reprezentować cel oprogramowania sprzęgającego. Jasna nazwa pomoże użytkownikom określić, czy oprogramowanie sprzęgające spełnia ich potrzeby. Unikaj w nazwie słowa oprogramowanie sprzęgające, ponieważ użytkownicy już wiedzą, że korzystają z oprogramowania sprzęgającego.
    • Nie używaj znaków specjalnych ani niewidocznych, aby zwrócić uwagę na pozycję oprogramowania sprzęgającego lub potencjalnie zmienić jej pozycję.
  8. W pliku manifestu nie używaj krótkich nazw Looker Studio (np. GDS, DS itp.).
  9. Emotikony nie są dozwolone w żadnym polu pliku manifestu (description, shortDescription, name itd.). Nie dodawaj znaków specjalnych ani niewidocznych, by zwrócić uwagę na oprogramowanie sprzęgające.
  10. Jeśli oprogramowanie sprzęgające ma stały schemat, utwórz szablon raportu dla oprogramowania sprzęgającego i dodaj go do pliku manifestu. Włącz w raporcie Udostępnianie za pomocą linku.

urlFetchWhitelist

  1. Ogranicz liczbę punktów końcowych wywoływanych przez funkcję UrlFetchApp do tych bezwzględnie wymaganych do działania oprogramowania sprzęgającego. Dodaj właściwość urlFetchWhitelist na poziomie głównym pliku manifestu. Aby dowiedzieć się więcej, zapoznaj się z informacjami o urlFetchBilling.
    • Uwzględnij wszystkie punkty końcowe używane z usługą UrlFetchApp.
    • Jeśli oprogramowanie sprzęgające nie pobiera zasobów za pomocą usługi UrlFetchApp, ustaw urlFetchWhitelist na pustą listę [].
    • Jeśli oprogramowanie sprzęgające nie łączy się ze zestawem stałych punktów końcowych lub prefiks punktu końcowego się zmienia, podczas przesyłania prośby o sprawdzenie pomiń właściwość urlFetchWhitelist i podaj szczegóły w polu Wyjątek dotyczący adresu urlFetchWhite.

oauthScopes

  1. Ustaw jawne zakresy protokołu OAuth w pliku manifestu. Oprogramowanie sprzęgające bez jawnych zakresów OAuth będzie odrzucane.

Oprogramowanie sprzęgające

  1. Jeśli użytkownik potrzebuje konta, aby móc korzystać z oprogramowania sprzęgającego, upewnij się, że oprogramowanie sprzęgające description lub link addOnUrl zawiera instrukcje, które ułatwiają mu jego utworzenie.
  2. Twoje oprogramowanie sprzęgające nie może być nieukończone ani w wersji beta. Musisz opublikować pełne i funkcjonalne oprogramowanie sprzęgające. Zawsze możesz zaktualizować oprogramowanie sprzęgające, ale wdrożenie produkcyjne udostępniane użytkownikom powinno być przetestowane i funkcja musi być ukończona.
  3. Gdy użytkownicy napotkają błąd wewnętrzny oprogramowania sprzęgającego, wyświetlaj użytkownikom przydatne i przydatne komunikaty o błędach. Obejmuje to przypadki, gdy użytkownik poda nieprawidłowe lub puste dane wejściowe podczas konfiguracji.
  4. shortDescription, description, addOnUrl, link supportUrl i strona OAuth (jeśli dotyczy) nie mogą zawierać błędów ortograficznych ani gramatycznych.
  5. shortDescription nie może zawierać adresów URL.
  6. Użyj metod uwierzytelniania udostępnianych przez getAuthType(). Nie żądaj danych logowania za pomocą getConfig().
  7. Przejdź proces weryfikacji klienta OAuth. Weryfikacja jest wymagana w przypadku wszystkich programów sprzęgających niezależnie od metody uwierzytelniania w getAuthType(). Proces weryfikacji różni się od weryfikacji oprogramowania sprzęgającego i jest obsługiwany przez osobny zespół, a nie Looker Studio. Więcej informacji znajdziesz w Najczęstszych pytaniach na temat weryfikacji interfejsu OAuth API. Jeśli proces weryfikacji klienta OAuth nie zostanie zakończony, Twoje oprogramowanie sprzęgające zostanie odrzucone.
  8. Przestrzegaj Warunków korzystania z usługi Galerie Looker Studio (dla przesyłającego).

Po spełnieniu wszystkich wymagań kliknij poniższy przycisk, aby poprosić o sprawdzenie oprogramowania sprzęgającego:

Opublikuj oprogramowanie sprzęgające partnera