Wdrażanie dodatku do Meet

Dodatki Google Meet są tworzone i konfigurowane w ramach projektu Google Cloud.

Tworzenie projektu Google Cloud

Aby wygenerować projekt Google Cloud, zapoznaj się z artykułem Tworzenie projektu Google Cloud.

Włączanie pakietu SDK Google Workspace Marketplace i interfejsu Google Workspace Add-ons API

Do tworzenia dodatków do Meet wymagane są pakiet SDK Google Workspace Marketplace i interfejs Add-ons API Google Workspace. Aby je włączyć:

  1. Otwórz konsolę Google Cloud.
  2. Jeśli inny projekt jest już otwarty, u góry kliknij nazwę projektu aplikacji, aby go zmienić.
  3. Na pasku wyszukiwania u góry wpisz Google Workspace Marketplace SDK i naciśnij klawisz Enter.
  4. Otwórz stronę Google Workspace Marketplace SDK i kliknij Włącz.

  5. Powtórz te czynności, aby znaleźć i włączyć Google Workspace Add-ons API.

Utwórz wdrożenie

Aby korzystać z dodatku w Meet, musisz mieć wdrożenie i plik z manifestem dodatku.

  1. Otwórz konsolę Google Cloud.
  2. Jeśli inny projekt jest już otwarty, u góry kliknij nazwę projektu aplikacji, aby go zmienić.
  3. Kliknij Interfejsy API i usługi.
  4. Kliknij Google Workspace Marketplace SDK, aby wyświetlić stronę z informacjami.

Tworzenie wdrożenia

Możesz utworzyć wdrożenie bezpośrednio w konsoli Google Cloud, tworząc wdrożenie HTTP (zalecane) lub używając Google Apps Script.

Wdrożenie HTTP

  1. Kliknij kartę Wdrożenia HTTP.
  2. Kliknij Utwórz nowe wdrożenie i wpisz identyfikator wdrożenia dodatku.

    Identyfikator wdrożenia to dowolny ciąg znaków, który pomaga deweloperowi dodatku zidentyfikować wdrożenie zawierające plik manifestu dodatku. Identyfikatory wdrożeń są wymagane i mogą mieć maksymalnie 100 znaków.

  3. Kliknij Dalej.

    Otworzy się panel boczny, w którym możesz przesłać specyfikację pliku manifestu dodatku w formacie JSON. Jest on też nazywany DEPLOYMENT.JSON.

    Plik manifestu dodatku to centralna konfiguracja dodatku Google Meet. Poniższy przykład kodu pokazuje dostępne pola Meet dla wersji internetowej w pliku manifestu dodatku.

    {
      "addOns": {
        "common": {
          "name": "NAME",
          "logoUrl": "LOGO_URL"
        },
        "meet": {
          "web": {
            "sidePanelUri": "SIDE_PANEL_URI",
            "addOnOrigins": ["ADD_ON_ORIGINS"],
            "darkModeLogoUrl": "DARK_MODE_LOGO_URL",
            "logoUrl": "MEET_WEB_LOGO_URL",
            "supportsScreenSharing": SUPPORTS_SCREENSHARING
          }
        }
      }
    }
    

    Zastąp następujące elementy:

    • NAME: ciąg znaków. Nazwa dodatku do Google Meet.
    • LOGO_URL: ciąg znaków. Adres URL logo dodatku Google Workspace. Jest on używany w dodatku w usługach Google Workspace.
    • SIDE_PANEL_URI: ciąg znaków. Adres URL punktu wejścia aplikacji dodatku. Jest wyświetlany w ramce iframe w panelu bocznym. Źródło tego adresu URL musi być jednym ze źródeł określonych w polu ADD_ON_ORIGINS.
    • ADD_ON_ORIGINS: lista ciągów znaków. Lista źródeł, w których hostowany jest dodatek. 2 adresy URL mają to samo źródło, gdy mają ten sam schemat, hosta i port. Dozwolone są też źródła podrzędne oraz subdomeny z symbolami wieloznacznymi. Więcej informacji znajdziesz w artykule Bezpieczeństwo dodatków.
    • DARK_MODE_LOGO_URL: ciąg znaków. Adres URL logo dodatku w ciemnym trybie. Przesłanie logo w trybie ciemnym zapewni, że wtyczka będzie wyglądać najlepiej w dowolnym temacie w Meet. Wytyczne dotyczące projektowania logo znajdziesz w artykule Sprawdzone metody.
    • MEET_WEB_LOGO_URL: opcjonalna. Ciąg tekstowy. Adres URL logo dodatku w Meet. To logo jest używane w Meet. Jeśli nie ma takiego parametru, używany jest parametr logoUrl z sekcji wspólnej. Wytyczne dotyczące projektowania logo znajdziesz w sekcji sprawdzonych metod.
    • SUPPORTS_SCREENSHARING: opcjonalna. Wartość logiczna. Jeśli ta opcja jest ustawiona na wartość false, użytkownicy muszą użyć dodatku, aby zobaczyć, co dzieje się podczas sesji dodatku na potrzeby współpracy. Jeśli ma wartość Prawda, osoba inicjująca sesję współpracy z dodatkiem może udostępnić widok tego dodatku.
  4. Kliknij Prześlij.

    Więcej informacji o wdrożeniach znajdziesz w artykule Tworzenie zasobu wdrożenia.

  5. Na karcie Konfiguracja aplikacji w sekcji Integracja aplikacji wybierz Dodatek Google Workspace. Kliknij Wdróż z użyciem zasobu wdrożenia w chmurze, a potem wybierz odpowiednie wdrożenie HTTP.

