Google Cloud projesi yapılandırması

Bu sayfada, Classroom eklentileri için Google Cloud projeleri oluşturma ve yapılandırma hakkında bilmeniz gerekenleri bulabilirsiniz. Google Cloud projeleri; OAuth 2.0 (Google TOA) üzerinden Google Tek Oturum Açma özelliğini uygulamak, eklentiniz tarafından yapılan istekleri yetkilendirmek ve eklentinin Google Workspace Marketplace mağazasındaki girişini yönetmek için kullanılır.

Marketplace'te eklenti yayınlama hakkında daha fazla genel bilgi için Uygulama yayınlama bölümüne bakın.

Google Cloud projesi oluşturma

Önemli Nokta: Üretim eklentisi uygulamanızın görünürlüğü, Google Workspace Marketplace SDK'sında herkese açık olarak ayarlanmış olmalıdır. Gizli proje, eklentinizi geliştirirken ve test ederken faydalı olabilir ancak yalnızca herkese açık bir proje gereklidir.

Oluşturulacak iki tür proje vardır: geliştirme için kullanılan özel bir proje ve son kullanıcıların erişebileceği herkese açık bir proje. "Herkese açık" ve "gizli" etiketleri, uygulamanızın Google Workspace Marketplace'teki görünürlüğünü ifade eder. Özel bir Marketplace uygulaması yalnızca oluşturulduğu alandaki kullanıcılar tarafından yüklenebilir. Herkese açık bir Marketplace uygulaması ise tüm Google Workspace alanlarında kullanılabilir. Proje hem herkese açık hem de gizli olamayacağından bunlar iki ayrı uygulama olmalıdır. Herkese açık başvuruların pazara sunulmadan önce incelenmesi ve onaylanması gerekir.

Önemli: Gizli bir projeyi herkese açık projeye dönüştüremezsiniz.

Google Cloud projesi oluşturmayla ilgili genel bilgiler için Google Cloud projesi oluşturma başlıklı makaleyi inceleyin.

Herkese açık bir Google Cloud projesi oluşturma

Bu proje yöneticiler, öğretmenler ve öğrenciler tarafından erişilebilen eklenti uygulamasını temsil eder. Herkese açık projelerin, kullanıma sunulmadan veya yüklenmeden önce Google Workspace Marketplace ekibi tarafından incelenip onaylanması gerekir.

1. Üretim alanınızda yeni bir Google Cloud projesi oluşturun.

   Google Cloud projesi oluşturma

   Önemli: Projenin üretim alanınıza ait olduğundan ve Google Cloud Console'da bu alanın kullanıcısı olarak oturum açtığınızdan emin olun.
   Uyarı: Test için projenizin Taslak sürümünü kullanmanız gerekir. Taslak özelliği şu anda yalnızca Google Workspace Geliştirici Önizleme Programı kapsamında kullanılabilir. Cloud projenizi oluşturduktan sonra, Google Workspace Geliştirici Önizleme Programı özelliklerini etkinleştirmek için başvuru formunu doldurun. Daha fazla bilgi için Uygulama girişinizi taslaklarla güncelleme bölümünü inceleyin.

2. Cloud projenizde Classroom API'yi etkinleştirin.

   Classroom API'yi etkinleştirme

3. Cloud projenizde Google Workspace Marketplace SDK'sını etkinleştirin.

   Google Workspace Marketplace SDK'sını etkinleştirme

4. Marketplace SDK Uygulama Yapılandırması Uygulama Görünürlüğü'nü Herkese Açık olarak ayarlayın ve Liste Dışı kutusunu işaretleyin.

   Önemli Bilgi: Dahili geliştirme ve test sırasında kullanılan özel bir projeyi paylaşamaz veya dönüştüremezsiniz.
   Önemli Nokta: Liste dışı uygulamalar Google Workspace Marketplace'te göz atarak veya arama yaparak bulunamaz. Marketplace SDK yapılandırmasında, eklentiyi yüklemek için kullanılabilecek doğrudan bir URL'yi bulabilirsiniz. Mağaza girişini yalnızca Google ve geliştirici bulabilir. Uygulamanız, herkesin kullanımına açık olana kadar liste dışı kalmalıdır. Bir eklentinin, Marketplace SDK'nın Uygulama Yapılandırması sayfasında listelenip listelenmeyeceğini değiştirebilirsiniz.

5. Marketplace SDK Mağaza Girişi sayfasında zorunlu alanları doldurun ve YAYINLA'yı tıklayın.

