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

Hızlı başlangıç kılavuzlarında, Google Workspace API'yi çağıran bir uygulamanın nasıl oluşturulacağı ve çalıştırılacağı açıklanmaktadır.

Google Workspace hızlı başlangıç kılavuzları, kimlik doğrulama ve yetkilendirme akışının bazı ayrıntılarını işlemek için API istemci kitaplıklarını kullanır. Kendi uygulamalarınız için istemci kitaplıklarını kullanmanızı öneririz. 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ında, uygulamanız için uygun erişim kimlik bilgilerini seçmeden önce kimlik doğrulama ve yetkilendirme hakkında bilgi edinmenizi öneririz.

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

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üzenleyicisinin 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

  1. Apps Komut Dosyası projesini açın.
  1. Düzenleyici'yi tıklayın.
  2. Hizmetler'in yanındaki Hizmet ekle'yi tıklayın .
  3. Google Classroom API'yi seçin ve Ekle'yi tıklayın.

Sana Özel'i çalıştırma

Apps Komut Dosyası düzenleyicisinde Çalıştır'ı tıklayın.

Sana Özel'i ilk kez çalıştırdığınızda erişim için yetki vermenizi ister:

  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