Requests

درخواست کنید

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

نمایندگی JSON
{

  // 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.
}
فیلدها
kind میدان اتحادیه . نوع به روز رسانی. دقیقا یک فیلد لازم است. kind می تواند تنها یکی از موارد زیر باشد:
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 )

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

createLine

object ( CreateLineRequest )

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

refreshSheetsChart

object ( RefreshSheetsChartRequest )

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

updateShapeProperties

object ( UpdateShapePropertiesRequest )

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

updateImageProperties

object ( UpdateImagePropertiesRequest )

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

updateVideoProperties

object ( UpdateVideoPropertiesRequest )

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

updatePageProperties

object ( UpdatePagePropertiesRequest )

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

updateTableCellProperties

object ( UpdateTableCellPropertiesRequest )

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

updateLineProperties

object ( UpdateLinePropertiesRequest )

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

createParagraphBullets

object ( CreateParagraphBulletsRequest )

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

replaceAllShapesWithImage

object ( ReplaceAllShapesWithImageRequest )

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

duplicateObject

object ( DuplicateObjectRequest )

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

updateTextStyle

object ( UpdateTextStyleRequest )

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

replaceAllShapesWithSheetsChart

object ( ReplaceAllShapesWithSheetsChartRequest )

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

deleteParagraphBullets

object ( DeleteParagraphBulletsRequest )

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

updateParagraphStyle

object ( UpdateParagraphStyleRequest )

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

updateTableBorderProperties

object ( UpdateTableBorderPropertiesRequest )

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

updateTableColumnProperties

object ( UpdateTableColumnPropertiesRequest )

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

updateTableRowProperties

object ( UpdateTableRowPropertiesRequest )

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

mergeTableCells

object ( MergeTableCellsRequest )

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

unmergeTableCells

object ( UnmergeTableCellsRequest )

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

groupObjects

object ( GroupObjectsRequest )

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

ungroupObjects

object ( UngroupObjectsRequest )

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

updatePageElementAltText

object ( UpdatePageElementAltTextRequest )

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

replaceImage

object ( ReplaceImageRequest )

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

updateSlideProperties

object ( UpdateSlidePropertiesRequest )

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

updatePageElementsZOrder

object ( UpdatePageElementsZOrderRequest )

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

updateLineCategory

object ( UpdateLineCategoryRequest )

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

rerouteLine

object ( RerouteLineRequest )

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

CreateSlideRequest

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

نمایندگی JSON
{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}
فیلدها
objectId

string

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

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

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

insertionIndex

integer

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

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

slideLayoutReference

object ( LayoutReference )

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

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

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

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

placeholderIdMappings[]

object ( LayoutPlaceholderIdMapping )

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

LayoutReference

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

  • یک طرح از پیش تعریف شده
  • یکی از طرح‌بندی‌های موجود در ارائه.
نمایندگی JSON
{

  // 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.
}
فیلدها
kind میدان اتحادیه . نوع LayoutReference. kind می تواند تنها یکی از موارد زیر باشد:
predefinedLayout

enum ( PredefinedLayout )

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

layoutId

string

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

از پیش تعریف شده Layout

انواع چیدمان از پیش تعریف شده اینها معمولاً طرح‌بندی‌هایی در ارائه‌ها یافت می‌شوند. با این حال، هیچ تضمینی وجود ندارد که این طرح‌بندی‌ها در اصلی فعلی وجود داشته باشند، زیرا می‌توانستند حذف شده باشند یا بخشی از موضوع مورد استفاده نباشند. علاوه بر این، جای‌بان‌های هر طرح‌بندی ممکن است تغییر کرده باشند.

Enums
PREDEFINED_LAYOUT_UNSPECIFIED چیدمان نامشخص
BLANK طرح‌بندی خالی، بدون مکان‌گردان.
CAPTION_ONLY چیدمان با عنوان در پایین.
TITLE چیدمان با عنوان و زیرنویس.
TITLE_AND_BODY چیدمان با عنوان و بدنه.
TITLE_AND_TWO_COLUMNS طرح بندی با عنوان و دو ستون.
TITLE_ONLY طرح بندی فقط با عنوان.
SECTION_HEADER طرح بندی با عنوان بخش.
SECTION_TITLE_AND_DESCRIPTION طرح بندی با عنوان و زیرنویس در یک طرف و توضیحات در طرف دیگر.
ONE_COLUMN_TEXT طرح بندی با یک عنوان و یک بدنه، مرتب شده در یک ستون.
MAIN_POINT چیدمان با یک نکته اصلی.
BIG_NUMBER چیدمان با عنوان شماره بزرگ.