6. Uygulamanız Google Workspace Marketplace ekibi tarafından incelenecektir. Bu yöneticiler sizinle Marketplace SDK'sında belirtilen geliştirici e-posta adresini kullanarak iletişim kurar. Uygulama onaylandıktan sonra, öğretmenlerin ve yöneticilerin Pazar Yeri'nde bulabilmesi için Liste dışı kutusunun işaretini kaldırın.

Özel bir Google Cloud projesi oluşturun

Bu gizli proje, geliştirme için kullanılan eklenti uygulamasını temsil eder. Oluşturulduğu alanın dışındaki kullanıcılar dosyaya erişemez ancak yüklemeden önce onaylanması gerekmez. Bu nedenle Google, eklentinizi kontrollü bir ortamda geliştirmek ve test etmek için bu projeyi kullanmanızı önerir.

Özel proje oluşturmak için Teaching & Learning veya Plus lisansına sahip bir Google Workspace for Education alanına erişiminizin olması gerekir. Böyle bir alana erişiminiz yoksa Google Workspace for Education demo alanı oluşturmak, alanı Plus lisansı sürümüne yükseltmek ve Classroom eklentileri API'sine erişmesine izin vermek için aşağıdaki adımları uygulayın:

1. Geliştirici test alanı alma adımlarını tamamlayın.

2. Demo alanında yönetici olarak oturum açmışken yeni bir Google Cloud projesi oluşturun.

   Google Cloud projesi oluşturma

   Uyarı: Projenin demo alanına ait olduğundan ve demo alanının yönetici hesabıyla Google Cloud Console'da oturum açtığınızdan emin olun.

   Google Cloud Console'a erişemiyor veya Cloud projeleri oluşturamıyorsanız Yönetici Konsolu'nda aşağıdakileri kontrol edin:

   • Hesap ayarları > Yaşa bağlı erişim ayarları sayfasını ziyaret edin ve Bu gruptaki veya kuruluş birimindeki tüm kullanıcılar 18 yaşında ya da daha büyük seçeneğini belirleyin.
   • Uygulamalar > Ek Google hizmetleri altında:
   • Google Cloud Platform herkes için ETKİN.
   • Proje Oluşturma Ayarları Kullanıcıların proje oluşturmasına izin ver'dir.
   • Cloud Shell Erişim Ayarları, Cloud Shell'e erişime izin ver şeklindedir.

3. Demo alanı yeni sürüme geçirme istek formunu doldurup gönderin. Bu formu gönderdiğinizde Google'ın demo alan adınızı on lisansla Google Workspace for Education Plus'a yükseltmesi ve Cloud projenizin Classroom eklentileri API'sine erişmesine izin vermeniz istenir.

   Yükseltme ve izin verilenler listesi işlemleri tamamlandığında bir e-posta alırsınız. Yönetici Konsolu'nda test öğretmeni hesaplarınıza Plus lisansları atayın. Dizin > Kullanıcılar altında, test öğretmeni hesaplarınızı oluşturun veya seçin. Her öğretmenin Lisanslar bölümünde, Google Workspace for Education Plus'ın Atandı olduğunu doğrulayın.

4. Cloud projenizde Classroom API'yi etkinleştirin.

   Classroom API'yi etkinleştirme

5. Cloud projenizde Google Workspace Marketplace SDK'sını etkinleştirin.

   Google Workspace Marketplace SDK'sını etkinleştirme

6. Marketplace SDK'sı Uygulama Yapılandırması Uygulama Görünürlüğü'nü gizli olarak ayarlayın.

7. Marketplace SDK Mağaza Girişi sayfasında zorunlu alanları doldurun ve YAYINLA'yı tıklayın. Uygulama girişi yayınlandıktan sonra, alandaki kullanıcılar Google Workspace Marketplace'te veya Mağaza Girişi sayfasında gösterilen Uygulama URL'sini ziyaret ederek uygulamayı bulup yükleyebilir.

OAuth 2.0

Classroom API'ye erişim için kullanıcı verilerine erişim izni gerekir. Bunlar, oturum açmış kullanıcının Google'ın OAuth kapsamlarına erişimi isteyerek ve daha sonra Google Classroom'a API çağrıları yapmak için kullanılabilecek bir jeton alarak elde edilir. Kapsamlar, Google Workspace Marketplace mağaza girişinde, eklentiyi yükleyen alan adı kullanıcıları adına izin verebilmesi için yapılandırılmalıdır.

