Method: courses.create

Kurs oluşturur.

ownerId içinde belirtilen kullanıcı, oluşturulan kursun sahibidir ve öğretmen olarak eklenir. Yönetici olmayan bir kullanıcı, yalnızca kendisinin sahibi olduğu bir kurs oluşturabilir. Alan yöneticileri, alanlarındaki herhangi bir kullanıcının sahip olduğu dersleri oluşturabilir.

Bu yöntem aşağıdaki hata kodlarını döndürür:

  • PERMISSION_DENIED İstekte bulunan kullanıcının kurs oluşturmasına izin verilmiyorsa veya erişim hataları için.
  • NOT_FOUND Birincil öğretmen geçerli bir kullanıcı değilse.
  • Kurs sahibinin hesabı devre dışı bırakılmışsa veya aşağıdaki istek hataları için FAILED_PRECONDITION:
    • UserCannotOwnCourse
    • UserGroupsMembershipLimitReached
    • CourseTitleCannotContainUrl
  • id içinde bir takma ad belirtilmişse ve bu takma ad zaten mevcutsa ALREADY_EXISTS.

HTTP isteği

POST https://classroom.googleapis.com/v1/courses

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
previewVersion

enum (PreviewVersion)

İsteğe bağlı. API'nin önizleme sürümü. Önizleme Programı'nda geliştiricilere sunulan yeni API özelliklerine erişmek için bu ayarın yapılması gerekir.

İstek metni

İstek metni, Course öğesinin bir örneğini içerir.

Yanıt metni

Başarılı olursa yanıt gövdesi, yeni oluşturulan bir Course örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/classroom.courses

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.