Requests

{

  // Union field kind can be only one of the following:
  "createSlide": {
    object (CreateSlideRequest)
  },
  "createShape": {
    object (CreateShapeRequest)
  },
  "createTable": {
    object (CreateTableRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "insertTableRows": {
    object (InsertTableRowsRequest)
  },
  "insertTableColumns": {
    object (InsertTableColumnsRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "deleteObject": {
    object (DeleteObjectRequest)
  },
  "updatePageElementTransform": {
    object (UpdatePageElementTransformRequest)
  },
  "updateSlidesPosition": {
    object (UpdateSlidesPositionRequest)
  },
  "deleteText": {
    object (DeleteTextRequest)
  },
  "createImage": {
    object (CreateImageRequest)
  },
  "createVideo": {
    object (CreateVideoRequest)
  },
  "createSheetsChart": {
    object (CreateSheetsChartRequest)
  },
  "createLine": {
    object (CreateLineRequest)
  },
  "refreshSheetsChart": {
    object (RefreshSheetsChartRequest)
  },
  "updateShapeProperties": {
    object (UpdateShapePropertiesRequest)
  },
  "updateImageProperties": {
    object (UpdateImagePropertiesRequest)
  },
  "updateVideoProperties": {
    object (UpdateVideoPropertiesRequest)
  },
  "updatePageProperties": {
    object (UpdatePagePropertiesRequest)
  },
  "updateTableCellProperties": {
    object (UpdateTableCellPropertiesRequest)
  },
  "updateLineProperties": {
    object (UpdateLinePropertiesRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "replaceAllShapesWithImage": {
    object (ReplaceAllShapesWithImageRequest)
  },
  "duplicateObject": {
    object (DuplicateObjectRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "replaceAllShapesWithSheetsChart": {
    object (ReplaceAllShapesWithSheetsChartRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "updateTableBorderProperties": {
    object (UpdateTableBorderPropertiesRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableRowProperties": {
    object (UpdateTableRowPropertiesRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "groupObjects": {
    object (GroupObjectsRequest)
  },
  "ungroupObjects": {
    object (UngroupObjectsRequest)
  },
  "updatePageElementAltText": {
    object (UpdatePageElementAltTextRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateSlideProperties": {
    object (UpdateSlidePropertiesRequest)
  },
  "updatePageElementsZOrder": {
    object (UpdatePageElementsZOrderRequest)
  },
  "updateLineCategory": {
    object (UpdateLineCategoryRequest)
  },
  "rerouteLine": {
    object (RerouteLineRequest)
  }
  // End of list of possible types for union field kind.
}

object ( CreateSlideRequest )

یک اسلاید جدید ایجاد می کند.

object ( CreateShapeRequest )

شکل جدیدی ایجاد می کند.

object ( CreateTableRequest )

یک جدول جدید ایجاد می کند.

object ( InsertTextRequest )

متن را در یک شکل یا سلول جدول درج می کند.

object ( InsertTableRowsRequest )

ردیف ها را در جدول درج می کند.

object ( InsertTableColumnsRequest )

ستون ها را در جدول درج می کند.

object ( DeleteTableRowRequest )

یک ردیف را از جدول حذف می کند.

object ( DeleteTableColumnRequest )

یک ستون را از جدول حذف می کند.

object ( ReplaceAllTextRequest )

همه نمونه های متن مشخص شده را جایگزین می کند.

object ( DeleteObjectRequest )

یک صفحه یا عنصر صفحه را از ارائه حذف می کند.

object ( UpdatePageElementTransformRequest )

تبدیل یک عنصر صفحه را به روز می کند.

object ( UpdateSlidesPositionRequest )

موقعیت مجموعه ای از اسلایدها را در ارائه به روز می کند.

object ( DeleteTextRequest )

متن را از یک شکل یا سلول جدول حذف می کند.

object ( CreateImageRequest )

یک تصویر ایجاد می کند.

object ( CreateVideoRequest )

یک ویدیو ایجاد می کند.

object ( CreateSheetsChartRequest )

یک نمودار Google Sheets تعبیه شده ایجاد می کند.

object ( CreateLineRequest )

یک خط ایجاد می کند.

object ( RefreshSheetsChartRequest )

نمودار کاربرگ‌نگار Google را تازه می‌کند.

object ( UpdateShapePropertiesRequest )

ویژگی های یک Shape را به روز می کند.

object ( UpdateImagePropertiesRequest )

ویژگی های یک Image را به روز می کند.

object ( UpdateVideoPropertiesRequest )

ویژگی های یک Video را به روز می کند.

object ( UpdatePagePropertiesRequest )

ویژگی های یک Page را به روز می کند.

object ( UpdateTableCellPropertiesRequest )

ویژگی های TableCell را به روز می کند.

object ( UpdateLinePropertiesRequest )

ویژگی های یک Line را به روز می کند.

object ( CreateParagraphBulletsRequest )

برای پاراگراف ها گلوله ایجاد می کند.

object ( ReplaceAllShapesWithImageRequest )

همه اشکال مطابق با برخی معیارها را با یک تصویر جایگزین می کند.

object ( DuplicateObjectRequest )

یک اسلاید یا عنصر صفحه را کپی می کند.

object ( UpdateTextStyleRequest )

استایل متن را در یک Shape یا Table به روز می کند.

object ( ReplaceAllShapesWithSheetsChartRequest )

همه اشکال مطابق با برخی معیارها را با نمودار Google Sheets جایگزین می کند.

object ( DeleteParagraphBulletsRequest )

گلوله ها را از پاراگراف ها حذف می کند.

object ( UpdateParagraphStyleRequest )

سبک پاراگراف ها را در یک Shape یا Table به روز می کند.

object ( UpdateTableBorderPropertiesRequest )

ویژگی های حاشیه های جدول را در یک Table به روز می کند.

object ( UpdateTableColumnPropertiesRequest )

ویژگی های یک ستون Table را به روز می کند.

object ( UpdateTableRowPropertiesRequest )

ویژگی های یک ردیف Table را به روز می کند.

object ( MergeTableCellsRequest )

سلول ها را در یک Table ادغام می کند.

object ( UnmergeTableCellsRequest )

سلول ها را در یک Table از هم ادغام می کند.

object ( GroupObjectsRequest )

اشیاء مانند عناصر صفحه را گروه بندی می کند.

object ( UngroupObjectsRequest )

اشیاء، مانند groups را از حالت گروه بندی خارج می کند.

object ( UpdatePageElementAltTextRequest )

عنوان متن جایگزین و/یا توضیحات یک page element را به روز می کند.

object ( ReplaceImageRequest )

یک تصویر موجود را با یک تصویر جدید جایگزین می کند.

object ( UpdateSlidePropertiesRequest )

ویژگی های یک اسلاید را به روز می کند

object ( UpdatePageElementsZOrderRequest )

ترتیب Z page elements را به روز می کند.

object ( UpdateLineCategoryRequest )

دسته بندی یک line را به روز می کند.

object ( RerouteLineRequest )

یک line را به گونه‌ای تغییر می‌دهد که در دو نزدیک‌ترین محل اتصال در عناصر صفحه متصل به هم متصل شود.

{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}

string

شناسه شی ارائه شده توسط کاربر.

اگر یک شناسه مشخص کنید، باید در بین تمام صفحات و عناصر صفحه در ارائه منحصر به فرد باشد. شناسه باید با یک نویسه الفبای عددی یا یک زیرخط شروع شود (منطبق با regex [a-zA-Z0-9_] ). نویسه‌های باقی‌مانده ممکن است شامل آن‌ها و همچنین یک خط فاصله یا دو نقطه باشند (با regex [a-zA-Z0-9_-:] مطابقت دارد). طول شناسه باید بین 5 تا 50 کاراکتر باشد.

اگر یک شناسه مشخص نکنید، یک شناسه منحصر به فرد ایجاد می شود.

integer

ایندکس اختیاری مبتنی بر صفر که محل درج اسلایدها را نشان می دهد.

اگر شاخصی را مشخص نکنید، اسلاید در پایان ایجاد می شود.

object ( LayoutReference )

مرجع طرح بندی اسلایدی که قرار است درج شود، بر اساس استاد فعلی ، که یکی از موارد زیر است:

• استاد شاخص اسلاید قبلی.
• اگر InsertionIndex صفر باشد، مستر اسلاید اول.
• استاد اول در ارائه، در صورت عدم وجود اسلاید.

اگر LayoutReference در اصلی فعلی یافت نشد، یک خطای درخواست بد 400 برگردانده می شود.

اگر مرجع طرح بندی را مشخص نکنید، اسلاید از طرح بندی BLANK از پیش تعریف شده استفاده می کند.

object ( LayoutPlaceholderIdMapping )

یک لیست اختیاری از نگاشت شناسه شیء از placeholder (ها) در طرح به مکان‌هایی که در اسلاید از طرح‌بندی مشخص شده ایجاد می‌شوند. فقط زمانی قابل استفاده است که slideLayoutReference مشخص شده باشد.

{

  // Union field kind can be only one of the following:
  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
  // End of list of possible types for union field kind.
}

enum ( PredefinedLayout )

چیدمان از پیش تعریف شده

string

Layout ID: شناسه شی یکی از طرح‌بندی‌های موجود در ارائه.

{
  "objectId": string,

  // Union field kind can be only one of the following:
  "layoutPlaceholder": {
    object (Placeholder)
  },
  "layoutPlaceholderObjectId": string
  // End of list of possible types for union field kind.
}

string

شناسه شی ارائه شده توسط کاربر برای مکان نگهدار مشخص شده در بالا که باید روی یک اسلاید ایجاد شود.

اگر یک شناسه مشخص کنید، باید در بین تمام صفحات و عناصر صفحه در ارائه منحصر به فرد باشد. شناسه باید با یک نویسه الفبای عددی یا یک زیرخط شروع شود (منطبق با regex [a-zA-Z0-9_] ). نویسه‌های باقی‌مانده ممکن است شامل آن‌ها و همچنین یک خط فاصله یا دو نقطه باشند (با regex [a-zA-Z0-9_-:] مطابقت دارد). طول شناسه نباید کمتر از 5 یا بیشتر از 50 باشد.

اگر یک شناسه مشخص نکنید، یک شناسه منحصر به فرد ایجاد می شود.

object ( Placeholder )

مکان نگهدار در یک طرح بندی که روی یک اسلاید اعمال می شود. فقط type و index مورد نیاز است. به عنوان مثال، یک طرح بندی از پیش تعریف شده TITLE_AND_BODY معمولاً ممکن است دارای یک مکان نگهدار TITLE با شاخص 0 و یک مکان نگهدار BODY با شاخص 0 باشد.

string

شناسه شی مکان‌نما در یک طرح‌بندی که روی یک اسلاید اعمال می‌شود.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}

string

شناسه شی ارائه شده توسط کاربر.

اگر یک شناسه مشخص کنید، باید در بین تمام صفحات و عناصر صفحه در ارائه منحصر به فرد باشد. شناسه باید با یک نویسه الفبای عددی یا یک زیرخط شروع شود (منطبق با regex [a-zA-Z0-9_] ). نویسه‌های باقی‌مانده ممکن است شامل آن‌ها و همچنین یک خط فاصله یا دو نقطه باشند (با regex [a-zA-Z0-9_-:] مطابقت دارد). طول شناسه نباید کمتر از 5 یا بیشتر از 50 باشد. اگر خالی باشد، یک شناسه منحصر به فرد ایجاد می شود.

object ( PageElementProperties )

ویژگی های عنصر برای شکل

enum ( Type )

نوع شکل

{
  "pageObjectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  }
}

string

شناسه شی صفحه ای که عنصر در آن قرار دارد.

object ( Size )

اندازه عنصر.

object ( AffineTransform )

تبدیل برای عنصر.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}

string

شناسه شی ارائه شده توسط کاربر.

اگر یک شناسه مشخص کنید، باید در بین تمام صفحات و عناصر صفحه در ارائه منحصر به فرد باشد. شناسه باید با یک نویسه الفبای عددی یا یک زیرخط شروع شود (منطبق با regex [a-zA-Z0-9_] ). نویسه‌های باقی‌مانده ممکن است شامل آن‌ها و همچنین یک خط فاصله یا دو نقطه باشند (با regex [a-zA-Z0-9_-:] مطابقت دارد). طول شناسه نباید کمتر از 5 یا بیشتر از 50 باشد.

اگر یک شناسه مشخص نکنید، یک شناسه منحصر به فرد ایجاد می شود.

object ( PageElementProperties )

ویژگی های عنصر برای جدول.

جدول در اندازه ارائه شده با حداقل اندازه ایجاد می شود. اگر اندازه ای ارائه نشود، جدول به طور خودکار اندازه می شود.

تبدیل جدول باید دارای مقیاس 1 و بدون اجزای برشی باشد. اگر هیچ تبدیلی ارائه نشود، جدول در مرکز صفحه قرار می گیرد.

integer

تعداد ردیف های جدول

integer

تعداد ستون های جدول

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": integer
}

string

شناسه شی شکل یا جدولی که متن در آن درج خواهد شد.

object ( TableCellLocation )

مکان اختیاری سلول جدول در صورتی که متن در سلول جدول درج شود. در صورت وجود، objectId باید به یک جدول اشاره کند.

string

متنی که قرار است درج شود.

درج یک کاراکتر خط جدید به طور ضمنی یک ParagraphMarker جدید در آن شاخص ایجاد می کند. سبک پاراگراف پاراگراف جدید از پاراگراف در نمایه درج فعلی، شامل لیست ها و گلوله ها، کپی می شود.

سبک های متن برای متن درج شده به طور خودکار تعیین می شود و به طور کلی سبک متن همسایه را حفظ می کند. در بیشتر موارد، متن به TextRun که در نمایه درج وجود دارد اضافه می شود.

برخی از نویسه‌های کنترلی (U+0000-U+0008، U+000C-U+001F) و نویسه‌های منطقه استفاده خصوصی هواپیمای چند زبانه پایه یونیکد (U+E000-U+F8FF) از متن درج‌شده حذف می‌شوند.

integer

نمایه ای که متن در واحد کد یونیکد بر اساس شاخص های TextElement درج می شود.

شاخص مبتنی بر صفر است و از ابتدای رشته محاسبه می شود. ممکن است این شاخص برای جلوگیری از درج در خوشه‌های گرافم یونیکد تنظیم شود. در این موارد، متن بلافاصله بعد از خوشه گرافی درج می شود.

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}

string

جدول برای درج سطرها.

object ( TableCellLocation )

محل سلول جدول مرجع که سطرها از آن درج خواهند شد.

یک ردیف جدید در بالای (یا پایین) ردیفی که سلول مرجع در آن قرار دارد درج می شود. اگر سلول مرجع یک سلول ادغام شده باشد، یک ردیف جدید در بالا (یا زیر) سلول ادغام شده درج می شود.

boolean

آیا ردیف‌های جدید در زیر محل سلول مرجع درج شود یا خیر.

• True : در زیر سلول قرار دهید.
• False : در بالای سلول قرار دهید.

integer

تعداد ردیف هایی که باید درج شوند. حداکثر 20 در هر درخواست

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean,
  "number": integer
}

string

جدول برای درج ستون ها

object ( TableCellLocation )

محل سلول جدول مرجع که ستون ها از آن درج خواهند شد.

یک ستون جدید در سمت چپ (یا راست) ستونی که سلول مرجع در آن قرار دارد درج می شود. اگر سلول مرجع یک سلول ادغام شده باشد، یک ستون جدید در سمت چپ (یا راست) سلول ادغام شده درج می شود.

boolean

ستون‌های جدید در سمت راست محل سلول مرجع درج شود یا خیر.

• True : درج به سمت راست.
• False : درج به سمت چپ.

integer

تعداد ستون هایی که باید درج شوند. حداکثر 20 در هر درخواست

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}

string

جدول برای حذف سطرها.

object ( TableCellLocation )

مکان سلول جدول مرجع که یک ردیف از آن حذف خواهد شد.

ردیفی که این سلول در آن قرار دارد حذف خواهد شد. اگر این یک سلول ادغام شده باشد، چندین ردیف حذف می شود. اگر بعد از این حذف هیچ ردیفی در جدول باقی نماند، کل جدول حذف می شود.

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}

string

جدولی برای حذف ستون ها از.

object ( TableCellLocation )

محل سلول جدول مرجع که یک ستون از آن حذف خواهد شد.

ستونی که این سلول در آن قرار دارد حذف خواهد شد. اگر این یک سلول ادغام شده باشد، چندین ستون حذف خواهد شد. اگر پس از این حذف هیچ ستونی در جدول باقی نماند، کل جدول حذف می شود.

{
  "replaceText": string,
  "pageObjectIds": [
    string
  ],

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.
}

string

متنی که جایگزین متن منطبق می شود.

string

اگر خالی نباشد، موارد منطبق را به عناصر صفحه فقط در صفحات داده شده محدود می کند.

اگر به شناسه شی صفحه notes master داده شود، یا اگر صفحه ای با آن شناسه شی در ارائه وجود نداشته باشد، خطای درخواست بد 400 را برمی گرداند.

object ( SubstringMatchCriteria )

متن را به شکلی مطابق با این زیررشته پیدا می کند.

{
  "text": string,
  "matchCase": boolean
}

string

متنی که باید در شکل یا جدول جستجو کنید.

boolean

نشان می دهد که آیا جستجو باید به حروف مورد توجه باشد یا خیر:

• True : جستجو به حروف بزرگ و کوچک حساس است.
• False : جستجو به حروف بزرگ و کوچک حساس نیست.

{
  "objectId": string
}

string

شناسه شی صفحه یا عنصر صفحه برای حذف.

اگر پس از یک عملیات حذف، یک group فقط شامل 1 یا هیچ عنصر صفحه ای نباشد، گروه نیز حذف می شود.

اگر یک جای‌بانی در یک طرح‌بندی حذف شود، هر جای‌بانی توارثی خالی نیز حذف می‌شود.

{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}

string

شناسه شی عنصر صفحه برای به روز رسانی.

object ( AffineTransform )

ماتریس تبدیل ورودی که برای به روز رسانی عنصر صفحه استفاده می شود.

enum ( ApplyMode )

حالت اعمال به‌روزرسانی تبدیل.

{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}

string

شناسه اسلایدهای موجود در ارائه که باید منتقل شوند. اسلایدهای این لیست باید به ترتیب ارائه موجود، بدون تکرار باشند.

integer

شاخصی که در آن اسلایدها باید درج شوند، بر اساس آرایش اسلایدها قبل از انجام حرکت. باید بین صفر و تعداد اسلایدهای ارائه، شامل باشد.

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}

string

شناسه شی شکل یا جدولی که متن از آن حذف خواهد شد.

object ( TableCellLocation )

مکان اختیاری سلول جدول در صورتی که متن از سلول جدول حذف شود. در صورت وجود، objectId باید به یک جدول اشاره کند.

object ( Range )

محدوده متن برای حذف، بر اساس شاخص های TextElement .

همیشه یک کاراکتر خط جدید ضمنی در انتهای متن یک شکل یا سلول جدول وجود دارد که نمی توان آن را حذف کرد. Range.Type.ALL از کران‌های صحیح استفاده می‌کند، اما هنگام تعیین محدوده‌های صریح برای انواع محدوده FROM_START_INDEX و FIXED_RANGE باید دقت شود. به عنوان مثال، اگر متن "ABC" و به دنبال آن یک خط جدید ضمنی باشد، حداکثر مقدار برای textRange.start_index 2 و برای textRange.end_index 3 است.

حذف متنی که از مرز پاراگراف عبور می کند ممکن است منجر به تغییر در سبک ها و لیست های پاراگراف با ادغام دو پاراگراف شود.

محدوده هایی که فقط یک واحد کد از یک جفت جایگزین را شامل می شود تا هر دو واحد کد را شامل شود.

{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}

integer

شاخص اختیاری مبتنی بر صفر ابتدای مجموعه. برای محدوده‌های FIXED_RANGE و FROM_START_INDEX لازم است.

integer

شاخص اختیاری مبتنی بر صفر پایان مجموعه. برای محدوده‌های FIXED_RANGE لازم است.

enum ( Type )

نوع محدوده.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}

string

شناسه شی ارائه شده توسط کاربر.

اگر یک شناسه مشخص کنید، باید در بین تمام صفحات و عناصر صفحه در ارائه منحصر به فرد باشد. شناسه باید با یک نویسه الفبای عددی یا یک زیرخط شروع شود (منطبق با regex [a-zA-Z0-9_] ). نویسه‌های باقی‌مانده ممکن است شامل آن‌ها و همچنین یک خط فاصله یا دو نقطه باشند (با regex [a-zA-Z0-9_-:] مطابقت دارد). طول شناسه نباید کمتر از 5 یا بیشتر از 50 باشد.

اگر یک شناسه مشخص نکنید، یک شناسه منحصر به فرد ایجاد می شود.

object ( PageElementProperties )

ویژگی های عنصر برای تصویر

زمانی که نسبت ابعاد اندازه ارائه شده با نسبت تصویر مطابقت نداشته باشد، برای حفظ نسبت ابعاد، تصویر نسبت به اندازه کوچک شده و در مرکز قرار می گیرد. تبدیل ارائه شده پس از این عملیات اعمال می شود.

ویژگی PageElementProperties.size اختیاری است. اگر اندازه را مشخص نکنید، از اندازه پیش فرض تصویر استفاده می شود.

ویژگی PageElementProperties.transform اختیاری است. اگر تبدیلی را مشخص نکنید، تصویر در گوشه سمت چپ بالای صفحه قرار می گیرد.

string

آدرس تصویر.

تصویر یک بار در زمان درج واکشی می شود و یک کپی برای نمایش در داخل ارائه ذخیره می شود. اندازه تصاویر باید کمتر از 50 مگابایت باشد، نباید از 25 مگاپیکسل تجاوز کند و باید در یکی از فرمت‌های PNG، JPEG یا GIF باشد.

URL ارائه شده باید برای عموم قابل دسترسی باشد و حداکثر 2 کیلوبایت طول داشته باشد. URL همراه با تصویر ذخیره می شود و از طریق فیلد Image.source_url در معرض دید قرار می گیرد.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}

string

شناسه شی ارائه شده توسط کاربر.

اگر یک شناسه مشخص کنید، باید در بین تمام صفحات و عناصر صفحه در ارائه منحصر به فرد باشد. شناسه باید با یک نویسه الفبای عددی یا یک زیرخط شروع شود (منطبق با regex [a-zA-Z0-9_] ). نویسه‌های باقی‌مانده ممکن است شامل آن‌ها و همچنین یک خط فاصله یا دو نقطه باشند (با regex [a-zA-Z0-9_-:] مطابقت دارد). طول شناسه نباید کمتر از 5 یا بیشتر از 50 باشد.

اگر یک شناسه مشخص نکنید، یک شناسه منحصر به فرد ایجاد می شود.

object ( PageElementProperties )

ویژگی های عنصر برای ویدیو.

ویژگی PageElementProperties.size اختیاری است. اگر اندازه ای را مشخص نکنید، یک اندازه پیش فرض توسط سرور انتخاب می شود.

ویژگی PageElementProperties.transform اختیاری است. تبدیل نباید دارای اجزای برشی باشد. اگر تبدیلی را مشخص نکنید، ویدیو در گوشه سمت چپ بالای صفحه قرار می گیرد.

enum ( Source )

منبع ویدیو

string

شناسه منحصر به فرد منبع ویدیو برای این ویدیو.

به عنوان مثال برای ویدیوی YouTube https://www.youtube.com/watch?v=7U3axjORYZ0 ، شناسه 7U3axjORYZ0 است. برای یک ویدیوی Google Drive https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q شناسه 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q است.

برای دسترسی به فایل ویدیویی Google Drive، ممکن است لازم باشد برای زیرمجموعه‌ای از فایل‌های قدیمی، یک کلید منبع به سربرگ HTTP اضافه کنید. برای اطلاعات بیشتر، دسترسی به فایل‌های به اشتراک گذاشته شده پیوند با استفاده از کلیدهای منبع را ببینید.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}

string

شناسه شی ارائه شده توسط کاربر.

اگر مشخص شده باشد، شناسه باید در بین تمام صفحات و عناصر صفحه در ارائه منحصر به فرد باشد. شناسه باید با یک کاراکتر کلمه [a-zA-Z0-9_] شروع شود و سپس با هر تعداد از نویسه های زیر [a-zA-Z0-9_-:] دنبال شود. طول شناسه نباید کمتر از 5 یا بیشتر از 50 باشد. اگر خالی باشد، یک شناسه منحصر به فرد ایجاد می شود.

object ( PageElementProperties )

ویژگی های عنصر برای نمودار.

زمانی که نسبت ابعاد اندازه ارائه شده با نسبت ابعاد نمودار مطابقت نداشته باشد، نمودار با توجه به اندازه مقیاس بندی شده و در مرکز قرار می گیرد تا نسبت تصویر حفظ شود. تبدیل ارائه شده پس از این عملیات اعمال می شود.

string

شناسه صفحه‌گسترده Google Sheets که حاوی نمودار است.

ممکن است لازم باشد برای زیرمجموعه ای از فایل های قدیمی، یک کلید منبع به سربرگ HTTP اضافه کنید. برای اطلاعات بیشتر، دسترسی به فایل‌های به اشتراک گذاشته شده پیوند با استفاده از کلیدهای منبع را ببینید.

integer

شناسه نمودار خاص در صفحه گسترده Google Sheets.

enum ( LinkingMode )

حالتی که با آن نمودار به صفحه گسترده منبع پیوند داده می شود. هنگامی که مشخص نیست، نمودار تصویری خواهد بود که پیوند داده نشده است.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}

string

شناسه شی ارائه شده توسط کاربر.

اگر یک شناسه مشخص کنید، باید در بین تمام صفحات و عناصر صفحه در ارائه منحصر به فرد باشد. شناسه باید با یک نویسه الفبای عددی یا یک زیرخط شروع شود (منطبق با regex [a-zA-Z0-9_] ). نویسه‌های باقی‌مانده ممکن است شامل آن‌ها و همچنین یک خط فاصله یا دو نقطه باشند (با regex [a-zA-Z0-9_-:] مطابقت دارد). طول شناسه نباید کمتر از 5 یا بیشتر از 50 باشد.

اگر یک شناسه مشخص نکنید، یک شناسه منحصر به فرد ایجاد می شود.

object ( PageElementProperties )

ویژگی های عنصر برای خط.

enum ( Category )

دسته بندی خطی که باید ایجاد شود.

منسوخ شده : به جای آن از category استفاده کنید.

line type ایجاد شده بر اساس دسته بندی و نحوه مسیریابی آن برای اتصال به سایر عناصر صفحه تعیین می شود.

اگر هم یک category و هم lineCategory را مشخص کنید، category اولویت دارد.

enum ( LineCategory )

دسته بندی خطی که باید ایجاد شود.

line type ایجاد شده بر اساس دسته بندی و نحوه مسیریابی آن برای اتصال به سایر عناصر صفحه تعیین می شود.

اگر هم یک category و هم lineCategory را مشخص کنید، category اولویت دارد.

اگر مقداری برای category مشخص نکنید، اما مقداری را برای lineCategory مشخص کنید، از مقدار lineCategory مشخص شده استفاده می شود.

اگر هیچ کدام را مشخص نکنید، STRAIGHT استفاده می شود.

{
  "objectId": string
}

string

شناسه شی نمودار برای بازخوانی.

{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}

string

شناسه شی شکلی که به‌روزرسانی‌ها روی آن اعمال می‌شوند.

object ( ShapeProperties )

ویژگی های شکل برای به روز رسانی.

string ( FieldMask format)

فیلدهایی که باید به روز شوند.

حداقل یک فیلد باید مشخص شود. ریشه shapeProperties به صورت ضمنی است و نباید مشخص شود. برای فهرست کردن هر فیلد می توان از یک "*" به عنوان علامت کوتاه استفاده کرد.

به عنوان مثال برای به‌روزرسانی رنگ پس‌زمینه شکل، fields روی "shapeBackgroundFill.solidFill.color" تنظیم کنید.

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

{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}

string

شناسه شی تصویری که به‌روزرسانی‌ها روی آن اعمال می‌شوند.

object ( ImageProperties )

ویژگی های تصویر برای به روز رسانی

string ( FieldMask format)

فیلدهایی که باید به روز شوند.

حداقل یک فیلد باید مشخص شود. ریشه imageProperties به صورت ضمنی است و نباید مشخص شود. برای فهرست کردن هر فیلد می توان از یک "*" به عنوان علامت کوتاه استفاده کرد.

برای مثال برای به‌روزرسانی رنگ طرح کلی تصویر، fields روی "outline.outlineFill.solidFill.color" تنظیم کنید.

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

{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}

string

شناسه شی ویدیویی که به‌روزرسانی‌ها روی آن اعمال می‌شوند.

object ( VideoProperties )

ویژگی های ویدئویی برای به روز رسانی

string ( FieldMask format)

فیلدهایی که باید به روز شوند.

حداقل یک فیلد باید مشخص شود. ریشه videoProperties به صورت ضمنی است و نباید مشخص شود. برای فهرست کردن هر فیلد می توان از یک "*" به عنوان علامت کوتاه استفاده کرد.

برای مثال برای به‌روزرسانی رنگ طرح کلی ویدیو، fields روی "outline.outlineFill.solidFill.color" تنظیم کنید.

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

{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}

string

شناسه شی صفحه ای که به روز رسانی روی آن اعمال می شود.

object ( PageProperties )

ویژگی های صفحه برای به روز رسانی

string ( FieldMask format)

فیلدهایی که باید به روز شوند.

حداقل یک فیلد باید مشخص شود. ریشه pageProperties به صورت ضمنی است و نباید مشخص شود. برای فهرست کردن هر فیلد می توان از یک "*" به عنوان علامت کوتاه استفاده کرد.

برای مثال برای به‌روزرسانی رنگ پرشده پس‌زمینه صفحه، fields روی "pageBackgroundFill.solidFill.color" تنظیم کنید.

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

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}

string

شناسه شی جدول.

object ( TableRange )

محدوده جدول نشان دهنده زیرمجموعه جدولی است که به روز رسانی ها روی آن اعمال می شود. اگر محدوده جدول مشخص نشده باشد، به روز رسانی ها برای کل جدول اعمال می شود.

object ( TableCellProperties )

ویژگی های سلول جدول برای به روز رسانی.

string ( FieldMask format)

فیلدهایی که باید به روز شوند.

حداقل یک فیلد باید مشخص شود. جدول tableCellProperties به صورت ضمنی است و نباید مشخص شود. برای فهرست کردن هر فیلد می توان از یک "*" به عنوان علامت کوتاه استفاده کرد.

برای مثال برای به‌روزرسانی رنگ پر جامد پس‌زمینه سلول جدول، fields روی "tableCellBackgroundFill.solidFill.color" تنظیم کنید.

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

{
  "location": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}

object ( TableCellLocation )

محل شروع محدوده جدول.

integer

عرض ردیف محدوده جدول.

integer

عرض ستون محدوده جدول.

{
  "objectId": string,
  "lineProperties": {
    object (LineProperties)
  },
  "fields": string
}

string

شناسه شی خطی که به‌روزرسانی روی آن اعمال می‌شود.

object ( LineProperties )

ویژگی های خط برای به روز رسانی.

string ( FieldMask format)

فیلدهایی که باید به روز شوند.

حداقل یک فیلد باید مشخص شود. root lineProperties به صورت ضمنی است و نباید مشخص شود. برای فهرست کردن هر فیلد می توان از یک "*" به عنوان علامت کوتاه استفاده کرد.

به عنوان مثال، برای به‌روزرسانی رنگ پر جامد خط، fields روی "lineFill.solidFill.color" تنظیم کنید.

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

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}

