Google Slides API به شما امکان می دهد جداول را در صفحات ایجاد و ویرایش کنید. مثالهای موجود در این صفحه برخی از عملیات رایج جدول را با استفاده از روش presentations.batchUpdate
نشان میدهند.
این نمونه ها از متغیرهای زیر استفاده می کنند:
- PRESENTATION_ID — محل ارائه شناسه ارائه را نشان می دهد. می توانید مقدار این شناسه را از نشانی اینترنتی ارائه کشف کنید.
- PAGE_ID — نشان می دهد که در آن شناسه های شی صفحه را ارائه می کنید. می توانید مقدار این مورد را از URL یا با استفاده از درخواست خواندن API بازیابی کنید.
- TABLE_ID - نشان می دهد که در آن شناسه شی عنصر صفحه را برای جدولی که با آن کار می کنید ارائه می کنید. میتوانید این شناسه را برای عناصری که ایجاد میکنید (با برخی محدودیتها ) مشخص کنید یا به Slides API اجازه دهید بهطور خودکار یکی را ایجاد کند. شناسه های عنصر را می توان از طریق درخواست خواندن API بازیابی کرد.
این نمونه ها به عنوان درخواست های HTTP برای خنثی بودن زبان ارائه می شوند. برای یادگیری نحوه اجرای یک بهروزرسانی دستهای به زبانهای مختلف با استفاده از کتابخانههای سرویس گیرنده Google API، به افزودن اشکال و متن مراجعه کنید.
نمونه کد presentations.batchUpdate
زیر نحوه استفاده از روش CreateTableRequest
را برای افزودن جدول به اسلاید مشخص شده توسط PAGE_ID نشان می دهد.
این جدول دارای هشت سطر و پنج ستون است. توجه داشته باشید که Slides API هر فیلد size
یا transform
ارائه شده به عنوان بخشی از elementProperties
را نادیده می گیرد. در عوض، API جدولی را ایجاد میکند که تقریباً در مرکز اسلاید قرار دارد و در صورت امکان تعداد ردیفها و ستونهای مشخص شده را در خود جای میدهد.
در زیر پروتکل درخواست برای ایجاد جدول آمده است:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createTable": { "objectId": TABLE_ID, "elementProperties": { "pageObjectId": PAGE_ID, }, "rows": 8, "columns": 5 } } ] }
نمونه کد presentations.batchUpdate
زیر نحوه استفاده از روش DeleteTableRowRequest
را برای حذف ردیف ششم نشان می دهد. سپس از روش DeleteTableColumnRequest
برای حذف ستون چهارم استفاده می کند. جدول توسط TABLE_ID مشخص شده است. هر دو rowIndex
و columnIndex
در cellLocation
بر اساس صفر هستند.
در زیر پروتکل درخواست حذف ردیف ها یا ستون های جدول آمده است:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "deleteTableRow": { "tableObjectId": TABLE_ID, "cellLocation": { "rowIndex": 5 } } }, { "deleteTableColumn": { "tableObjectId": TABLE_ID, "cellLocation": { "columnIndex": 3 } } } ] }
نمونه کد presentations.batchUpdate
زیر نحوه استفاده از روش DeleteTextRequest
را برای حذف تمام متن یک سلول در textRange
نشان می دهد. سپس از روش InsertTextRequest
برای جایگزینی آن با متن جدید "کانگورو" استفاده می کند.
جدول توسط TABLE_ID مشخص شده است. سلول آسیب دیده در ردیف پنجم و ستون سوم قرار دارد. هر دو rowIndex
و columnIndex
در cellLocation
بر اساس صفر هستند.
در زیر پروتکل درخواست ویرایش داده های جدول آمده است:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "deleteText": { "objectId": TABLE_ID, "cellLocation": { "rowIndex": 4, "columnIndex": 2 }, "textRange": { "type": "ALL", } } }, { "insertText": { "objectId": TABLE_ID, "cellLocation": { "rowIndex": 4, "columnIndex": 2 }, "text": "Kangaroo", "insertionIndex": 0 } } ] }
نمونه کد presentations.batchUpdate
زیر نحوه استفاده از روش UpdateTableCellPropertiesRequest
را برای قالب بندی ردیف سرصفحه یک عنصر جدول، در tableRange
، مشخص شده توسط TABLE_ID نشان می دهد. سپس از روش TableCellProperties
برای تنظیم رنگ پسزمینه ردیف سرصفحه سیاه استفاده میکند.
هر درخواست زیر از روش UpdateTextStyleRequest
استفاده میکند تا قالب متن را در یک سلول از ردیف سرصفحه روی قلم سفید 18 نقطهای Cambria در محدوده textRange
تنظیم کند. سپس باید این درخواست را برای هر سلول اضافی در هدر تکرار کنید.
هر دو rowIndex
و columnIndex
در location
و cellLocation
بر اساس صفر هستند.
در زیر پروتکل درخواست برای قالب بندی ردیف سرصفحه جدول آمده است:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updateTableCellProperties": { "objectId": TABLE_ID, "tableRange": { "location": { "rowIndex": 0, "columnIndex": 0 }, "rowSpan": 1, "columnSpan": 3 }, "tableCellProperties": { "tableCellBackgroundFill": { "solidFill": { "color": { "rgbColor": { "red": 0.0, "green": 0.0, "blue": 0.0 } } } } }, "fields": "tableCellBackgroundFill.solidFill.color" } }, { "updateTextStyle": { "objectId": TABLE_ID, "cellLocation": { "rowIndex": 0, "columnIndex": 0 }, "style": { "foregroundColor": { "opaqueColor": { "rgbColor": { "red": 1.0, "green": 1.0, "blue": 1.0 } } }, "bold": true, "fontFamily": "Cambria", "fontSize": { "magnitude": 18, "unit": "PT" } }, "textRange": { "type": "ALL" }, "fields": "foregroundColor,bold,fontFamily,fontSize" } }, // Repeat the above request for each additional cell in the header row.... ] }
در اینجا ردیف فرمتشده سرصفحه پس از این بهروزرسانیها به نظر میرسد:
نمونه کد presentations.batchUpdate
زیر نحوه استفاده از روش InsertTableRowsRequest
را برای اضافه کردن سه ردیف زیر ردیف ششم نشان می دهد. سپس از روش InsertTableColumnsRequest
برای اضافه کردن دو ستون به سمت چپ ستون چهارم در همان جدول استفاده می کند.
جدول توسط TABLE_ID مشخص شده است. هر دو rowIndex
و columnIndex
در cellLocation
بر اساس صفر هستند.
در زیر پروتکل درخواست برای درج ردیف یا ستون جدول آمده است:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "insertTableRows": { "tableObjectId": TABLE_ID, "cellLocation": { "rowIndex": 5 }, "insertBelow": true, "number": 3 } }, { "insertTableColumns": { "tableObjectId": TABLE_ID, "cellLocation": { "columnIndex": 3 }, "insertRight": false, "number": 2 } } ] }