Bağlantı eklerini Classroom eklentisi eklerine yükseltin

Öğretmenler, Classroom'a üçüncü taraf içeriği eklemek için ödev oluşturma sayfasına Bağlantı eki olarak bağlantı yapıştırabilir. Öğretmenlerin aşina olduğu özelliklerden yararlanmak için artık eklentinizi, öğretmenlerin bağlantı ekesini eklenti eki olarak yükseltmesine olanak tanıyacak şekilde yapılandırabilirsiniz.

Genel Bakış

Eklentinizi bu özellikle yapılandırırsanız öğretmenler, ödev oluşturma sayfasına bağlantı eki yapıştırdığında bağlantıyı eklenti eki olarak yükseltmeleri istenir. Öğretmenlerden yalnızca eklenti yüklüyse bunu yapmaları istenir.

Öğretmen bağlantıyı eklenti eki olarak yükseltmeyi kabul ettiğinde, bağlantı yükseltme iFrame'si aşağıdaki sorgu parametreleriyle başlatılır:

  • courseId
  • itemId
  • itemType
  • addOnToken
  • urlToUpgrade
  • login_hint (yalnızca kullanıcı uygulamanıza yetki verdiyse)

İlk dört sorgu parametresi, Ek Keşfi iframe'inde başlatılan sorgu parametrelerini yansıtır. urlToUpgrade sorgu parametresi yenidir ve eklenti ekinin nasıl oluşturulacağını değerlendirmenize yardımcı olabilir. Ardından, kullanıcının oturum açıp açmadığını kontrol etmek için diğer sorgu parametrelerini kullanabilir ve itemType değerine göre courseWork, courseWorkMaterials veya announcements CreateAddOnAttachment yöntemini çağırabilirsiniz. IFrame içinde, öğretmene eklenti ekinin oluşturulmakta olduğunu belirtmek için bir yükleme ekranı gösterebilirsiniz.

Eklenti eki oluşturulduktan sonra iFrame kapatılır ve öğretmen, ödevdeki eki normal şekilde görüntüleyebilir.

Teknik uygulama ayrıntıları

Bu bölümde, özelliklere ilişkin bazı önemli teknik ayrıntılar vurgulanmıştır.

urlToUpgrade sorgu parametresini okuma

urlToUpgrade sorgu parametresi, Bağlantı Yükseltme iframe'inde iletilirken URI kodlanır. URL'yi orijinal biçiminde almak için URL'nin kodunu çözmeniz gerekir. Örneğin, JavaScript kullanıyorsanız bunu yapmak için decodeURIComponent() işlevini kullanabilirsiniz.

Bu özellik için en iyi kullanıcı deneyimini sağlamak amacıyla, eklenti eki başarıyla oluşturulduktan sonra postMessage gönderin. Bu işlem, iframe'i kapatır. Daha fazla bilgi için iframe uygulama ayrıntıları sayfasına bakın.

Yapılandırma ayrıntıları

Bu özelliği eklentinize entegre etmek için aşağıdaki yapılandırmalar gereklidir:

  • Bağlantıyı Yükseltme iframe'inin URL'si: Bir öğretmen yükseltmeyi kabul ettiğinde iframe'de açılan URL'dir.

  • Classroom'un tespit etmesi ve yükseltmeye çalışması gereken URL kalıpları: URL kalıpları, bir ana makine ve birden fazla yol ön ekinden oluşabilir.

    • Birden fazla URL kalıbı sağlayabilirsiniz.
    • Yol ön eki sağlamazsanız ana makineyle eşleşen tüm URL'ler yükseltilebilir.
    • Yalnızca https şemasına sahip URL'ler yükseltilebilir.
    • URL kalıpları localhost içermemelidir.
    • Yol önekleri sorgu parametreleri veya URL parçaları içermemelidir.
    • Yol ön ekleri şu anda joker karakterleri destekleyebilir ancak ana makineler destekleyemez:
      • example.com geçerli bir ana makine, /foo ve /bar/*/baz ise geçerli yol önekleridir.
      • example.*.host.com geçerli bir ana makine değil.
    • Yol ön ek bileşenleri arasındaki joker karakter yalnızca tek bir bileşenle eşleşir ve eğik çizgiyle ayrılmış birden fazla bileşenle eşleşmez. example.com ana makine ve /bar/*/baz yol ön ekiyle bir URL kalıbı düşünün:
      • https://example.com/bar/123/baz, URL kalıbıyla geçerli bir eşleşmedir.
      • https://example.com/bar/123/baz/456/789, URL kalıbıyla geçerli bir eşleşmedir.
      • https://example.com/bar/123/456/baz, yol ön ekindeki joker karakter /123/456/ ile eşleşmediği için URL kalıbıyla geçerli bir eşleşme değildir.

