Google Docs API به شما امکان می دهد اسناد را در Google Docs ایجاد و اصلاح کنید.
برنامهها میتوانند با Docs API ادغام شوند تا اسناد صیقلی را هم از دادههای کاربر و هم از دادههای ارائهشده توسط سیستم ایجاد کنند. Docs API به شما امکان می دهد:
- فرآیندها را خودکار کنید
- اسناد را به صورت انبوه ایجاد کنید
- فرمت اسناد
- فاکتورها یا قراردادها را ایجاد کنید
- بازیابی ویژگی های خاص اشیاء
در زیر لیستی از اصطلاحات رایج مورد استفاده در Docs API آمده است:
- شناسه سند
شناسه منحصر به فرد یک سند. این یک رشته خاص است که حاوی حروف، اعداد و برخی کاراکترهای خاص است که به یک سند اشاره میکند و میتوان آن را از URL سند مشتق کرد. شناسههای سند پایدار هستند، حتی اگر نام سند تغییر کند. برای اطلاعات بیشتر در مورد نحوه یافتن شناسه، به شناسه سند مراجعه کنید.
https://docs.google.com/document/d/DOCUMENT_ID/edit
- عنصر
ساختاری که یک سند را می سازد. عناصر سطح بالای یک سند عبارتند از
Body
،DocumentStyle
وList
.- سند Google Workspace
فایلی که یک برنامه Google Workspace، مانند Google Docs، ایجاد می کند. قالب نوع MIME برای Docs
application/vnd.google-apps.document
است. برای لیستی از انواع MIME، به انواع MIME پشتیبانی شده Google Workspace و Google Drive مراجعه کنید.- شاخص
اکثر عناصر درون بدنه محتوا دارای ویژگی
startIndex
وendIndex
هستند. اینها نشان دهنده انحراف شروع و پایان یک عنصر، نسبت به ابتدای بخش احاطه کننده آن است.- تصویر درون خطی
تصویری که در جریان متن در یک سند ظاهر می شود. این یک پیوست نیست.
- محدوده نامگذاری شده
طیف پیوسته ای از متن.
NamedRange
مجموعه ای از محدوده ها با همانnamedRangeId
است. محدودههای نامگذاری شده به توسعهدهندگان اجازه میدهد تا بخشهایی از یک سند را با یک برچسب دلخواه تعریفشده توسط کاربر مرتبط کنند تا محتوای آنها بعداً بهصورت برنامهریزی خوانده یا ویرایش شود. یک سند میتواند شامل چندین محدوده نامگذاری شده با یک نام باشد، اما هر محدوده نامگذاری شده یک شناسه منحصربهفرد دارد.- بخش
Body
،Header
،Footer
یاFootnote
حاوی عناصر ساختاری یا محتوایی. شاخص های عناصر داخل یک بخش نسبت به ابتدای آن بخش است.- پیشنهاد
تغییر در یک سند بدون تغییر متن اصلی. اگر مالک پیشنهادات شما را تأیید کند، متن اصلی را جایگزین میکند.
موضوعات مرتبط
برای آشنایی با توسعه با Google Workspace APIها، از جمله رسیدگی به احراز هویت و مجوز، به Develop on Google Workspace مراجعه کنید.
برای دریافت یک نمای کلی مفهومی از یک سند، به سند مراجعه کنید.
برای یادگیری نحوه پیکربندی و اجرای برنامه Docs API، شروع سریع جاوا اسکریپت را امتحان کنید.