Google Classroom eklentileri artık geliştiricilerin genel kullanımına sunuldu! Daha fazla bilgi edinmek için lütfen eklenti belgelerini inceleyin.

Öğretmen ve öğrenci oluşturma ve yönetme

Google Classroom'daki öğrenci ve öğretmen rolleri, kullanıcının kurstaki rolünü temsil eder. Bir kullanıcı, bir kursta öğretmen, başka bir kursta ise öğrenci olarak atanabilir. "Öğrenci" veya "öğretmen" tanımlaması, belirli bir kurstaki belirli bir kullanıcının izinlerini ifade eder.

Öğrenciler

Student kaynağı, öğrenci olarak kayıtlı bir kullanıcıyı temsil eder.

belirli bir kursta Öğrenciler, ders ayrıntılarını ve dersin öğretmenlerini görüntüleyebilir.

Öğretmenler

Teacher kaynağı, belirli bir kursu öğreten bir kullanıcıyı temsil eder. Öğretmenlerin kurs ayrıntılarını görüntülemesine ve değiştirmesine, öğretmenleri ve öğrencileri görüntülemesine, ek öğretmenleri ve öğrencileri yönetmesine izin verilir. Her kursta, kurs sahipliği aktarımı gibi ayarları yönetebilen bir öğretmen olan birincil öğretmen veya kurs sahibi bulunur.

Öğrenciler ve öğretmenler, Directory API tarafından döndürülen kullanıcının benzersiz kimliği veya e-posta adresiyle tanımlanır. Mevcut kullanıcı, "me" kısayolunu kullanarak kendi kimliğine de başvurabilir.

Classroom API'yi kullanarak doğrudan yönetim izinleri

Yöneticiler, öğrenciler ve öğretmenler, Classroom API'yi kullanarak doğrudan kurslara kullanıcı eklerken veya kurslardan kullanıcı kaldırırken farklı izinlere sahiptir.

Yöneticiler

Aşağıdaki koşullar karşılandığında alan yöneticilerinin davet akışını atlayıp öğrencileri ve öğretmenleri doğrudan bir kursa eklemesine izin verilir:

Eklenen kullanıcı, yöneticinin alanının bir parçasıdır.
Kursun birincil öğretmeni veya kurs sahibi, yöneticinin alanının bir parçasıdır.

Bir yöneticinin alanı dışındaki kullanıcılar veya kurslar için uygulamalar, invitations.create yöntemiyle davet göndererek kullanıcının iznini almalıdır.

Öğrenciler

Öğrenciler students.create numarasını arayıp kursun enrollmentCode bilgisini vererek kursa kaydolabilir. enrollmentCode, Course kaynağında yer alan dersin benzersiz tanımlayıcısıdır. Classroom web uygulamasında enrollmentCode, akış sekmesinde ve kurs ayrıntıları sayfasında kullanılabilir.

Öğretmenler

Öğretmenler, kullanıcılara doğrudan kurs ekleyemez. Öğrencileri ve diğer öğretmenleri kursa davet etmek için invitations.create yöntemini kullanmalıdır.

Aşağıdaki tabloda, Teacher ve Student kaynakları için create ve delete yöntemlerine hangi kullanıcının istekte bulunmasına izin verildiği açıklanmaktadır.

	Yönetici	Öğretmen	Öğrenci
`CreateTeacher`	✔️	✖️	✖️
`DeleteTeacher`	✔️	✔️	✖️
`CreateStudent`	✔️	✖️	✔️ ¹
`DeleteStudent`	✔️	✔️	✔️ ²

¹ Öğrenciler kendilerini yalnızca bir kursa ekleyebilir.

² Öğrenciler yalnızca kendilerini bir kurstan silebilir.

Öğretmenleri yönetme

Alan yöneticileri, alanlarındaki öğretmenleri doğrudan teachers.create ile derslere ekleyebilir. Aşağıdaki örnekte bu işlem gösterilmektedir:

.NET

classroom/snippets/ClassroomSnippets/AddTeacher.cs

GitHub'da göster

