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

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

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

يمكنك إنشاء برمجة تطبيقات Google تتيح إرسال الطلبات إلى Google Docs API.

الأهداف

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

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

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

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

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

docs/quickstart/quickstart.gs
/**
 * Prints the title of the sample document:
 * https://docs.google.com/document/d/195j9eDD3ccgjQRttHhJPymLJUCOUjs-jmwTrekvdjFE/edit
 * @see https://developers.google.com/docs/api/reference/rest/v1/documents/get
 */
function printDocTitle() {
  const documentId = '195j9eDD3ccgjQRttHhJPymLJUCOUjs-jmwTrekvdjFE';
  try {
    // Get the document using document id
    const doc = Docs.Documents.get(documentId);
    // Log the title  of document.
    console.log('The title of the doc is: %s', doc.title);
  } catch (err) {
    // TODO (developer) - Handle exception from Docs API
    console.log('Failed to found document with an error %s', err.message);
  }
}

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

تفعيل واجهة برمجة تطبيقات "مستندات Google"

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

تشغيل النموذج

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

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

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

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

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