Watch demos on how to build & run AI-powered apps with Firebase at Demo Day '24. Watch now.

Ta strona została przetłumaczona przez Cloud Translation API.

Dokumentacja rozszerzeniaextension.yaml

Plik specyfikacji rozszerzenia (extension.yaml) zawiera metadane rozszerzenia, deklaruje zasoby utworzone przez rozszerzenie oraz interfejsy API i dostęp wymagane przez rozszerzenie, a także definiuje parametry konfigurowane przez użytkownika, które są udostępniane przez rozszerzenie.

Tabele na tej stronie opisują pola dostępne w pliku extension.yaml.

podstawowe informacje i informacje umożliwiające identyfikację;

name: your-extension-name
version: 1.0.0         # Semantic versioning (semver)
specVersion: v1beta    # Always "v1beta"
license: Apache-2.0    # Always "Apache-2.0" (required to publish on extensions.dev)
billingRequired: true  # Always "true"

displayName: Your extension name
description: >-
  Description of the extension. (One or two
  sentences.)
icon: icon.png
tags: [tag, anothertag]

sourceUrl: https://github.com/your-org/your-repo   # GitHub repo URL
releaseNotesUrl: https://github.com/your-org/your-repo/blob/main/CHANGELOG.md

author:
  authorName: Your Company
  email: extensions@example.com
  url: https://example.com/
contributors:
  - authorName: Your Name
  - authorName: Another Contributor
    email: colleague@example.net
    url: https://github.com/their-org/

Pola podstawowe

name
string
(wymagany)

Identyfikator rozszerzenia.

Może zawierać tylko małe litery, cyfry i łączniki; limit 40 znaków.

Uwaga: ta wartość jest używana do generowania identyfikatora instancji rozszerzenia (który jest następnie używany do generowania nazw kont usługi rozszerzenia i zasobów specyficznych dla rozszerzenia).

version
string
(wymagany)

Wersja rozszerzenia.

Musi być zgodna z wersją semver (np. 1.2.0).

specVersion
string
(wymagany)

Wersja specyfikacji Rozszerzeń w Firebase.

Bieżąca wartość: v1beta

license
string
(opcjonalnie)

Licencja na rozszerzenie.

Rozszerzenie musi mieć licencję uzyskaną za pomocą Apache-2.0.

billingRequired
boolean
(opcjonalnie)

Czy usługi używane przez rozszerzenie wymagają płatnego konta rozliczeniowego Firebase.

Zawsze ustawiona na true.

displayName
string
(opcjonalnie)

Przyjazna nazwa wyświetlana rozszerzenia (3–5 słów).

Obowiązuje limit 40 znaków.

description
string
(opcjonalnie) Krótki opis zadania wykonywanego przez rozszerzenie (ok. 1 zdania).

icon
string
(opcjonalnie)

Plik do użycia jako ikona rozszerzenia w extensions.dev i na konsoli Firebase.

Plik musi być kwadratowym obrazem PNG o rozmiarach od 512 x 512 do 1024 x 1024 piksele. Umieść plik w tym samym katalogu co extension.yaml. Nie możesz podać podkatalogu.

Podczas projektowania ikony rozszerzenia pamiętaj o tych wytycznych:

Wybierz kolory tła i elementów graficznych odpowiednie dla Twojej marki.
Użyj tylko 2 kolorów. Użycie wielu kolorów może sprawić, że ikona będzie przytłaczająca.
Z tego samego powodu nie używaj w ikonie gradientów. Gradienty są trudne do rozróżnienia w małej skali i sprawiają, że ikona jest wizualnie skomplikowana.
Używaj prostych, unikalnych obrazów, które informują o funkcjonalności rozszerzenia.
Jeśli Twoja firma tworzy wiele rozszerzeń, nie używaj logo jako ikony. Użytkownicy będą mieli trudności z odróżnieniem Twoich rozszerzeń.
Upewnij się, że grafika jest wyraźna i czytelna. Nie używaj delikatnych lub skomplikowanych grafik, które nie będą dobrze wyglądać w mniejszych rozmiarach.
Nie używaj słów, które wyjaśniają, do czego służy Twoje rozszerzenie. Tekst jest często nieczytelny w mniejszych rozmiarach.