using Google.Apis.Auth.OAuth2;
using Google.Apis.Classroom.v1;
using Google.Apis.Classroom.v1.Data;
using Google.Apis.Services;
using System;
using System.Net;
using Google;

namespace ClassroomSnippets
{
    // Class to demonstrate the use of Classroom Create Teacher API
    public class AddTeacher
    {
       /// <summary>
       /// Add teacher to the Course
       /// </summary>
       /// <param name="courseId"></param>
       /// <param name="teacherEmail"></param>
       /// <returns></returns>
        public static Teacher ClassroomAddTeacher( string courseId,
                 string teacherEmail)
         {
             try 
             {
                 /* Load pre-authorized user credentials from the environment.
                  TODO(developer) - See https://developers.google.com/identity for 
                  guides on implementing OAuth2 for your application. */
                 GoogleCredential credential = GoogleCredential.GetApplicationDefault()
                     .CreateScoped(ClassroomService.Scope.ClassroomRosters);

                 // Create Classroom API service.
                 var service = new ClassroomService(new BaseClientService.Initializer
                 {
                     HttpClientInitializer = credential,
                     ApplicationName = "Classroom API Snippet"
                 });

                 var teacher = new Teacher
                 {
                     UserId = teacherEmail
                 };
                 // Add the teacher to the course.
                 teacher = service.Courses.Teachers.Create(teacher, courseId).Execute();
                     Console.WriteLine(
                         "User '{0}' was added as a teacher to the course with ID '{1}'.\n",
                         teacher.Profile.Name.FullName, courseId);
                     return teacher;
             }
             catch (Exception e)
             {
                 // TODO(developer) - handle error appropriately
                 if (e is AggregateException)
                 {
                     Console.WriteLine("Credential Not found");
                 }
                 else if (e is GoogleApiException)
                 {
                     Console.WriteLine("Failed to Add the teacher. Error message: {0}", e.Message);
                 }
                 else
                 {
                     throw;
                 }
             }

             return null;
         }


    }

}

Java

classroom/snippets/src/main/java/AddTeacher.java

GitHub'da göster

import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.googleapis.json.GoogleJsonError;
import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.classroom.Classroom;
import com.google.api.services.classroom.ClassroomScopes;
import com.google.api.services.classroom.model.Teacher;
import java.io.IOException;
import java.security.GeneralSecurityException;
import java.util.ArrayList;
import java.util.Arrays;

/* Class to demonstrate the use of Classroom Add Teacher API */
public class AddTeacher {

  /* Scopes required by this API call. If modifying these scopes, delete your previously saved
  tokens/ folder. */
  static ArrayList<String> SCOPES =
      new ArrayList<>(Arrays.asList(ClassroomScopes.CLASSROOM_ROSTERS));

  /**
   * Add teacher to a specific course.
   *
   * @param courseId - Id of the course.
   * @param teacherEmail - Email address of the teacher.
   * @return newly created teacher
   * @throws IOException - if credentials file not found.
   * @throws GeneralSecurityException - if a new instance of NetHttpTransport was not created.
   */
  public static Teacher addTeacher(String courseId, String teacherEmail)
      throws GeneralSecurityException, IOException {

    // Create the classroom API client.
    final NetHttpTransport HTTP_TRANSPORT = GoogleNetHttpTransport.newTrustedTransport();
    Classroom service =
        new Classroom.Builder(
                HTTP_TRANSPORT,
                GsonFactory.getDefaultInstance(),
                ClassroomCredentials.getCredentials(HTTP_TRANSPORT, SCOPES))
            .setApplicationName("Classroom samples")
            .build();

    Teacher teacher = new Teacher().setUserId(teacherEmail);
    try {
      // Add a teacher to a specified course
      teacher = service.courses().teachers().create(courseId, teacher).execute();
      // Prints the course id with the teacher name
      System.out.printf(
          "User '%s' was added as a teacher to the course with ID '%s'.\n",
          teacher.getProfile().getName().getFullName(), courseId);
    } catch (GoogleJsonResponseException e) {
      // TODO(developer) - handle error appropriately
      GoogleJsonError error = e.getDetails();
      if (error.getCode() == 409) {
        System.out.printf("User '%s' is already a member of this course.\n", teacherEmail);
      } else if (error.getCode() == 403) {
        System.out.println("The caller does not have permission.\n");
      } else {
        throw e;
      }
    }
    return teacher;
  }
}