string

شناسه شی شکل یا جدول حاوی متن برای افزودن گلوله به آن.

object ( TableCellLocation )

مکان اختیاری سلول جدول اگر متنی که باید اصلاح شود در یک سلول جدول است. در صورت وجود، objectId باید به یک جدول اشاره کند.

object ( Range )

محدوده متنی که باید پیش تنظیم های گلوله را بر اساس شاخص های TextElement اعمال کرد.

enum ( BulletGlyphPreset )

انواع گلیف گلوله مورد استفاده. پیش‌فرض BULLET_DISC_CIRCLE_SQUARE از پیش تنظیم شده است.

{
  "replaceMethod": enum (ReplaceMethod),
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "pageObjectIds": [
    string
  ],

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.

  // Union field image_source can be only one of the following:
  "imageUrl": string
  // End of list of possible types for union field image_source.
}

enum ( ReplaceMethod )

روش جایگزینی

منسوخ شده : به جای آن از imageReplaceMethod استفاده کنید.

اگر هم یک replaceMethod و هم یک imageReplaceMethod را مشخص کنید، imageReplaceMethod اولویت دارد.

enum ( ImageReplaceMethod )

روش جایگزینی تصویر

اگر هم یک replaceMethod و هم یک imageReplaceMethod را مشخص کنید، imageReplaceMethod اولویت دارد.