tags
lista ciągów znaków
(opcjonalnie) tagi, które ułatwiają użytkownikom znalezienie rozszerzenia; Te tagi są mapowane na kategorie w Centrum rozszerzeń:marketing,messaging,payments,search,shipping,social,utilities,ai.

sourceUrl
string
(opcjonalnie) Publiczny adres URL, pod którym można uzyskać dostęp do katalogu rozszerzeń.

releaseNotesUrl
string
(opcjonalnie) Publiczny adres URL, pod którym można znaleźć informacje o wersji rozszerzenia.

author
jeden obiekt author
(opcjonalnie)

Główny autor i osoba kontaktowa rozszerzenia.

author:
  authorName: Your Company
  email: extensions@example.com
  url: https://example.com/

Pola autora

authorName
string
(wymagany)

Imię i nazwisko autora.

Może to być osoba, firma, organizacja itp.

email
ciąg znaków
(opcjonalnie) Adres e-mail autora.

url
ciąg znaków
(opcjonalnie) Publiczny adres URL, pod którym można uzyskać dostęp do informacji o autorze.

contributors
lista obiektów autor
(opcjonalnie)

dodatkowych autorów, którzy przyczynili się do powstania rozszerzenia;

contributors:
  - authorName: Your Name
  - authorName: Another Contributor
    email: colleague@example.net
    url: https://github.com/their-org/

Pola autora

authorName
string
(wymagany)

Imię i nazwisko autora.

Może to być osoba, firma, organizacja itp.

email
ciąg znaków
(opcjonalnie) Adres e-mail autora.

url
ciąg znaków
(opcjonalnie) Publiczny adres URL, pod którym można uzyskać dostęp do informacji o autorze.

Firebase i interfejsy Google Cloud API

Te pola określają interfejsy Firebase i Google, których używa rozszerzenie. Po zainstalowaniu rozszerzenia użytkownicy mogą automatycznie włączyć te interfejsy API w swoim projekcie.

apis:
  - apiName: apiname.googleapis.com
    reason: Explanation of why the extension uses this API
  - apiName: anotherapiname.googleapis.com
    reason: Explanation of why the extension uses this API

Pola interfejsu API
`apiName` string (wymagany)	Nazwa interfejsu Google API Musi być zgodny z polem Nazwa usługi na stronie przeglądu każdego interfejsu API (przykład) w bibliotece interfejsów API Google Cloud.
`reason` string (wymagany)	krótki opis, dlaczego rozszerzenie musi używać tego interfejsu API;

Pola interfejsu API

apiName
string
(wymagany)

Nazwa interfejsu Google API

Musi być zgodny z polem Nazwa usługi na stronie przeglądu każdego interfejsu API (przykład) w bibliotece interfejsów API Google Cloud.

reason
string
(wymagany) krótki opis, dlaczego rozszerzenie musi używać tego interfejsu API;

Role uprawnień

Te pola określają role Cloud IAM wymagane przez rozszerzenie. Te role są przypisywane do konta usługi utworzonego dla rozszerzenia.

Możesz określić tylko jedną z obsługiwanych ról.

