Google Drive arayüzleri oluşturma

Google Workspace eklentileri, kullanıcı Google Drive'ı kullanırken özelleştirilmiş arayüzler sağlayabilir. Bu, kullanıcıya görevleri otomatikleştirebilir ve üçüncü tarafları bağlayarak Google Drive'a aktarmanızı sağlar.

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çip eklenti simgesini tıklarsa ya da eklenti açıkken öğe seçerse eklenti, ilgili drive.onItemsSelectedTrigger bağlam işlevini (varsa) yürütür. 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ünü 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 ana sayfası olmasını isteyip istemediğinize karar verin. Ayrıca, kullanıcı Drive öğeleri seçtiğinde bağlamsal bir arayüz sunmak isteyip istemediğinize karar verin.
  2. Gerekli tüm Drive kapsamları dahil olmak üzere, eklenti komut dosyası projesi manifest dosyasına uygun addOns.common ve addOns.drive alanlarını ekleyin.
  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 bağlama dayalı öğe seçim arayüzü sağlıyorsanız bu arayüzü oluşturmak için bir drive.onItemsSelectedTrigger bağlama dayalı tetikleyici işlevi uygulamanız gerekir. Seçili öğeler için Drive içerik arayüzü başlıklı makaleyi inceleyin) inceleyebilirsiniz.
  5. Kullanıcının kullanıcı arayüzü etkileşimlerine (ör. düğme tıklamaları) yanıt vermek için gereken ilişkili geri çağırma işlevlerini uygulayın.

Drive ana sayfaları

Google Drive, Google Workspace Eklentisinin gösterilmesini destekler ana sayfalar. Eklentinizin ortak ana sayfasını Google Drive'da göstermek için eklentinin manifest dosyasında bir addOns.drive alanı bulunduğundan emin olmanız yeterlidir.

Alternatif olarak, Drive'a özel bir ana sayfa sağlamak için eklenti manifest dosyasına bir drive.homepageTrigger ekleyin.

Her iki durumda da eklentinizin komut dosyası projesinde bir ana sayfa tetikleyici işlevinin adını sağlamanız gerekir. Bu işlev, gerektiğinde Drive ana sayfasını oluşturmak için otomatik olarak çağrılır. Ana sayfayı oluşturan tek bir Card veya Card nesnesi dizisi oluşturmak ve döndürmek için bu işlevi uygulamanız gerekir. Ana sayfa tetikleyici işlevine, istemcinin platformu gibi bazı genel bilgileri içeren bir parametre olarak bir etkinlik nesnesi iletilir. Ana sayfanın yapısını özelleştirmek için etkinlik nesnesi verilerini kullanabilirsiniz.

Seçilen öğeler için Drive bağlamsal arayüzü

Google Drive, kullanıcı bir veya daha fazla Google Drive öğesi seçtiğinde hangi arayüzün (varsa) gösterileceğini belirlemek için bağlamsal tetikleyici kullanır. Tetikleyici etkinleştirildiğinde, eklenti manifesti'ndeki drive.onItemsSelectedTrigger.runFunction alanında belirtilen bağlama dayalı tetikleyici işlevi yürütülür.

Drive için içeriğe dayalı öğe seçim arayüzü oluşturmak istiyorsanız takip etmek için:

  1. Eklentinin manifest dosyasında https://www.googleapis.com/auth/drive.addons.metadata.readonly scope değerinin bulunduğundan emin olun

  2. Manifest dosyasında bir drive.onItemsSelectedTrigger bölümünün bulunduğundan emin olun.

  3. drive.onItemsSelectedTrigger alanında belirtilen işlevi uygulayın. 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üze bir düğme ekleyecekseniz düğmeye bağlı bir İşlem ve düğme tıklandığında çalışan bir geri çağırma işlevi eklemeniz gerekir.

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 veya eklenti davranışını başka bir şekilde kontrol etmek için bu etkinlik nesnesinde bulunan bilgileri kullanabilir.

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ğlama dayalı Drive etkinlik nesneleri, tetikleyici etkinleştirildiğinde kullanıcının seçtiği öğelerle ilgili bilgileri içerir. Kullanıcı Drive'da birden fazla öğe seçtiğinde, öğelerden biri birincil ilgi alanı olarak kabul edilir. Bu öğeye etkin imleç öğesi denir.

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