Geliştirme süreci

classroom-link-upgrade-external@google.com adresine e-posta göndererek test veya üretim eklentinizin Bağlantı Yükseltme iFrame URL'sini ve URL kalıplarını gönderin.

Classroom eklentisini temsil eden herhangi bir Google Cloud projesi için yapılandırmalar sağlayabilirsiniz. Canlı kullanıcıları etkilemeden geliştirme ve test yapabilmek için önce gizli görünürlüklü bir eklenti yapılandırması sağlamanızı öneririz.

Yapılandırmalar etkinleştirildiğinde e-postanıza yanıt gönderilir. localhost kullanan URL kalıplarının bu özellik için desteklenmediğini unutmayın.

E-postayı aşağıdakileri içerecek şekilde biçimlendirin:

Google Cloud Project number: GCP_PROJECT_NUMBER

Link Upgrade iframe URL: LINK_UPGRADE_IFRAME_URL

URL Patterns:
-   Host:HOST_1
-   Path prefixes:
  -   PATH_PREFIX_1
  -   PATH_PREFIX_2

-   Host:HOST_2
-   Path prefixes:
  -   PATH_PREFIX_3
  -   PATH_PREFIX_4

// add more hosts and path prefixes as needed

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

  • GCP_PROJECT_NUMBER: Eklentinin ilişkili olduğu Google Cloud projesinin numarası.
  • LINK_UPGRADE_IFRAME_URL: Bağlantı Yükseltme iframe'inde açılması gereken URL.
  • HOST_1: Classroom'un algılaması gereken bir ana makine. Yalnızca https şeması desteklenir.
  • PATH_PREFIX_1 ve PATH_PREFIX_2: Classroom'un algılaması ve yükseltmeyi denemesi gereken, HOST_1 ile ilişkili yol ön ekleri.
  • HOST_2: Classroom'un algılaması gereken bir ana makine. Yalnızca https şeması desteklenir.
  • PATH_PREFIX_3 ve PATH_PREFIX_4: Classroom'un algılaması ve yükseltmeyi denemesi gereken, HOST_2 ile ilişkili yol ön ekleri.

Bu özelliği uygularken dikkate alabileceğiniz öneriler aşağıda verilmiştir.

Öğretmenlerin ek iş yükünden kaçınması

Gerekirse oturum açmayı kolaylaştırmak veya bir yükleme göstergesi görüntülemek için iFrame kullanmanızı önemle tavsiye ederiz. En iyi kullanıcı deneyimi için, yapıştırılan bağlantıyı eklenti eki olarak yükseltmeyi kabul eden öğretmenden ek bilgi istenmemelidir. Ancak bu, eklentiniz için mümkün değilse ihtiyacınız olan ek bilgileri toplamak için Bağlantı Yükseltme iFrame'sini kullanabilirsiniz. Iframe, bağlantının yükseltilmesinin mümkün olmadığı veya bir hata oluştuğu durumlarda öğretmeni bilgilendirmek için de kullanılabilir.

Kullanıcı dostu erişim hata mesajları ekleyin

Öğretmenler erişimi olmayan bir bağlantıyı yapıştırıp yükseltirse iframe'de kullanıcı dostu bir hata mesajı göstererek öğretmenlerin sorundan haberdar olmasını sağlayın. İçeriği görüntülemek için öğretmene uygun izinleri vermek üzere de iframe kullanılabilir.