اگر مقداری برای imageReplaceMethod مشخص نکنید، اما مقداری را برای replaceMethod مشخص کنید، آنگاه از مقدار replaceMethod مشخص شده استفاده می شود.

اگر هیچ کدام را مشخص نکنید، از CENTER_INSIDE استفاده می شود.

string

اگر خالی نباشد، موارد منطبق را به عناصر صفحه فقط در صفحات داده شده محدود می کند.

اگر شناسه شی صفحه یک notes page یا یک notes master داده شود، یا اگر صفحه ای با آن شناسه شی در ارائه وجود نداشته باشد، یک خطای درخواست بد 400 را برمی گرداند.

object ( SubstringMatchCriteria )

اگر تنظیم شود، این درخواست جایگزین تمام اشکالی می شود که حاوی متن داده شده هستند.

string

آدرس تصویر.

تصویر یک بار در زمان درج واکشی می شود و یک کپی برای نمایش در داخل ارائه ذخیره می شود. اندازه تصاویر باید کمتر از 50 مگابایت باشد، نباید بیش از 25 مگاپیکسل باشد و باید در یکی از فرمت‌های PNG، JPEG یا GIF باشند.

URL ارائه شده حداکثر می تواند 2 کیلوبایت طول داشته باشد. خود URL همراه با تصویر ذخیره می شود و از طریق فیلد Image.source_url در معرض دید قرار می گیرد.

