این صفحه مروری بر مثال برنامه وب Apps Script برای API فرمهای گوگل ارائه میدهد.
پیشنیازها
- API فرمها را در پروژه Google Cloud خود فعال کنید.
- همانطور که در فایل README گیتهاب برای برنامه وب نمونه توضیح داده شده است، یک پروژه Apps Script جدید راهاندازی کنید.
نمای کلی
API فرمها به هر کلاینت احراز هویت شدهای اجازه میدهد تا مستقیماً با استفاده از REST به API دسترسی پیدا کند.
از آنجا که Apps Script راهی برای به دست آوردن توکن دسترسی معتبر OAuth و برقراری فراخوانیهای REST فراهم میکند، میتوان Apps Script را مستقیماً با Forms API ادغام کرد. Apps Script از قبل یک سرویس Forms موجود ارائه میدهد که به اسکریپتها اجازه میدهد فرمها را ایجاد، دسترسی و تغییر دهند. با این حال، اگر ترجیح میدهید از Forms API مستقیماً از Apps Script استفاده کنید، دسترسی OAuth را به شرح زیر تنظیم کنید:
یک توکن دسترسی OAuth احراز هویت شده و محدود شده دریافت کنید.
ScriptApp.getOAuthToken();توکن OAuth را در آرگومان گزینههای ارائه شده در هرگونه فراخوانی REST به API قرار دهید.
UrlFetchApp.fetch(Url, options);
برای مثالی از این مورد در عمل، به بخش «راهاندازی یک پروژه اسکریپت برنامهها» مراجعه کنید. راهنمای راهاندازی، زیرساخت مورد نیاز برای فراخوانی API را شرح میدهد - با این حال، برای فراهم کردن دسترسی شهودی به API برای کاربران، میتوانید برنامه وب نمونه ما را نیز امتحان کرده و تغییر دهید.
مثال استفاده از برنامه وب
یک نمونه کامل از یک برنامه وب که تمام متدهای Forms API را مستقیماً فراخوانی میکند، در مخزن گیتهاب apps-script-samples موجود است.
اجرای برنامه وب
وقتی پروژه خود را راهاندازی و به عنوان یک برنامه وب مستقر کردید، میتوانید برخی عملیات را امتحان کنید.
با کلیک بر روی دکمه «ایجاد فرم»، یک فرم جدید ایجاد کنید.
فرم جدید اکنون در فیلد Form id: قابل مشاهده است و میتوانید با کلیک روی Open in Forms آن را باز کنید.
پس از باز کردن فرم جدید در یک پنجره جداگانه، سعی کنید چند سوال را به صورت دستی اضافه کنید، سپس روی Get Form by Id کلیک کنید تا سوالات جدید خود را در خروجی JSON در سمت راست مشاهده کنید.
سایر روشهای موجود در برنامه را بررسی کنید و خروجی سمت راست هر عملیات را مشاهده کنید.
کار با ساعتهای فرم
همچنین به دکمههای مربوط به watchهای فرمها توجه کنید. این دکمهها از ویژگی watchهای API فرمها استفاده میکنند و عملیات ایجاد، فهرست کردن، حذف و تمدید watchها را انجام میدهند. برای استفاده از آنها باید یک پروژه با موضوعات Cloud Pub/Sub راهاندازی کنید.
برای اطلاعات بیشتر در مورد Forms API watchs و Cloud Pub/Sub، به بخش تنظیم و دریافت اعلانهای فوری مراجعه کنید.
مراحل بعدی
سعی کنید برنامه نمونه را متناسب با نیازهای خود سفارشی کنید. در اینجا چند مثال آورده شده است:
- یک بانک سوال در یک برگه گوگل ایجاد کنید و سپس از سرویس Apps Script SpreadsheetApp برای دریافت سوالات از یک برگه و پر کردن فرمهای جدید استفاده کنید.
- از طرف دیگر، بانک سوالات شما میتواند در یک پایگاه داده SQL قرار گیرد که در آن میتوانید از سرویس Apps Script JDBC برای پر کردن فرمها با سوالات از پایگاه داده استفاده کنید.
- یک آزمون ایجاد کنید و نمرات را در دفتر نمره گوگل شیت ذخیره کنید.
- پروژه خود را با Cloud Pub/Sub تنظیم کنید و از ویژگی watchs برای ایجاد یک جدول امتیازات دانشآموزان در لحظه (real-time) برای نمایش نتایج آزمون استفاده کنید.