Google Picker API Referansı

Bu sayfa, Google Picker API'de bulunan sınıfların, yöntemlerin ve numaralanmış türlerin bir listesini içerir. Bu öğelerin tümü google.picker.* ad alanına aittir. 2 tür sınıf ve numaralanmış tür vardır: Google Seçici'yi oluşturmak ve yapılandırmak için kullanılanlar ve kullanıcı bir öğe seçtikten sonra Google Seçici tarafından döndürülenler.

Yapılandırma Sınıfları ve Türleri

Google Seçici'yi oluşturmak ve yapılandırmak için aşağıdaki sınıflar ve numaralanmış türler kullanılır.

DocsUploadView

Google Drive'a doküman yüklemek için DocsUploadView kullanın.

DocsUploadView()Oluşturucu.
DocsUploadView.setIncludeFolders(boolean)Kullanıcının Google Drive'da yükleme yapmak için bir klasör seçmesine olanak tanır.
DocsUploadView.setParent(string)Yükleme hedefini belirtilen klasöre ayarlar. Bu işlem, setIncludeFolders politikasını yanlış olarak geçersiz kılar.

DocsView

DocsView, Google Drive görünümleri için kullanılabilecek bir View alt sınıfıdır.

DocsView(ViewId | undefined)Oluşturucu. ViewId, Google Drive görünümlerinden biri olmalıdır. Varsayılan değer: ViewId.DOCS.
DocsView.setEnableDrives(boolean)Ortak Drive'ları ve içerdikleri dosyaları gösterir. Etkinleştirmeden önce Ortak Drive'ları etkinleştirmek için Google Drive API dokümanlarını inceleyin.
DocsView.setIncludeFolders(boolean)Görünüm öğelerinde klasörleri göster. setOwnedByMe ile birleştirmeyin. setIncludeFolders(true) ayarlandığında setOwnedByMe yoksayılır.
DocsView.setSelectFolderEnabled(boolean)Kullanıcının Google Drive'da klasör seçmesine olanak tanır.
DocsView.setMode(DocsViewMode)Görünümün dokümanları görüntülemek için kullanacağı modu seçer.
DocsView.setOwnedByMe(boolean | undefined)Dokümanları, dokümanların kullanıcıya ait olup olmadığına veya kullanıcıyla paylaşılmış olmasına göre filtreler. Bu ayarı setIncludeFolders ile birleştirmeyin. setIncludeFolders(true) ayarlandığında setOwnedByMe yoksayılır.
DocsView.setParent(string)Görüntülenecek ilk üst klasörü ayarlar.
DocsView.setStarred(boolean)Dokümanları, kullanıcı tarafından yıldız işaretli olup olmamalarına göre filtreler.

DocsViewMode

DocsViewMode, DocsView'da veri görüntülemek için numaralandırılmış bir türdür. Bu değerleri DocsView.setMode çağrılarında kullanın.

DocsViewMode.GRIDDokümanları küçük resim tablosunda görüntüleyin.
DocsViewMode.LISTDokümanları ayrıntılı bir listede görüntüleyin.

Öne Çıkarın

Feature, çeşitli görünümlerde özellikleri açıp kapatmak için kullanılan numaralandırılmış bir türdür. Bu değerleri PickerBuilder.enableFeature ve PickerBuilder.disableFeature çağrılarında kullanın.

Feature.MINE_ONLYGoogle Drive'daki öğeleri gösterirken yalnızca kullanıcıya ait dokümanları göster.
Feature.MULTISELECT_ENABLEDKullanıcının birden fazla öğe seçmesine izin ver.
Feature.NAV_HIDDENGezinme bölmesini gizleyin. Gezinme bölmesi gizlenirse kullanıcılar yalnızca seçilen ilk görünümden seçim yapabilir.
Feature.SIMPLE_UPLOAD_ENABLEDFotoğraf yüklemeleri için, fotoğraf başına seçimin (albüm başına değil) etkinleştirilip etkinleştirilmeyeceğini kontrol eder.
Feature.SUPPORT_DRIVES