{
  "objectId": string,
  "objectIds": {
    string: string,
    ...
  }
}

string

شناسه شی که باید تکرار شود.

map (key: string, value: string)

شیء که در آن کپی شده است ممکن است شامل اشیاء دیگری باشد ، به عنوان مثال هنگام کپی کردن اسلاید یا یک عنصر صفحه گروه. این نقشه نحوه تولید شناسه اشیاء تکراری را مشخص می کند: کلیدها شناسه اشیاء اصلی هستند و مقادیر آن شناسه هایی هستند که به شیء تکراری مربوطه اختصاص می یابد. شناسه کپی شیء منبع ممکن است در این نقشه نیز مشخص شود ، با استفاده از همان مقدار قسمت objectId به عنوان یک کلید و شناسه تازه مورد نظر به عنوان مقدار.

تمام کلیدها باید در ارائه با شناسه های موجود مطابقت داشته باشند. تمام مقادیر باید در ارائه منحصر به فرد باشند و باید با یک شخصیت الفبایی یا یک زیربنایی شروع کنند (با Regex [a-zA-Z0-9_] مطابقت دارد). شخصیت های باقیمانده ممکن است شامل مواردی و همچنین یک Hyphen یا Colon (با Regex [a-zA-Z0-9_-:] )). طول شناسه جدید نباید کمتر از 5 یا بیشتر از 50 باشد.

