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

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

تستخدم الشركات الناشئة في 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. افتح مشروع "برمجة تطبيقات Google".

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

تنفيذ النموذج

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

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

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

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

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

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