LayoutPlaceholderIdMapping

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

نمایندگی JSON
{
  "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.
}
فیلدها
objectId

string

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

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

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

kind میدان اتحادیه . نوعی برای شناسایی یک مکان نگهدار در یک طرح. kind می تواند تنها یکی از موارد زیر باشد:
layoutPlaceholder

object ( Placeholder )

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

layoutPlaceholderObjectId

string

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

CreateShapeRequest

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

نمایندگی JSON
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}
فیلدها
objectId

string

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

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

elementProperties

object ( PageElementProperties )

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

shapeType

enum ( Type )

نوع شکل

PageElement Properties

ویژگی های رایج برای یک عنصر صفحه

توجه: هنگامی که در ابتدا یک PageElement ایجاد می کنید، API ممکن است مقادیر size و transform را تغییر دهد، اما اندازه بصری بدون تغییر خواهد بود.

نمایندگی JSON
{
  "pageObjectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  }
}
فیلدها
pageObjectId

string

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

size

object ( Size )

اندازه عنصر.

transform

object ( AffineTransform )

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

CreateTableRequest

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

نمایندگی JSON
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}
فیلدها
objectId

string

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

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

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

elementProperties

object ( PageElementProperties )

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

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

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

rows

integer

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

columns

integer

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

InsertTextRequest

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

نمایندگی JSON
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": integer
}
فیلدها
objectId

string

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

cellLocation

object ( TableCellLocation )

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

text

string

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

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

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

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

insertionIndex

integer

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

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

InsertTableRowsRequest

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

نمایندگی JSON
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}
فیلدها
tableObjectId

string

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

cellLocation

object ( TableCellLocation )

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

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

insertBelow

boolean

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

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

integer

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

InsertTableColumnsRequest

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

سایر ستون‌های جدول برای تناسب با ستون جدید تغییر اندازه می‌دهند.

نمایندگی JSON
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean,
  "number": integer
}
فیلدها
tableObjectId

string

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

cellLocation

object ( TableCellLocation )

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

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

insertRight

boolean

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

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

integer

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

حذف TableRowRequest

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

نمایندگی JSON
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
فیلدها
tableObjectId

string

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

cellLocation

object ( TableCellLocation )

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

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

DeleteTableColumnRequest

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

نمایندگی JSON
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
فیلدها
tableObjectId

string

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

cellLocation

object ( TableCellLocation )

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

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

ReplaceAllTextRequest

همه نمونه های متنی را که با یک معیار مطابقت دارند با replace text جایگزین می کند.

نمایندگی JSON
{
  "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.
}
فیلدها
replaceText

string

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

pageObjectIds[]

string

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

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

criteria میدان اتحادیه معیارهای مورد استفاده برای مطابقت متن برای جایگزینی. criteria فقط می توانند یکی از موارد زیر باشند:
containsText

object ( SubstringMatchCriteria )

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

معیارهای SubstringMatch

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

نمایندگی JSON
{
  "text": string,
  "matchCase": boolean
}
فیلدها
text

string

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

matchCase

boolean

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

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

DeleteObjectRequest

یک شی، pages یا page elements را از ارائه حذف می کند.

نمایندگی JSON
{
  "objectId": string
}
فیلدها
objectId

string

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

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

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

UpdatePageElementTransformRequest

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

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

نمایندگی JSON
{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}
فیلدها
objectId

string

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

transform

object ( AffineTransform )

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

applyMode

enum ( ApplyMode )

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

ApplyMode

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

Enums
APPLY_MODE_UNSPECIFIED حالت نامشخص
RELATIVE ماتریس جدید AffineTransform را به ماتریس موجود اعمال می کند و الحاق حاصل را جایگزین ماتریس موجود می کند.
ABSOLUTE ماتریس AffineTransform موجود را با ماتریس جدید جایگزین می کند.