roles:
  - role: product.role
    reason: Explanation of why the extension needs this level of access
  - role: anotherproduct.role
    resource: projects/${project_id}/resource_type/*
    reason: Explanation of why the extension needs this level of access

Pola roli
`role` string (wymagany)	Nazwa roli uprawnień, która jest wymagana do działania rozszerzenia Musi być jedną z obsługiwanych ról
`reason` string (wymagany)	krótki opis, dlaczego rozszerzenie potrzebuje dostępu przyznanego przez tę rolę;
`resource` string (opcjonalnie)	Ogranicz zakres roli do tego zasobu. Jeśli go pominiesz, domyślnie tag będzie w wersji VAST 2.0.`projects/${project_id}` Zapoznaj się z artykułem Ograniczanie zakresu ról.

Pola roli

role
string
(wymagany)

Nazwa roli uprawnień, która jest wymagana do działania rozszerzenia

Musi być jedną z obsługiwanych ról

reason
string
(wymagany) krótki opis, dlaczego rozszerzenie potrzebuje dostępu przyznanego przez tę rolę;

resource
string
(opcjonalnie)

Ogranicz zakres roli do tego zasobu.

Jeśli go pominiesz, domyślnie tag będzie w wersji VAST 2.0.projects/${project_id} Zapoznaj się z artykułem Ograniczanie zakresu ról.

Usługi zewnętrzne

Te pola określają usługi inne niż Firebase i inne niż Google, których używa rozszerzenie (zazwyczaj interfejsy API REST). Platforma Firebase Extensions nie udostępnia żadnych sposobów automatycznego włączania ani autoryzacji tych usług.

externalServices:
  - name: Example API
    pricingUri: https://developers.example.com/pricing
  - name: Another Example API
    pricingUri: https://developers.example.com/pricing

Pola dotyczące usług zewnętrznych
`name` string (wymagany)	Nazwa usługi zewnętrznej, która jest wymagana do działania rozszerzenia.
`pricingUri` string (wymagany)	Identyfikator URI informacji o cenach usługi

Parametry konfigurowane przez użytkownika

Te pola określają parametry, które rozszerzenie udostępnia użytkownikom do konfiguracji.

params:
  - param: PARAM_ID
    label: Short description of the parameter
    description: >-
      What do you want to set PARAM_ID to?
      This is a longer description of the parameter, often phrased as a prompt
      to the user.
  - param: ANOTHER_PARAM_ID
    label: Short description of the parameter
    description: >
      What do you want to set ANOTHER_PARAM_ID to?
      This is a longer description of the parameter.
    example: example-input
    validationRegex: "^[a-zA-Z][a-zA-Z-]*[a-zA-Z]?$"
    validationErrorMessage:
      Must be a hyphen-delimited string of alphabetic characters
    default: default-value
    required: false
    immutable: true

Pola parametrów
`param` string (wymagany)	Nazwa parametru. Za pomocą tej nazwy możesz odwoływać się do wartości parametru w kodzie.
`label` string (wymagany)	Krótki opis parametru. Wyświetla się użytkownikowi, gdy zostanie poproszony o podanie wartości parametru.
`description` string (opcjonalnie)	Szczegółowy opis parametru. Wyświetla się użytkownikowi, gdy wyświetli się prośba o podanie wartości parametru. Obsługuje Markdown.
`example` string (opcjonalnie)	Przykładowa wartość parametru.
`default` string (opcjonalnie)	wartość domyślna parametru, jeśli użytkownik pozostawi jego wartość pustą;
`validationRegex` string (opcjonalnie)	Wyrażenie regularne służące do sprawdzania wartości parametru skonfigurowanej przez użytkownika. składnia Google RE2.
`validationErrorMessage` string (opcjonalnie)	Komunikat o błędzie wyświetlany w przypadku nieudanej weryfikacji wyrażenia regularnego.
`required` boolean (opcjonalnie)	Określa, czy użytkownik może przesłać pusty ciąg znaków, gdy zostanie poproszony o wartość parametru. Domyślna wartość to `true`.
`immutable` boolean (opcjonalnie)	Określa, czy użytkownik może zmienić wartość parametru po instalacji (np. jeśli zmodyfikuje konfigurację rozszerzenia). Domyślna wartość to `false`. Uwaga: jeśli zdefiniujesz parametr „location” dla funkcji rozszerzenia, które zostały wdrożone, ustaw to pole na `true`.
`type` string (opcjonalnie)	Typ parametru. Specjalne typy parametrów mogą mieć dodatkowe wymagania lub inną prezentację w interfejsie. Zapoznaj się z sekcjami poniżej.

Parametry do wyboru i wielokrotnego wyboru

Parametry do wyboru i wielokrotny wybór umożliwiają użytkownikom wybór z listy wstępnie zdefiniowanych opcji.

params:
  - param: PARAM_ID
    label: Short description of the parameter
    description: >-
      Do you want to enable the option?
    type: select
    options:
      - label: Yes
        value: true
      - label: No
        value: false
  - param: ANOTHER_PARAM_ID
    label: Short description of the parameter
    description: >-
      Which options do you want to enable?
    type: multiselect
    options:
      - value: red
      - value: green
      - value: blue

Pola parametrów jednokrotnego wyboru

type
ciąg znaków

select lub multiselect

Określa, że parametr może mieć jedną wartość (select) lub kilka wartości (multiselect) wybranych z zestawu wstępnie zdefiniowanych opcji.

options
list of options
(wymagany)

opcje, które użytkownik może wybrać;

Pola opcji
`value` string (wymagany)	Jedna z wartości, które może wybrać użytkownik. To jest wartość, którą uzyskujesz, gdy odczytujesz wartość parametru w kodzie.
`label` ciąg znaków (opcjonalnie)	Krótki opis opcji do wyboru. Jeśli go pominiesz, domyślnie tag będzie w wersji `value`.

Parametry zasobów do wyboru

Parametry z możliwością wyboru umożliwiają użytkownikom wybranie zasobu (instancja bazy danych, zasobnik pamięci itp.) z ich projektu.

params:
  - param: PARAM_ID
    label: Short description of the parameter
    description: >-
      Which resource do you want to use?
    type: selectresource
    resourceType: product.googleapis.com/ResourceType

Pola parametrów zasobu
`type` ciąg znaków	`selectresource` Wskazuje, że parametr reprezentuje zasób projektu.
`resourceType` string (wymagany)	Typ zasobu, który użytkownik ma wybrać. Prawidłowe wartości: `storage.googleapis.com/Bucket` `firestore.googleapis.com/Database` `firebasedatabase.googleapis.com/DatabaseInstance` Obecnie interfejs wyboru mają tylko zasobniki Cloud Storage (inne typy zasobów są przedstawiane jako pola tekstowe do wprowadzania dowolnego tekstu).

Pola parametrów zasobu

type
ciąg znaków

selectresource

Wskazuje, że parametr reprezentuje zasób projektu.

resourceType
string
(wymagany)

Typ zasobu, który użytkownik ma wybrać.

Prawidłowe wartości:

storage.googleapis.com/Bucket
firestore.googleapis.com/Database
firebasedatabase.googleapis.com/DatabaseInstance

Obecnie interfejs wyboru mają tylko zasobniki Cloud Storage (inne typy zasobów są przedstawiane jako pola tekstowe do wprowadzania dowolnego tekstu).

Parametry obiektu tajnego

Wartości tajne podawane przez użytkownika (np. klucze interfejsu API) są obsługiwane inaczej:

Wartości tajne są przechowywane w usłudze Cloud Secret Manager. Dostęp do tych wartości mają tylko autoryzowani klienci (np. zainstalowana instancja rozszerzenia).
Gdy użytkownicy są proszeni o podanie tych wartości, ich dane nie są wyświetlane.

params:
  - param: PARAM_ID
    label: Short description of the parameter
    description: >-
      What is the secret value?
    type: secret

Pola parametrów tajnych
`type` ciąg znaków	`secret` Określa, że parametr jest wartością tajną.

Pola parametrów tajnych

type
ciąg znaków

secret

Określa, że parametr jest wartością tajną.

Zasoby Cloud Functions

Te pola deklarują funkcje Cloud Functions zawarte w rozszerzeniu. Składnia deklaracji zasobów różni się nieco w przypadku funkcji 1 generacji i 2 generacji, które mogą współistnieć w rozszerzeniu.

Cloud Functions pierwszej generacji

resources:
  - name: functionName
    type: firebaseextensions.v1beta.function
    description: >-
      Description of what the function does. (One or two
      sentences.)
    properties:
      runtime: runtime-version
      eventTrigger:
        eventType: google.product.event
        resource: projects/_/resource/specifier

Pola zasobów

name
string
(wymagany)

Przyjazna dla użytkownika nazwa wyeksportowanej funkcji.

Jeśli nie określisz właściwości entryPoint (patrz poniżej), ta wartość musi być zgodna z nazwą funkcji w kodzie źródłowym funkcji.

Ostateczna nazwa wdrożonej funkcji będzie miała format: ext-extension-instance-id-name.

type
string
(wymagany) W przypadku zasobu funkcji 1 generacji:firebaseextensions.v1beta.function

description
string
(wymagany)

Krótki opis zadania wykonywanego przez funkcję w przypadku rozszerzenia.

properties
(wymagane)

Właściwości Cloud Functions pierwszej generacji. Najważniejsze właściwości wymieniono poniżej, ale ich pełną listę znajdziesz w dokumentacji Cloud Functions.

Usługi
`location` (opcjonalnie)	Miejsce, w którym chcesz wdrożyć funkcję. Domyślna wartość to:`us-central1`
`entryPoint` (opcjonalnie)	Nazwa wyeksportowanej funkcji w kodzie źródłowym funkcji, której rozszerzenie powinno szukać. Domyślnie jest ustawiana wartość `name` (patrz wyżej).
`sourceDirectory` (opcjonalnie)	Katalog, który zawiera plik `package.json` w katalogu głównym. Plik z kodem źródłowym funkcji musi znajdować się w tym katalogu. Domyślna wartość to `functions` Uwaga: pole `main` w `package.json` określa plik kodu źródłowego funkcji (np. `index.js`).
`timeout` (opcjonalnie)	Maksymalny czas wykonania funkcji. Domyślnie: `60s` Maksymalna wartość: `540s`
`availableMemoryMb` (opcjonalnie)	Ilość pamięci w MB dostępnej dla funkcji. Domyślnie: `256` Prawidłowe wartości to: `128`, `256`, `512`, `1024` i `2048`.
`runtime` (zalecane)	Środowisko wykonawcze funkcji. Domyślnie wybrana jest najnowsza z wersji Node.js obecnie obsługiwanych przez Cloud Functions. Prawidłowe wartości:`nodejs14`,`nodejs16`,`nodejs18`
`httpsTrigger` lub `eventTrigger` lub `scheduleTrigger` lub `taskQueueTrigger` (wymagany jest jeden z tych typów reguł funkcji)	Szczegółowe informacje o poszczególnych typach reguł znajdziesz w artykule Tworzenie rozszerzeń za pomocą Cloud Functions.

Cloud Functions (2 generacji)

resources:
  - name: functionName
    type: firebaseextensions.v1beta.v2function
    description: >-
      Description of what the function does. (One or two
      sentences.)
    properties:
      buildConfig:
        runtime: nodejs16
      serviceConfig:
        availableMemory: 512M
      eventTrigger:
        eventType: google.firebase.firebasealerts.alerts.v1.published
        triggerRegion: global
        eventFilters:
          - attribute: alerttype
            value: crashlytics.newFatalIssue

Pola zasobów

name
string
(wymagany)

Przyjazna dla użytkownika nazwa wyeksportowanej funkcji.

Jeśli nie określisz właściwości entryPoint (patrz poniżej), ta wartość musi być zgodna z nazwą funkcji w kodzie źródłowym funkcji.

Ostateczna nazwa wdrożonej funkcji będzie miała format: ext-extension-instance-id-name.

type
string
(wymagany) W przypadku zasobu funkcji 2 generacji:firebaseextensions.v1beta.v2function

description
string
(wymagany)

Krótki opis zadania wykonywanego przez funkcję w przypadku rozszerzenia.

properties
(wymagane)

Właściwości Cloud Functions (2 generacji). Najważniejsze właściwości wymieniono poniżej, ale ich pełną listę znajdziesz w dokumentacji Cloud Functions.

Usługi

location
(opcjonalnie)

Miejsce, w którym chcesz wdrożyć funkcję. Domyślna wartość to:us-central1

sourceDirectory
(opcjonalnie)

Katalog, który zawiera plik package.json w katalogu głównym. Plik z kodem źródłowym funkcji musi znajdować się w tym katalogu. Domyślna wartość to functions

Uwaga: pole main w package.json określa plik kodu źródłowego funkcji (np. index.js).

Istnieją też 3 pola typu obiektu z własnymi właściwościami:

Właściwości buildConfig

buildConfig.runtime
(zalecane)

Środowisko wykonawcze funkcji.

Domyślnie wybrana jest najnowsza z wersji Node.js obecnie obsługiwanych przez Cloud Functions.
Prawidłowe wartości:nodejs14,nodejs16,nodejs18

buildConfig.entryPoint
(opcjonalnie) Nazwa wyeksportowanej funkcji w kodzie źródłowym funkcji, której rozszerzenie powinno szukać. Domyślnie jest ustawiana wartość name (patrz wyżej).

Właściwości serviceConfig

serviceConfig.timeoutSeconds
(opcjonalnie)

Maksymalny czas wykonania funkcji.

Domyślnie: 60
Maksymalna wartość: 540

serviceConfig.availableMemory
(opcjonalnie) Ilość pamięci dostępnej dla funkcji. Domyślna wartość to 256M. Obsługiwane jednostki to k, M, G, Mi i Gi. Jeśli nie podasz jednostki, wartość zostanie zinterpretowana jako bajty.

Właściwości eventTrigger
`eventTrigger.eventType` (wymagane)	Typ zdarzenia, na które ma być nasłuchiwane. Typy zdarzeń dostępne w poszczególnych usługach znajdziesz w artykule Tworzenie funkcji Cloud Functions w rozszerzeniu.
`eventTrigger.eventFilters` (opcjonalnie)	Filtry, które dodatkowo ograniczają zdarzenia do nasłuchiwania. Możesz na przykład odbierać tylko zdarzenia pasujące do określonego wzorca zasobu. Informacje o filtrowaniu poszczególnych typów zdarzeń znajdziesz w artykule Tworzenie funkcji Cloud Functions w rozszerzeniu.
`eventTrigger.channel` (opcjonalnie)	Nazwa kanału powiązanego z aktywatorem w formacie `projects/{project}/locations/{location}/channels/{channel}`. Jeśli pominiesz tę właściwość, funkcja będzie nasłuchiwać zdarzeń na kanale domyślnym projektu.
`eventTrigger.triggerRegion` (opcjonalnie)	Wyzwalacz będzie otrzymywać tylko zdarzenia pochodzące z tego regionu. Może to być ten sam region co funkcja, inny region, region wielostrefowy lub region globalny. Jeśli nie zostanie podany, zostanie użyty ten sam region co w przypadku funkcji.

Zdarzenia cyklu życia

Zdarzenia cyklu życia umożliwiają określenie funkcji, które będą wykonywane, gdy użytkownik zainstaluje, zaktualizuje lub skonfiguruje instancję rozszerzenia. Zobacz, jak obsługiwać zdarzenia cyklu życia rozszerzenia.

lifecycleEvents:
  onInstall:
    function: myTaskFunction
    processingMessage: Describes the task being completed
  onUpdate:
    function: myOtherTaskFunction
    processingMessage: Describes the task being completed
  onConfigure:
    function: myOtherTaskFunction
    processingMessage: Describes the task being completed

Pola zdarzeń cyklu życia

onInstall
(opcjonalnie)

Określa funkcję, która działa, gdy użytkownik zainstaluje rozszerzenie.

Specyfikacja funkcji

function
string
(wymagany)

Nazwa funkcji wywoływanej przez kolejkę zadań, która będzie obsługiwać zdarzenie.

Funkcja musi być zadeklarowana w sekcji resources i mieć zdefiniowaną kolejkę zadań taskQueue.

processingMessage
string
(wymagany) Komunikat wyświetlany w konsoli Firebase podczas wykonywania zadania.

onUpdate
(opcjonalnie)

Określa funkcję, która jest wykonywana, gdy użytkownik zaktualizuje rozszerzenie.

Specyfikacja funkcji

function
string
(wymagany)

Nazwa funkcji wywoływanej przez kolejkę zadań, która będzie obsługiwać zdarzenie.

Funkcja musi być zadeklarowana w sekcji resources i mieć zdefiniowaną kolejkę zadań taskQueue.

processingMessage
string
(wymagany) Komunikat wyświetlany w konsoli Firebase podczas wykonywania zadania.

onConfigure
(opcjonalnie)

Określa funkcję, która jest wykonywana, gdy użytkownik ponownie skonfiguruje rozszerzenie.

Specyfikacja funkcji

function
string
(wymagany)

Nazwa funkcji wywoływanej przez kolejkę zadań, która będzie obsługiwać zdarzenie.

Funkcja musi być zadeklarowana w sekcji resources i mieć zdefiniowaną kolejkę zadań taskQueue.

processingMessage
string
(wymagany) Komunikat wyświetlany w konsoli Firebase podczas wykonywania zadania.

Zdarzenia niestandardowe (Eventarc)

Zdarzenia niestandardowe to zdarzenia emitowane przez Twoje rozszerzenie, które umożliwiają użytkownikom wstawianie do niego własnej logiki. Zobacz sekcję Eventarc w artykule Dodawanie elementów wywołujących w rozszerzeniu.

events:
  - type: publisher-id.extension-name.version.event-name
    description: Description of the event
  - type: publisher-id.extension-name.version.another-event-name
    description: Description of the other event

Pola zdarzeń niestandardowych
`type` string (wymagany)	Identyfikator typu zdarzenia. Utwórz identyfikator z 3–4 oddzielonych kropką pól: identyfikator wydawcy, nazwa rozszerzenia i nazwa zdarzenia są wymagane, pole wersji jest zalecane. Wybierz unikalną i opisową nazwę zdarzenia dla każdego publikowanego typu zdarzenia.
`description` string (wymagany)	Opis zdarzenia.