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