Düzenleyici manifest kaynağı

Düzenleyiciler içindeki 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, Düzenleyici'nin kapsamını genişleten tüm bileşenler Zorunlu olarak işaretlenmelidir.

Düzenleyiciler

Editor uzantıları için Google Workspace eklentisi manifest yapılandırması. Daha fazla bilgi için Google Workspace Eklentileriyle Düzenleyicileri Genişletme bölümünü 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 ana sayfa eklentisini oluşturur. Bu, addOns.common.homepageTrigger eklentisini geçersiz kılar.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Eklentiniz, kullanıcı drive.file kapsamını yetkilendirdiğinde tetiklenen mevcut Editor dokümanına özel davranışlar içeriyorsa gereklidir.
linkPreviewTriggers[]

object (LinkPreviewTriggers)

Bağlantı önizlemeleri için gereklidir. Google Dokümanlar, E-Tablolar veya Slaytlar dosyasındaki bağlantıları önizlemeye yönelik tetikleyicilerin listesi. 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

CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build(); kullanan ve kullanıcı, drive.file kapsam yetkilendirmesi verdiğinde istek dosyası kapsamı iletişim kutusu olduğunda tetiklenen bağlamsal tetikleyici için yapılandırma.

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

string

drive.file kapsamı verilirse çalıştırılacak işlevin adı. Belirtilirse eklenti kullanıcı arayüzünde görüntülenecek bir Card nesne dizisi derleyip döndürmek için bu işlevi uygulamanız gerekir.

LinkPreviewTriggers

Kullanıcı üçüncü taraf veya Google dışı bir hizmetteki bağlantıyı bir Dokümanlar, E-Tablolar veya Slaytlar dosyasına yazdığında ya da yapıştırdığında tetiklenen bir tetikleyicinin yapılandırmasıdır.

Bu tetikleyiciyi bir Google Workspace eklentisi için ayarlamak istiyorsanız Akıllı çiplerle bağlantıları önizleme bölümüne bakın.

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

string

Zorunludur. Kullanıcılardan bağlantıyı önizlemelerini isteyen örnek bir akıllı çipin metni (ör. 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 ISO 639, ülke/bölgeyi ise ISO 3166'ya uygun şekilde biçimlendirin. Öğeleri kısa çizgiyle (-) ayırın. Örneğin, en-US.

Bir kullanıcının yerel ayarı haritanın anahtarlarında yer alıyorsa labelText, yerelleştirilmiş sürümünü görür.
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ı. Belirtilirse bu işlevi, bağımsız değişken olarak EDITOR_NAME.matchedUrl.url içeren bir etkinlik nesnesini kabul etmek ve eklenti kullanıcı arayüzünde bağlantı önizlemesi gösteren tek bir Card nesnesi döndürmek için uygulamanız gerekir.
logoUrl

string

İsteğe bağlı. Akıllı çip ve önizleme kartında gösterilen simge. 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, subdomain.example.com ve another.subdomain.example.com ile eşleşir.
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ı Google Dokümanlar @ menüsünden bir üçüncü taraf entegrasyon menü öğesi seçtiğinde tetiklenen bir tetikleyiciye yönelik yapılandırma.

Bu tetikleyiciyi bir 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ı ayırt etmek için kullanılan benzersiz kimlik. Kimlik en fazla 64 karakter içerebilir ve [a-zA-Z0-9-]+. biçiminde olmalıdır.
labelText

string

Zorunludur. @ menüsünde görünen Create support case gibi metin.
localizedLabelText

map (key: string, value: string)

İsteğe bağlı. Diğer dillere yerelleştirilecek labelText haritası. Dili ISO 639, ülke/bölgeyi ise ISO 3166'ya uygun şekilde biçimlendirin. Öğeleri kısa çizgiyle (-) ayırın. Örneğin, en-US.

Bir kullanıcının yerel ayarı haritanın anahtarlarında yer alıyorsa labelText, yerelleştirilmiş sürümünü görür.
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. Atlanırsa eklenti kendi araç çubuğu simgesini (logoUrl) kullanır.