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

Hızlı başlangıç kılavuzlarında, Google Workspace API.

Google Workspace hızlı başlangıç kılavuzları, bazı ve kimlik doğrulama ve yetkilendirme akışıyla ilgili ayrıntılara dikkat edin. Önerilerimiz: istemci kitaplıklarını kullanmayı tercih edebilirsiniz. Bu hızlı başlangıç kılavuzunda test için uygun olan basitleştirilmiş kimlik doğrulama yaklaşımı bahsedeceğim. Üretim ortamı için şu konularda bilgi edinmenizi öneririz: kimlik doğrulama ve yetkilendirme önce erişim kimlik bilgilerini seçme seçmeniz gerekir.

Bir metin oluştur: Google Apps Komut Dosyası Google Classroom API'ye istek gönderen bir uygulamadı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şme

Komut dosyasını oluşturun

  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 ve Hızlı Başlangıç'ı tıklayı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ında Hizmet ekle'yi tıklayın.
  3. Seç Google Classroom API'sı ve Ekle'yi tıklayın.

Örneği çalıştırma

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

Örneği ilk kez çalıştırdığınızda sizden 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.

'nı inceleyin.

Sonraki adımlar