Entegrasyonunuz için hızlı başlangıç kılavuzu
Ortak müşterilerimiz için yeni pazarlara açılabilmek amacıyla entegrasyonunuzun hızla yayına girmesini istiyoruz.
Udemy Business Entegrasyonlar sayfası, aşağıda gösterilmiştir
Ön koşul adımları
- İş ortaklığı başvurusu gönderilir ve onaylanır
- Udemy, Udemy Business için korumalı alan ortamı sağlar
- Udemy yöneticisi, diğer kullanıcıları davet eder
Bunlardan herhangi biri eksikse lütfen önce bunları tamamlamak için (Başlangıç Kılavuzuna) bakın
İş ortağı entegrasyonu kullanım senaryoları: Bu entegrasyon adımlarının desteklediği üst düzey kullanım senaryolarını incelemek istiyorsanız. İstemiyorsanız geliştirme aşamasına geçebiliriz.
Geliştirme adımları
Önerdiğimiz en iyi uygulama, önce tüm Udemy API'lerine bağlanıp ardından tüm uç noktaların çalıştığı doğrulandıktan sonra yazılım geliştirmeye başlayarak teknik riski en aza indirmektir.
- Kurslar API'sine bağlanın, en az 10 kurs getirin
- Kurs API'sine bağlanın, 1 kurs getirin
- Udemy Business sitenizde oturum açın ve bir kursa kaydolun, en az 1 dakikalığına bir ders izleyin (Oynatma hızını artırabilirsiniz)
- Raporlama API'sine bağlanın (kullanıcı-etkinlik)
- Raporlama API'sine bağlanın (kullanıcı-kurs-etkinlik)
- Raporlama API'sine bağlanın (öğrenim-etkinlik-deneme)
- Udemy Business sitenizde oturum açın ve bir Öğrenim Yolu (belgeler) oluşturun, bir kurs açın ve bu kursu, az önce oluşturduğunuz öğrenim yoluna ekleyin
- Öğrenim Yolu API'sine bağlanın, oluşturduğunuz öğrenim yolunu getirin
Yapılandırmalar
API'lerin çoğu çalışır durumda olduğunda yapılandırma adımlarına geçebilirsiniz.
- Çoklu Oturum Açma (SSO) yapılandırması, doğrudan Udemy Business Ayarlar sayfanızdan yapılır. Bu ayarlara erişmek için yönetici kimlik bilgilerine sahip olmanız gerekir. Çok sayıda sağlayıcımızdan biriyle kullanıma hazır SSO'yu kurun. Alternatif olarak, SAML 2.0 ile özel bir bağlantı oluşturun (SSO belgelerinin bağlantısı)
- [Udemy Business: Yönet: Ayarlar] bölümündeki diğer ayarları inceleyin ve istediğiniz şekilde özelleştirin
Geliştirmeler
Öğrenim Yolları - Kullanıcıların, öğrenciyi yönlendirecek bir başlangıcı ve sonu olan çeşitli öğrenim kaynaklarından oluşan bir müfredat oluşturmasına olanak tanır.
- Udemy Business sitenizde oturum açın ve bir Öğrenim Yolu (belgeler) oluşturun, bir kurs açın ve bu kursu, az önce oluşturduğunuz öğrenim yoluna ekleyin
- Öğrenim Yolu API'sine bağlanın; oluşturduğunuz öğrenim yolunu getirin
- Raporlama API'sine (öğrenim-yolu-etkinliği) bağlanın
Web kancası yoluyla gerçek zamanlı raporlama
- Kurulum xAPI'si - Öğrencinin ilerleme durumuna ve tamamlanma olaylarına dair raporlama verileri için Udemy'nin web kancası (belgeler). Udemy yönetici ayarları sayfasına parametreler ekleyeceksiniz.
- Kurulumun ardından maksimum oynatma hızında kısa bir ders izleyin ve ilerleme durumu verilerini alıp almadığınıza bakın.
Kurs verilerini sorgulama veya arama - Udemy'nin GraphQL API'sini kullanarak kurs kataloğumuzda sorgu işlevini kullanmanıza ve yalnızca ilgili kullanım senaryosu için ihtiyacınız olan verileri almanıza olanak tanırız. Ayrıca girdinizi ve filtrelerinizi alarak ilgili kurs sonuçları getiren bir Arama API'si de sunarız.
- GraphQL API kimlik bilgilerini edinin
- GetAuthToken() adlı GraphQL işlevini çağırın
- Kurslar API'sini çağırmak için [authToken] ifadesini kullanın
- CourseSearch API'sini çağırın
Not: GraphQL Belgelerine erişmek için Udemy Business'ta oturum açmanız gerekir. İlgili URL, kuruluşunuzun Udemy hesabına yönelik alt etki alanını ve ardından .udemy.com/dev-portal/api-reference/ ifadesini içerir.
Örneğin:
https://{alt_etki_alaniniz}.udemy.com/dev-portal/api-reference/.
Temel yazılım geliştirme
Tüm Udemy kimlik bilgileri çalıştığında, tüm API'lere bağlanıldığında ve ek yapılandırmalar kurulduğunda teknik risk ortadan kalkar. Çoğu iş ortağı, planlama aşamasına veya doğrudan geliştirme aşamasına geçer. Başlamanın bir yolu da kullanıcı hikayelerinin veya desteklenen kullanım senaryolarının listesini almak ve her bir kullanım senaryosu için gereken Udemy API'lerini eşleştirmektir. Bu aşamadan sonra yazılım mühendisliği ekibinize bol şans diliyoruz!
Hata giderme, istisnalar ve en iyi uygulamalar
Hata giderme, istisnalar ve uç senaryolarını dahil ederek yazılımınızı güçlendirin. Beklenmeyen BT sorunlarını gidermek için çok çeşitli hata giderme önerilerimiz bulunmaktadır.
- API'ler tarafından döndürülen hata yanıtlarını kaydedin
- API çağrılarına yeniden deneme mantığı ekleyin
- sayfa_boyutu en iyi uygulamalarını kullanarak oran sınırlarını ele alın
- Belgede yer alan diğer en iyi uygulamaları gerçekleştirin
Daha fazla destek ve geri bildirim için veya yeni entegrasyonunuzun tamamlanmasının ardından lütfen partnersupport@udemy.com adresinden bizimle iletişime geçin. Yeni ortak işlevselliğimiz ile birlikte yeni pazarlara açılmayı sabırsızlıkla bekliyoruz.