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

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

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

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

الأهداف

  • أنشِئ النص البرمجي.
  • تفعيل واجهة برمجة تطبيقات Google Sheets.
  • شغِّل العيّنة.

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

  • حساب على Google
  • الوصول إلى Google Drive

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

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

sheets/quickstart/quickstart.gs
/**
 * Creates a Sheets API service object and prints the names and majors of
 * students in a sample spreadsheet:
 * https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms/edit
 * @see https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/get
 */
function logNamesAndMajors() {
  const spreadsheetId = '1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms';
  const rangeName = 'Class Data!A2:E';
  try {
    // Get the values from the spreadsheet using spreadsheetId and range.
    const values = Sheets.Spreadsheets.Values.get(spreadsheetId, rangeName).values;
    //  Print the values from spreadsheet if values are available.
    if (!values) {
      console.log('No data found.');
      return;
    }
    console.log('Name, Major:');
    for (const row in values) {
      // Print columns A and E, which correspond to indices 0 and 4.
      console.log(' - %s, %s', values[row][0], values[row][4]);
    }
  } catch (err) {
    // TODO (developer) - Handle Values.get() exception from Sheet API
    console.log(err.message);
  }
}

  1. انقر على "حفظ" .
  2. انقر على مشروع بلا عنوان، واكتب البدء السريع، ثم انقر على إعادة تسمية.

تفعيل Google Sheets API

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

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

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

في المرة الأولى التي تشغّل فيها النموذج، سيُطلب منك السماح بالوصول إليه:

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

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

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