نمای کلی Google Docs API

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، شروع سریع جاوا اسکریپت را امتحان کنید.