Bir kullanıcı bir dosya seçip Drive kullanıcı arayüzünün "Birlikte aç" menü öğesini tıkladığında Drive, kullanıcıyı ilgili uygulamanın Drive kullanıcı arayüzü entegrasyonunu yapılandırma bölümünde tanımlanan Açı URL'sine yönlendirir.
Drive kullanıcı arayüzü entegrasyonunu yapılandırırken "İçe aktarma" kutusunu işaretlediyseniz kullanıcı, açmak için uygulamaya özel dosyalar ile Google Workspace dosyalarının bir kombinasyonunu seçebilir. Drive kullanıcı arayüzü entegrasyonu yapılandırdığınızda, uygulamaya özel dosyalar "Varsayılan MIME türleri" ve "Varsayılan dosya uzantıları" alanlarında tanımlanır. Google Workspace dosyaları ise "İkincil MIME türleri" ve "İkincil dosya uzantıları" alanlarında tanımlanır.
Drive, kullanıcının açmak istediği her dosya için MIME türlerini, tanımladığınız varsayılan ve ikincil MIME türlerinizle karşılaştırarak kontrol eder:
"Varsayılan MIME türleri" alanında tanımlanan MIME türleri için dosya kimliği uygulamanıza iletilir. Uygulamaya özel dosyaların nasıl işleneceği hakkında bilgi edinmek için Uygulamaya özel dokümanlar için Açık URL'leri işleme bölümüne göz atın.
"İkincil MIME türleri" alanında tanımlanan MIME türleri için Drive kullanıcı arayüzünde, kullanıcıya Google Workspace dosyasının hangi dosya türüne dönüştürüleceğini soran bir iletişim kutusu görüntülenir. Örneğin, Drive kullanıcı arayüzünde bir Google Dokümanlar dosyası seçerseniz ve "İkincil MIME türleri" alanı, uygulamanızın metin/düz veya uygulama/pdf desteklediğini önerirse Drive kullanıcı arayüzü, kullanıcıya Düz Metin veya PDF'ye dönüştürmek isteyip istemediğini sorar.
Google Workspace dosyalarının nasıl işleneceği hakkında bilgi edinmek için Google Workspace dokümanları için açık URL'leri işleme başlıklı makaleye bakın. Google Workspace dokümanları ve MIME türü dönüşüm biçimlerinin listesini Google Workspace dokümanları için MIME türlerini dışa aktarma başlıklı makalede bulabilirsiniz.
Uygulamaya özel dokümanlar için bir Açık URL'yi işleyin
Drive kullanıcı arayüzü entegrasyonunu yapılandırma bölümünde belirtildiği gibi, uygulamanız dosyayı açması için gerekli bilgileri içeren şablon değişkenleri alır. Uygulamanız, state
parametresi içinde varsayılan bir şablon değişkenleri grubu alır. Uygulamaya özel bir Açılış URL'si için varsayılan state
bilgileri şunlardır:
{
"ids": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
Bu çıkış aşağıdaki değerleri içerir:
- ID: Üst klasörün kimliği.
- RESOURCE_KEYS: İlgili kaynak anahtarlarıyla eşlenen dosya kimliklerinin bir JSON sözlüğü.
open
: Gerçekleştirilen işlem. Açık URL kullanılırken değeropen
'dir.- USER_ID: Kullanıcıyı benzersiz şekilde tanımlayan profil kimliği.
Uygulamanızın aşağıdaki adımları uygulayarak bu istek üzerine işlem yapması gerekir:
action
alanınınopen
değerinin olduğunu veids
alanının mevcut olduğunu doğrulayın.- Kullanıcı için yeni bir oturum oluşturmak isterseniz
userId
değerini kullanın. Oturum açmış kullanıcılar hakkında daha fazla bilgi edinmek için Kullanıcılar ve yeni etkinlikler bölümüne göz atın. - İzinleri kontrol etmek, dosya meta verilerini getirmek ve
ID
değerlerini kullanarak dosya içeriğini indirmek içinfiles.get
yöntemini kullanın. - İstekte
resourceKeys
ayarlandıysaX-Goog-Drive-Resource-Keys
istek başlığını ayarlayın. Kaynak anahtarları hakkında daha fazla bilgi için Kaynak anahtarlarını kullanarak bağlantıyla paylaşılan dosyalara erişme bölümüne bakın.
state
parametresi URL olarak kodlandığı için uygulamanız çıkış karakterlerini işlemeli ve JSON olarak ayrıştırmalıdır.
Google Workspace dokümanları için açık URL'leri işleme
Drive kullanıcı arayüzü entegrasyonunu yapılandırma bölümünde belirtildiği gibi, uygulamanız state
parametresi içinde varsayılan bir grup şablon değişkeni alır. Google Workspace Açılış URL'si için varsayılan state
bilgileri şu şekildedir:
{
"exportIds": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
Bu çıkış aşağıdaki değerleri içerir:
- EXPORT_ID: Dışa aktarılan dosya kimliklerinin virgülle ayrılmış listesi (yalnızca yerleşik Google dokümanlarını açarken kullanılır).
- RESOURCE_KEYS: İlgili kaynak anahtarlarıyla eşlenen dosya kimliklerinin bir JSON sözlüğü.
open
: Gerçekleştirilen işlem. Açık URL kullanılırken değeropen
'dir.- USER_ID: Kullanıcıyı tanımlayan profil kimliği.
Uygulamanızın aşağıdaki adımları uygulayarak bu istek üzerine işlem yapması gerekir:
state
alanındakiopen
değerini veexportIds
alanının varlığını algılayarak bunun bir dosya açma isteği olduğunu doğrulayın.İzinleri kontrol etmek, dosya meta verilerini getirmek ve
EXPORT_ID
değerlerini kullanarak MIME türünü belirlemek içinfiles.get
yöntemini kullanın.files.export
yöntemini kullanarak dosya içeriğini dönüştürün. Aşağıdaki kod örneğinde bir Google Workspace dokümanının istenen MIME türüne nasıl dışa aktarılacağı gösterilmektedir.İstekte
resourceKey
ayarlandıysaX-Goog-Drive-Resource-Keys
istek başlığını ayarlayın. Kaynak anahtarları hakkında daha fazla bilgi için Kaynak anahtarlarını kullanarak bağlantıyla paylaşılan dosyalara erişme bölümüne bakın.Java
Python
Node.js
PHP
Dönüştürülen dosyaları salt okunur olarak görüntüleyin veya kullanıcının dosyayı yeni dosya türü olarak kaydetmesine olanak tanıyan bir iletişim kutusu gösterin.
state
parametresi URL olarak kodlandığı için uygulamanız çıkış karakterlerini işlemeli ve JSON olarak ayrıştırmalıdır.
Kullanıcılar ve yeni etkinlikler
Drive uygulamaları, tüm "Birlikte aç" etkinliklerini potansiyel oturum açma etkinlikleri olarak işlemelidir. Bazı kullanıcıların birden fazla hesabı olabilir. Bu nedenle, state
parametresindeki kullanıcı kimliği mevcut oturumla eşleşmeyebilir. state
parametresindeki kullanıcı kimliği geçerli oturumla eşleşmiyorsa uygulamanızın geçerli oturumu sonlandırılıp istenen kullanıcı olarak oturum açın.
İlgili konular
Uygulamalar, Google Drive kullanıcı arayüzünden uygulama açmanın yanı sıra uygulama içinden içerik seçmek için bir dosya seçici görüntüleyebilir. Daha fazla bilgi için Google Seçici'ye bakın.