PHP

classroom/snippets/src/ClassroomAddTeacher.php

GitHub'da göster

<?php
use Google\Client;
use Google\Service\Classroom;
use Google\Service\Classroom\Teacher;
use Google\service\Exception;

function addTeacher($courseId, $teacherEmail)
{
    /* Load pre-authorized user credentials from the environment.
    TODO (developer) - See https://developers.google.com/identity for
     guides on implementing OAuth2 for your application. */
    $client = new Client();
    $client->useApplicationDefaultCredentials();
    $client->addScope("https://www.googleapis.com/auth/classroom.profile.photos");
    $service = new Classroom($client);
    $teacher = new Teacher([
        'userId' => $teacherEmail
    ]);
    try {
        //  calling create teacher
        $teacher = $service->courses_teachers->create($courseId, $teacher);
        printf("User '%s' was added as a teacher to the course with ID '%s'.\n",
            $teacher->profile->name->fullName, $courseId);
    } catch (Exception $e) {
        if ($e->getCode() == 409) {
            printf("User '%s' is already a member of this course.\n", $teacherEmail);
        } else {
            throw $e;
        }
    }
    return $teacher;
}

Python

classroom/snippets/classroom_add_teacher.py

GitHub'da göster

import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError


def classroom_add_teacher(course_id):
  """
  Adds a teacher to a course with specific course_id.
  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """
  creds, _ = google.auth.default()
  # pylint: disable=maybe-no-member
  service = build("classroom", "v1", credentials=creds)

  teacher_email = "gduser1@workspacesamples.dev"
  teacher = {"userId": teacher_email}

  try:
    teachers = service.courses().teachers()
    teacher = teachers.create(courseId=course_id, body=teacher).execute()
    print(
        "User %s was added as a teacher to the course with ID %s"
        % (teacher.get("profile").get("name").get("fullName"), course_id)
    )
  except HttpError as error:
    print('User "{%s}" is already a member of this course.' % teacher_email)
    return error
  return teachers


if __name__ == "__main__":
  # Put the course_id of course for which Teacher needs to be added.
  classroom_add_teacher(453686957652)

Yardımcı öğretmenler, teachers.delete yöntemini kullanarak diğer öğretmenleri dersten kaldırabilir. Bu işlem yalnızca belirtilen öğretmeni kurstan kaldırır ve diğer kurslara atanmasını veya kullanıcı profilini etkilemez.

Kurs sahiplerini yönetme

Alan yöneticileri, kursların sahipliğini öğretmenler arasında aktarabilir. Önemli ayrıntılar için Kurs sahibini güncelleme bölümüne bakın.

Öğrencileri yönetme

Alan yöneticileri, students.create yöntemiyle alanlarındaki öğrencileri doğrudan ekleyebilir. Bir öğrenci doğrudan bir derse kaydoluyorsa enrollmentCode alanı gereklidir.

.NET

classroom/snippets/ClassroomSnippets/AddStudent.cs

GitHub'da göster

using Google.Apis.Auth.OAuth2;
using Google.Apis.Classroom.v1;
using Google.Apis.Classroom.v1.Data;
using Google.Apis.Services;
using System;
using System.Net;
using Google;

