البدء السريع لبرمجة تطبيقات Google

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

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

أنشئ نصوص برمجة تطبيقات Google تُرسل طلبات إلى 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. انقر على مشروع بلا عنوان، واكتب البدء السريع، ثم انقر على إعادة التسمية.

ضبط النص البرمجي

تفعيل Google Classroom API

1. افتح مشروع Apps Script.

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

تشغيل العيّنة

في محرِّر Apps Script، انقر على تشغيل.

في المرة الأولى التي تُشغِّل فيها العيّنة، سيُطلَب منك تفويض الوصول:

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

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

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

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