UpdateSlidesPositionRequest

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

نمایندگی JSON
{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}
فیلدها
slideObjectIds[]

string

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

insertionIndex

integer

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

DeleteTextRequest

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

نمایندگی JSON
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
فیلدها
objectId

string

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

cellLocation

object ( TableCellLocation )

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

textRange

object ( Range )

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

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

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

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

محدوده

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

نمایندگی JSON
{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}
فیلدها
startIndex

integer

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

endIndex

integer

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

type

enum ( Type )

نوع محدوده.

تایپ کنید

انواع محدوده ها.

Enums
RANGE_TYPE_UNSPECIFIED نوع محدوده نامشخص این مقدار نباید استفاده شود.
FIXED_RANGE یک محدوده ثابت هر دو startIndex و endIndex باید مشخص شوند.
FROM_START_INDEX محدوده را در startIndex شروع می کند و تا پایان مجموعه ادامه می دهد. endIndex نباید مشخص شود.
ALL محدوده را در کل طول مجموعه تنظیم می کند. هر دو startIndex و endIndex نباید مشخص شوند.

CreateImageRequest

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

نمایندگی JSON
{
  "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.
}
فیلدها
objectId

string

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

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

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

elementProperties

object ( PageElementProperties )

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

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

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

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

فیلد اتحادیه image_source . نوع منبع تصویر image_source فقط می تواند یکی از موارد زیر باشد:
url

string

آدرس تصویر.

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

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

CreateVideoRequest

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

توجه: برای ایجاد یک ویدیو از Google Drive نیاز است که برنامه درخواست‌کننده حداقل یکی از حوزه‌های درایو، drive.readonly یا drive.file OAuth را داشته باشد.

نمایندگی JSON
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}
فیلدها
objectId

string

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

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

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

elementProperties

object ( PageElementProperties )

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

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

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

source

enum ( Source )

منبع ویدیو

id

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 اضافه کنید. برای اطلاعات بیشتر، دسترسی به فایل‌های به اشتراک گذاشته شده پیوند با استفاده از کلیدهای منبع را ببینید.

CreateSheetsChartRequest

یک نمودار Google Sheets جاسازی شده ایجاد می کند.

توجه: ایجاد نمودار حداقل به یکی از دامنه‌های spreadsheets.readonly، spreadsheets، drive.readonly، drive.file یا drive OAuth نیاز دارد.

نمایندگی JSON
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}
فیلدها
objectId

string

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

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

elementProperties

object ( PageElementProperties )

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

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

spreadsheetId

string

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

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

chartId

integer

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

linkingMode

enum ( LinkingMode )

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

LinkingMode

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

Enums
NOT_LINKED_IMAGE نمودار با صفحه گسترده منبع مرتبط نیست و نمی توان آن را به روز کرد. نموداری که پیوند داده نشده باشد به عنوان تصویر درج می شود.
LINKED پیوند دادن نمودار به آن امکان به روز رسانی را می دهد و سایر همکاران پیوندی به صفحه گسترده را می بینند.

CreateLineRequest

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

نمایندگی JSON
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}
فیلدها
objectId

string

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

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

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

elementProperties

object ( PageElementProperties )

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

lineCategory
(deprecated)

enum ( Category )

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

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

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

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

category

enum ( LineCategory )

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

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

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

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

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

دسته بندی

دسته بندی خطوط

Enums
STRAIGHT کانکتورهای مستقیم، از جمله کانکتور مستقیم 1. هنگامی که یکی از آنها مشخص نشده باشد، دسته پیش فرض است.
BENT کانکتورهای خمیده، از جمله کانکتور خمیده 2 تا 5.
CURVED کانکتورهای منحنی، از جمله کانکتور منحنی 2 تا 5.

RefreshSheetsChartRequest

نمودار کاربرگ‌نگار جاسازی‌شده Google را با جایگزین کردن آن با آخرین نسخه نمودار از Google Sheets، تازه‌سازی می‌کند.

توجه: برای بازخوانی نمودارها حداقل به یکی از صفحات گسترده، صفحات گسترده، drive.readonly یا درایو OAuth scope نیاز است.