Önemli: Eklentiniz ek kapsamlar istiyorsa bunları OAuth izin ekranına, Marketplace SDK Uygulama Yapılandırması sekmesine ve eklentinizin uygulama koduna ekleyin. Bu konumlardaki kapsamların uyuşmazlığı, eklenti yüklenirken kullanıcılar için sorunlara neden olabilir.

Mevcut tüm kapsamların ve kullanımlarının ayrıntılı listesi için Google API'leri için OAuth Kapsamları sayfasına bakın. Genel OAuth yapılandırma bilgileri için Workspace dokümanlarındaki OAuth yapılandırma sayfasını inceleyin.

Kullanıcı izinleri

Web uygulamanız aşağıdaki kapsamlardan en az birini istemelidir:

• https://www.googleapis.com/auth/userinfo.email: Bu, uygulamanın kullanıcının e-posta adresini görüntülemesine olanak tanır.
• https://www.googleapis.com/auth/userinfo.profile, uygulamanın portre, ad ve soyadı gibi kişisel bilgilerin yanı sıra kullanıcının herkese açık olarak sunduğu diğer kişisel bilgileri görmesine olanak tanır.

Bir kullanıcı, eklentinizde bu kapsamlardan birini yetkilendirdikten sonra login_hint sorgu parametresiyle tanımlanır. Bu parametre, bir iframe açıldığında web uygulamanızın URL'lerinden herhangi birine aktarılır. Kullanıcı bu kapsamlardan birini yetkilendirmediyse login_hint gönderilmez.

Uyarı: Aynı kullanıcının sonraki ziyaretlerinde login_hint alabilmek için uygulamanızın userinfo.email veya userinfo.profile kapsamlarından en az birini istemesi gerekir.

login_hint, Google ile Oturum Açma özelliğini kullanırken veya OAuth jetonu isterken isteğe bağlı olarak Google'a iletebileceğiniz standart bir COPPA Connect parametreleridir. Bu özelliğin amacı, son kullanıcı için daha sorunsuz bir yetkilendirme deneyimi sunmaktır.

Classroom eklentisi kapsamları

Aşağıdaki kapsamlar Classroom eklentilerine özeldir:

• https://www.googleapis.com/auth/classroom.addons.teacher tüm API yöntemlerine erişim sağlar.
• https://www.googleapis.com/auth/classroom.addons.student izni bulunur. Bu API, doğrulama ve ek okuma işlemlerini başlatmak için erişim izni verir.

Kullanıcının kimlik bilgilerini belirten geçerli bir OAuth erişim jetonuyla bile, API çağrıları ek şartlara tabi tutulur:

• Tüm yöntemler için kullanıcının, istekteki courseId tarafından belirtilen derste öğretmen veya öğrenci olması gerekir.
• Ek oluşturma, güncelleme, silme ve notlara geri verme işlemleri için kullanıcının öğretmen olması gerekir.
• Belirli bir Google Classroom yayınına yapılan aramalar aşağıdaki kontrollerle korunur.
  • Bir eklenti, yayında en az bir ek içeriyorsa aşağıdakiler için istekte bulunabilir:
    • iframe başlatma doğrulaması
    • Ek okuma, güncelleme ve silme işlemleri
    • Bu yayındaki güncellemelere not verin
  • Attach Discovery iframe'i ilk açıldığında eklentinin yayında henüz bir eki olmayabilir. Aşağıdakiler için istekte bulunmak üzere kullanılabilecek bir addOnToken sorgu parametresi sağlanır:
    • Gönderinin altında ek oluşturma (addOnToken gereklidir)
    • Doğrulamayı başlat (sağlanmışsa addOnToken doğrulanır ve eklentinin yayında mevcut bir eki yoksa zorunludur)

OAuth doğrulaması

Not: OAuth doğrulama süreci kapsamında gönderilecek bir demo video oluşturamazsınız. Bunun yerine, eklentiyi OAuth'u doğrulamadan yayınlayın. Bu işlem, Google Workspace Marketplace İnceleme ekibini sizin adınıza bir tanıtım videosu hazırlamaları için uyarır. Ardından inceleme ekibi, OAuth doğrulama gönderiminize ekleyebilmeniz için videoyu size sunar.

Classroom eklentileri, Google kullanıcılarının verilerine erişmek için Google API'lerini kullanır.

• Marka kimliğinizi doğrulama
• Hassas OAuth kapsamlarını doğrulayın.

Doğrulama süreci hakkında daha fazla bilgi edinmek için OAuth API doğrulamasıyla ilgili SSS bölümüne bakın.

Google Workspace Marketplace girişi

Uyarı: Yayın sürecinde görünürlük seçeneğinizi kaydettikten sonra seçiminizi daha sonra değiştiremezsiniz.

