Drive kullanıcı arayüzü entegrasyonunu yapılandırma

Bir kullanıcı dosya oluşturduğunda veya açtığında uygulamanızı Google Drive'da göstermek için öncelikle bir Drive kullanıcı arayüzü (UI) entegrasyonu oluşturmanız gerekir. Uygulamanızı Google Workspace Marketplace'te listelemek için de yapılandırma gerekir.

Drive API'yi etkinleştirme

Google API'lerini kullanmadan önce bir Google Cloud projesinde etkinleştirmeniz gerekir. Tek bir Google Cloud projesinde bir veya daha fazla API'yi etkinleştirebilirsiniz.

Google Drive kullanıcı arayüzüyle entegrasyona başlamak için Drive API'yi etkinleştirmeniz gerekir. Bu sayede API'ye ve kullanıcı arayüzü entegrasyon özelliklerine erişebilirsiniz.

Drive kullanıcı arayüzü entegrasyonunu ayarlama

  1. Google API Console'da menü > API'ler ve Hizmetler > Etkin API'ler ve hizmetler'e gidin.

    Etkin API'ler ve hizmetler'e gidin

  2. API'ler ve Hizmetler kontrol panelinin alt kısmında Google Drive API'yi tıklayın. Google Drive API yapılandırma sayfası görüntülenir.
  3. Drive kullanıcı arayüzü entegrasyonu sekmesini seçin.
  4. (İsteğe bağlı) Uygulama adı alanına bir ad girin. Uygulamanın adı, Drive ayarlarındaki Uygulamaları Yönet sekmesinde kullanıcılara gösterilir.
  5. (İsteğe bağlı) Kısa açıklama alanına tek satırlık kısa bir açıklama girin. Kısa açıklama, Drive ayarlarındaki Uygulamaları Yönet sekmesinde kullanıcılara gösterilir.
  6. (İsteğe bağlı) Uzun açıklama alanına tam açıklama girin.

  7. Bir kullanıcının bağlı Drive uygulamaları listesinde ve "Birlikte aç" içerik menüsünde gösterilecek bir veya daha fazla Uygulama simgesi yükleyin. Simgeler, şeffaf arka plana sahip PNG biçiminde olmalıdır. Simgelerin Drive'da görünmesi 24 saati bulabilir.

  8. Drive kullanıcı arayüzünün "Birlikte aç" menü öğesini kullanmak için URL'yi Aç alanına uygulamanızın URL'sini girin. Bu URL, "Birlikte Aç" içerik menüsü tarafından kullanılır.

    • Bu URL, tam nitelikli bir alan adı içermelidir. localhost geçerli değildir.
    • Bu URL, uygulamanızın hedeflenen kullanıcıları tarafından erişilebilir olmalıdır. Herkese açık sürüm için bir tane ve belirli kullanıcılara yönelik kısıtlanmış sürüm için olmak gibi birden çok uygulama sürümünüz varsa her sürüm benzersiz bir URL kullanmalıdır. Ardından her sürüm için farklı uygulama yapılandırmaları oluşturabilirsiniz.
    • Uygulamanızı Google Workspace Marketplace'te listeleyebilmek için bu URL'nin sahibi olduğunuzu doğrulamanız gerekir.
    • Varsayılan olarak, Drive kullanıcı arayüzünden uygulamanıza veri aktarmak için bu URL'ye bir state sorgu parametresi eklenir. state parametresinin içeriği hakkında bilgi edinmek için state parametresi bölümüne bakın.

  9. (İsteğe bağlı) Varsayılan MIME türleri ve Varsayılan dosya uzantıları alanlarına varsayılan MIME türlerini ve dosya uzantılarını girin. Varsayılan MIME türleri ve dosya uzantıları, uygulamanızın açmak için benzersiz bir şekilde oluşturduğu dosyaları temsil eder. Örneğin, uygulamanız resimleri katmanlara ayırmak ve düzenlemek için yerleşik bir biçim açabilir. Yalnızca standart medya türlerini ekleyin ve bunlarda yazım hatası ve yanlış yazım bulunmadığından emin olun. Uygulamanız yalnızca kısayol veya üçüncü taraf kısayol dosyalarını açıyorsa MIME türünü boş bırakabilirsiniz.

  10. (İsteğe bağlı) İkincil MIME türleri ve İkincil dosya uzantıları alanlarına ikincil MIME türlerini ve dosya uzantılarını girin. İkincil MIME türleri ve dosya uzantıları, uygulamanızın açabildiği ancak uygulamanıza özgü olmayan dosyaları temsil eder. Örneğin, uygulamanız PNG ve JPG resimleri açan bir resim düzenleme uygulaması olabilir. Yalnızca standart medya türlerini ekleyin ve bunlarda yazım hatası ve yanlış yazım bulunmadığından emin olun. Uygulamanız yalnızca kısayol veya üçüncü taraf kısayol dosyalarını açıyorsa MIME türünü boş bırakabilirsiniz.

  11. Drive kullanıcı arayüzünün "Yeni" düğmesini kullanmak ve kullanıcıların uygulamanızla dosya oluşturmasını sağlamak için Dosya oluşturma kutusunu işaretleyin. Yeni URL ve isteğe bağlı Belge adı alanları görünür.

    • Bu URL, tam nitelikli bir alan adı içermelidir. localhost geçerli değildir.
    • Uygulamanızı Google Workspace Marketplace'te listeleyebilmek için bu URL'nin sahipliğini doğrulamanız gerekir.
    • Varsayılan olarak, Drive kullanıcı arayüzünden uygulamanıza veri aktarmak için bu URL'ye bir state sorgu parametresi eklenir. state parametresinin içeriği hakkında bilgi için state parametresine bakın.

  12. Yeni URL alanına bir URL girin. Bu URL, kullanıcıyı uygulamanıza yönlendirmek için "Yeni" düğmesi tarafından kullanılır.

  13. (İsteğe bağlı) Uygulamanızın Google Workspace tarafından desteklenen dosyaları açmasını istiyorsanız İçe aktarma kutusunu işaretleyin.

  14. (İsteğe bağlı) Uygulamanızın ortak Drive'lardaki dosyaları yönetmesi gerekiyorsa Ortak Drive desteği kutusunu işaretleyin. Uygulamanızda ortak Drive'ları nasıl destekleyeceğiniz hakkında daha fazla bilgi için Ortak Drive desteğini uygulama başlıklı makaleyi inceleyin.

  15. Gönder'i tıklayın.

