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örüntülemek için öncelikle bir Drive kullanıcı arayüzü (UI) entegrasyonu ayarlamanız gerekir. Uygulamanızı Google Workspace Marketplace'te listelemek için de yapılandırma gereklidir.

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ü ile entegrasyona başlamak için Drive API'yi etkinleştirmeniz gerekir. Bu şekilde, API'ye ve kullanıcı arayüzü entegrasyon özelliklerine erişebilirsiniz.

Drive kullanıcı arayüzü entegrasyonunu ayarlayın

  1. Google API Konsolu'nda 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 tarafındaki 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ı) Application name (Uygulama adı) alanına bir ad girin. Uygulama adı, kullanıcılara Drive ayarlarının Uygulamaları Yönet sekmesinde gösterilir.
  5. (İsteğe bağlı) Kısa açıklama alanına kısa, tek satırlık bir açıklama girin. Kısa açıklama, kullanıcılara Drive ayarlarındaki Uygulamaları Yönet sekmesinde 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ı listesinde ve "Birlikte aç" içerik menüsünde görüntülenecek 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ç" içerik menüsü tarafından kullanılır.

    • Bu URL, tam nitelikli bir alan adı içermelidir. localhost çalışmaz.
    • Uygulamanızı kullananların bu URL'ye erişebilmeleri gerekir. Birden fazla uygulama sürümünüz varsa (örneğin, herkese açık sürüm ve belirli kullanıcılara yönelik kısıtlanmış sürüm için bir sürüm), 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 önce 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 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çıldığı dosyaları temsil eder. Örneğin, uygulamanız resimlerin katmanlanması ve düzenlenmesi için yerleşik bir biçimi açabilir. Yalnızca standart medya türlerini ekleyin ve yazım hatası ve yazım yanlışı 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ürleri ve dosya uzantıları 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 resimleri açan bir resim düzenleme uygulaması olabilir. Yalnızca standart medya türlerini ekleyin ve yazım hatası ve yazım yanlışı 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ünün "Yeni" düğmesini kullanmak ve kullanıcıların uygulamanızla bir 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 listeleyebilmek için öncelikle 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 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ı 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ı iste

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ü ile entegre olmasını isteyin. Bu kapsamı talep ederken kullanıcılar şuna benzer bir iletişim kutusu görür:

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 edinmek için API'ye özel yetkilendirme ve kimlik doğrulama bilgileri bölümüne bakın.

state parametresi

Varsayılan olarak, Drive kullanıcı arayüzünden uygulamanıza veri iletmek için hem Aç URL'ye hem de Yeni URL'ye bir state parametresi eklenir. Bu parametre, şablon değişkenlerini ve uygulamanıza gelen istekle ilgili verileri içeren JSON kodlamalı bir dize içerir. Dahil edilen değişkenler, kullanılan URL türüne (Açık URL 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ı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 ve Yeni URL Aç
{action} Gerçekleştirilen işlem. Değer, Açık URL kullanılırken open, Yeni URL kullanırken create olur. URL ve Yeni URL Aç

state parametresi URL olarak kodlandığı için uygulamanız çıkış 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 bir URL için JSON'de örnek durum bilgileri

Yeni bir URL'nin state bilgileri şunlardır:

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

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

Açık bir 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ız dosya kimliği ve erişim jetonuna sahip olduğunda, izinleri kontrol edebilir, dosya meta verilerini getirebilir ve dosya içeriğini files.get yönteminde açıklandığı gibi indirebilir.

Yüklü uygulamaların, Drive kullanıcı arayüzünden başlatılan işlemleri oluşturabilmesi, yönetebilmesi ve açabilmesi gerekir. Daha fazla bilgi edinmek için Drive kullanıcı arayüzünün "Yeni" düğmesiyle entegre etme veya Drive kullanıcı arayüzünün "Birlikte aç" bağlam menüsüyle entegrasyon başlıklı makalelere bakın.