Wdrażanie dodatku do Meet

Dodatki do 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 wymagany jest pakiet SDK Google Workspace Marketplace i interfejs Google Workspace Add-ons API. Aby je włączyć:

  1. Otwórz konsolę Google Cloud.
  2. Jeśli otwarty jest już inny projekt, u góry wybierz jego nazwę, aby przełączyć projekty.
  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 on 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 Twój dodatek. Dwa adresy URL mają tę samą pochodzenie, jeśli korzystają z tego samego schematu, hosta i portu. 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 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, która zainicjowała współdzieloną sesję dodatku, może udostępnić na ekranie swój widok 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óż przy użyciu zasobu wdrożenia w chmurze i 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 addOns i meet. Sekcje addOns i meet mają tę samą strukturę co na karcie Wdrożenie HTTP.

    W przeciwieństwie do innych dodatków do Google Workspace dodatków do Meet nie można w całości tworzyć w Apps Script. Zamiast tego musisz utworzyć pełną aplikację internetową, tworząc panel boczny i główny obszar. 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. Zapoznaj się z dokumentacją dodatków do Google Workspace, aby dowiedzieć się, jak zainstalować nieopublikowany dodatek.

Teraz możesz już korzystać z dodatku podczas spotkania. 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ć.