نمایندگی JSON
{
  "objectId": string
}
فیلدها
objectId

string

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

UpdateShapePropertiesRequest

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

نمایندگی JSON
{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}
فیلدها
objectId

string

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

shapeProperties

object ( ShapeProperties )

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

fields

string ( FieldMask format)

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

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

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

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

UpdateImagePropertiesRequest

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

نمایندگی JSON
{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}
فیلدها
objectId

string

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

imageProperties

object ( ImageProperties )

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

fields

string ( FieldMask format)

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

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

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

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

UpdateVideoPropertiesRequest

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

نمایندگی JSON
{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}
فیلدها
objectId

string

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

videoProperties

object ( VideoProperties )

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

fields

string ( FieldMask format)

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

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

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

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

UpdatePagePropertiesRequest

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

نمایندگی JSON
{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}
فیلدها
objectId

string

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

pageProperties

object ( PageProperties )

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

fields

string ( FieldMask format)

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

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

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

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

UpdateTableCellPropertiesRequest

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

نمایندگی JSON
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}
فیلدها
objectId

string

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

tableRange

object ( TableRange )

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

tableCellProperties

object ( TableCellProperties )

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

fields

string ( FieldMask format)

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

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

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

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

محدوده جدول

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

توجه به این نکته مهم است که سلول های مشخص شده توسط یک محدوده جدول لزوما یک مستطیل تشکیل نمی دهند. برای مثال، فرض کنید یک جدول 3×3 داریم که تمام سلول های ردیف آخر با هم ادغام شده اند. جدول به شکل زیر است:

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

