Google Apps Komut Dosyası hızlı başlangıç kılavuzu

Google Classroom API'ye istek gönderen bir Google Apps Komut Dosyası oluşturun.

Hızlı başlangıç kılavuzlarında, Google Workspace API'sini çağıran bir uygulamanın nasıl ayarlanacağı ve çalıştırılacağı açıklanır. Bu hızlı başlangıç kılavuzunda, test ortamı için uygun olan basitleştirilmiş bir kimlik doğrulama yaklaşımı kullanılmaktadır. Üretim ortamı için, uygulamanıza uygun erişim kimlik bilgilerini seçmeden önce kimlik doğrulama ve yetkilendirme hakkında bilgi edinmenizi öneririz.

Apps Komut Dosyası'nda, Google Workspace hızlı başlangıçlarında Google Workspace API'lerini çağırmak ve kimlik doğrulama ile yetkilendirme akışının bazı ayrıntılarını işlemek için Gelişmiş Google hizmetleri kullanılır.

Hedefler

  • Ortamı yapılandırın.
  • Komut dosyasını oluşturun ve yapılandırın.
  • Komut dosyasını çalıştırın.

Ön koşullar

  • Google Classroom'un etkin olduğu bir Google for Education hesabı.

  • Google Drive'a erişim

Komut dosyasını oluşturma

  1. script.google.com/create adresine giderek yeni bir komut dosyası oluşturun.
  2. Komut dosyası düzenleyicinin içeriğini aşağıdaki kodla değiştirin:

classroom/quickstart/quickstart.gs
/**
 * Lists 10 course names and ids.
 */
function listCourses() {
  /**  here pass pageSize Query parameter as argument to get maximum number of result
   * @see https://developers.google.com/classroom/reference/rest/v1/courses/list
   */
  const optionalArgs = {
    pageSize: 10
    // Use other parameter here if needed
  };
  try {
    // call courses.list() method to list the courses in classroom
    const response = Classroom.Courses.list(optionalArgs);
    const courses = response.courses;
    if (!courses || courses.length === 0) {
      console.log('No courses found.');
      return;
    }
    // Print the course names and IDs of the courses
    for (const course of courses) {
      console.log('%s (%s)', course.name, course.id);
    }
  } catch (err) {
    // TODO (developer)- Handle Courses.list() exception from Classroom API
    // get errors like PERMISSION_DENIED/INVALID_ARGUMENT/NOT_FOUND
    console.log('Failed with error %s', err.message);
  }
}

  1. Kaydet'i tıklayın.
  2. Adsız proje'yi tıklayın, Hızlı Başlangıç yazın ve Yeniden adlandır'ı tıklayın.

Komut dosyasını yapılandırma

Google Classroom API'yi etkinleştirme

Apps Komut Dosyası projesini açın.

  1. Düzenleyici'yi tıklayın.
  2. Hizmetler'in yanında Hizmet ekle'yi tıklayın .
  3. Google Classroom API'yi seçip Ekle'yi tıklayın.

Örneği çalıştırma

Apps Komut Dosyası Düzenleyicisi'nde Çalıştır'ı tıklayın.

Örneği ilk kez çalıştırdığınızda erişimi yetkilendirmeniz istenir:

  1. İzinleri incele'yi tıklayın.
  2. Bir hesap seçin.
  3. İzin ver'i tıklayın.

Komut dosyasının yürütme günlüğü pencerenin alt kısmında görünür.

Sonraki adımlar