Uygulama stratejisi

Bu sayfada, eklenti web uygulamanız ile Google Classroom eklentileri API'si arasındaki temel etkileşimlere kısa bir genel bakış sunulmaktadır.

Ek Bulma 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 yapmanızı öneririz:

  • İçerik keşfetme 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'li açıldığında iletilen itemType sorgu parametresinin değerini kontrol edin. Öğrenci yanıtlarını yalnızca courseWork türü kabul eder.

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

Diğer iframe'ler

Öğrenci Görünümü iframe'i, Öğrenci Çalışması İnceleme iframe'i ve Öğretmen Görünümü iframe'i, bir Classroom ödevini değiştirmek yerine kullanıcıya içerik sunmayı amaçlar. Bu görünümlerle ilgili olarak aşağıdaki işlemleri yapmanızı öneririz:

  • 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.
  • Geçerli kullanıcı öğ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 ekin üst gönderisinin başka bir yayından veya dersten kopyalanmış olması gerekir. 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.