محدوده جدول با مکان = (0، 0)، فاصله ردیف = 3 و طول ستون = 2 سلول های زیر را مشخص می کند:

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
نمایندگی JSON
{
  "location": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
فیلدها
location

object ( TableCellLocation )

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

rowSpan

integer

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

columnSpan

integer

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

UpdateLinePropertiesRequest

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

نمایندگی JSON
{
  "objectId": string,
  "lineProperties": {
    object (LineProperties)
  },
  "fields": string
}
فیلدها
objectId

string

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

lineProperties

object ( LineProperties )

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

fields

string ( FieldMask format)

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

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

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

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

CreateParagraphBulletsRequest

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

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

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

نمایندگی JSON
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
فیلدها
objectId

string

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

cellLocation

object ( TableCellLocation )

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

textRange

object ( Range )

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

bulletPreset

enum ( BulletGlyphPreset )

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

BulletGlyphPreset

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

این الگوها از این نوع گلوله ها استفاده می کنند:

  • ARROW : یک فلش، مربوط به نقطه کد Unicode U+2794
  • ARROW3D : یک فلش با سایه زنی سه بعدی، مربوط به نقطه کد Unicode U+27a2
  • CHECKBOX : یک مربع توخالی، مربوط به نقطه کد Unicode U+274f
  • CIRCLE : یک دایره توخالی، مربوط به نقطه کد Unicode U+25cb
  • DIAMOND : الماس جامد، مربوط به نقطه کد Unicode U+25c6
  • DIAMONDX : الماسی با x، مربوط به نقطه کد Unicode U+2756
  • HOLLOWDIAMOND : الماس توخالی، مربوط به نقطه کد Unicode U+25c7
  • DISC : یک دایره جامد، مربوط به نقطه کد Unicode U+25cf
  • SQUARE : یک مربع جامد، مربوط به نقطه کد Unicode U+25a0
  • STAR : یک ستاره، مربوط به نقطه کد Unicode U+2605
  • ALPHA : یک حرف کوچک، مانند "a"، "b" یا "c".
  • UPPERALPHA : یک حرف بزرگ، مانند "A"، "B" یا "C".
  • DIGIT : عددی مانند «1»، «2» یا «3».
  • ZERODIGIT : عددی که در آن اعداد تک رقمی با یک پیشوند صفر مانند '01'، '02' یا '03' قرار می گیرند. اعدادی که بیش از یک رقم دارند پیشوند صفر نیستند.
  • ROMAN : یک عدد رومی کوچک، مانند "i"، "ii" یا "iii".
  • UPPERROMAN : یک عدد رومی بزرگ، مانند "I"، "II" یا "III".
  • LEFTTRIANGLE : مثلثی به سمت چپ، مربوط به نقطه کد Unicode U+25c4
Enums
BULLET_DISC_CIRCLE_SQUARE یک لیست گلوله‌دار با علامت گلوله DISC ، CIRCLE و SQUARE برای 3 سطح تودرتوی فهرست اول.
BULLET_DIAMONDX_ARROW3D_SQUARE یک لیست گلوله‌دار با علامت گلوله DIAMONDX ، ARROW3D و SQUARE برای 3 سطح تودرتو لیست اول.
BULLET_CHECKBOX یک لیست گلوله‌دار با علامت گلوله CHECKBOX برای همه سطوح تودرتوی فهرست.
BULLET_ARROW_DIAMOND_DISC یک لیست گلوله‌دار با ARROW ، DIAMOND و گلوله DISC برای 3 سطح تودرتوی فهرست اول.
BULLET_STAR_CIRCLE_SQUARE یک لیست گلوله‌دار با علامت گلوله STAR ، CIRCLE و SQUARE برای 3 سطح تودرتوی فهرست اول.
BULLET_ARROW3D_CIRCLE_SQUARE یک لیست گلوله‌دار با علامت گلوله ARROW3D ، CIRCLE و SQUARE برای 3 سطح تودرتوی فهرست اول.
BULLET_LEFTTRIANGLE_DIAMOND_DISC یک لیست گلوله‌دار با علامت گلوله LEFTTRIANGLE ، DIAMOND و DISC برای 3 سطح تودرتوی فهرست اول.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE یک لیست گلوله‌دار با علامت گلوله DIAMONDX ، HOLLOWDIAMOND و SQUARE برای 3 سطح تودرتوی فهرست اول.
BULLET_DIAMOND_CIRCLE_SQUARE یک لیست گلوله‌دار با علامت گلوله DIAMOND ، CIRCLE و SQUARE برای 3 سطح تودرتوی فهرست اول.
NUMBERED_DIGIT_ALPHA_ROMAN یک فهرست شماره‌دار با علامت‌های عددی DIGIT ، ALPHA و ROMAN برای 3 سطح تودرتوی فهرست اول، به دنبال نقطه.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS یک فهرست شماره‌دار با علامت‌های عددی DIGIT ، ALPHA و ROMAN برای 3 سطح تودرتوی فهرست اول، به دنبال پرانتز.
NUMBERED_DIGIT_NESTED فهرستی شماره‌دار با علامت‌های عددی DIGIT که با نقطه از هم جدا شده‌اند، که در آن هر سطح تودرتو از علامت علامت سطح تودرتوی قبلی به عنوان پیشوند استفاده می‌کند. به عنوان مثال: «1.»، «1.1.»، «2.»، «2.2.».
NUMBERED_UPPERALPHA_ALPHA_ROMAN فهرستی شماره‌دار با علامت‌های عددی UPPERALPHA ، ALPHA و ROMAN برای 3 سطح تودرتوی فهرست اول، به دنبال نقطه‌ها.
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT فهرستی شماره‌دار با علامت‌های عددی UPPERROMAN ، UPPERALPHA و DIGIT برای 3 سطح تودرتوی فهرست اول، به دنبال نقطه.
NUMBERED_ZERODIGIT_ALPHA_ROMAN یک فهرست شماره‌دار با علامت‌های عددی ZERODIGIT ، ALPHA و ROMAN برای 3 سطح تودرتوی فهرست اول، به دنبال نقطه.

Replace AllShapesWithImageRequest

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

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

نمایندگی JSON
{
  "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.
}
فیلدها
replaceMethod
(deprecated)

enum ( ReplaceMethod )

روش جایگزینی

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

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

imageReplaceMethod

enum ( ImageReplaceMethod )

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

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

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

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

pageObjectIds[]

string

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

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

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

object ( SubstringMatchCriteria )

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

فیلد اتحادیه image_source . نوع منبع تصویر image_source فقط می تواند یکی از موارد زیر باشد:
imageUrl

string

آدرس تصویر.

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

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

ReplaceMethod

روش جایگزینی

Enums
CENTER_INSIDE تصویر را مقیاس بندی و مرکزی می کند تا در محدوده شکل اصلی قرار گیرد و نسبت تصویر را حفظ می کند. اندازه رندر شده تصویر ممکن است کوچکتر از اندازه شکل باشد. این روش پیش فرض زمانی است که یکی از آن ها مشخص نشده باشد.
CENTER_CROP تصویر را مقیاس و مرکز می کند تا مرزهای شکل اصلی پر شود. ممکن است تصویر برای پر کردن شکل برش داده شود. اندازه رندر شده تصویر با شکل اصلی یکسان خواهد بود.

ImageReplaceMethod

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

Enums
IMAGE_REPLACE_METHOD_UNSPECIFIED روش جایگزینی تصویر نامشخص این مقدار نباید استفاده شود.
CENTER_INSIDE تصویر را مقیاس بندی و مرکزی می کند تا در محدوده شکل اصلی قرار گیرد و نسبت تصویر را حفظ می کند. اندازه رندر شده تصویر ممکن است کوچکتر از اندازه شکل باشد. این روش پیش فرض زمانی است که یکی از آن ها مشخص نشده باشد.
CENTER_CROP تصویر را مقیاس و مرکز می کند تا مرزهای شکل اصلی پر شود. ممکن است تصویر برای پر کردن شکل برش داده شود. اندازه رندر شده تصویر همانند شکل اصلی خواهد بود.

DuplicateObjectRequest

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

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

نمایندگی JSON
{
  "objectId": string,
  "objectIds": {
    string: string,
    ...
  }
}
فیلدها
objectId

string

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

objectIds

map (key: string, value: string)

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

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

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

UpdateTextStyLerequest

یک ظاهر طراحی متن را به Shape یا Table به روز کنید.

نمایندگی JSON
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
فیلدها
objectId

string

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

cellLocation

object ( TableCellLocation )

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

style

object ( TextStyle )

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

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

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

textRange

object ( Range )

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

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

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

fields

string ( FieldMask format)

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

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

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

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

cheperallshapeswithsheetschartrequest

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

توجه: جایگزینی اشکال با نمودار حداقل به یکی از صفحات گسترده نیاز دارد. readonly ، صفحات گسترده ، drive.readonly یا Drive Oauth Scopes.

نمایندگی JSON
{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}
فیلدها
containsText

object ( SubstringMatchCriteria )

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

spreadsheetId

string

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

chartId

integer

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

linkingMode

enum ( LinkingMode )

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

pageObjectIds[]

string

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

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

مادی

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

Enums
NOT_LINKED_IMAGE نمودار با صفحه گسترده منبع همراه نیست و به روز نمی شود. نمودار که به هم پیوند ندارد به عنوان یک تصویر درج می شود.
LINKED پیوند نمودار اجازه می دهد تا به روز شود و سایر همکاران پیوندی به صفحه گسترده مشاهده می کنند.

DeleteparagraphBulletsRequest

گلوله ها را از تمام پاراگراف هایی که با range شاخص متن داده شده همپوشانی دارند حذف می کند.

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

نمایندگی JSON
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
فیلدها
objectId

string

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

cellLocation

object ( TableCellLocation )

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

textRange

object ( Range )

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

به روز رسانی

یک ظاهر طراحی شده برای همه پاراگراف ها را به Shape یا Table که با محدوده شاخص متن داده شده همپوشانی دارند ، به روز می کند.

نمایندگی JSON
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
فیلدها
objectId

string

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

cellLocation

object ( TableCellLocation )

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

style

object ( ParagraphStyle )

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

textRange

object ( Range )

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

fields

string ( FieldMask format)

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

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

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

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

UpdateTableBorderPropertiesRequest

خصوصیات مرزهای جدول را در یک Table به روز می کند.

نمایندگی JSON
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}
فیلدها
objectId

