Bu sayfa, Cloud Translation API ile çevrilmiştir.

Masaüstü uygulamalarına genel bakış

Google Picker API, kullanıcıların Google Drive dosyalarını seçmesine veya yüklemesine olanak tanır. Kullanıcılar, masaüstü uygulamalarınıza Drive verilerine erişme izni vererek dosyalarıyla güvenli ve yetkili bir şekilde etkileşim kurabilir.

Google Picker, Drive'da depolanan dosyalar için "Dosya Aç" iletişim kutusu görevi görür ve çeşitli özelliklere sahiptir:

Google Drive kullanıcı arayüzüne benzer bir görünüm ve tarz.
Drive dosyalarının önizlemelerini ve küçük resimlerini gösteren çeşitli görünümler.
Kullanıcının varsayılan tarayıcısında yeni bir sekmede Google Seçici'ye yönlendirme yapılır.

Google Seçici'nin, kullanıcıların dosyaları bir klasörden diğerine düzenlemesine, taşımasına veya kopyalamasına izin vermediğini unutmayın. Dosyaları yönetmek için Google Drive API'yi veya Drive kullanıcı arayüzünü kullanmanız gerekir.

Ön koşullar

Google Seçici'yi kullanan uygulamalar, mevcut tüm Hizmet Şartları'na uymalıdır. En önemlisi, isteklerinizde kendinizi doğru şekilde tanımlamanız gerekir.

Ayrıca bir Google Cloud projeniz olmalıdır.

Ortamınızı ayarlama

Google Picker API'yi kullanmaya başlamak için ortamınızı ayarlamanız gerekir.

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 Cloud Console'da Google Picker API'yi etkinleştirin.

API'yi etkinleştirme

API anahtarı oluşturma

API anahtarı, büyük ve küçük harfler, sayılar, alt çizgiler ve kısa çizgiler içeren uzun bir dizedir (ör. AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe). Bu kimlik doğrulama yöntemi, "İnternette bu bağlantıya sahip olan herkes" paylaşım ayarı kullanılarak paylaşılan Google Workspace dosyaları gibi herkese açık veriye anonim olarak erişmek için kullanılır. Daha fazla bilgi için API anahtarlarını yönetme başlıklı makaleyi inceleyin.

API anahtarı oluşturmak için:

Google Cloud Console'da Menü > API'ler ve Hizmetler > Kimlik Bilgileri'ne gidin.
Kimlik Bilgileri'ne gidin.
Kimlik bilgileri oluştur > API anahtarı'nı tıklayın.
Yeni API anahtarınız gösterilir.
- Uygulamanızın kodunda kullanmak üzere API anahtarınızı kopyalamak için Kopyala'yı tıklayın. API anahtarını, projenizin kimlik bilgilerinin "API Anahtarları" bölümünde de bulabilirsiniz.
- Yetkisiz kullanımı önlemek için API anahtarının nerede ve hangi API'ler için kullanılabileceğini kısıtlamanızı öneririz. Daha fazla bilgi için API kısıtlamaları ekleme başlıklı makaleyi inceleyin.

Bir masaüstü uygulaması için kimlik bilgilerini yetkilendirme

Uygulamanızda son kullanıcıların kimliğini doğrulamak ve kullanıcı verilerine erişmek için bir veya daha fazla OAuth 2.0 istemci kimliği oluşturmanız gerekir. İstemci kimliği, tek bir uygulamanın Google OAuth sunucularına tanıtılması için kullanılır. Uygulamanız birden fazla platformda çalışıyorsa her platform için ayrı bir istemci kimliği oluşturmanız gerekir.

Google Cloud Console'da Menü > Google Auth platform > İstemciler'e gidin.
Müşteriler'e gidin.
Create Client'ı (İstemci Oluştur) tıklayın.
Uygulama türü > Masaüstü uygulaması'nı tıklayın.
Ad alanına, kimliğin adını yazın. Bu ad yalnızca Google Cloud Console'da gösterilir.
Oluştur'u tıklayın.
Yeni oluşturulan kimlik bilgisi, "OAuth 2.0 İstemci Kimlikleri" bölümünde görünür.

Uygulamaların daha önce kendilerine verilen dosyalara erişim yetkisi alması için aşağıdaki adımları uygulamanız gerekir:

drive.file, drive veya drive.readonly kapsamına sahip bir OAuth 2.0 jetonunu şu talimatları kullanarak almanız gerekir: Google API'lerine Erişmek İçin OAuth 2.0'ı Kullanma. Kapsamlar hakkında daha fazla bilgi için Google Drive API kapsamlarını seçme başlıklı makaleyi inceleyin.
Kullanıcının daha önce erişim izni verdiği dosyaları okumak ve değiştirmek için OAuth 2.0 jetonunu Drive API'ye iletin.

Google Seçici'yi görüntüleme

