Google Drive arayüzleri oluşturma

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 ise: drive.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:

  1. 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.
  2. Uygun addOns.common ve addOns.drive alanı komut dosyası projesi manifest şunları içerir: gerekli tüm Drive kapsamları.
  3. 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.
  4. 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.
  5. 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çim arayüzü oluşturmak istiyorsanız takip etmek için:

  1. Eklentinin manifestinin aşağıdakileri içerdiğinden emin olun: https://www.googleapis.com/auth/drive.addons.metadata.readonly. kapsam

  2. Manifest dosyasında drive.onItemsSelectedTrigger bölümüne bakın.

  3. drive.onItemsSelectedTrigger girin. Bu işlev, bağımsız değişken olarak etkinlik nesnesini kabul eder ve tek bir Card nesnesi veya bir dizisi Card nesne algılandı.

  4. 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"
          },
          ...
        ]
      },
      ...
    }