Uygulama stratejisi

Bu sayfada, eklenti web uygulamanız ile Google Classroom eklentileri API'si arasındaki temel etkileşimlere kısaca göz atabilirsiniz.

Ek Keşfi iframe'i

Ek Discovery iframe'i, eklentinizdeki öğretmenlere yönelik açılış sayfasıdır. Bu görünümle ilgili olarak aşağıdaki işlemleri yapabilirsiniz:

  • İçerik bulma veya oluşturma kullanıcı arayüzünüzü gösterin.

    İsteğe bağlı olarak, öğretmenin etkinlik türü ekleri eklemesini önlemek isteyebilirsiniz. Böylece, akış öğesinin öğrenci yanıtlarını kabul edip etmeyeceğini belirleyebilirsiniz. Eklenti iframe'i açıldığında iletilen itemType sorgu parametresinin değerini kontrol edin. Yalnızca courseWork türü öğrenci yanıtlarını kabul eder.

  • Öğretmen seçimlerine bağlı olarak, ödeve ek eklemek için bir veya daha fazla eklenti create isteği gönderin.

Diğer iframe'ler

Öğrenci Görünümü iframe'i, Öğrenci Çalışması İncelemesi iframe'i ve Öğretmen Görünümü iframe'i, Classroom ödevini değiştirmek yerine kullanıcıya içerik sunmak için tasarlanmıştır. Bu görünümlerle ilgili olarak aşağıdaki işlemleri yapabilirsiniz:

  • Bir iFrame açıldığında kullanıcının OAuth iznini alıp rolünü ve ek kimliğini doğrulayın.
  • Bir iFrame açıldığında, kullanıcı rolünü doğrulamak için itemType temelinde bir courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest veya announcements.GetAddOnContextRequest oluşturun.
  • Mevcut kullanıcı bir öğrenciyse yanıttaki submissionId öğesini öğrenci çalışmasıyla ilişkilendirin. Bu, not verme aracında notları geri vermek ve öğrenci çalışmalarını öğretmenlere göstermek için gereklidir. submissionIds, görünümlerde eşleşir.
  • attachmentId, eklenti tarafından zaten biliniyorsa uygun ek kullanıcı arayüzünü gösterin.
  • Aksi takdirde, bu eki içeren üst gönderi başka bir gönderiden veya kurstan kopyalanmış demektir. Eklentinin bildiği en yeni kopyayı belirlemek için copyHistory kullanın ve eklenti tarafında ekin karşılık gelen yeni bir modelini oluşturmak için ayarları kopyalayın. Ardından, uygun ek kullanıcı arayüzünü gösterin.