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 önce Drive kullanıcı arayüzü (UI) entegrasyonu ayarlamanız gerekir. Uygulamanızın Google Workspace Marketplace'te listelenmesi 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 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.

• Google Cloud Console'da Google Drive API'yi etkinleştirin.

  API'yi etkinleştirme

Drive kullanıcı arayüzü entegrasyonunu ayarlama

1. Google API Konsolu'nda Menü > API'ler ve Hizmetler > Etkin API'ler ve hizmetler'e gidin.

   Etkin API'ler ve hizmetler sayfasına git

2. API'ler ve Hizmetler kontrol panelinin en altı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ı, kullanıcılara Drive ayarlarındaki 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, 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, PNG biçiminde ve şeffaf bir arka plana sahip olmalıdır. Simgelerin Drive'da görünmesi 24 saati bulabilir.

   Not: Doküman simgeleri kullanımdan kaldırılmıştır. Uygulama simgeniz, kısayol ve üçüncü taraf kısayol dosyalarının yanında görünür. Diğer dosya türleri için bir dizi standart simge kullanılır.

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 çalışmaz.
   • Uygulamanızı Google Workspace Marketplace'te listelemeden önce bu URL'nin sahipliğini doğrulamanız gerekir.
   • Drive kullanıcı arayüzünden uygulamanıza veri iletmek için varsayılan olarak bu URL'ye bir state sorgu parametresi eklenir. state parametresinin içeriği hakkında bilgi için state parametresi konusuna bakın.
   Uyarı: OAuth 2.0 izin ekranını otomatik olarak gösterme seçeneği kullanımdan kaldırıldı. Bu kutuyu işaretlemeyin. Uygulamanın tüm yetkilendirme isteklerini başlatması gerekir.

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çmak üzere geliştirildiği dosyaları temsil eder. Örneğin, uygulamanız görselleri katmanlar halinde eklemek ve düzenlemek için yerleşik bir biçim açabilir. Yalnızca standart medya türlerini dahil edin ve yazım hataları 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 özel 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 dahil edin ve yazım hataları 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.

    Not: Bir kullanıcı dosyayı açabilecek birden fazla Drive uygulaması yüklerse kullanıcı en son yüklenen uygulama, başka bir uygulama seçene kadar kullanılır.

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ı Doküman 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.
    • Drive kullanıcı arayüzünden uygulamanıza veri iletmek için varsayılan olarak bu URL'ye bir state sorgu parametresi eklenir. state parametresinin içeriği hakkında bilgi için state parametresi konusuna bakın.

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

    Not: Doküman adı alanını boş bırakın. Bu alan artık kullanılmıyor.

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'lar desteği kutusunu işaretleyin. Uygulamanızdaki ortak Drive'ları destekleme hakkında daha fazla bilgi edinmek 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 https://www.googleapis.com/auth/drive.install kapsamının Drive kullanıcı arayüzüyle entegre edilmesini isteyin. Bu kapsam istenirken kullanıcılara aşağıdakine benzer bir iletişim kutusu gösterilir:

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

Drive uygulamaları için istekte bulunabileceğiniz kapsamlar ve nasıl isteneceği hakkında daha fazla bilgi edinmek için API'ye özel yetkilendirme ve kimlik doğrulama bilgileri bölümüne bakın.

Not: Drive uygulamanızı Google Workspace Marketplace'te yayınlarsanız kullanıcılar ve alan yöneticileri uygulamayı doğrudan Google Workspace Marketplace'ten arayabilir ve yükleyebilir.

state parametresi

Drive kullanıcı arayüzünden uygulamanıza veri aktarmak için hem Açık URL'ye hem de yeni URL'ye varsayılan olarak bir state parametresi eklenir. Bu parametre, şablon değişkenlerini içeren JSON kodlamalı bir dize ve uygulamanıza gelen istekle ilgili veriler içerir. Dahil edilen değişkenler, kullanılan URL'nin türüne bağlıdır (Açık URL veya Yeni URL):

Ş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}	İ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.	Açık URL ve Yeni URL
{action}	Gerçekleşen işlem. Değer, Açık URL kullanılırken open, Yeni URL kullanırken ise create şeklindedir.	Açık URL ve Yeni URL

state parametresi URL olarak kodlandığından, 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 URL için JSON'da ö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'daki örnek durum bilgileri

Açık URL'nin state bilgileri:

{
  "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ğine ve erişim jetonuna sahip olduktan sonra izinleri kontrol edebilir, dosya meta verilerini getirebilir ve dosya içeriğini files.get yönteminde açıklandığı gibi indirebilir.

Not: Kısayollardan ve üçüncü taraf kısayollarından dosya açan uygulamalar da dahil olmak üzere tüm uygulamalar, kullanıcının bir dokümanla ilgili izinlerini kontrol etmek için files.get yöntemini çağırmalıdır. Uygulamalar, salt okuma erişimine sahip kullanıcıları düzenleyemezler veya kaydedemedikleri bir dosyayı açarken uyarmalıdır (düzenlemek için zaman harcamalarına ve ardından kaydetme sırasında bir hata görüntülemesine izin vermek yerine).

İlgili konular

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 edinmek için Drive kullanıcı arayüzünün "Yeni" düğmesiyle entegrasyon yapma veya Drive kullanıcı arayüzünün "Birlikte aç" içerik menüsüyle entegrasyon yapma başlıklı makalelere bakın.