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,
  "searchByRegex": boolean
}
فیلدها
text

string

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

matchCase

boolean

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

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

boolean

اختیاری. درست است اگر مقدار find باید به عنوان یک عبارت منظم در نظر گرفته شود. از هر گونه بک اسلش در الگو باید فرار کرد.

  • 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 (