Masaüstü uygulamaları için Google Picker API, kullanıcının varsayılan tarayıcısında yeni bir sekmede Google Picker'a yönlendirir. Kullanıcı erişim izni verip ilgili dosyaları seçtikten sonra Google Picker, geri çağırma URL'si aracılığıyla çağıran uygulamaya geri döner. Google Picker API'nin bir istemci sayfasında açılması için bunun yerine web uygulamaları için Google Picker API'yi kullanın. Daha fazla bilgi için Web uygulamalarına genel bakış başlıklı makaleyi inceleyin.

Kullanıcıların ek dosyalara erişim vermesine veya masaüstü uygulama akışınızda kullanılacak dosyaları seçmesine izin vermek için aşağıdaki adımları uygulayın:

drive.file kapsamına erişim isteğinde bulunarak OAuth 2.0 erişim sayfasını yeni bir tarayıcı sekmesinde açmak için şu talimatları uygulayın: Google API'lerine Erişmek İçin OAuth 2.0'ı Kullanma. Kapsamlar hakkında daha fazla bilgi için Google Drive API kapsamlarını seçme başlıklı makaleyi inceleyin.

Masaüstü uygulamaları için yalnızca drive.file kapsamına izin verildiğini ve bu kapsamın başka bir kapsamla birleştirilemeyeceğini unutmayın.

Yeni tarayıcı sekmesinin URL'si tüm standart OAuth sorgu dizesi parametrelerini kabul eder.

prompt ve trigger_onepick URL parametrelerini OAuth 2.0 yetkilendirme URL'si isteğinize eklemeniz gerekir. Google Seçici'yi çeşitli isteğe bağlı parametrelerle de özelleştirebilirsiniz:

Parametre	Açıklama	Durum
`prompt=consent`	Dosya erişimi için istem	Zorunlu
`trigger_onepick=true`	Google Seçici'yi etkinleştirin.	Zorunlu
`allow_multiple=true`	Doğruysa kullanıcının birden fazla dosya seçmesine izin verilir.	İsteğe bağlı
`mimetypes=MIMETYPES`	Arama sonuçlarını filtrelemek için virgülle ayrılmış MIME türleri listesi. Ayarlanmazsa görünümde tüm MIME türlerine ait dosyalar gösterilir.	İsteğe bağlı
`file_ids=FILE_IDS`	Arama sonuçlarını filtrelemek için dosya kimliklerinin virgülle ayrılmış listesi. Ayarlanmazsa tüm dosyalar görünümde gösterilir.	İsteğe bağlı

Aşağıdaki örnekte bir OAuth 2.0 yetkilendirme URL'si isteği gösterilmektedir:

https://accounts.google.com/o/oauth2/v2/auth? \
client_id=CLIENT_ID \
&scope=https://www.googleapis.com/auth/drive.file \
&redirect_uri=REDIRECT_URI \
&response_type=code \
&access_type=offline \
&prompt=consent \
&trigger_onepick=true

Aşağıdakini değiştirin:

CLIENT_ID: Masaüstü uygulamanızın istemci kimliği.
REDIRECT_URI: Yetkilendirme sunucusunun, başarılı kimlik doğrulamanın ardından kullanıcının tarayıcısını yönlendirdiği yer. Örneğin, https://www.cymbalgroup.com/oauth2callback.

Belirtilen redirect_uri, herkese açık bir HTTPS URL'si olmalıdır. redirect_uri için özel bir protokol veya localhost URL'si kullanmak istiyorsanız önce özel protokole ya da localhost URL'sine yönlendiren herkese açık bir HTTPS URL'si kullanmanız gerekir.

Kullanıcı erişim izni verip ilgili dosyaları seçtikten sonra OAuth, isteğinde belirtilen redirect_uri adresine aşağıdaki URL parametreleri eklenmiş şekilde yönlendirir:
- picked_file_ids: Kullanıcı erişim izni verip dosyaları seçtiyse seçilen dosya kimliklerinin virgülle ayrılmış listesi.
- code: İstekte ayarlanan response_type parametresine göre erişim jetonu veya erişim kodu. Bu parametre yeni bir yetkilendirme kodu içerir.
- scope: İsteğe dahil edilen kapsamlar.
- error: Kullanıcı, izin akışı içinde isteği iptal ettiyse bir hata gösterilir.
Aşağıdaki örnekte bir OAuth 2.0 yetkilendirme URL'si yanıtı gösterilmektedir:
```
https://REDIRECT_URI?picked_file_ids=PICKED_FILE_IDS&code=CODE&scope=SCOPES
```
Uygulamalar, 3. adımdaki yetkilendirme kodunu yeni bir OAuth 2.0 jetonuyla değiştirmelidir. Daha fazla bilgi için Yenileme ve erişim jetonları için yetkilendirme kodu değiş tokuşu yapma başlıklı makaleyi inceleyin.
Uygulamalar daha sonra Drive API'yi çağırmak için 3. adımda URL parametresinden alınan dosya kimliklerini ve 4. adımda elde edilen OAuth 2.0 jetonunu kullanabilir. Daha fazla bilgi için Google Drive API'ye genel bakış başlıklı makaleyi inceleyin.