drive.install kapsamını isteme

Uygulamaların "Birlikte aç" veya "Yeni" menüsünde seçenek olarak görünmesine izin vermek için https://www.googleapis.com/auth/drive.install kapsamının Drive kullanıcı arayüzüyle entegre edilmesini isteyin. Bu kapsamı isteyen kullanıcılara aşağıdakine benzer bir iletişim kutusu gösterilir:

Google Drive kullanıcı arayüzünün yükleme iletişim kutusu.
Şekil 1. Drive kullanıcı arayüzü için kapsamları kullanırken gösterilen yükleme iletişim kutusu.

Drive uygulamaları için isteyebileceğiniz kapsamlar ve bunları nasıl isteyeceğiniz hakkında daha fazla bilgi için API'ye özel yetkilendirme ve kimlik doğrulama bilgileri başlıklı makaleyi inceleyin.

state parametresi

Varsayılan olarak, Drive kullanıcı arayüzünden uygulamanıza veri aktarmak için hem Açılan URL'ye hem de Yeni URL'ye bir state parametresi eklenir. Bu parametre, şablon değişkenlerini ve uygulamanıza yapılan istekle ilgili verileri içeren JSON kodlu bir dize içerir. Eklenen değişkenler, kullanılan URL türüne (Açılan URL veya Yeni URL) bağlıdır:

Şablon değişkeni Açıklama URL başvurusu
{ids} Açılan dosya kimliklerinin virgülle ayrılmış listesi. URL'yi aç
{exportIds} Aktarılan dosya kimliklerinin virgülle ayrılmış listesi (yalnızca yerleşik Google dokümanlarını açarken kullanılır). URL'yi aç
{resourceKeys} İlgili kaynak anahtarlarıyla eşlenen dosya kimliklerinin JSON sözlüğü. URL'yi aç
{folderId} Üst klasörün kimliği. Yeni URL
{folderResourceKey} Üst klasörün kaynak anahtarı. Yeni URL
{userId} Kullanıcıyı tanımlayan profil kimliği. URL'yi aç ve Yeni URL
{action} Gerçekleştirilen işlem. Açık URL kullanıldığında değer open, yeni URL kullanıldığında ise create olur. URL'yi ve Yeni URL'yi Aç

state parametresi URL olarak kodlandığından uygulamanızın kaçış karakterlerini işleyip JSON olarak ayrıştırması gerekir. Uygulamalar, dosya oluşturma isteğini doğrulamak için state parametresindeki create değerini algılayabilir.

Yeni bir URL için JSON'da örnek durum bilgileri

Yeni URL için state bilgileri:

{
  "action":"create",
  "folderId":"FOLDER_ID",
  "folderResourceKey":"FOLDER_RESOURCE_KEY",
  "userId":"USER_ID"
}

Açık URL için JSON'da örnek durum bilgileri

Açık URL için state bilgileri:

{
  "ids": ["ID"],
  "resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
  "action":"open",
  "userId":"USER_ID"
}

Kimlikler ve kaynak anahtarları, dosya meta verilerini almak ve dosya içeriğini indirmek için kullanılır. Uygulamanız dosya kimliğine ve erişim jetonuna sahip olduğunda izinleri kontrol edebilir, dosya meta verilerini alabilir ve files.get yönteminde açıklandığı gibi dosya içeriğini indirebilir.

Yüklü bir uygulama, Drive kullanıcı arayüzünden başlatılan işlemleri oluşturmalı, yönetmeli ve açabilmelidir. Daha fazla bilgi için Drive kullanıcı arayüzünün "Yeni" düğmesiyle entegrasyon veya Drive kullanıcı arayüzünün "Şu programla aç" bağlam menüsüyle entegrasyon başlıklı makaleleri inceleyin.