string

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

tableRange

object ( TableRange )

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

borderPosition

enum ( BorderPosition )

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

tableBorderProperties

object ( TableBorderProperties )

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

fields

string ( FieldMask format)

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

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

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

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

مرز

موقعیت مرزی جدول.

Enums
ALL تمام مرزهای موجود در محدوده.
BOTTOM مرزها در پایین محدوده.
INNER مرزهای داخل محدوده.
INNER_HORIZONTAL مرزهای افقی در قسمت داخلی محدوده.
INNER_VERTICAL مرزهای عمودی در قسمت داخلی محدوده.
LEFT مرزها در سمت چپ محدوده.
OUTER مرزهای خارج از محدوده.
RIGHT مرزها در سمت راست محدوده.
TOP مرزها در بالای محدوده.

UpdateTelecumnPropertiesRequest

خصوصیات یک ستون Table را به روز می کند.

نمایندگی JSON
{
  "objectId": string,
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
فیلدها
objectId

string

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

columnIndices[]

integer

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

tableColumnProperties

object ( TableColumnProperties )

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

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

fields

string ( FieldMask format)

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

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

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

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

UpdateTableRowpropertiesRequest

خصوصیات یک ردیف Table را به روز می کند.

نمایندگی JSON
{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}
فیلدها
objectId

string

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

rowIndices[]

integer

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

tableRowProperties

object ( TableRowProperties )

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

fields

string ( FieldMask format)

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

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

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

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

MergetAbleCellsRequest

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

نمایندگی JSON
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
فیلدها
objectId

string

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

tableRange

object ( TableRange )

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

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

unmergetablecellsrequest

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

نمایندگی JSON
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
فیلدها
objectId

string

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

tableRange

object ( TableRange )

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

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

GroupObjectsRequest

گروه ها را برای ایجاد یک گروه شیء. به عنوان مثال ، گروه PageElements گروه برای ایجاد Group در همان صفحه همه کودکان.

نمایندگی JSON
{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}
فیلدها
groupObjectId

string

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

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

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

childrenObjectIds[]

string

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

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

ungroupobjectsrequest

اشیاء UNGROUP ، مانند groups .

نمایندگی JSON
{
  "objectIds": [
    string
  ]
}
فیلدها
objectIds[]

string

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

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

UpdatePageElementalTtextRequest

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

نمایندگی JSON
{
  "objectId": string,
  "title": string,
  "description": string
}
فیلدها
objectId

string

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

title

string

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

description

string

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

charporimagerequest

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

جایگزینی یک تصویر برخی از image effects را از تصویر موجود حذف می کند.

نمایندگی JSON
{
  "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.
}
فیلدها
imageObjectId

string

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

imageReplaceMethod

enum ( ImageReplaceMethod )

روش جایگزینی

Union Field image_source . نوع منبع تصویر. image_source فقط می تواند یکی از موارد زیر باشد:
url

string

URL تصویر

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

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

به روزرسانی های propertiesRequest

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

نمایندگی JSON
{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}
فیلدها
objectId

string

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

slideProperties

object ( SlideProperties )

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

fields

string ( FieldMask format)

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

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

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

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

به روز رسانی

سفارش z-or از عناصر صفحه را به روز می کند. Z-order سفارش عناصر موجود در صفحه از پشت به جلو است. عنصر صفحه در جلو ممکن است عناصر موجود در پشت آن را پوشش دهد.

نمایندگی JSON
{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}
فیلدها
pageElementObjectIds[]

string

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

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

operation

enum ( ZOrderOperation )

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

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

زرنگ

عملیاتی برای به روزرسانی یک عنصر صفحه Z-order.

Enums
Z_ORDER_OPERATION_UNSPECIFIED عملیات نامشخص
BRING_TO_FRONT عناصر صفحه را به قسمت جلوی صفحه می آورد.
BRING_FORWARD عناصر صفحه را در صفحه توسط یک عنصر نسبت به قسمت اصلی در عناصر صفحه مشخص به جلو می آورد.
SEND_BACKWARD عناصر صفحه را به عقب در صفحه توسط یک عنصر نسبت به دورترین پشت یکی در عناصر صفحه مشخص می کند.
SEND_TO_BACK عناصر صفحه را به پشت صفحه می فرستد.

UpdateLineCategoreQuest

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

نمایندگی JSON
{
  "objectId": string,
  "lineCategory": enum (LineCategory)
}
فیلدها
objectId

string

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

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

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

lineCategory

enum ( LineCategory )

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

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

بازگرداندن

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

نمایندگی JSON
{
  "objectId": string
}
فیلدها
objectId

string

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

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