التشغيل السريع لبرمجة Google Apps

توضّح الخطوات السريعة كيفية إعداد وتشغيل تطبيق يستدعي واجهة برمجة تطبيقات من Google Workspace.

تستخدم عمليات البدء السريع في Google Workspace مكتبات البرامج لواجهة برمجة التطبيقات للتعامل مع بعض تفاصيل عملية المصادقة والتفويض. وننصحك باستخدام مكتبات العميل لتطبيقاتك الخاصة. يستخدم نظام البدء السريع منهجًا مبسّطًا للمصادقة ومناسبًا لبيئة الاختبار. بالنسبة إلى بيئة الإنتاج، ننصحك للتعرّف على المصادقة والتفويض قبل اختيار بيانات اعتماد الوصول المناسبة لتطبيقك.

أنشئ برمجة تطبيقات Google التي ترسل الطلبات إلى واجهة برمجة تطبيقات Google Classroom.

الأهداف

• أنشِئ النص البرمجي.
• تفعيل Google Classroom API
• شغِّل النموذج.

المتطلبات الأساسية

• حساب على Google for Education تم فيه تفعيل Google Classroom.

• الوصول إلى Google Drive

إنشاء النص البرمجي

1. أنشئ نصًا برمجيًا جديدًا من خلال الانتقال إلى script.google.com/create.
2. استبدل محتوى محرِّر النص البرمجي بالرمز التالي:

/**
 * 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);
  }
}

3. انقر على حفظ .
4. انقر على مشروع بلا عنوان، واكتب Quickstart، وانقر على إعادة تسمية.

تفعيل Google Classroom API

1. افتح مشروع برمجة التطبيقات.
2. انقر على محرِّر code.
3. بجانب الخدمات، انقر على رمز إضافة خدمة add .
4. اختَر Google Classroom API وانقر على إضافة.

تنفيذ عيّنة

في محرِّر "برمجة تطبيقات Google"، انقر على تشغيل.

عند تنفيذ النموذج لأول مرة، يطلب منك إذن الوصول:

1. انقر على مراجعة الأذونات.
2. اختيار حساب.
3. انقر على سماح.

سيظهر سجلّ تنفيذ النص البرمجي في أسفل النافذة.

الخطوات التالية

• مستندات الخدمات المتقدمة في برمجة تطبيقات Google
• تحديد مشاكل المصادقة والمصادقة وحلّها
• المستندات المرجعية في Classroom API