این بخش رفتارها و محدودیتهایی را شرح میدهد که هنگام ویرایش اسناد با استفاده از API گوگل داکس باید آنها را درک کنید.
به طور کلی، شما نمیتوانید ویرایشهایی را اجرا کنید که باعث ایجاد ساختار نامعتبر در عناصر درون یک سند شوند. هر روش درخواست documents.batchUpdate را برای محدودیتها و قوانینی که برای آن درخواستها اعمال میشود، بررسی کنید.
بخشهای زیر خلاصهای از قوانین کلیدی در این روشها را ارائه میدهند.
متن را وارد کنید
- درج یک کاراکتر خط جدید به طور ضمنی یک
Paragraphدر آن فهرست ایجاد میکند. سبک پاراگراف پاراگراف جدید از پاراگراف در فهرست درج فعلی، شامل لیستها و بولتها، کپی میشود. - متن باید در محدودهی یک
Paragraphموجود درج شود. برای مثال، متن را نمیتوان در اندیس شروع جدول درج کرد. متن باید در پاراگراف قبلی درج شود. - ممکن است API به طور ضمنی مکان را تنظیم کند تا از درج در خوشههای گرافیم یونیکد جلوگیری شود. وقتی این اتفاق میافتد، متن بلافاصله پس از خوشه گرافیم درج میشود.
- سبکهای متن برای متن درجشده بهطور خودکار تعیین میشوند و بهطورکلی سبک متن مجاور را حفظ میکنند. بهطور معمول، سبک متن برای متن درجشده با متن بلافاصله قبل از شاخص درج مطابقت دارد.
- برخی از کاراکترهای کنترلی (
U+0000-U+0008, U+000C-U+001F) و کاراکترهای ناحیه استفاده خصوصی صفحه چندزبانه پایه یونیکد (U+E000-U+F8FF) از متن درج شده حذف شدهاند. - برای اطلاعات بیشتر، به درج، حذف و انتقال متن مراجعه کنید.
تصاویر درون خطی را وارد کنید
- حجم تصویر باید کمتر از ۵۰ مگابایت، حداکثر ۲۵ مگاپیکسل و با یکی از فرمتهای PNG، JPEG یا GIF باشد.
- آدرس اینترنتی (URI) ارائه شده باید به صورت عمومی قابل دسترسی باشد و حداکثر ۲ کیلوبایت طول داشته باشد.
- تصویر باید در محدوده یک
Paragraphموجود درج شود. برای مثال، متن را نمیتوان در اندیس شروع جدول درج کرد. - تصاویر را نمیتوان داخل پاورقی یا معادله قرار داد.
- برای اطلاعات بیشتر، به درج تصاویر درونخطی مراجعه کنید.
قالببندی متن
- وقتی قالببندی در سطح پاراگراف را روی یک محدوده اعمال میکنید، این قالببندی روی هر پاراگرافی که تا حدی یا کاملاً با آن محدوده همپوشانی داشته باشد، اعمال میشود.
- این محدوده میتواند گسترش یابد تا شامل خطوط جدید مجاور نیز بشود.
- اگر محدوده به طور کامل شامل یک پاراگراف متعلق به یک لیست باشد، بولت پاراگراف نیز با سبک متن منطبق بهروزرسانی میشود.
- برای اطلاعات بیشتر، به قالببندی متن مراجعه کنید.
ایجاد بولتهای پاراگراف
- برای تمام پاراگرافهایی که با محدوده داده شده همپوشانی دارند، علامتهای نقطهای (بولت) ایجاد میکند.
- سطح تودرتوی هر پاراگراف با تعداد تبهای ابتدایی قبل از هر پاراگراف تعیین میشود.
- هنگام ایجاد بولتها، تبهای ابتدایی حذف میشوند که ممکن است اندیس بخشهایی از متن را تغییر دهد.
- اگر بلافاصله قبل از پاراگراف هدف، بولتهای پاراگرافی را اضافه کنید که با بولتهای یک لیست مطابقت داشته باشند، آن پاراگراف به لیست اضافه میشود.
- برای اطلاعات بیشتر، به بخش «کار با لیستها» مراجعه کنید.
حذف متن
حذف متنی که از مرز پاراگراف عبور میکند، ممکن است باعث تغییراتی در سبکهای پاراگراف، لیستها، اشیاء موقعیتیابی شده و نشانکها هنگام ادغام دو پاراگراف شود.
حذفهایی که باعث ایجاد ساختار نامعتبر سند میشوند، مجاز نیستند. برخی از نمونههای درخواستهای حذف نامعتبر عبارتند از:
حذف یک واحد کد از یک جفت جایگزین.
حذف آخرین کاراکتر خط جدید از
Body،Header،Footer،Footnote،TableCellیاTableOfContents.حذف ابتدا یا انتهای یک
Table،TableOfContentsیاEquationبدون حذف کل عنصر.حذف کاراکتر خط جدید قبل از یک
Table،TableOfContentsیاSectionBreakبدون حذف عنصر.حذف سطرها یا سلولهای تکی یک جدول. حذف محتوای یک سلول جدول مجاز است.
برای اطلاعات بیشتر، به درج، حذف و انتقال متن مراجعه کنید.