namespace ClassroomSnippets
{
    // Class to demonstrate the use of Classroom Create Student API
    public class AddStudent
    {
        public static Student ClassroomAddStudent(string courseId, string enrollmentCode)
        {
            try
            {
                /* Load pre-authorized user credentials from the environment.
                 TODO(developer) - See https://developers.google.com/identity for 
                 guides on implementing OAuth2 for your application. */
                GoogleCredential credential = GoogleCredential.GetApplicationDefault()
                    .CreateScoped(ClassroomService.Scope.ClassroomRosters);
                var service = new ClassroomService(new BaseClientService.Initializer
                {
                    HttpClientInitializer = credential,
                    ApplicationName = "Classroom API .NET Quickstart"
                });

                var student = new Student
                {
                    UserId = "me"
                };

                var request = service.Courses.Students.Create(student, courseId);
                request.EnrollmentCode = enrollmentCode;
                student = request.Execute();
                Console.WriteLine(
                    "User '{0}' was enrolled  as a student in the course with ID '{1}'.\n",
                    student.Profile.Name.FullName, courseId);
            }
            catch (Exception e)
            {
                // TODO(developer) - handle error appropriately
                if (e is AggregateException)
                {
                    Console.WriteLine("Credential Not found");
                }
                else if (e is GoogleApiException)
                {
                    Console.WriteLine("Failed to Add the Student. Error message: {0}", e.Message);
                }
                else
                {
                    throw;
                }
            }

            return null;
        }
    }

}

Java

classroom/snippets/src/main/java/AddStudent.java

GitHub'da göster

import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.googleapis.json.GoogleJsonError;
import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.classroom.Classroom;
import com.google.api.services.classroom.ClassroomScopes;
import com.google.api.services.classroom.model.Student;
import java.io.IOException;
import java.security.GeneralSecurityException;
import java.util.ArrayList;
import java.util.Arrays;

/* Class to demonstrate the use of Classroom Add Student API */
public class AddStudent {

  /* Scopes required by this API call. If modifying these scopes, delete your previously saved
  tokens/ folder. */
  static ArrayList<String> SCOPES =
      new ArrayList<>(Arrays.asList(ClassroomScopes.CLASSROOM_ROSTERS));

  /**
   * Add a student in a specified course.
   *
   * @param courseId - Id of the course.
   * @param enrollmentCode - Code of the course to enroll.
   * @return newly added student
   * @throws IOException - if credentials file not found.
   * @throws GeneralSecurityException - if a new instance of NetHttpTransport was not created.
   */
  public static Student addStudent(String courseId, String enrollmentCode, String studentId)
      throws GeneralSecurityException, IOException {

    // Create the classroom API client.
    final NetHttpTransport HTTP_TRANSPORT = GoogleNetHttpTransport.newTrustedTransport();
    Classroom service =
        new Classroom.Builder(
                HTTP_TRANSPORT,
                GsonFactory.getDefaultInstance(),
                ClassroomCredentials.getCredentials(HTTP_TRANSPORT, SCOPES))
            .setApplicationName("Classroom samples")
            .build();

    Student student = new Student().setUserId(studentId);
    try {
      // Enrolling a student to a specified course
      student =
          service
              .courses()
              .students()
              .create(courseId, student)
              .setEnrollmentCode(enrollmentCode)
              .execute();
      // Prints the course id with the Student name
      System.out.printf(
          "User '%s' was enrolled as a student in the course with ID '%s'.\n",
          student.getProfile().getName().getFullName(), courseId);
    } catch (GoogleJsonResponseException e) {
      // TODO(developer) - handle error appropriately
      GoogleJsonError error = e.getDetails();
      if (error.getCode() == 409) {
        System.out.println("You are already a member of this course.");
      } else if (error.getCode() == 403) {
        System.out.println("The caller does not have permission.\n");
      } else {
        throw e;
      }
    }
    return student;
  }
}

PHP

classroom/snippets/src/ClassroomAddStudent.php

GitHub'da göster

<?php
use Google\Client;
use Google\Service\Classroom;
use Google\Service\Classroom\Student;
use Google\Service\Exception;

function enrollAsStudent($courseId,$enrollmentCode)
{
    /* Load pre-authorized user credentials from the environment.
    TODO (developer) - See https://developers.google.com/identity for
     guides on implementing OAuth2 for your application. */
    $client = new Client();
    $client->useApplicationDefaultCredentials();
    $client->addScope("https://www.googleapis.com/auth/classroom.profile.emails");
    $service = new Classroom($client);
    $student = new Student([
        'userId' => 'me'
    ]);
    $params = [
        'enrollmentCode' => $enrollmentCode
    ];
    try {
        $student = $service->courses_students->create($courseId, $student, $params);
        printf("User '%s' was enrolled  as a student in the course with ID '%s'.\n",
            $student->profile->name->fullName, $courseId);
    } catch (Exception $e) {
        if ($e->getCode() == 409) {
            print "You are already a member of this course.\n";
        } else {
            throw $e;
        }
    }
    return $student;
}

