Drive kullanıcı arayüzüyle entegrasyon "Yeni" düğmesi

Kullanıcı Drive kullanıcı arayüzündeki "Yeni" düğmesini tıkladığında ve Drive kullanıcı arayüzünde bir uygulama seçtiğinde Drive, kullanıcıyı Drive kullanıcı arayüzü entegrasyonunu yapılandırma bölümünde tanımlanan uygulamanın Yeni URL'sine yönlendirir.

Uygulamanız daha sonra state parametresi içinde varsayılan bir şablon değişkenleri grubu alır. Yeni bir URL için varsayılan state bilgisi:

{
  "action":"create",
  "folderId":"FOLDER_ID",
  "folderResourceKey":"FOLDER_RESOURCE_KEY",
  "userId":"USER_ID"
}

Bu çıkış aşağıdaki değerleri içerir:

  • create: Gerçekleştirilen işlem. Kullanıcı Drive kullanıcı arayüzündeki "Yeni" düğmesini tıkladığında değer create olur.
  • FOLDER_ID: Üst klasörün kimliği.
  • FOLDER_RESOURCE_KEY: Üst klasörün kaynak anahtarı.
  • USER_ID: Kullanıcıyı benzersiz şekilde tanımlayan profil kimliği.

Uygulamanızın aşağıdaki adımları uygulayarak bu isteğe yanıt vermesi gerekir:

  1. action alanının değerinin create olduğunu doğrulayın.
  2. Kullanıcı için yeni bir oturum oluşturmak üzere userId değerini kullanın. Oturum açmış kullanıcılar hakkında daha fazla bilgi için Kullanıcılar ve yeni etkinlikler başlıklı makaleyi inceleyin.
  3. Dosya kaynağı oluşturmak için files.create yöntemini kullanın. İstek üzerinde folderId ayarlandıysa parents alanını folderId değeri olarak ayarlayın.
  4. İstek üzerinde folderResourceKey ayarlandıysa X-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ı ile paylaşılan dosyalara erişme başlıklı makaleyi inceleyin.

state parametresi URL biçiminde kodlanmıştır. Bu nedenle, uygulamanız kaçış karakterlerini işlemeli ve JSON olarak ayrıştırmalıdır.

Kullanıcılar ve yeni etkinlikler

Drive uygulamaları, tüm "oluşturma" etkinliklerini potansiyel oturum açma işlemleri olarak değerlendirmelidir. 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 mevcut oturumla eşleşmiyorsa uygulamanızın mevcut oturumunu sonlandırın ve istenen kullanıcı olarak oturum açın.