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

Uygulamanızı, kullanıcı bir dosya oluşturduğunda veya açtığında 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 yapmanız gerekir.

Drive API'yi etkinleştirme

Google API'lerini kullanmadan önce 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 işlem, API'ye ve kullanıcı arayüzü entegrasyonu özelliklerine erişmenizi sağlar.

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ünür.
  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 kısa ve tek satırlık 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 bir açıklama girin.

  7. 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 planlı 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 Açma URL'si alanına uygulamanızın URL'sini girin. Bu URL, "Birlikte Aç" bağlam menüsü tarafından kullanılır.

    • Bu URL, tam nitelikli bir alan adı içermelidir. localhost çalışmaz.
    • Bu URL, uygulamanızın amaçlanan kullanıcıları tarafından erişilebilir olmalıdır. Herkese açık sürüm ve belirli kullanıcılar için sınırlı sürüm gibi birden fazla uygulama sürümünüz varsa her sürümde benzersiz bir URL kullanılmalıdır. Ardından her sürüm için farklı uygulama yapılandırmaları oluşturabilirsiniz.
    • Uygulamanızı Google Workspace Marketplace'te listeleyebilmeniz için bu URL'nin sahipliğini doğrulamanız gerekir.
    • Varsayılan olarak, Drive kullanıcı arayüzündeki verileri uygulamanıza aktarmak için bu URL'ye bir state sorgu parametresi eklenir. state parametresinin içeriği hakkında bilgi edinmek için state parametresi başlıklı makaleyi inceleyin.

  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 özel olarak oluşturulduğu dosyaları temsil eder. Örneğin, uygulamanız görüntüleri katmanlandırmak ve düzenlemek için yerleşik bir biçim açabilir. Yalnızca standart medya türlerini ekleyin ve yazım hatası içermediğinden 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 ancak uygulamanıza özgü olmayan dosyaları temsil eder. Örneğin, uygulamanız PNG ve JPG resimlerini açan bir resim düzenleme uygulaması olabilir. Yalnızca standart medya türlerini ekleyin ve yazım hatası içermediğinden 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ündeki "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 çalışmaz.
    • Uygulamanızı Google Workspace Marketplace'te listelemeden önce bu URL'nin sahipliğini doğrulamanız gerekir.
    • Varsayılan olarak, Drive kullanıcı arayüzündeki verileri uygulamanıza aktarmak için bu URL'ye bir state sorgu parametresi eklenir. state parametresinin içeriği hakkında bilgi edinmek için state parametresi başlıklı makaleyi inceleyin.

  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ı destekleme 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ı isteyin

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

Google Drive kullanıcı arayüzünün yükleme iletişim kutusu.
1. şekil. 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ç URL'sine hem de Yeni URL'ye bir state parametresi eklenir. Bu parametre, şablon değişkenleri ve uygulamanıza yapılan istek hakkında veriler içeren JSON biçiminde kodlanmış bir dize içerir. Hangi değişkenlerin ekleneceği, kullanılan URL türüne (Aç URL'si veya Yeni URL) bağlıdır:

Şablon değişkeni Açıklama URL uygulaması
{ids} Açılan dosya kimliklerinin virgülle ayrılmış listesi. URL'yi aç
{exportIds} Dışa aktarılan dosya kimliklerinin virgülle ayrılmış listesi (yalnızca yerleşik Google dokümanları açılırken kullanılır). URL'yi aç
{resourceKeys} Dosya kimliklerinin ilgili kaynak anahtarlarıyla eşlendiği bir 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. Değer, Açık URL kullanılırken open, Yeni URL kullanılırken create olur. URL'yi aç ve yeni URL

state parametresi URL biçiminde kodlanmıştır. Bu nedenle, uygulamanız kaçış karakterlerini işlemeli ve JSON olarak ayrıştırmalıdır. Uygulamalar, dosya oluşturma isteğini doğrulamak için state parametresindeki create değerini algılayabilir.

Yeni URL için JSON biçiminde örnek durum bilgileri

Yeni URL'nin state bilgileri:

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

Açık URL için JSON biçiminde örnek durum bilgileri

Açık URL'nin state bilgileri şunlardır:

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

Kimlikler ve kaynak anahtarları, dosya meta verilerini getirmek ve dosya içeriğini indirmek için kullanılır. Uygulamanızda dosya kimliği ve erişim jetonu olduğunda, files.get yönteminde açıklandığı gibi izinleri kontrol edebilir, dosya meta verilerini getirebilir ve dosya içeriğini indirebilir.

Yüklü bir uygulama, Drive kullanıcı arayüzünden başlatılan işlemleri oluşturabilmeli, yönetebilmeli 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 "Birlikte aç" bağlam menüsüyle entegrasyon başlıklı makaleleri inceleyin.