Python

classroom/snippets/classroom_add_student.py

GitHub'da göster

import os

from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError

SCOPES = ["https://www.googleapis.com/auth/classroom.coursework.students"]


def classroom_add_student_new(course_id):
  """
  Adds a student to a course, the teacher has access to.
  The file token.json stores the user's access and refresh tokens, and is
  created automatically when the authorization flow completes for the first
  time.
  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity for
   guides on implementing OAuth2 for the application.
  """

  creds = None
  # The file token.json stores the user's access and refresh tokens, and is
  # created automatically when the authorization flow completes for the first
  # time.
  if os.path.exists("token.json"):
    creds = Credentials.from_authorized_user_file("token.json", SCOPES)
  # If there are no (valid) credentials available, let the user log in.
  if not creds or not creds.valid:
    if creds and creds.expired and creds.refresh_token:
      creds.refresh(Request())
    else:
      flow = InstalledAppFlow.from_client_secrets_file(
          "credentials.json", SCOPES
      )
      creds = flow.run_local_server(port=0)
    # Save the credentials for the next run
    with open("token.json", "w", encoding="utf8") as token:
      token.write(creds.to_json())

  enrollment_code = "abc-def"
  student = {"userId": "gduser1@workspacesamples.dev"}
  try:
    service = build("classroom", "v1", credentials=creds)
    student = (
        service.courses()
        .students()
        .create(
            courseId=course_id, enrollmentCode=enrollment_code, body=student
        )
        .execute()
    )
    print(
        '''User {%s} was enrolled as a student in
                   the course with ID "{%s}"'''
        % (student.get("profile").get("name").get("fullName"), course_id)
    )
    return student
  except HttpError as error:
    print(error)
    return error


if __name__ == "__main__":
  # Put the course_id of course for which student needs to be added.
  classroom_add_student_new(478800920837)

students.delete yöntemini kullanarak bir öğrenciyi kurstan kaldırdığınızda öğrenci yalnızca belirtilen kurstan kaldırılır ve diğer kurslara kaydı veya kullanıcı profili etkilenmez.

Kullanıcının kurslarını alma

Bir öğrenci veya öğretmenin kurs listesini almak için courses.list işlevini çağırın ve ilgili kullanıcının studentId veya teacherId değerini sağlayın.

Tek bir courses.list() isteğinde hem studentId hem de teacherId değerini ayarlayamazsınız. Belirli bir öğretmen ve öğrencinin kayıtlı olduğu kursların listesini almak için her kullanıcı için ayrı courses.list() isteği gönderin. Ardından, iki sonuç kümesinin kesişimini bulun.

Kullanıcı profilini alma

Kimlik ve ad dahil olmak üzere bir kullanıcının profilini almak için userProfiles.get işlevini kullanıcının kimliği, e-posta adresi veya istekte bulunan kullanıcı için "me" ile çağırın. emailAddress alanını almak için classroom.profile.emails kapsamını eklemeniz gerekir.

Döndürülen id, eşleşen studentId veya teacherId içeren Directory API Users resource'a karşılık gelir.

Ders davetiyeleri oluşturma ve yönetme

Öğretmen ve öğrenci oluşturma ve yönetme Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Classroom API'yi kullanarak doğrudan yönetim izinleri

Yöneticiler

Öğrenciler

Öğretmenler

Öğretmenleri yönetme

.NET

Java

PHP

Python

Kurs sahiplerini yönetme

Öğrencileri yönetme

.NET

Java

PHP

Python

Kullanıcının kurslarını alma

Kullanıcı profilini alma

Öğretmen ve öğrenci oluşturma ve yönetme