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.
Google Cloud konsolunda Google Drive API'yi etkinleştirin.
Drive kullanıcı arayüzü entegrasyonunu ayarlayın
- Google API Konsolu'nda Menü > API'ler ve Hizmetler > Etkin API'ler ve hizmetler'e gidin.
- 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.
- Drive kullanıcı arayüzü entegrasyonu sekmesini seçin.
- (İ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.
- (İ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.
- (İsteğe bağlı) Uzun açıklama alanına tam açıklama girin.
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.
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çinstate
parametresi bölümüne bakın.
- Bu URL, tam nitelikli bir alan adı içermelidir.
(İ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.
(İ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.
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çinstate
parametresi bölümüne bakın.
- Bu URL, tam nitelikli bir alan adı içermelidir.
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.
(İsteğe bağlı) Uygulamanızın Google Workspace tarafından desteklenen dosyaları açmasını istiyorsanız İçe aktarma kutusunu işaretleyin.
(İ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.
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:
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.
İlgili konular
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.