Google Apps Script

  1. Kliknij kartę Konfiguracja aplikacji.

  2. W sekcji Integracja aplikacji wybierz Dodatek Google Workspace. Wybierz Wdróż za pomocą identyfikatora wdrożenia Google Apps Script i wpisz identyfikator wdrożenia skryptu.

  3. Kliknij Zapisz.

    Szczegółowe informacje o tworzeniu projektu Apps Script znajdziesz w dokumentacji Apps Script. Dodatek do Meet korzysta wyłącznie z pliku manifestu appsscript.json, zwanego też pliku manifestu projektu Apps Script. Upewnij się, że plik manifestu w projekcie Apps Script zawiera sekcje addOnsmeet. Sekcje addOnsmeet mają tę samą strukturę co na karcie Wdrożenie HTTP.

    W przeciwieństwie do innych dodatków do Google Workspace dodatki do Meet nie mogą być tworzone wyłącznie w Apps Script. Zamiast tego musisz utworzyć pełną aplikację internetową, tworząc panel boczny i główny etap. Następnie musisz podać adres URL panelu bocznego aplikacji internetowej w sekcji SIDE_PANEL_URI pliku manifestu appsscript.json.

Instalowanie i testowanie dodatku w Meet

Aby przetestować dodatek w Meet, musisz najpierw zainstalować go dla zalogowanego użytkownika:

Wdrożenie HTTP

  1. W konsoli Google Cloud otwórz pakiet SDK Google Workspace Marketplace dla swojego projektu.
  2. Kliknij kartę Wdrożenia HTTP.
  3. W kolumnie Działania kliknij Zainstaluj.

Google Apps Script

  1. Aby zainstalować nieopublikowany dodatek, postępuj zgodnie z instrukcjami w dokumentacji dodatków do Google Workspace.

Teraz powinieneś mieć możliwość korzystania z dodatku na spotkaniu. Aby to sprawdzić, rozpocznij spotkanie na stronie meet.google.com. Zainstalowany dodatek jest teraz widoczny w panelu aktywności.

Oprócz zainstalowania dodatku dla konkretnego zalogowanego użytkownika możesz go też opublikować. Gdy opublikujesz dodatek do Google Workspace, inni użytkownicy będą mogli go znaleźć, zainstalować i używać.