اگر شناسه اشیاء منبع از نقشه حذف شود ، شناسه تصادفی جدید اختصاص می یابد. اگر نقشه خالی یا غیرقانونی باشد ، تمام اشیاء تکراری یک شناسه تصادفی جدید دریافت می کنند.

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}

string

شناسه شیء شکل یا جدول با متن برای طراحی.

object ( TableCellLocation )

محل سلول در جدول حاوی متن به سبک. اگر objectId به یک جدول اشاره کند ، cellLocation باید دارای یک مقدار باشد. در غیر این صورت ، نباید.

object ( TextStyle )

سبک (های) برای تنظیم متن.

اگر ارزش یک سبک خاص با والدین مطابقت داشته باشد ، آن سبک به ارث می رسد.

برخی از تغییرات سبک متن ممکن است باعث ایجاد تغییرات دیگر به معنای آینه کاری ویرایشگر اسلایدها شود. برای اطلاعات بیشتر به مستندات TextStyle مراجعه کنید.

object ( Range )

دامنه متن به سبک.

دامنه ممکن است گسترش یابد تا شامل خطوط جدید مجاور شود.

اگر دامنه کاملاً حاوی پاراگراف متعلق به یک لیست باشد ، گلوله پاراگراف نیز با سبک متن متناسب به روز می شود.