Genel Google Workspace Marketplace SDK yapılandırma bilgileri için Google Workspace Marketplace SDK'sını etkinleştirme ve yapılandırma ve Google Workspace Marketplace mağaza girişi oluşturma sayfalarını ziyaret edin.

Girişle ilgili dikkat edilmesi gereken noktalar

Herkese açık Google Cloud projenizin Marketplace SDK Deposu Girişi, uygulamanızın adını ve son kullanıcılara yönelik açıklamalarını belirtir. Bu ayrıntıları, Uygulama Ayrıntıları altında birden fazla dilde sağlayabilirsiniz.

Girişlerinizde şu kurallara uyun:

• Uygulama Ayrıntıları altında:

  • Uygulama Adı'nda noktalama işaretleri kullanmaktan kaçının. Örneğin, "Şirketim: Eklentim" yerine "Eklentim" veya "Şirketim'den Eklentim" kullanın.

  • Kısa Açıklama ve Ayrıntılı Açıklama tam olarak aynı metni içermemelidir.

  + Fiyatlandırma alanı için bir değer seçtiğinizden emin olun. Bu alan; Ücretsiz, Ücretsiz denemeyle ücretli, Ücretsiz özelliklerle ücretli ve Ücretli fiyatlandırma seçeneklerini içerir. Marketplace girişinde maliyet tutarını belirtmenize gerek yoktur.

  • Kategori alanı için bir değer seçtiğinizden emin olun. Classroom eklentisi için Akademik Kaynaklar veya Öğretmen ve Yönetici Araçları iyi bir tercih olabilir.

  • Daha fazla bilgi için Marketplace'in Uygulama ayrıntıları açıklamasında listelenen öğelere bakın.

Önemli: Eklentinizi sunduğunuz her dil için Uygulama Ayrıntılarını kontrol edin.

• Grafik Öğeleri altında:

  • Sağlanan grafik öğeleri kesin değildir ve Google Workspace Marketplace standartlarında belirtilen boyutları karşılamalıdır.

  • Sağlanan ekran görüntüleri, eklenti deneyiminizi doğru şekilde temsil eder.

• Destek Bağlantıları bölümünde:

  • Uygulamanızın Hizmet Şartları'nın bağlantısını sağladığınızdan emin olun.

• İzin verilen adları ve açıklamaları kapsayan Google API Markalama yönergelerini karşıladığınızdan emin olun.

• Girişinizde herhangi bir Google ürününe atıfta bulunuyorsanız bu ürünün adını Ticari Marka Listesi'nde belirtilen biçimde kullanın. Belirtilmişse ticari marka (TM) sembolünü eklediğinizden emin olun. "Google Dokümanlar"ı değil, "Google DocsTM" kullanın.

Google'ın lisanslama ve faturalandırma hizmetleriyle entegrasyon

Google Workspace Marketplace uygulamalarınızın Google'ın lisanslama ve faturalandırma hizmetleriyle entegre olmasını istiyorsanız Marketplace API sayfasını ziyaret edin.

Yükleme ayarları

Eklentiler, yönetici kurulumuna ek olarak bağımsız yükleme işlemlerine izin verebilir. Bu sayfada, iki yükleme türü arasındaki bazı farklılıklar vurgulanmaktadır. İki yükleme türünün tanıtımı amaçlanmamıştır. Google Workspace Marketplace SDK Uygulama Yapılandırması sayfasında bireysel yüklemeye izin verip vermeyeceğinizi seçebilirsiniz.

Yönetici haklarıyla yükleme

Yönetici yüklemeleri, yöneticilerin bir alandaki tüm hesaplara veya belirli erişim gruplarına ya da kuruluş birimlerine eklenti eklemesine olanak tanır. Yönetici yüklemesini yalnızca bir alan yöneticisi gerçekleştirebilir. Yönetici, isteğe bağlı olarak alandaki tüm kullanıcılar adına tüm erişim kapsamlarına izin verebilir. Yönetici izin verirse kullanıcılardan herhangi bir erişim kapsamı için izin vermeleri istenmez.

Aşağıda, yönetici kurulumuyla ilgili dikkate alınması gereken bazı noktalar yer almaktadır.

