Google Workspace Eklentileri, müşterilerinize kullanıcı Google Drive'ı kullanırken arayüz oluşturur. Bu, kullanıcıya görevleri otomatik hale getirir ve üçüncü tarafları bağlarken sistemleri Google Drive'a aktarın.
Eklenti kullanıcı arayüzüne erişme
Google Workspace eklentisini şurada açabilirsiniz: Google Drive simgesi simge sütununu tıklayın. CEVAP Google Workspace eklentisi bir ana sayfa arayüzü, bir öğe seçme arayüzü veya her ikisini birden tanımlayın:
- Kullanıcı Google Drive'da eklenti simgesini tıklarsa
eklenti yürütülür
ilgili
drive.homepageTrigger
işlevini kullanın (varsa). Bu işlev bir ana sayfa kartı oluşturur ve döndürür Google Drive'a ekleyin. Yanıt hayır isedrive.homepageTrigger
işlevi tanımlanırsa bunun yerine genel bir ana sayfa kartı gösterilir. - Kullanıcı Google Drive'da bir veya daha fazla öğe seçer ve ardından eklentiyi tıklarsa
veya eklenti açıkken öğeleri seçtiğinde eklenti, alakalı
drive.onItemsSelectedTrigger
bağlamsal işlev (varsa). Bu işlev, eklentinin Google Drive'ını oluşturur içeriğe dayalı "seçilen öğeler" arayüz ve görüntülemek üzere Google Drive'a geri gönderir.
Eklenti Drive arayüzü oluşturma
Buradaki genel talimatları uygulayarak Google Drive'ı genişleten arayüzler oluşturabilirsiniz. için şu adımları izleyin:
- Eklentinizin Drive'a özel bir eklenti olmasını isteyip istemediğinize karar verin. homepage. Ayrıca, kullanıcının ne zaman ziyaret ettiğine ilişkin bağlamsal Drive öğelerini seçer.
- Uygun
addOns.common
veaddOns.drive
alanı komut dosyası projesi manifest şunları içerir: gerekli tüm Drive kapsamları. - Drive'a özel bir ana sayfa sağlıyorsanız
drive.homepageTrigger
işlevini kullanmanız gerekir. Ayrıca,common.homepageTrigger
birden fazla Google Workspace ana makinesine yönelik arayüz sağlar. - Drive içeriğe dayalı öğe seçme arayüzü sağlıyorsanız
drive.onItemsSelectedTrigger
uygulamak bağlamsal tetikleyici işlevi görür. Seçili öğeler için Drive içerik arayüzü başlıklı makaleyi inceleyin) inceleyebilirsiniz. - Kullanıcının Düğme tıklamaları gibi kullanıcı arayüzü etkileşimleri.
Drive ana sayfaları
Google Drive, Google Workspace Eklentisinin gösterilmesini destekler
ana sayfalar.
Eklentinizin ortak ana sayfasının Google Drive'da gösterilmesi için
bir addOns.drive
alanıdır
manifest dosyasında bulun.
Alternatif olarak,
drive.homepageTrigger
eklenti manifest dosyasını eklemeniz gerekir.
Her iki durumda da,
eklentisinin komut dosyası projesidir. Bu fonksiyon, yeni bir istem oluşturmak için
Gerektiğinde Drive ana sayfasına erişin. Doğru aracı oluşturmak için
tek bir tane döndür
Card
veya bir dizi
Card
nesneleri içerir. Ana sayfa tetikleyici işlevi,
etkinlik nesnesi
gibi bazı genel bilgileri içeren bir parametre olarak gösterilir.
platformu. Etkinlik nesnesi verilerini kullanarak,
ana sayfa.
Seçilen öğeler için Drive içerik arayüzü
Google Drive, kullanılacak arayüzü belirlemek için bağlamsal bir tetikleyici kullanır
(varsa) gösterilir.
etkinleştiğinde, tetikleyici etiketi tarafından belirtilen bağlamsal tetikleyici işlevini yürütür.
drive.onItemsSelectedTrigger.runFunction
alanı, eklenti manifest dosyasında gösterilir.
Drive için içeriğe dayalı öğe seçme arayüzü oluşturmak üzere aşağıdakileri yapmanız gerekir: takip etmek için:
Eklentinin manifestinin aşağıdakileri içerdiğinden emin olun:
https://www.googleapis.com/auth/drive.addons.metadata.readonly
. kapsamManifest dosyasında
drive.onItemsSelectedTrigger
bölümüne ekleyin.drive.onItemsSelectedTrigger
girin. Bu işlev, bağımsız değişken olarak etkinlik nesnesini kabul eder ve tek birCard
nesnesi veya bir dizisiCard
nesne algılandı.Herhangi bir kartta olduğu gibi, Widget etkileşimine olanak tanır. Örneğin, arayüzde, onun yerine İşlem ve düğme tıklandığında çalışan, uygulanmış bir geri çağırma işlevinden oluşur.
Etkinlik nesneleri
Bir etkinlik nesnesi oluşturulur ve iletilir
drive.homepageTrigger
veya drive.onItemsSelectedTrigger
tetikleyici işlevi çağırır. Tetikleyici işlevi,
eklenti kartlarının nasıl oluşturulacağını belirlemek için bu etkinlik nesnesindeki bilgileri
veya eklenti davranışını başka şekilde kontrol edebilir.
Etkinlik nesnelerinin tam yapısı aşağıda açıklanmıştır: Etkinlik nesneleri. Drive, eklentinin işlem ana makine uygulaması olduğunda, bağlamsal etkinlik nesneleri şunları içerir: Drive etkinlik nesnesi Drive'a özgü istemci bilgilerini taşıyan bir alanı kontrol eder.
Öğe seçimi tetikleyicileri için bağlamsal Drive etkinlik nesneleri bilgi içerir tetikleyici etkinleştiğinde kullanıcının seçtiği öğeler hakkında. Bir kullanıcı Drive'da birden fazla öğe seçerse, öğelerden birinin birincil menfaat; bu öğeye etkin imleç öğesi adı verilir.
Aşağıdaki örnekte bir
Drive etkinlik nesnesi
drive.onItemsSelectedTrigger
işlev:
{
"commonEventObject": { ... },
"drive": {
"activeCursorItem":{
"addonHasFileScopePermission": true,
"id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
"iconUrl": "https://drive-thirdparty.googleusercontent.com...",
"mimeType":"application/pdf",
"title":"How to get started with Drive"
},
"selectedItems": [
{
"addonHasFileScopePermission": true,
"id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
"iconUrl":"https://drive-thirdparty.googleusercontent.com...",
"mimeType":"application/pdf",
"title":"How to get started with Drive"
},
...
]
},
...
}