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. Uygulama 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. Kullanıcının bağlı Drive uygulamalarının listesinde ve "Şu programla 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 "Bununla 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. Her biri benzersiz bir URL kullanan birden fazla uygulama sürümünüz varsa (ör. herkese açık sürüm ve belirli kullanıcılara yönelik kısıtlanmış sürüm) 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 benzersiz bir şekilde açılması için tasarlanmış 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 yazım hatalarından ve yanlış yazılmalardan 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çabileceği dosyaları temsil eder ancak uygulamanıza özgü değildir. Örneğin, uygulamanız PNG ve JPG resimleri açan bir resim düzenleme uygulaması olabilir. Yalnızca standart medya türlerini ekleyin ve yazım hatalarından ve yanlış yazılmalardan 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 edinmek için state parametresi bölümüne 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ünmesi için Drive kullanıcı arayüzüyle entegrasyon için https://www.googleapis.com/auth/drive.install kapsamını 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ılı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 aç ve Yeni URL

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ığı şekilde 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.