مقدمه

API اسکریپت Google Apps به شما امکان می‌دهد ایجاد، مدیریت و اجرای اسکریپت را در Google Apps Script خودکار کنید. می‌توانید پروژه‌های اسکریپت Google Apps را به صورت برنامه‌نویسی ایجاد، اصلاح و مستقر کنید و توابع اسکریپت Apps را از راه دور اجرا کنید - اقداماتی که در غیر این صورت نیاز به استفاده از ویرایشگر اسکریپت Apps یا رابط کاربری آن دارند.

این API اغلب برای موارد زیر استفاده می‌شود:

  • ایجاد و مدیریت پروژه‌ها و استقرارهای اسکریپت برنامه‌ها.
  • توابع را در پروژه‌های اسکریپت اضافه یا به‌روزرسانی کنید.
  • اجرای توابع اسکریپت برنامه‌ها از برنامه‌های دیگر.
  • نظارت بر گزارش‌های اجرای اسکریپت و وضعیت آنها.

API اسکریپت برنامه‌ها همچنین جایگزین و توسعه‌دهنده‌ی API اجرای اسکریپت برنامه‌ها است. شما می‌توانید از API اسکریپت برنامه‌ها برای اجرای توابع اسکریپت برنامه‌ها از راه دور استفاده کنید، همانطور که می‌توانستید با API اجرا این کار را انجام دهید.

برای استفاده از این API در برنامه‌های خود، باید آن را برای استفاده فعال کنید .

برای اینکه به برنامه‌های دیگر اجازه دهید اسکریپت‌های شما را مدیریت کنند، باید به آنها دسترسی بدهید .

نمای کلی API

API اسکریپت برنامه‌ها به چندین منبع تقسیم شده است که هر کدام هدف و مجموعه‌ای از درخواست‌های خاص را دارند که می‌توانید انجام دهید. این منابع به شرح زیر هستند:

  • projects — نمایشی از یک پروژه اسکریپت. این API متدهایی برای ایجاد، خواندن، نظارت و اصلاح پروژه‌ها ارائه می‌دهد. از این منبع برای مدیریت فایل‌های اسکریپت و فراداده‌های پروژه خود استفاده کنید.
  • projects.deployments — نمایشی از استقرار اسکریپت. این API متدهایی برای ایجاد، فهرست کردن، به‌روزرسانی و حذف استقرارهای پروژه اسکریپت ارائه می‌دهد. از استقرارها برای در دسترس قرار دادن اسکریپت خود به عنوان یک برنامه وب، افزونه یا فایل اجرایی استفاده کنید.
  • projects.versions — نمایشی از نسخه پروژه اسکریپت. این API متدهایی برای ایجاد و خواندن نسخه‌های پروژه ارائه می‌دهد. از نسخه‌ها برای ردیابی تکرارهای مختلف پروژه اسکریپت خود استفاده کنید.
  • processes — نمایشی از اجرای یک تابع اسکریپت. این API روش‌هایی برای فهرست کردن فرآیندهای موجود و جمع‌آوری اطلاعات در مورد آنها، مانند نوع و وضعیت فعلی، ارائه می‌دهد. از این منبع برای نظارت بر اجرای اسکریپت‌هایی که با استفاده از متد scripts.run آغاز می‌شوند، استفاده کنید.
  • scripts — نقطه پایانی که روش‌هایی برای اجرای از راه دور توابع اسکریپت برنامه‌ها ارائه می‌دهد. از این منبع برای اجرای توابع در پروژه اسکریپت خود از برنامه خود استفاده کنید.