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 Keşfi iframe'i

Ek Keşfi iframe'i, eklentinizdeki öğretmenlerin açılış sayfasıdır. Bu görünümle ilgili olarak aşağıdaki işlemleri gerçekleştirmeyi düşünebilirsiniz:

  • Ek Keşfi iframe'i açıldığında kullanıcı rolünü doğrulamak ve supportsStudentWork değerini almak için itemType değerini temel alan bir courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest veya announcements.GetAddOnContextRequest oluşturun.
  • İçerik keşfetme veya oluşturma kullanıcı arayüzünüzü gösterin. Başlatma doğrulama yanıtındaki supportsStudentWork değerine göre etkinlik türü ekleri çıkarabilirsiniz.
  • Öğretmen seçimlerine göre, ödeve ek eklemek için bir veya daha fazla create eklenti isteğinde bulunun.

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, bir Classroom ödevini değiştirmek yerine kullanıcıya içerik sunmayı amaçlamaktadır. Bu görüşlerle ilgili olarak şu işlemleri gerçekleştirmeyi düşünün:

  • Bir iframe açıldığında kullanıcının OAuth iznini alın ve ardından rolünü ve ek kimliğini doğrulayın.

    • Geçerli kullanıcı öğrenciyse yanıttaki submissionId öğesini öğrencinin çalışmasıyla ilişkilendirin. Bu, notları geri vermek ve öğrenci çalışmalarını not verme aracında öğretmenlere göstermek için gereklidir. submissionIds, görünümler genelinde eşleşir.
    • attachmentId, eklenti tarafından zaten biliniyorsa uygun ek kullanıcı arayüzünü gösterin.
    • Aksi takdirde, bu ekin üst yayını başka bir yayından veya kurstan kopyalanmış olmalıdır. Eklentinin farkında olduğu en son kopyayı tanımlamak için copyHistory kullanın ve eklenti tarafında ek için karşılık gelen yeni bir model oluşturmak üzere ayarları kopyalayın. Ardından, uygun ek kullanıcı arayüzünü gösterin.