string ( FieldMask format)

زمینه هایی که باید به روز شوند.

حداقل یک قسمت باید مشخص شود. style ریشه دلالت دارد و نباید مشخص شود. یک "*" واحد می تواند به عنوان دست کوتاه برای لیست هر قسمت استفاده شود.

به عنوان مثال ، برای به روزرسانی سبک متن به جسورانه ، fields را روی "bold" تنظیم کنید.

برای تنظیم مجدد یک ویژگی به مقدار پیش فرض خود ، نام فیلد آن را در ماسک فیلد قرار دهید اما خود را به خود اختصاص دهید.

{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}

object ( SubstringMatchCriteria )

معیارهایی که شکل ها باید با آن مطابقت داشته باشند. درخواست جایگزین تمام اشکال حاوی متن داده شده خواهد شد.

string

شناسه صفحه گسترده برگه Google که شامل نمودار است.

integer

شناسه نمودار خاص در صفحه گسترده برگه Google.

enum ( LinkingMode )

روشی که نمودار با آن به صفحه گسترده منبع مرتبط است. هنگامی که مشخص نشده است ، نمودار تصویری خواهد بود که به هم پیوند ندارد.

string

اگر غیر خالی باشد ، مسابقات را فقط در صفحات داده شده به عناصر صفحه محدود می کند.

