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ı. Düzenleyici'yi genişleten Google Workspace eklentisi manifestlerinde tüm bileşenler Zorunlu olarak işaretlenmelidir.

Editörler

Düzenleyici uzantıları için Google Workspace eklentisi manifest yapılandırması. Daha fazla bilgi için Düzenleyicileri Google Workspace eklentileriyle 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 uygulamada eklenti ana sayfasını oluşturur. Bu, addOns.common.homepageTrigger değerini geçersiz kılar.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Eklentiniz, kullanıcı drive.file kapsamına yetki verdiğinde tetiklenen, geçerli Düzenleyici belgesine özgü bir davranış içeriyorsa gereklidir.
linkPreviewTriggers[]

object (LinkPreviewTriggers)

Bağlantı önizlemeleri için gereklidir. Google Dokümanlar, E-Tablolar veya Slaytlar dosyalarındaki bağlantıları önizlemeyle ilgili 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 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

CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build(); kullanılarak dosya kapsamı istek iletişim kutusu açıldığında ve kullanıcı drive.file kapsam yetkilendirmesi verdiğinde tetiklenen bağlama dayalı tetikleyici yapılandırması.

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

string

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

LinkPreviewTriggers

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

Bu tetikleyiciyi bir Google Workspace eklentisi için ayarlamak istiyorsanız Akıllı çiplerle 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ılardan bağlantıyı önizlemesini isteyen örnek bir akıllı çipin metni (Example: Support case gibi). Bu metin statiktir ve kullanıcılar eklentiyi çalıştırmadan önce gösterilir.
localizedLabelText

map (key: string, value: string)

İsteğe bağlı. Diğer dillere yerelleştirilecek labelText haritası. Dili ISO 639, ülkeyi/bölgeyi ise ISO 3166 biçiminde, kısa çizgi - ile ayırarak biçimlendirin. Örneğin, en-US.

Kullanıcının yerel ayarı haritanın anahtarlarında mevcutsa kullanıcı, labelText öğesinin yerelleştirilmiş sürümünü görür.
patterns[]

object (UriPattern)

Zorunludur. Bağlantıları önizlemek için eklentiyi tetikleyen bir 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. 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ının önizlenmesi için gereklidir. URL kalıbının alan adı. Eklenti, URL'sinde bu alanı içeren bağlantıları önizler. Belirli bir alt alan adının (ör. subdomain.example.com) bağlantılarını önizlemek için alt alanı ekleyin. Alan adının tamamının bağlantılarını önizlemek için alt alan adı 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 alanının eklendiği yol.

Örneğin, URL ana makine kalıbı support.example.com ise support.example.com/cases/ adresinde barındırılan destek kayıtlarının URL'lerini eşleştirmek için cases değerini kullanın.

Barındırıcı 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 entegrasyonu menü öğesi seçtiğinde tetiklenen tetikleyicinin yapılandırması.

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 karakterden oluşabilir ve [a-zA-Z0-9-]+. biçiminde olmalıdır.
labelText

string

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

map (key: string, value: string)

İsteğe bağlı. Diğer dillere yerelleştirilecek labelText haritası. Dili ISO 639, ülkeyi/bölgeyi ise ISO 3166 biçiminde, kısa çizgi - ile ayırarak biçimlendirin. Örneğin, en-US.

Kullanıcının yerel ayarı haritanın anahtarlarında mevcutsa kullanıcı, labelText öğesinin 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şturmaya yönelik girişlerin bulunduğu 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.