Kullanımdan kaldırıldı: Ortak drive öğeleri artık varsayılan olarak dahil edilmektedir.

Ortak drive öğelerinin sonuçlara dahil edilip edilmeyeceği.

Seçici

Picker, kullanıcıyla gerçekleştirilen kullanıcı arayüzü işlemini temsil eden üst düzey nesnedir. Bu nesneler doğrudan oluşturulmaz, bunun yerine PickerBuilder nesnesini kullanır.

Picker.isVisible()Mevcut seçici görünürlüğünü belirten bir boole değeri alın.
Picker.setCallback(function(object))Kullanıcı bir öğe seçtiğinde (veya iptal ettiğinde) çağrılan geri çağırma yöntemini belirtin.
Picker.setRelayUrl(string)Alanlar arası sorunları atlatmak için bir geçiş URL'si belirtin.
Picker.setVisible(boolean)Seçici nesnesinin görünürlüğünü kontrol eder.
Picker.dispose()Seçici nesnesini ortadan kaldırır.

PickerBuilder

PickerBuilder, Picker nesneleri oluşturmak için kullanılır. Aksi belirtilmedikçe, aşağıdaki yöntemlerin döndürme türü PickerBuilder türündedir ve bir çağrıyı birbiri ardına zincirlemenize olanak tanır. Tipik kullanım için Google Seçici kod örneğine bakın.

PickerBuilder()Oluşturucu.
PickerBuilder.addView(View | ViewId)Gezinme bölmesine bir View ekleyin.
PickerBuilder.addViewGroup(ViewGroup)Üst düzey gezinme bölmesine bir ViewGroup ekleyin.
PickerBuilder.build()Seçici nesnesini oluşturun. Seçici nesnesi döndürülür.
PickerBuilder.disableFeature(Feature)Seçici özelliğini devre dışı bırakın.
PickerBuilder.enableFeature(Feature)Seçici özelliğini etkinleştirin.
PickerBuilder.getRelayUrl()shortcuts.rpc için kullanılan geçiş URL'sini alın.
PickerBuilder.getTitle()İletişim kutusu başlığını alın.
PickerBuilder.hideTitleBar()Başlık çubuğunun gösterilmesini devre dışı bırakın. Yeniden etkinleştirmek için setTitle öğesini boş olmayan veya tanımlanmamış bir başlıkla çağırın.
PickerBuilder.isFeatureEnabled(Feature)Bir seçicinin Feature etkin olup olmadığını kontrol edin.
PickerBuilder.setAppId(string)Uygulamanın, Google Drive API üzerinden kullanıcının dosyalarına erişmesine izin vermek için gerekli Google Drive Uygulama Kimliğini belirler.
PickerBuilder.setCallback(method)Geri çağırma yöntemini ayarlayın. Bu yöntem, kullanıcı öğeleri seçtiğinde veya iptal ettiğinde çağrılır. Geri çağırma yöntemi, tek bir geri çağırma nesnesi alır. Geri çağırma nesnesinin yapısı JSON Kılavuzu'nda açıklanmıştır.
PickerBuilder.setDeveloperKey(string)Google API Konsolu'ndan alınan Tarayıcı API'sı anahtarını ayarlar. Tarayıcı API anahtarının nasıl alınacağıyla ilgili ayrıntılar için Geliştirici Kılavuzu'na bakın.
PickerBuilder.setDocument(document)Dokümanı ayarlayın.
PickerBuilder.setLocale(string)ISO 639 dil kodu. Dil desteklenmiyorsa en-US kullanılır. Bu yöntem, yerel ayarın google.load() zamanında belirlenmesine bir alternatif sağlar. Desteklenen yerel ayarların listesi için Geliştirici Kılavuzu'na bakın.
PickerBuilder.setMaxItems(number)Kullanıcının seçebileceği maksimum öğe sayısını ayarlar.
PickerBuilder.setOAuthToken(string)Geçerli kullanıcının kimliğini doğrulamak için kullanılacak bir OAuth jetonu ayarlar. Jetonun kapsamına bağlı olarak yalnızca belirli görünümlerde veri gösterilir. Geçerli kapsamlar Google Dokümanlar ve Drive'dır.
PickerBuilder.setOrigin(string)Google Seçici iletişim kutusunun kaynağını ayarlar. Uygulamanız bir iframe içinde çalışıyorsa kaynak, en üstteki sayfanın window.location.protocol + '//' + window.location.host değerine ayarlanmalıdır.
PickerBuilder.setRelayUrl(string)shortcuts.rpc için kullanılan geçiş URL'sini ayarlayın.
PickerBuilder.setSelectableMimeTypes(string)Seçilebilir MIME türlerinin listesini ayarlayın. Birden fazla gerekiyorsa MIME türlerini ayırmak için virgül kullanın.
PickerBuilder.setSize()Tercih edilen iletişim kutusu boyutunu ayarlayın. İletişim kutusu otomatik olarak ortalanır. Minimum boyutu (566.350) ve maksimum boyutu (1051.650) vardır.
PickerBuilder.setTitle(string)İletişim kutusu başlığını ayarlayın.
PickerBuilder.toUri()Bu oluşturucu tarafından oluşturulan URI'yı döndürür.