اگر به صفحه شناسه صفحه یک notes page یا یک notes master داده شود ، خطای درخواست بد را برمی گرداند ، یا اگر صفحه ای با آن شیء در ارائه وجود ندارد.

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}

string

شناسه شیء شکل یا جدول حاوی متن برای حذف گلوله ها از.

object ( TableCellLocation )

مکان سلول جدول اختیاری اگر متن اصلاح شده در یک سلول جدول باشد. در صورت وجود ، ObjectID باید به یک جدول مراجعه کند.

object ( Range )

دامنه متن برای حذف گلوله ها ، بر اساس شاخص های TextElement .

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}

string

شناسه شیء شکل یا جدول با متن برای طراحی.

object ( TableCellLocation )

محل سلول در جدول حاوی پاراگراف (های) به سبک. اگر objectId به یک جدول اشاره کند ، cellLocation باید دارای یک مقدار باشد. در غیر این صورت ، نباید.

object ( ParagraphStyle )

سبک پاراگراف.

object ( Range )

دامنه متن حاوی پاراگراف (ها) به سبک.

string ( FieldMask format)

زمینه هایی که باید به روز شوند.

حداقل یک قسمت باید مشخص شود. style ریشه دلالت دارد و نباید مشخص شود. یک "*" واحد می تواند به عنوان دست کوتاه برای لیست هر قسمت استفاده شود.

به عنوان مثال ، برای به روزرسانی تراز پاراگراف ، fields به "alignment" تنظیم کنید.

برای تنظیم مجدد یک ویژگی به مقدار پیش فرض خود ، نام فیلد آن را در ماسک فیلد قرار دهید اما خود را به خود اختصاص دهید.

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}

string

شناسه شیء جدول.

object ( TableRange )

محدوده جدول نمایانگر زیر مجموعه جدول که به روزرسانی ها در آن اعمال می شود. اگر محدوده جدول مشخص نشده باشد ، به روزرسانی ها در کل جدول اعمال می شود.

enum ( BorderPosition )

موقعیت مرزی در جدول جدول به روزرسانی ها باید اعمال شود. اگر موقعیت مرزی مشخص نشده باشد ، به روزرسانی ها در تمام مرزهای موجود در محدوده جدول اعمال می شود.

object ( TableBorderProperties )

ویژگی های مرزی جدول برای به روزرسانی.

string ( FieldMask format)

زمینه هایی که باید به روز شوند.

حداقل یک قسمت باید مشخص شود. tableBorderProperties ریشه ای دلالت دارد و نباید مشخص شود. یک "*" واحد می تواند به عنوان دست کوتاه برای لیست هر قسمت استفاده شود.

به عنوان مثال برای به روزرسانی رنگ پرنده جامد میز ، fields را روی "tableBorderFill.solidFill.color" تنظیم کنید.

برای تنظیم مجدد یک ویژگی به مقدار پیش فرض خود ، نام فیلد آن را در ماسک فیلد قرار دهید اما خود را به خود اختصاص دهید.

{
  "objectId": string,
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}

string

شناسه شیء جدول.

integer

لیست شاخص های مبتنی بر صفر مشخص می کند که کدام ستون ها برای به روزرسانی. در صورت عدم ارائه شاخص ، تمام ستون های جدول به روز می شوند.

object ( TableColumnProperties )

ویژگی های ستون جدول برای به روزرسانی.

اگر مقدار tableColumnProperties#columnWidth در درخواست کمتر از 406،400 EMU (32 امتیاز) باشد ، یک خطای درخواست بد 400 بازگردانده می شود.

string ( FieldMask format)

زمینه هایی که باید به روز شوند.

حداقل یک قسمت باید مشخص شود. tableColumnProperties ریشه دلالت دارد و نباید مشخص شود. یک "*" واحد می تواند به عنوان دست کوتاه برای لیست هر قسمت استفاده شود.

به عنوان مثال برای به روزرسانی عرض ستون ، fields روی "columnWidth" تنظیم کنید.

اگر "" ستون پهنه "در ماسک فیلد گنجانده شده باشد اما این خاصیت از بین رفته است ، عرض ستون به 406.400 EMU (32 امتیاز) پیش فرض خواهد شد.

{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}

string

شناسه شیء جدول.

integer

لیست شاخص های مبتنی بر صفر مشخص می کند که ردیف ها برای به روزرسانی. در صورت عدم ارائه شاخص ، تمام ردیف های جدول به روز می شوند.

object ( TableRowProperties )

ویژگی های Table Row برای به روزرسانی.

string ( FieldMask format)

زمینه هایی که باید به روز شوند.

حداقل یک قسمت باید مشخص شود. tableRowProperties ریشه ای دلالت دارد و نباید مشخص شود. یک "*" واحد می تواند به عنوان دست کوتاه برای لیست هر قسمت استفاده شود.

به عنوان مثال برای به روزرسانی حداقل ارتفاع ردیف ، fields را روی "minRowHeight" تنظیم کنید.

اگر "" minrowheight "در ماسک میدانی گنجانده شده باشد اما این ویژگی غیرقانونی باقی مانده است ، حداقل ارتفاع ردیف به طور پیش فرض 0 خواهد بود.

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}

