Düzenleyici manifest kaynağı

Düzenleyicilerdeki Google Workspace eklentisi içeriğini ve davranışını tanımlamak için kullanılan kaynak yapılandırması. Google Workspace eklentisi manifest dosyalarında şunlar bulunmalıdır: Düzenleyici'yi genişlettikleri takdirde Gerekli olarak işaretlenen tüm bileşenler.

Editörler

Şu kullanıcı için Google Workspace eklentisi manifest yapılandırması: Düzenleyici uzantıları. Görüntüleyin Google Workspace Eklentileriyle Düzenleyicileri Genişletme konulu videomuzu izleyin.

JSON gösterimi
  {
    "homepageTrigger": {
      object (HomepageTrigger)
    },
    "onFileScopeGrantedTrigger": {
      object (OnFileScopeGrantedTrigger)
    },
    "linkPreviewTriggers": [
      {
        object (LinkPreviewTriggers)
      }
    ],
    "createActionTriggers": [
      {
        object (CreateActionTriggers)
      }
  }
Alanlar
homepageTrigger

object (HomepageTrigger)

Bu tetikleyici işlevi, ana sayfayı ana makine uygulaması. Bu, geçersiz kılma addOns.common.homepageTrigger.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Eklentiniz Kullanıcı drive.file kapsamını yetkilendirdiğinde tetiklenen düzenleyici dokümanı.

linkPreviewTriggers[]

object (LinkPreviewTriggers)

Bağlantı önizlemeleri için gereklidir. Tetikleyiciler listesi: Google Dokümanlar, E-Tablolar veya Slaytlar dosyasındaki bağlantıları önizleme. Ayrıntılı bilgi için Akıllı çiplerle bağlantıları önizleme başlıklı makaleyi inceleyin.

createActionTriggers[]

object (createActionTriggers)

Üçüncü taraf kaynak oluşturmak için gereklidir. @ menüsünden üçüncü taraf bir hizmette kaynak oluşturmaya yönelik tetikleyicilerin listesi. Ayrıntılı bilgi için Akıllı çiplerle üçüncü taraf kaynakları oluşturma başlıklı makaleyi inceleyin.

OnFileScopeGrantedTrigger

Aşağıdaki durumlarda etkinleşen bağlamsal bir tetikleyici için CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build(); kullanarak ve kullanıcı drive.file izni verdiğinde, istek dosyası kapsamı iletişim kutusu kapsam yetkilendirmesi.

JSON gösterimi
{
  "runFunction": string
}
Alanlar
runFunction

string

drive.file kapsamı bu durumda çalıştırılacak işlevin adı verildi. Belirtilmişse, oluşturmak ve dizisi döndür Eklenti kullanıcı arayüzünde gösterilecek Card nesneleri.

LinkPreviewTriggers

Kullanıcı bir bağlantı yazdığında veya yapıştırdığında tetiklenen tetikleyicilere yönelik yapılandırma bir üçüncü taraf ya da Google dışı bir hizmetten Dokümanlar'a E-Tablolar veya Slaytlar dosyası.

Bu tetikleyiciyi bir Google Workspace eklentisi için ayarlamak isterseniz bkz. Akıllı çiplerle bağlantıları önizleme

JSON gösterimi
{
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
  "patterns": [
    {
      object(patterns)
    }
  ]
}
Alanlar
labelText

string

Zorunludur. Kullanıcılardan bilgi isteyen bir akıllı çip örneği. bağlantıyı önizleyin (örneğin, Example: Support case). Bu metin sabittir ve kullanıcılar eklentiyi yürütmeden önce gösterilir.
localizedLabelText

map (key: string, value: string)

İsteğe bağlı. Diğer dillere yerelleştirilecek labelText haritası. Dili biçimlendirme ISO 639'a uygun olması ve ISO 3166 - kısa çizgiyle ayırın. Örneğin, en-US.

Bir kullanıcının yerel ayarı haritanın anahtarlarında mevcutsa kullanıcı yerelleştirilmiş sürümüne (labelText) göre.

patterns[]

object (UriPattern)

Zorunludur. Önizleme bağlantılarında eklentiyi tetikleyen URL kalıpları dizisi.
runFunction

string

Zorunludur. Kullanıcı, https://www.googleapis.com/auth/workspace.linkpreview kapsamını yetkilendirdiğinde çalıştırılacak işlevin adı. Belirtildiyse bu işlevi, bağımsız değişken olarak EDITOR_NAME.matchedUrl.url içeren bir etkinlik nesnesini kabul edecek ve eklenti kullanıcı arayüzünde bağlantı önizlemesi gösteren tek bir Card nesnesi döndürecek şekilde uygulamanız gerekir.
logoUrl

string

İsteğe bağlı. Akıllı çip ve önizleme kartında gösterilen simge. Eğer atlanırsa eklenti, kendi araç çubuğu simgesini (logoUrl) kullanır.

UriPattern

Bir bağlantı önizlemesini tetikleyen her URL kalıbının yapılandırması.

JSON gösterimi
{
  "hostPattern": string,
  "pathPrefix" : string
}
Alanlar
hostPattern

string

Önizlemek için her URL kalıbı için gereklidir. URL kalıbının alanı. Eklenti, URL'de bu alan adını içeren bağlantıları önizler. subdomain.example.com gibi belirli bir alt alan adının bağlantılarını önizlemek için alt alan adını ekleyin. Alanın tamamı için bağlantıları önizlemek isterseniz alt alan olarak yıldız işareti (*) içeren bir joker karakter belirtin.

Örneğin, *.example.com şununla eşleşir: subdomain.example.com ve another.subdomain.example.com.

pathPrefix

string

İsteğe bağlı. hostPattern öğesinin alanını ekleyen yol.

Örneğin, URL ana makine kalıbı support.example.com ise support.example.com/cases/ alanında barındırılan destek kayıtlarına ait URL'leri eşleştirmek için cases kullanın.

Ana makine kalıbı alanındaki tüm URL'leri eşleştirmek için pathPrefix alanını boş bırakın.

CreateActionTriggers

Kullanıcı üçüncü tarafı seçtiğinde tetiklenen bir tetikleyicinin yapılandırması entegrasyon menüsü öğesini seçin.

Bu tetikleyiciyi bir Google Workspace eklentisi için ayarlamak isterseniz bkz. Akıllı çiplerle üçüncü taraf kaynakları oluşturma

JSON gösterimi
{
  "id": string,
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
}
Alanlar
id

string

Zorunludur. Bu uzantıyı ayırt etmek için kullanılan benzersiz kimlik puan. Kimlik en fazla 64 karakter içerebilir ve şu biçimde olmalıdır: [a-zA-Z0-9-]+.
labelText

string

Zorunludur. @ işaretinde görünen metin (Create support case gibi).
localizedLabelText

map (key: string, value: string)

İsteğe bağlı. Diğer dillere yerelleştirilecek labelText haritası. Dili biçimlendirme ISO 639'a uygun olması ve ISO 3166 - kısa çizgiyle ayırın. Örneğin, en-US.

Bir kullanıcının yerel ayarı haritanın anahtarlarında mevcutsa kullanıcı yerelleştirilmiş sürümüne (labelText) göre.

runFunction

string

Zorunludur. Kullanıcı @ menüsünden bir uzantı noktası seçtiğinde çalıştırılacak işlevin adı. İşlev, üçüncü taraf kaynağını oluşturmak için girişlerin bulunduğu bir form kartı döndürmelidir.
logoUrl

string

İsteğe bağlı. @ menüsünde görüntülenen simge. Eğer atlanırsa eklenti, kendi araç çubuğu simgesini (logoUrl) kullanır.