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 eklenti manifestoları, düzenleyiciyi genişletiyorlarsa Zorunlu olarak işaretlenen tüm bileşenleri içermelidir.

Editörler

Düzenleyici uzantıları için Google Workspace eklenti manifest yapılandırması. Ayrıntılar için Google Workspace eklentileriyle Editors'ı genişletme başlıklı makaleyi inceleyin.

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

object (HomepageTrigger)

Bu tetikleyici işlevi, ana makine uygulamasında eklenti ana sayfasını oluşturur. Bu işlev, addOns.common.homepageTrigger değerini geçersiz kılar.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Eklenti, geçerli dokümana özgü davranışlar içeriyorsa gereklidir. Kullanıcı drive.file kapsamını yetkilendirdiğinde tetiklenir.

linkPreviewTriggers[]

object (LinkPreviewTriggers)

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

createActionTriggers[]

object (createActionTriggers)

Üçüncü taraf kaynağı oluşturmak için gereklidir. @ menüsünden üçüncü taraf hizmetinde kaynak oluşturmak için kullanılan tetikleyicilerin listesi. Ayrıntılı bilgi için Akıllı çiplerle üçüncü taraf kaynakları oluşturma başlıklı makaleyi inceleyin.

OnFileScopeGrantedTrigger

İstek dosyası kapsamı iletişim kutusu CardService.newEditorFileScopeActionResponseBuilder().requestFileScopeForActiveDocument().build(); kullandığında ve kullanıcı drive.file kapsamı yetkilendirmesi verdiğinde tetiklenen bağlamsal tetikleyici yapılandırması.

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

string

drive.file kapsamı verilirse çalıştırılacak işlevin adı. İşlev, kullanıcı arayüzü için bir Card nesne dizisi döndürmelidir.

LinkPreviewTriggers

Kullanıcı bir üçüncü taraf hizmetinden bağlantı yazıp yapıştırdığında tetiklenen bir tetikleyicinin yapılandırması Dokümanlar, E-Tablolar veya Slaytlar dosyasına.

Bu tetikleyiciyi bir Google Workspace eklentisi için ayarlamak istiyorsanız Akıllı çipleri kullanarak bağlantıları önizleme başlıklı makaleyi inceleyin.

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

string

Zorunludur. Kullanıcıları bağlantının önizlemesini yapmaya yönlendiren örnek bir akıllı çipin metni (ör. Example: Support case). Bu metin statiktir.
localizedLabelText

map (key: string, value: string)

İsteğe bağlı. labelText haritası, diğer dillere yerelleştirilecek. Dili ISO 639, ülkeyi/bölgeyi ise ISO 3166 biçiminde ve aralarına tire - koyarak girin.
patterns[]

object (UriPattern)

Zorunludur. Eklentinin bağlantıları önizlemesini tetikleyen URL kalıpları dizisi.
runFunction

string

Zorunludur. Kullanıcı https://www.googleapis.com/auth/workspace.linkpreview kapsamına yetki verdiğinde çalıştırılacak işlevin adı. İşlev, önizlenecek URL'yi içeren bir matchedUrl.url özelliği içeren bir etkinlik nesnesini kabul etmeli ve bir Card nesnesi döndürmelidir.
logoUrl

string

İsteğe bağlı. Akıllı çipte ve önizleme kartında gösterilen simge. Boş bırakılırsa eklenti, araç çubuğu simgesini logoUrl kullanır.

UriPattern

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

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

string

Her URL kalıbı için zorunludur. URL kalıbı alanı. Eklenti, bu alan adını içeren bağlantıları önizler. Tüm alt alan adlarını eşleştirmek için yıldız joker karakteri (*) kullanın.
pathPrefix

string

İsteğe bağlı. Alana eklenen yol. Alandaki tüm URL'lerle eşleşmek için pathPrefix değerini boş bırakın.

CreateActionTriggers

Kullanıcı, Google Dokümanlar'daki @ menüsünden üçüncü taraf entegrasyonu menü öğesini seçtiğinde tetiklenen bir tetikleyicinin yapılandırması.

Bu tetikleyiciyi Google Workspace eklentisi için ayarlamak istiyorsanız Akıllı çiplerle üçüncü taraf kaynakları oluşturma başlıklı makaleyi inceleyin.

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

string

Zorunludur. Bu uzantı noktasının benzersiz kimliği. [a-zA-Z0-9-]+. biçiminde en fazla 64 karakter kullanın.
labelText

string

Zorunludur. @ menüsünde görünen metinler (ör. Create support case).
localizedLabelText

map (key: string, value: string)

İsteğe bağlı. Yerelleştirilecek labelText haritası. Dili ISO 639, ülkeyi/bölgeyi ise ISO 3166 biçiminde ve aralarına kısa çizgi - koyarak biçimlendirin.
runFunction

string

Zorunludur. Kullanıcı bir uzantı noktası seçtiğinde çalıştırılacak işlevin adı. İşlev, bir form kartı döndürmelidir.
logoUrl

string

İsteğe bağlı. @ menüsünde gösterilen simge. Boş bırakılırsa eklenti, araç çubuğu simgesini logoUrl kullanır.