string

شناسه شیء جدول.

object ( TableRange )

محدوده جدول مشخص می کند که سلولهای جدول برای ادغام.

هر متنی در سلولهای ادغام شده در سلول سمت چپ چپ ("سر") دامنه جمع آوری و ذخیره می شود. اگر دامنه غیر مستطیل باشد (که می تواند در بعضی موارد رخ دهد که دامنه سلولهایی را که قبلاً ادغام شده اند را پوشش می دهد) ، یک خطای درخواست بد 400 بازگردانده می شود.

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}

string

شناسه شیء جدول.

object ( TableRange )

محدوده جدول مشخص می کند که سلولهای جدول برای جدا کردن.

تمام سلولهای ادغام شده در این محدوده از بین نمی روند و سلولهایی که از قبل بدون استفاده نیستند ، تحت تأثیر قرار نمی گیرند. اگر دامنه سلولهای ادغام نشده ای نداشته باشد ، درخواست هیچ کاری نمی کند. اگر در هر یک از سلولهای ادغام شده متنی وجود داشته باشد ، متن در سلول سمت چپ ("سر") بلوک حاصل از سلولهای غیرمجاز باقی می ماند.

{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}

string

یک شناسه شیء با کاربر برای ایجاد این گروه.

اگر شناسه را مشخص کنید ، باید در بین همه صفحات و عناصر صفحه در ارائه منحصر به فرد باشد. شناسه باید با یک شخصیت الفبایی یا یک زیربنایی شروع شود (مطابقت با regex [a-zA-Z0-9_] ) ؛ شخصیت های باقیمانده ممکن است شامل مواردی و همچنین یک Hyphen یا Colon (با Regex [a-zA-Z0-9_-:] )). طول شناسه نباید کمتر از 5 یا بیشتر از 50 باشد.

اگر شناسه را مشخص نکنید ، یک مورد منحصر به فرد تولید می شود.

string

شناسه شیء اشیاء به گروه.

فقط عناصر صفحه می توانند گروه بندی شوند. حداقل باید دو عنصر صفحه در همان صفحه وجود داشته باشد که در حال حاضر در گروه دیگری نیستند. برخی از عناصر صفحه مانند videos ، tables و placeholders نمی توانند گروه بندی شوند.

{
  "objectIds": [
    string
  ]
}

string

شناسه های شیء اشیاء به UNGROUP.

فقط groups که در داخل groups دیگر نیستند ، می توانند بدون گروه باشند. همه گروه ها باید در همان صفحه باشند. خود گروه حذف شده است. اندازه و موقعیت های بصری همه کودکان حفظ می شود.

{
  "objectId": string,
  "title": string,
  "description": string
}

string

شناسه شیء عنصر صفحه ای که به روزرسانی ها اعمال می شود.

string

عنوان متن ALT به روز شده از عنصر صفحه. در صورت عدم استفاده از مقدار موجود حفظ می شود. این عنوان در معرض خوانندگان صفحه نمایش و سایر رابط های دسترسی است. فقط از مقادیر قابل خواندن انسان مربوط به محتوای عنصر صفحه استفاده کنید.

string

توضیحات متن ALT به روز شده از عنصر صفحه. در صورت عدم استفاده از مقدار موجود حفظ می شود. توضیحات در معرض خوانندگان صفحه نمایش و سایر رابط های دسترسی است. فقط از مقادیر قابل خواندن انسان مربوط به محتوای عنصر صفحه استفاده کنید.

{
  "imageObjectId": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}

string

شناسه تصویر موجود که جایگزین خواهد شد. شناسه را می توان از پاسخ درخواست دریافت بازیابی کرد.

enum ( ImageReplaceMethod )

روش جایگزینی

string

URL تصویر

تصویر یک بار در زمان درج گرفته می شود و یک نسخه برای نمایش در داخل ارائه ذخیره می شود. تصاویر باید کمتر از 50 مگابایت باشند ، نمی توانند از 25 مگاپیکسل تجاوز کنند و باید در قالب PNG ، JPEG یا GIF باشد.

URL ارائه شده نمی تواند از 2 کیلوبایت طول بکشد. URL با تصویر ذخیره می شود و از طریق Image.source_url قرار می گیرد.

{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}

string

شناسه شیء اسلاید بروزرسانی به آن اعمال می شود.

object ( SlideProperties )

خصوصیات اسلاید برای به روزرسانی.

string ( FieldMask format)

زمینه هایی که باید به روز شوند.

حداقل یک قسمت باید مشخص شود. ریشه "اسلایدپروپری ها" دلالت دارد و نباید مشخص شود. یک "*" واحد می تواند به عنوان دست کوتاه برای لیست هر قسمت استفاده شود.

به عنوان مثال برای به روزرسانی اینکه آیا یک اسلاید از بین رفته است ، fields برای "isSkipped" تنظیم کنید.

برای تنظیم مجدد یک ویژگی به مقدار پیش فرض خود ، نام فیلد آن را در ماسک فیلد قرار دهید اما خود را به خود اختصاص دهید.

{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}

string

شناسه های شیء عناصر صفحه برای به روزرسانی.

تمام عناصر صفحه باید در همان صفحه باشند و نباید گروه بندی شوند.

enum ( ZOrderOperation )

عملیات z-ore برای اعمال در عناصر صفحه.

هنگام استفاده از عملیات در عناصر چند صفحه ، سفارشات Z نسبی در این عناصر صفحه قبل از حفظ عمل.

{
  "objectId": string,
  "lineCategory": enum (LineCategory)
}

string

شناسه شیء خط بروزرسانی برای آن اعمال می شود.

فقط یک خط با یک category که نشان می دهد "اتصال دهنده" است می تواند به روز شود.

این خط ممکن است پس از به روزرسانی گروه خود ، دوباره مورد استفاده قرار گیرد.

enum ( LineCategory )

دسته خط برای به روزرسانی.

line type دقیق بر اساس دسته بندی برای به روزرسانی و نحوه اتصال آن برای اتصال به عناصر صفحه دیگر تعیین می شود.

{
  "objectId": string
}

string

شناسه شیء خط برای استفاده مجدد.

فقط یک خط با یک category که نشان می دهد "اتصال دهنده" است قابل تغییر است. اتصالات شروع و پایان خط باید در عناصر مختلف صفحه باشد.