ResourceId

ResourceId, Google Documents List API 'sına uygun kaynak kimlikleri oluşturmak için kullanılan statik bir sınıftır.

ResourceId.generate(Document)Bir belge nesnesini kaynak kimliğiyle eşleyin.

Göster

View, DocsView gibi çeşitli View sınıfları için soyut temel sınıftır.

View(ViewId)Oluşturucu.
View.getId()Bu görünüm için ViewId değerini döndürür.
View.setMimeTypes(string)Görünüme dahil edilen MIME türlerini ayarlar. Birden fazla gerekiyorsa MIME türlerini ayırmak için virgül kullanın. MIME türlerini ayarlamazsanız görünümde her MIME türünden dosya gösterilir.
View.setQuery(string)Arama içeren görünümler için arama sorgusunu bu terimlerle önceden doldurun.

ViewGroup

ViewGroup, görüntülemelerin görsel bir gruplamasıdır. ViewGroup'un kök öğesi bir View olmalıdır.

ViewGroup(View | ViewId)ViewGroup, gezinme bölmesindeki görünümlerin görsel bir gruplamasıdır. ViewGroup öğesinin kök öğesi View olmalıdır.
ViewGroup.addLabel(string)Bu ViewGroupya etiket ekleyin.
ViewGroup.addView(ViewId | View)ViewGroup'a bir görünüm ekleyin. View, view türetilmiş bir nesne veya sadece ViewId ile temsil edilebilir.
ViewGroup.addViewGroup(ViewGroup)ViewGroup'i mevcut ViewGroup içine yerleştirin.

ViewId

ViewId, View ve ViewGroup nesnelerini oluşturmak için kullanılan numaralandırılmış bir türdür.

ViewId.DOCSTüm Google Drive doküman türleri.
ViewId.DOCS_IMAGESGoogle Drive fotoğrafları.
ViewId.DOCS_IMAGES_AND_VIDEOSGoogle Drive fotoğrafları ve videoları.
ViewId.DOCS_VIDEOSGoogle Drive videoları.
ViewId.DOCUMENTSGoogle Drive Dokümanları.
ViewId.DRAWINGSGoogle Drive Çizimler'i tıklayın.
ViewId.FOLDERSGoogle Drive Klasörleri.
ViewId.FORMSGoogle Drive Formları'nı tıklayın.
ViewId.PDFSGoogle Drive'da depolanan PDF dosyaları.
ViewId.PRESENTATIONSGoogle Drive Sunuları.
ViewId.SPREADSHEETSGoogle Drive E-Tabloları'nı tıklayın.

Geri Çağırma Türleri