• Daha sıkı kontroller. Yöneticiler, bir eklentiye hangi kullanıcıların erişebileceğini kısıtlayabilir.
• Lisanslama ile uyumluluk. Uygulamanız için lisans gerekiyorsa yüklemeleri bir yönetici aracılığıyla yönlendirmek, lisansların dağıtılmasını ve ilgili kurumla uygun şekilde kullanılmasını sağlayabilir.
• Son kullanıcıların yükünü azaltın. Bir yönetici yüklemesi, öğretmenlerin ve öğrencilerin kurulum yükünü azaltır. Bu sayede, daha az tıklamayla daha sorunsuz bir kullanıcı deneyimi sunabilir, kafa karışıklığı yaratabilecek fırsatlar da azalabilir.

Yönetici yüklemelerini nasıl gerçekleştireceğinizle ilgili daha fazla bilgi için Alanınıza Marketplace uygulamalarını yükleme ve kuruluş birimleri ile erişim grupları hakkında daha fazla bilgi edinmek için Kuruluş yapısının işleyiş şekli konusuna bakın.

Bireysel kurulum

Tek tek yüklemeler, kullanıcının kendi hesabına bir eklenti ekler. Yükleme sırasında kullanıcıdan eklentinin erişim kapsamlarına izin vermesi istenir.

Aşağıda, tek tek yüklemeyle ilgili olarak dikkate alınması gereken bazı noktalar yer almaktadır.

• Benimseme sürecini kolaylaştırın. Google Workspace Marketplace'ten eklentinizi daha fazla kullanıcı görebilir ve yükleyebilir. Tek tek yüklemeye izin vermek, daha fazla öğretmenin ürününüzü benimsemesini veya desteklemesini sağlayabilir.
• Yönetici tarafından test. Bir yönetici, bir eklentiyi daha geniş bir grup için onaylamadan ya da yüklemeden önce test etmek veya değerlendirmek amacıyla tek tek yükleyebilir.

Yöneticiler, kullanıcılar adına eklenti yüklemenin yanı sıra kullanıcıların bağımsız yüklemeye izin veren eklentileri yüklemesine izin vermek için bir izin verilenler listesi de tutabilir. Bir eklenti izin verilenler listesinde değilse kullanıcılar eklentinin girişini Google Workspace Marketplace'te görmeye devam edebilir ancak eklentiyi yükleyemez. Bunun yerine, eklentinin bir alan yöneticisi tarafından yüklenmesine izin verilmediğini açıklayan bir mesaj görürler. Bu davranış hakkında daha fazla bilgi edinmek için İzin verilenler listenizdeki Google Workspace Marketplace uygulamalarını yönetme başlıklı makaleye bakın.

Daha fazla bilgi için Google Workspace Marketplace yükleme ayarları dokümanlarına bakın.

Uygulama Entegrasyonu

Ek Kurulumu URI'si alanında bir başlatma iframe'i URL'si sağlamanız gerekir. Bu URL, Ek Discovery iframe'i için iframe src değeri olarak kullanılır. Ek Discovery iframe'i öğretmenler tarafından ödevlerine eklenecek içerik veya etkinlikleri bulmak için kullanılır.

Ayrıca, eklentinizden eklere izin verilen tüm URI ön eklerini belirtmeniz gerekir. Bu özellik, yetkisiz kaynaklardan gelen ekleri engelleyerek güvenliği artırır.

Bu alanlarla ilgili daha ayrıntılı bilgi için iframe'ler kılavuzu sayfasına bakın.

Test hesapları

Özel eklentinizin doğru davranışını doğrulamak için demo alanınızda test hesapları oluşturun. Öğrenci Çalışma İncelemesi iframe'inde öğrenciler arasında geçişi test etmek için iki öğrenci hesabı gereklidir.

Önerilen test hesapları:

• Tammy Öğretmen, tammy.ogretmen@<demo alanınız>
• Selim Öğrenci, sam.student@<demo alanınız>
• Sally Öğrenci, sally.student@<demo alanınız>

Yeni bir test hesabı oluşturmak için şu prosedürü izleyin:

1. Yönetici konsolunuza giriş yapın.
2. Kullanıcılar'a gidin.
3. Yeni kullanıcı ekle'yi tıklayın (bkz. Şekil 1).
4. Kullanıcının bilgilerini girin ve uygun rolleri atayın.

Şekil 1. Yönetici konsolundaki Yeni kullanıcı ekle bağlantısının konumu.

Yeni bir test grubu oluşturmak için şu prosedürü izleyin:

1. Yönetici konsolunuza giriş yapın.
2. Gruplar'a gidin.
3. Grup oluştur'u tıklayın (bkz. Şekil 2).
4. Grubun üyelerini ve sahiplerini girin.

Şekil 2. Grup oluştur bağlantısının Yönetici Konsolu'ndaki konumu.