Google Picker API tarafından döndürülen geri çağırma verilerinde aşağıdaki numaralandırılmış türler bulunur.

İşlem

Action, kullanıcının iletişim kutusunu kapatmak için gerçekleştirdiği işlemi temsil eden numaralandırılmış bir türdür. Bu değer, geri çağırma verilerindeki Response.ACTION alanında yer alır.

Action.CANCELKullanıcı, Google Seçici iletişim kutusunu iptal etti.
Action.PICKEDKullanıcı en az bir öğe seçti.

Doküman

Document, seçilen belirli bir öğe hakkında bilgi aktarmak için kullanılan numaralandırılmış bir türdür. Yalnızca seçilen öğeyle alakalı alanlar döndürülür. Bu değer, geri çağırma verilerindeki Response.DOCUMENTS alanında yer alır.

Document.DESCRIPTIONSeçilen öğe için kullanıcı tarafından katkıda bulunulan açıklama.
Document.DURATIONSeçilen videonun süresi.
Document.EMBEDDABLE_URLBu öğenin bir web sayfasına yerleştirilmeye uygun URL'si.
Document.ICON_URLBu öğe için bir simgenin URL'si.
Document.IDSeçilen öğenin kimliği.
Document.IS_NEWSeçilen öğe yeni yüklenmişse true değerini döndürür.
Document.LAST_EDITED_UTCBu öğenin en son ne zaman düzenlendiğini açıklayan zaman damgası.
Document.MIME_TYPEBu öğenin MIME türü.
Document.NAMEBu öğenin adı.
Document.NUM_CHILDRENBu öğede bulunan alt öğelerin sayısı. Örneğin, seçili klasördeki dosya sayısı.
Document.PARENT_IDBu öğenin üst kimliği. Örneğin, bu dosyayı içeren klasör.
Document.SERVICE_IDBu öğenin seçildiği hizmeti açıklayan bir ServiceId.
Document.THUMBNAILSBir fotoğraf veya videonun özelliklerini açıklayan Thumbnail dizisi. Seçili öğeler Google Drive'a aitse küçük resimler döndürülmez.
Document.TYPESeçilen öğenin Type.
Document.URLBu öğenin URL'si.

Yanıt

Response, kullanıcının seçili öğeleri hakkında bilgi aktarmak için kullanılan numaralandırılmış bir türdür.

Response.ACTIONİletişim kutusunu kapatmak için kullanıcının gerçekleştirdiği işlemi temsil eden Action türü.
Response.DOCUMENTSKullanıcı tarafından seçilen bir Document dizisi.
Response.PARENTSSeçilen öğeler için üst klasörlerin kimlikleri. (Örneğin, dosyaları seçilen üst klasörlerin kimlikleri.)
Response.VIEWKullanıcının View bu öğeleri seçtiği.

hizmet kimliği

ServiceId, öğenin seçildiği hizmeti açıklamak için kullanılan numaralandırılmış bir türdür. Bu değer, seçilen Document öğesinin Document.SERVICE_ID alanındadır.

ServiceId.DOCSGoogle Drive'a.

küçük resim

Thumbnail, seçilen bir fotoğraf veya video hakkında bilgi aktarmak için kullanılan numaralandırılmış bir türdür. Bu değer, seçilen bir Document öğesinin Document.THUMBNAILS alanında bulunabilir.

Thumbnail.HEIGHTFotoğraf veya videonun piksel cinsinden yüksekliği.
Thumbnail.WIDTHFotoğraf veya videonun piksel cinsinden genişliği.
Thumbnail.URLSeçilen fotoğrafın veya videonun URL'si.

tür

Type, seçilen öğeyi kategorilere ayırmak için kullanılan numaralandırılmış bir türdür. Bu değer, seçilen bir Document öğesinin Document.TYPE alanında bulunabilir.

Type.DOCUMENTÖğe bir doküman.
Type.PHOTOÖğe bir fotoğraf.
Type.VIDEOÖğe bir videodur.