Yêu cầu
Một loại nội dung cập nhật được áp dụng cho bản trình bày.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Các trường | |
---|---|
Trường nhóm kind . Loại nội dung cập nhật. Chỉ có đúng một trường là bắt buộc.
kind chỉ có thể là một trong những loại sau đây:
|
|
createSlide
|
Tạo trang trình bày mới. |
createShape
|
Tạo một hình dạng mới. |
createTable
|
Tạo bảng mới. |
insertText
|
Chèn văn bản vào ô hoặc hình dạng. |
insertTableRows
|
Chèn hàng vào bảng. |
insertTableColumns
|
Chèn cột vào bảng. |
deleteTableRow
|
Xóa một hàng khỏi bảng. |
deleteTableColumn
|
Xóa một cột khỏi bảng. |
replaceAllText
|
Thay thế tất cả các bản sao của văn bản được chỉ định. |
deleteObject
|
Xóa một trang hoặc phần tử trang khỏi bản trình bày. |
updatePageElementTransform
|
Cập nhật biến đổi của một phần tử trang. |
updateSlidesPosition
|
Cập nhật vị trí của một tập hợp các trang trình bày trong bản trình bày. |
deleteText
|
Xoá văn bản khỏi một hình dạng hoặc một ô trong bảng. |
createImage
|
Tạo hình ảnh. |
createVideo
|
Tạo video. |
createSheetsChart
|
Tạo biểu đồ trên Google Trang tính được nhúng. |
createLine
|
Tạo đường. |
refreshSheetsChart
|
Làm mới biểu đồ trên Google Trang tính. |
updateShapeProperties
|
Cập nhật các thuộc tính của một |
updateImageProperties
|
Cập nhật các thuộc tính của một |
updateVideoProperties
|
Cập nhật các thuộc tính của một |
updatePageProperties
|
Cập nhật các thuộc tính của một |
updateTableCellProperties
|
Cập nhật các thuộc tính của một |
updateLineProperties
|
Cập nhật các thuộc tính của một |
createParagraphBullets
|
Tạo dấu đầu dòng cho đoạn văn bản. |
replaceAllShapesWithImage
|
Thay thế tất cả các hình dạng khớp với một số tiêu chí bằng hình ảnh. |
duplicateObject
|
Sao y trang trình bày hoặc phần tử trang. |
updateTextStyle
|
|
replaceAllShapesWithSheetsChart
|
Thay thế tất cả các hình dạng khớp với một số tiêu chí bằng biểu đồ trên Google Trang tính. |
deleteParagraphBullets
|
Xóa dấu đầu dòng khỏi đoạn. |
updateParagraphStyle
|
|
updateTableBorderProperties
|
Cập nhật các thuộc tính của đường viền bảng trong |
updateTableColumnProperties
|
Cập nhật các thuộc tính của cột |
updateTableRowProperties
|
Cập nhật các thuộc tính của một hàng |
mergeTableCells
|
Hợp nhất các ô trong một |
unmergeTableCells
|
Hủy hợp nhất các ô trong |
groupObjects
|
Nhóm các đối tượng, chẳng hạn như phần tử trang. |
ungroupObjects
|
Tách các đối tượng, chẳng hạn như |
updatePageElementAltText
|
Cập nhật tiêu đề văn bản thay thế và/hoặc nội dung mô tả về một |
replaceImage
|
Thay thế hình ảnh hiện tại bằng hình ảnh mới. |
updateSlideProperties
|
Cập nhật các thuộc tính của một Trang trình bày |
updatePageElementsZOrder
|
Cập nhật thứ tự Z của |
updateLineCategory
|
Cập nhật danh mục của một |
rerouteLine
|
Định tuyến lại |
Tạo Yêu cầu trang trình bày
Tạo trang trình bày.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string, "insertionIndex": integer, "slideLayoutReference": { object ( |
Các trường | |
---|---|
objectId
|
Mã đối tượng do người dùng cung cấp.
Nếu bạn chỉ định ID thì ID đó phải là duy nhất trong số tất cả các trang và phần tử trang trong bản trình bày. Mã này phải bắt đầu bằng một ký tự bao gồm chữ và số hoặc dấu gạch dưới (khớp với biểu thức chính quy
Nếu bạn không chỉ định ID, ID duy nhất được tạo. |
insertionIndex
|
Chỉ mục không bắt buộc cho biết vị trí chèn trang trình bày. Nếu bạn không chỉ định chỉ mục, trang trình bày sẽ được tạo ở cuối. |
slideLayoutReference
|
Tham chiếu bố cục của trang trình bày cần chèn vào, dựa trên trang chính hiện tại, đây là một trong các giá trị sau:
Nếu không tìm thấy LayoutReference trong bản chính hiện tại, hệ thống sẽ trả về lỗi yêu cầu 400 không hợp lệ.
Nếu bạn không chỉ định tham chiếu bố cục, trang trình bày sẽ sử dụng bố cục
|
placeholderIdMappings[]
|
Một danh sách không bắt buộc về các liên kết mã đối tượng từ (các) |
Tệp đối chiếu bố cục
Tài liệu tham khảo về bố cục trang trình bày. Điều này có thể tham chiếu:
- Bố cục được xác định trước
- Một trong các bố cục trong bản trình bày.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Các trường | |
---|---|
Trường nhóm kind . Loại LayoutReference.
kind chỉ có thể là một trong những loại sau đây:
|
|
predefinedLayout
|
Bố cục định sẵn. |
layoutId
|
ID bố cục: ID đối tượng của một trong số các bố cục trong bản trình bày. |
Bố cục định sẵn
Loại bố cục định sẵn. Đây là những bố cục thường thấy trong bản trình bày. Tuy nhiên, không có gì đảm bảo rằng những bố cục này sẽ xuất hiện trong bản cái hiện tại vì có thể chúng đã bị xoá hoặc không thuộc giao diện được sử dụng. Ngoài ra, phần giữ chỗ trên mỗi bố cục có thể đã được thay đổi.
Enum | |
---|---|
PREDEFINED_LAYOUT_UNSPECIFIED
|
Bố cục không xác định. |
BLANK
|
Bố cục trống, không có trình giữ chỗ. |
CAPTION_ONLY
|
Bố cục có chú thích ở dưới cùng. |
TITLE
|
Bố cục có tiêu đề và phụ đề. |
TITLE_AND_BODY
|
Bố cục có tiêu đề và nội dung. |
TITLE_AND_TWO_COLUMNS
|
Bố cục có tiêu đề và hai cột. |
TITLE_ONLY
|
Bố cục chỉ có tiêu đề. |
SECTION_HEADER
|
Bố cục có tiêu đề mục. |
SECTION_TITLE_AND_DESCRIPTION
|
Bố cục có tiêu đề và phụ đề ở một bên và mô tả ở bên kia. |
ONE_COLUMN_TEXT
|
Bố cục có một tiêu đề và một nội dung, được sắp xếp trong một cột. |
MAIN_POINT
|
Bố cục có một điểm chính. |
BIG_NUMBER
|
Bố cục có tiêu đề số lớn. |
Layout chỗIdId
Ánh xạ ID do người dùng chỉ định cho phần giữ chỗ sẽ được tạo trên một trang trình bày từ một bố cục đã chỉ định.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string, // Union field |
Các trường | |
---|---|
objectId
|
Mã đối tượng do người dùng cung cấp cho phần giữ chỗ được xác định ở trên sẽ được tạo trên trang trình bày.
Nếu bạn chỉ định ID thì ID đó phải là duy nhất trong số tất cả các trang và phần tử trang trong bản trình bày. Mã này phải bắt đầu bằng một ký tự chữ-số hoặc dấu gạch dưới (khớp với biểu thức chính quy
Nếu bạn không chỉ định ID, ID duy nhất được tạo. |
Trường nhóm kind . Loại để xác định phần giữ chỗ trên bố cục.
kind chỉ có thể là một trong những loại sau đây:
|
|
layoutPlaceholder
|
Phần giữ chỗ trên bố cục sẽ được áp dụng cho trang trình bày. Chỉ cần có |
layoutPlaceholderObjectId
|
Mã đối tượng của phần giữ chỗ trên bố cục sẽ được áp dụng cho một trang trình bày. |
Tạo hình yêu cầu
Tạo một hình dạng mới.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
Các trường | |
---|---|
objectId
|
Mã đối tượng do người dùng cung cấp.
Nếu bạn chỉ định ID thì ID đó phải là duy nhất trong số tất cả các trang và phần tử trang trong bản trình bày. Mã này phải bắt đầu bằng một ký tự chữ-số hoặc dấu gạch dưới (khớp với biểu thức chính quy
|
elementProperties
|
Thuộc tính phần tử cho hình dạng. |
shapeType
|
Loại hình dạng. |
Thuộc tính phần tử trang
Thuộc tính chung cho một phần tử trang.
Lưu ý: Khi bạn tạo PageElement
lúc đầu, API có thể sửa đổi giá trị của cả size
và transform
, nhưng kích thước hình ảnh sẽ không thay đổi.
Biểu diễn dưới dạng JSON |
---|
{ "pageObjectId": string, "size": { object ( |
Các trường | |
---|---|
pageObjectId
|
ID đối tượng của trang nơi đặt phần tử. |
size
|
Kích thước của phần tử. |
transform
|
Phép biến đổi cho phần tử. |
Tạo yêu cầu bảng
Tạo bảng mới.
Biểu diễn dưới dạng JSON |
---|
{
"objectId": string,
"elementProperties": {
object (
|
Các trường | |
---|---|
objectId
|
Mã đối tượng do người dùng cung cấp.
Nếu bạn chỉ định ID thì ID đó phải là duy nhất trong số tất cả các trang và phần tử trang trong bản trình bày. Mã này phải bắt đầu bằng một ký tự chữ-số hoặc dấu gạch dưới (khớp với biểu thức chính quy
Nếu bạn không chỉ định ID, ID duy nhất được tạo. |
elementProperties
|
Thuộc tính phần tử cho bảng. Bảng sẽ được tạo ở kích thước được cung cấp, theo kích thước tối thiểu. Nếu bạn không cung cấp kích thước thì bảng sẽ được tự động điều chỉnh kích thước. Phép biến đổi bảng phải có tỷ lệ 1 và không có thành phần cắt. Nếu không có chuyển đổi nào được cung cấp, bảng sẽ được căn giữa trên trang. |
rows
|
Số hàng trong bảng. |
columns
|
Số cột trong bảng. |
Yêu cầu văn bản chèn
Chèn văn bản vào hình dạng hoặc ô trong bảng.
Biểu diễn dưới dạng JSON |
---|
{
"objectId": string,
"cellLocation": {
object (
|
Các trường | |
---|---|
objectId
|
ID đối tượng của hình dạng hoặc bảng nơi văn bản sẽ được chèn vào. |
cellLocation
|
Vị trí ô bảng tuỳ chọn nếu văn bản được chèn vào một ô bảng. Nếu có, ID đối tượng phải tham chiếu đến một bảng. |
text
|
Văn bản sẽ được chèn.
Việc chèn một ký tự dòng mới sẽ ngầm tạo một
Kiểu văn bản cho văn bản được chèn sẽ được xác định tự động, thường duy trì kiểu văn bản lân cận. Trong hầu hết trường hợp, văn bản sẽ được thêm vào Một số ký tự điều khiển (U + 0000-U + 0008, U + 000C-U + 001F) và các ký tự từ Vùng sử dụng riêng trên mặt phẳng đa ngôn ngữ Unicode Basic (U + E000-U + F8FF) sẽ bị xóa khỏi văn bản được chèn. |
insertionIndex
|
Chỉ mục nơi chèn văn bản, theo đơn vị mã Unicode, dựa trên chỉ mục Chỉ mục là 0 và được tính từ đầu chuỗi. Chỉ mục có thể được điều chỉnh để ngăn việc chèn bên trong các cụm Unicode grapheme. Trong những trường hợp này, văn bản sẽ được chèn ngay sau cụm grapheme. |
Yêu cầu InsertTableRows
Chèn hàng vào bảng.
Biểu diễn dưới dạng JSON |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
Các trường | |
---|---|
tableObjectId
|
Bảng để chèn hàng. |
cellLocation
|
Vị trí ô bảng tham chiếu mà các hàng sẽ được chèn vào. Một hàng mới sẽ được chèn vào bên trên (hoặc bên dưới) hàng có ô tham chiếu. Nếu ô tham chiếu là một ô đã hợp nhất, một hàng mới sẽ được chèn vào bên trên (hoặc bên dưới) ô đã hợp nhất. |
insertBelow
|
Liệu có chèn hàng mới bên dưới vị trí ô tham chiếu hay không.
|
number
|
Số hàng được chèn. Tối đa 20 yêu cầu. |
Yêu cầu Chèn Bảng
Chèn cột vào bảng.
Các cột khác trong bảng sẽ được đổi kích thước để vừa với cột mới.
Biểu diễn dưới dạng JSON |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
Các trường | |
---|---|
tableObjectId
|
Bảng để chèn cột. |
cellLocation
|
Vị trí ô trong bảng tham chiếu mà từ đó các cột sẽ được chèn. Một cột mới sẽ được chèn vào bên trái (hoặc bên phải) cột có ô tham chiếu. Nếu ô tham chiếu là một ô đã hợp nhất, một cột mới sẽ được chèn vào bên trái (hoặc bên phải) ô được hợp nhất. |
insertRight
|
Liệu có chèn cột mới vào bên phải vị trí ô tham chiếu hay không.
|
number
|
Số cột được chèn. Tối đa 20 yêu cầu. |
XóaBảngHàngYêu cầu
Xóa một hàng khỏi bảng.
Biểu diễn dưới dạng JSON |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
Các trường | |
---|---|
tableObjectId
|
Bảng để xóa hàng. |
cellLocation
|
Vị trí ô trong bảng tham chiếu mà một hàng sẽ bị xoá. Hàng mà ô này kéo dài sẽ bị xóa. Nếu đây là một ô đã hợp nhất, nhiều hàng sẽ bị xóa. Nếu không còn hàng nào trong bảng sau khi xoá, toàn bộ bảng sẽ bị xoá. |
XóaBảngCộtYêu cầu
Xóa một cột khỏi bảng.
Biểu diễn dưới dạng JSON |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
Các trường | |
---|---|
tableObjectId
|
Bảng để xóa cột. |
cellLocation
|
Vị trí ô trong bảng tham chiếu mà một cột sẽ bị xoá. Cột mà ô này kéo dài sẽ bị xóa. Nếu đây là một ô đã hợp nhất, nhiều cột sẽ bị xóa. Nếu không còn cột nào trong bảng sau khi xoá, thì toàn bộ bảng sẽ bị xoá. |
Thay thế tất cả văn bản yêu cầu
Thay thế tất cả các trường hợp văn bản khớp với một tiêu chí bằng
replace text
.
Biểu diễn dưới dạng JSON |
---|
{ "replaceText": string, "pageObjectIds": [ string ], // Union field |
Các trường | |
---|---|
replaceText
|
Văn bản sẽ thay thế văn bản phù hợp. |
pageObjectIds[]
|
Nếu không trống, hãy giới hạn các kết quả phù hợp thành các phần tử trang chỉ trên các trang nhất định.
Trả về lỗi yêu cầu 400 không hợp lệ nếu mã đối tượng của trang là |
Trường nhóm criteria . Tiêu chí dùng để so khớp văn bản sẽ thay thế.
criteria chỉ có thể là một trong những loại sau đây:
|
|
containsText
|
Tìm văn bản có hình dạng phù hợp với chuỗi con này. |
Tiêu chí so khớp chuỗi con
Tiêu chí khớp một chuỗi văn bản cụ thể trong một hình dạng hoặc một bảng.
Biểu diễn dưới dạng JSON |
---|
{ "text": string, "matchCase": boolean } |
Các trường | |
---|---|
text
|
Văn bản để tìm kiếm trong hình dạng hoặc bảng. |
matchCase
|
Cho biết liệu cụm từ tìm kiếm có nên tuân thủ hay không:
|
Xóa đối tượng yêu cầu
Xoá một đối tượng (pages
hoặc page elements
) khỏi bản trình bày.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string } |
Các trường | |
---|---|
objectId
|
ID đối tượng của trang hoặc phần tử trang cần xóa.
Nếu sau một thao tác xóa, Nếu một phần giữ chỗ bị xoá trên một bố cục, thì mọi phần giữ chỗ kế thừa trống cũng sẽ bị xoá. |
UpdatePageElementTransformYêu cầu
Cập nhật biến đổi của một phần tử trang.
Việc cập nhật biến đổi của một nhóm sẽ thay đổi biến đổi tuyệt đối của các thành phần trang trong nhóm đó. Điều này có thể thay đổi giao diện trực quan của nhóm. Hãy xem tài liệu về PageElement.transform
để biết thêm thông tin chi tiết.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string, "transform": { object ( |
Các trường | |
---|---|
objectId
|
ID đối tượng của phần tử trang cần cập nhật. |
transform
|
Ma trận biến đổi đầu vào dùng để cập nhật phần tử trang. |
applyMode
|
Chế độ áp dụng của bản cập nhật biến đổi. |
Chế độ áp dụng
Các chế độ áp dụng của bản cập nhật biến đổi.
Enum | |
---|---|
APPLY_MODE_UNSPECIFIED
|
Chế độ không xác định. |
RELATIVE
|
Áp dụng ma trận AffineTransform mới cho ma trận hiện tại và thay thế ma trận hiện tại bằng phép nối kết quả. |
ABSOLUTE
|
Thay thế ma trận AffineTransform hiện tại bằng ma trận mới. |
Cập nhật trang trình bày về yêu cầu vị trí
Cập nhật vị trí của các trang trình bày trong bản trình bày.
Biểu diễn dưới dạng JSON |
---|
{ "slideObjectIds": [ string ], "insertionIndex": integer } |
Các trường | |
---|---|
slideObjectIds[]
|
Mã trang trình bày trong bản trình bày mà bạn cần di chuyển. Các trang trình bày trong danh sách này phải theo thứ tự bản trình bày hiện có, không bị trùng lặp. |
insertionIndex
|
Chỉ mục nơi chèn các trang trình bày, dựa trên việc sắp xếp trang trình bày trước khi di chuyển. Phải nằm trong khoảng từ 0 đến số trang trình bày trong bản trình bày, tính toàn bộ. |
Yêu cầu xóa văn bản
Xoá văn bản khỏi một hình dạng hoặc một ô trong bảng.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
Các trường | |
---|---|
objectId
|
Mã đối tượng của hình dạng hoặc bảng sẽ xoá văn bản khỏi đó. |
cellLocation
|
Vị trí ô bảng tuỳ chọn nếu văn bản cần xoá khỏi một ô trong bảng. Nếu có, ID đối tượng phải tham chiếu đến một bảng. |
textRange
|
Phạm vi văn bản cần xoá, dựa trên chỉ mục của
Luôn có một ký tự dòng mới ngầm ẩn ở cuối văn bản trong hình dạng hoặc của ô không thể xóa được.
Việc xóa văn bản vượt qua ranh giới của đoạn văn có thể dẫn đến thay đổi đối với kiểu đoạn và danh sách khi hai đoạn văn được hợp nhất. Phạm vi chỉ bao gồm một đơn vị mã của cặp thay thế được mở rộng để bao gồm cả hai đơn vị mã. |
Phạm vi
Chỉ định phạm vi liền kề của tập hợp đã được lập chỉ mục, chẳng hạn như các ký tự trong văn bản.
Biểu diễn dưới dạng JSON |
---|
{
"startIndex": integer,
"endIndex": integer,
"type": enum (
|
Các trường | |
---|---|
startIndex
|
Chỉ mục bắt đầu của tập hợp. Bắt buộc đối với các phạm vi |
endIndex
|
Chỉ mục không bắt buộc của số cuối của tập hợp. Bắt buộc đối với phạm vi |
type
|
Loại phạm vi. |
Loại
Các loại phạm vi.
Enum | |
---|---|
RANGE_TYPE_UNSPECIFIED
|
Loại phạm vi chưa được chỉ định. Không được sử dụng giá trị này. |
FIXED_RANGE
|
Phạm vi cố định. Bạn phải chỉ định cả startIndex và endIndex .
|
FROM_START_INDEX
|
Bắt đầu dải ô tại
startIndex
và tiếp tục cho đến khi hết bộ sưu tập. Không được chỉ định endIndex .
|
ALL
|
Đặt dải ô thành toàn bộ chiều dài của tập hợp. Không được chỉ định cả startIndex và endIndex .
|
Tạo yêu cầu hình ảnh
Tạo hình ảnh.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
Các trường | |
---|---|
objectId
|
Mã đối tượng do người dùng cung cấp.
Nếu bạn chỉ định ID thì ID đó phải là duy nhất trong số tất cả các trang và phần tử trang trong bản trình bày. Mã này phải bắt đầu bằng một ký tự chữ-số hoặc dấu gạch dưới (khớp với biểu thức chính quy
Nếu bạn không chỉ định ID, ID duy nhất được tạo. |
elementProperties
|
Thuộc tính phần tử cho hình ảnh. Khi tỷ lệ cỡ ảnh của kích thước được cung cấp không khớp với tỷ lệ cỡ ảnh, hình ảnh được chia tỷ lệ và được căn giữa theo kích thước để duy trì tỷ lệ co. Phép biến đổi đã cho được áp dụng sau thao tác này.
Bạn không bắt buộc phải sử dụng thuộc tính
Bạn không bắt buộc phải sử dụng thuộc tính |
Trường nhóm image_source . Loại nguồn hình ảnh.
image_source chỉ có thể là một trong những loại sau đây:
|
|
url
|
URL hình ảnh. Hình ảnh được tìm nạp một lần tại thời điểm chèn và bản sao được lưu trữ để hiển thị bên trong bản trình bày. Hình ảnh phải có kích thước nhỏ hơn 50 MB, không được vượt quá 25 megapixel và phải ở một trong các định dạng PNG, JPEG hoặc GIF.
URL được cung cấp phải truy cập công khai và có độ dài tối đa 2 KB. URL này được lưu cùng với hình ảnh và hiển thị thông qua trường |
Tạo yêu cầu video
Tạo video.
LƯU Ý: Để tạo video từ Google Drive, ứng dụng yêu cầu phải có ít nhất một trong các phạm vi OAuth của Drive, Drive.readonly hoặc drive.file.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
Các trường | |
---|---|
objectId
|
Mã đối tượng do người dùng cung cấp.
Nếu bạn chỉ định ID thì ID đó phải là duy nhất trong số tất cả các trang và phần tử trang trong bản trình bày. Mã này phải bắt đầu bằng một ký tự chữ-số hoặc dấu gạch dưới (khớp với biểu thức chính quy
Nếu bạn không chỉ định ID, ID duy nhất được tạo. |
elementProperties
|
Thuộc tính phần tử cho video.
Bạn không bắt buộc phải sử dụng thuộc tính
Bạn không bắt buộc phải sử dụng thuộc tính |
source
|
Nguồn video. |
id
|
Giá trị nhận dạng duy nhất của nguồn video cho video này. ví dụ: Đối với video trên YouTube https://www.youtube.com/watch?v=7U3axjORYZ0, mã nhận dạng là 7U3axjORYZ0. Đối với một video trên Google Drive https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q thì mã nhận dạng là 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q. Để truy cập tệp video trên Google Drive, bạn có thể cần phải thêm khóa tài nguyên vào tiêu đề HTTP cho một tập hợp con các tệp cũ. Để biết thêm thông tin, hãy xem phần Truy cập vào tệp được chia sẻ đường liên kết bằng khoá tài nguyên. |
Tạo yêu cầu biểu đồ trang tính
Tạo biểu đồ trên Google Trang tính được nhúng.
LƯU Ý: Việc tạo biểu đồ yêu cầu ít nhất một trong các bảng tính.chỉ xem, bảng tính, drive.readonly, drive.file hoặc drive OAuth phạm vi.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
Các trường | |
---|---|
objectId
|
Mã đối tượng do người dùng cung cấp. Nếu được chỉ định, ID phải là duy nhất trong số tất cả các trang và phần tử trang trong bản trình bày. ID phải bắt đầu bằng ký tự từ [a-zA-Z0-9_], sau đó là bất kỳ số nào trong các ký tự sau [a-zA-Z0-9_-:]. Độ dài của ID không được nhỏ hơn 5 hoặc lớn hơn 50. Nếu trống, hệ thống sẽ tạo một giá trị nhận dạng duy nhất. |
elementProperties
|
Thuộc tính phần tử cho biểu đồ. Khi tỷ lệ cỡ ảnh của kích thước đã cho không khớp với tỷ lệ cỡ ảnh của biểu đồ, biểu đồ sẽ được điều chỉnh theo tỷ lệ và chính giữa so với kích thước để duy trì tỷ lệ cỡ ảnh. Phép biến đổi đã cho được áp dụng sau thao tác này. |
spreadsheetId
|
Mã của bảng tính Google Trang tính có chứa biểu đồ. Bạn có thể cần thêm khóa tài nguyên vào tiêu đề HTTP cho một số tệp cũ. Để biết thêm thông tin, hãy xem phần Truy cập vào tệp được chia sẻ đường liên kết bằng khoá tài nguyên. |
chartId
|
Mã của biểu đồ cụ thể trong bảng tính Google Trang tính. |
linkingMode
|
Chế độ mà biểu đồ được liên kết với bảng tính nguồn. Khi không được chỉ định, biểu đồ sẽ là một hình ảnh không được liên kết. |
Chế độ liên kết
Chế độ mà biểu đồ được liên kết với bảng tính nguồn.
Enum | |
---|---|
NOT_LINKED_IMAGE
|
Biểu đồ này không liên kết với bảng tính nguồn và không thể cập nhật. Biểu đồ không được liên kết sẽ được chèn dưới dạng hình ảnh. |
LINKED
|
Việc liên kết biểu đồ sẽ cho phép cập nhật biểu đồ và các cộng tác viên khác sẽ thấy liên kết tới bảng tính. |
Tạo dòng yêu cầu
Tạo đường.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
Các trường | |
---|---|
objectId
|
Mã đối tượng do người dùng cung cấp.
Nếu bạn chỉ định ID thì ID đó phải là duy nhất trong số tất cả các trang và phần tử trang trong bản trình bày. Mã này phải bắt đầu bằng một ký tự chữ-số hoặc dấu gạch dưới (khớp với biểu thức chính quy
Nếu bạn không chỉ định ID, ID duy nhất được tạo. |
elementProperties
|
Thuộc tính phần tử cho đường. |
lineCategory
|
Danh mục dòng được tạo.
Không dùng nữa
: sử dụng
Nếu bạn chỉ định cả |
category
|
Danh mục dòng được tạo.
Nếu bạn chỉ định cả
Nếu bạn không chỉ định giá trị cho
Nếu bạn không chỉ định thuộc tính nào, thì |
Category (Danh mục)
Danh mục dòng.
Enum | |
---|---|
STRAIGHT
|
Đường nối thẳng, bao gồm cả đường nối thẳng 1. Đây là danh mục mặc định khi bạn không chỉ định danh mục. |
BENT
|
Các đầu nối uốn cong, bao gồm cả đầu nối uốn cong từ 2 đến 5. |
CURVED
|
Đầu nối cong, bao gồm cả đầu nối cong từ 2 đến 5. |
Làm mới yêu cầu trang tính biểu đồ
Làm mới biểu đồ trên Google Trang tính đã nhúng bằng cách thay thế biểu đồ đó bằng phiên bản mới nhất của biểu đồ trên Google Trang tính.
LƯU Ý: Việc làm mới biểu đồ cần ít nhất một trong các bảng tính.Chỉ xem bảng tính, drive.readonly hoặc phạm vi OAuth của Drive.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string } |
Các trường | |
---|---|
objectId
|
Mã đối tượng của biểu đồ cần làm mới. |
Cập nhật
Cập nhật các thuộc tính của Shape
.
Biểu diễn dưới dạng JSON |
---|
{
"objectId": string,
"shapeProperties": {
object (
|
Các trường | |
---|---|
objectId
|
Mã đối tượng của hình dạng được áp dụng bản cập nhật. |
shapeProperties
|
Thuộc tính hình dạng cần cập nhật. |
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. Gốc
Ví dụ: để cập nhật màu nền đồng nhất của hình dạng, hãy đặt Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó. |
Cập nhậtThuộc tính hình ảnh
Cập nhật các thuộc tính của Image
.
Biểu diễn dưới dạng JSON |
---|
{
"objectId": string,
"imageProperties": {
object (
|
Các trường | |
---|---|
objectId
|
Mã đối tượng của hình ảnh sẽ áp dụng nội dung cập nhật. |
imageProperties
|
Thuộc tính hình ảnh cần cập nhật. |
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. Gốc
Ví dụ: để cập nhật màu viền hình ảnh, hãy đặt Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó. |
Cập nhật thuộc tính video
Cập nhật các thuộc tính của Video
.
Biểu diễn dưới dạng JSON |
---|
{
"objectId": string,
"videoProperties": {
object (
|
Các trường | |
---|---|
objectId
|
Mã đối tượng của video có áp dụng nội dung cập nhật. |
videoProperties
|
Các thuộc tính video cần cập nhật. |
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. Gốc
Ví dụ: để cập nhật màu viền video, hãy đặt Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó. |
Cập nhật các thuộc tính trang yêu cầu
Cập nhật các thuộc tính của một Page
.
Biểu diễn dưới dạng JSON |
---|
{
"objectId": string,
"pageProperties": {
object (
|
Các trường | |
---|---|
objectId
|
Mã đối tượng của trang áp dụng bản cập nhật. |
pageProperties
|
Thuộc tính trang cần cập nhật. |
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. Gốc
Ví dụ: để cập nhật màu nền đồng nhất cho nền trang, hãy đặt Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó. |
Cập nhậtBảngCellPropertiesRequest
Cập nhật các thuộc tính của TableCell
.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string, "tableRange": { object ( |
Các trường | |
---|---|
objectId
|
Mã đối tượng của bảng. |
tableRange
|
Dải ô của bảng thể hiện tập hợp con của bảng sẽ áp dụng nội dung cập nhật. Nếu một dải ô không được chỉ định, các nội dung cập nhật sẽ áp dụng cho toàn bộ bảng. |
tableCellProperties
|
Thuộc tính ô trong bảng cần cập nhật. |
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. Gốc
Ví dụ: để cập nhật màu nền đồng nhất của ô trong bảng, hãy đặt Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó. |
Phạm vi bảng
Dải ô đại diện cho một tham chiếu đến một tập hợp con của bảng.
Điều quan trọng cần lưu ý là các ô được chỉ định bởi phạm vi bảng không nhất thiết phải tạo thành hình chữ nhật. Ví dụ: giả sử chúng ta có một bảng 3 x 3 trong đó tất cả các ô của hàng cuối cùng được hợp nhất với nhau. Bảng sẽ có dạng như sau:
[ ][ ][ ]
[ ][ ][ ]
[ ]
Dải ô bảng có vị trí = (0, 0), khoảng hàng = 3 và khoảng cột = 2 chỉ định các ô sau:
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
Biểu diễn dưới dạng JSON |
---|
{
"location": {
object (
|
Các trường | |
---|---|
location
|
Vị trí bắt đầu của dải ô bảng. |
rowSpan
|
Khoảng hàng của dải ô bảng. |
columnSpan
|
Nhịp cột của dải ô bảng. |
Cập nhật Dòng yêu cầu Thuộc tính
Cập nhật các thuộc tính của một Line
.
Biểu diễn dưới dạng JSON |
---|
{
"objectId": string,
"lineProperties": {
object (
|
Các trường | |
---|---|
objectId
|
Mã đối tượng của dòng mà thông tin cập nhật được áp dụng. |
lineProperties
|
Thuộc tính dòng cần cập nhật. |
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. Gốc
Ví dụ: để cập nhật màu đồng nhất của dòng, hãy đặt Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó. |
Tạo Đoạn nội dung Dấu đầu dòng Yêu cầu
Tạo dấu đầu dòng cho tất cả các đoạn chồng chéo với dải chỉ mục văn bản đã cho.
Mức lồng ghép của từng đoạn văn sẽ được xác định bằng cách đếm số thẻ đứng trước mỗi đoạn. Để tránh thừa dấu cách giữa dấu đầu dòng và đoạn văn tương ứng, những thẻ đang ở đầu này sẽ bị xoá theo yêu cầu này. Thao tác này có thể thay đổi chỉ mục của các phần văn bản.
Nếu đoạn ngay trước khi các đoạn được cập nhật nằm trong danh sách có giá trị đặt trước phù hợp thì đoạn đó sẽ được thêm vào danh sách trước đó.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
Các trường | |
---|---|
objectId
|
Mã đối tượng của hình dạng hoặc bảng chứa văn bản để thêm dấu đầu dòng. |
cellLocation
|
Vị trí ô bảng tùy chọn nếu văn bản cần sửa đổi nằm trong ô bảng. Nếu có, ID đối tượng phải tham chiếu đến một bảng. |
textRange
|
Phạm vi văn bản áp dụng các giá trị đặt trước đầu dòng, dựa trên chỉ mục |
bulletPreset
|
Các loại ký tự dấu đầu dòng được sử dụng. Giá trị mặc định là giá trị đặt trước |
Đặt lại BulletGlyph
Mẫu đặt sẵn của dấu đầu dòng cho danh sách trong văn bản.
Các mẫu này sử dụng những loại dấu đầu dòng sau:
-
ARROW
: Mũi tên, tương ứng với điểm mã Unicode U+2794 -
ARROW3D
: Mũi tên có tính năng tô bóng 3D, tương ứng với điểm mã Unicode U+27a2 -
CHECKBOX
: Một hình vuông rỗng, tương ứng với một điểm mã Unicode U+274f -
CIRCLE
: Một hình tròn rỗng, tương ứng với một điểm mã Unicode U+25cb -
DIAMOND
: Hình thoi đặc, tương ứng với điểm mã Unicode U+25c6 -
DIAMONDX
: Hình thoi có dấu 'x', tương ứng với điểm mã Unicode U+2756 -
HOLLOWDIAMOND
: Một hình thoi rỗng, tương ứng với một điểm mã Unicode U+25c7 -
DISC
: Một hình tròn đặc, tương ứng với một điểm mã Unicode U+25cf -
SQUARE
: Một hình vuông vững chắc, tương ứng với một điểm mã Unicode U+25a0 -
STAR
: Một dấu sao, tương ứng với một điểm mã Unicode U+2605 -
ALPHA
: Chữ cái viết thường, như 'a', 'b' hoặc 'c'. -
UPPERALPHA
: Một chữ cái viết hoa, như 'A', 'B' hoặc 'C'. -
DIGIT
: Một số, chẳng hạn như '1', '2' hoặc '3'. -
ZERODIGIT
: Một số có số đơn vị ở đầu số 0, chẳng hạn như '01', '02' hoặc '03'. Các số có nhiều hơn một chữ số không được bắt đầu bằng số 0. -
ROMAN
: Chữ số la mã viết thường, như 'i', 'ii' hoặc 'iii'. -
UPPERROMAN
: Chữ số la mã viết hoa, như 'I', 'II' hoặc 'III'. -
LEFTTRIANGLE
: Hình tam giác trỏ sang trái, tương ứng với một điểm mã Unicode U+25c4
Enum | |
---|---|
BULLET_DISC_CIRCLE_SQUARE
|
Danh sách có dấu đầu dòng gồm
DISC ,
CIRCLE
và
SQUARE
ký tự dấu đầu dòng cho 3 cấp lồng danh sách đầu tiên.
|
BULLET_DIAMONDX_ARROW3D_SQUARE
|
Danh sách có dấu đầu dòng gồm
DIAMONDX ,
ARROW3D
và
SQUARE
ký tự dấu đầu dòng cho 3 cấp lồng danh sách đầu tiên.
|
BULLET_CHECKBOX
|
Một danh sách có dấu đầu dòng gồm
CHECKBOX
ký tự dấu đầu dòng cho mọi cấp lồng ghép danh sách.
|
BULLET_ARROW_DIAMOND_DISC
|
Danh sách có dấu đầu dòng gồm
ARROW ,
DIAMOND
và
DISC
ký tự dấu đầu dòng cho 3 cấp lồng danh sách đầu tiên.
|
BULLET_STAR_CIRCLE_SQUARE
|
Danh sách có dấu đầu dòng gồm
STAR ,
CIRCLE
và
SQUARE
ký tự dấu đầu dòng cho 3 cấp lồng danh sách đầu tiên.
|
BULLET_ARROW3D_CIRCLE_SQUARE
|
Danh sách có dấu đầu dòng gồm
ARROW3D ,
CIRCLE
và
SQUARE
ký tự dấu đầu dòng cho 3 cấp lồng danh sách đầu tiên.
|
BULLET_LEFTTRIANGLE_DIAMOND_DISC
|
Danh sách có dấu đầu dòng gồm
LEFTTRIANGLE ,
DIAMOND
và
DISC
ký tự dấu đầu dòng cho 3 cấp lồng danh sách đầu tiên.
|
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE
|
Danh sách có dấu đầu dòng gồm
DIAMONDX ,
HOLLOWDIAMOND
và
SQUARE
ký tự dấu đầu dòng cho 3 cấp lồng danh sách đầu tiên.
|
BULLET_DIAMOND_CIRCLE_SQUARE
|
Danh sách có dấu đầu dòng gồm
DIAMOND ,
CIRCLE
và
SQUARE
ký tự dấu đầu dòng cho 3 cấp lồng danh sách đầu tiên.
|
NUMBERED_DIGIT_ALPHA_ROMAN
|
Danh sách được đánh số gồm DIGIT , ALPHA và các ký tự ROMAN dưới dạng số cho 3 cấp độ lồng danh sách đầu tiên, theo sau là dấu chấm câu.
|
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS
|
Danh sách được đánh số với các ký tự số DIGIT , ALPHA và ROMAN cho 3 cấp độ danh sách đầu tiên trong lồng, theo sau là dấu ngoặc đơn.
|
NUMBERED_DIGIT_NESTED
|
Danh sách được đánh số với các ký tự số dạng DIGIT được phân tách bằng dấu chấm, trong đó mỗi cấp lồng ghép sử dụng ký tự của cấp độ lồng trước đó làm tiền tố. Ví dụ: '1.', '1.1.', '2.', "2.2.".
|
NUMBERED_UPPERALPHA_ALPHA_ROMAN
|
Danh sách được đánh số gồm UPPERALPHA , ALPHA và các ký tự ROMAN dưới dạng số cho 3 cấp độ lồng danh sách đầu tiên, theo sau là dấu chấm câu.
|
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT
|
Danh sách được đánh số gồm UPPERROMAN , UPPERALPHA và các ký tự DIGIT dưới dạng số cho 3 cấp độ lồng danh sách đầu tiên, theo sau là dấu chấm câu.
|
NUMBERED_ZERODIGIT_ALPHA_ROMAN
|
Danh sách được đánh số gồm ZERODIGIT , ALPHA và các ký tự ROMAN dưới dạng số cho 3 cấp độ lồng danh sách đầu tiên, theo sau là dấu chấm câu.
|
Thay thế tất cả hình dạng bằng yêu cầu hình ảnh
Thay thế tất cả các hình dạng khớp với tiêu chí đã cho bằng hình ảnh được cung cấp.
Hình ảnh thay thế cho hình dạng có hình chữ nhật sau khi được chèn vào bản trình bày và không có dạng hình dạng.
Biểu diễn dưới dạng JSON |
---|
{ "replaceMethod": enum ( |
Các trường | |
---|---|
replaceMethod
|
Phương thức thay thế.
Không dùng nữa
: sử dụng
Nếu bạn chỉ định cả |
imageReplaceMethod
|
Phương thức thay thế hình ảnh.
Nếu bạn chỉ định cả
Nếu bạn không chỉ định giá trị cho Nếu bạn không chỉ định, khi đó CENTER_INSIDE sẽ được sử dụng. |
pageObjectIds[]
|
Nếu không trống, hãy giới hạn các kết quả phù hợp thành các phần tử trang chỉ trên các trang nhất định.
Trả về lỗi yêu cầu 400 không hợp lệ nếu mã đối tượng của trang là |
Trường nhóm criteria . Tiêu chí mà hình dạng phải phù hợp để được thay thế.
criteria chỉ có thể là một trong những loại sau đây:
|
|
containsText
|
Nếu được đặt, yêu cầu này sẽ thay thế tất cả các hình dạng có chứa văn bản đã cho. |
Trường nhóm image_source . Loại nguồn hình ảnh.
image_source chỉ có thể là một trong những loại sau đây:
|
|
imageUrl
|
URL hình ảnh. Hình ảnh được tìm nạp một lần tại thời điểm chèn và bản sao được lưu trữ để hiển thị bên trong bản trình bày. Hình ảnh phải có kích thước nhỏ hơn 50 MB, không được vượt quá 25 megapixel và phải ở một trong các định dạng PNG, JPEG hoặc GIF.
URL được cung cấp có thể dài tối đa 2 kB. Bản thân URL đó được lưu cùng với hình ảnh và hiển thị qua trường |
Phương thức thay thế
Phương thức thay thế.
Enum | |
---|---|
CENTER_INSIDE
|
Điều chỉnh và căn giữa hình ảnh để vừa với ranh giới của hình dạng ban đầu và duy trì tỷ lệ co của hình ảnh. Kích thước hình ảnh được hiển thị có thể nhỏ hơn kích thước của hình dạng. Đây là phương thức mặc định khi không chỉ định phương pháp. |
CENTER_CROP
|
Chia tỷ lệ và căn giữa hình ảnh để lấp đầy ranh giới của hình dạng ban đầu. Hình ảnh có thể bị cắt để lấp đầy hình. Kích thước được hiển thị của hình ảnh sẽ giống với kích thước của hình dạng ban đầu. |
Phương thức thay thế hình ảnh.
Enum | |
---|---|
IMAGE_REPLACE_METHOD_UNSPECIFIED
|
Phương thức thay thế hình ảnh không xác định. Không được sử dụng giá trị này. |
CENTER_INSIDE
|
Điều chỉnh và căn giữa hình ảnh để vừa với ranh giới của hình dạng ban đầu và duy trì tỷ lệ co của hình ảnh. Kích thước hình ảnh được hiển thị có thể nhỏ hơn kích thước của hình dạng. Đây là phương thức mặc định khi không chỉ định phương pháp. |
CENTER_CROP
|
Chia tỷ lệ và căn giữa hình ảnh để lấp đầy ranh giới của hình dạng ban đầu. Hình ảnh có thể bị cắt để lấp đầy hình. Kích thước được hiển thị của hình ảnh sẽ giống với hình dạng ban đầu. |
Yêu cầu đối tượng trùng lặp
Sao y trang trình bày hoặc phần tử trang.
Khi nhân bản trang trình bày, trang trình bày trùng lặp sẽ được tạo ngay sau trang trình bày được chỉ định. Khi sao y một phần tử trang, trang trùng lặp sẽ được đặt trên cùng một trang ở cùng vị trí với trang gốc.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string, "objectIds": { string: string, ... } } |
Các trường | |
---|---|
objectId
|
Mã của đối tượng cần sao chép. |
objectIds
|
Đối tượng được sao chép có thể chứa các đối tượng khác, ví dụ như khi sao chép trang trình bày hoặc phần tử trang nhóm. Bản đồ này xác định cách tạo ID của các đối tượng trùng lặp: khóa là ID của đối tượng gốc và giá trị của đối tượng đó là ID sẽ được chỉ định cho đối tượng trùng lặp tương ứng. Mã nhận dạng trùng lặp của đối tượng nguồn cũng có thể được chỉ định trong bản đồ này, sử dụng cùng một giá trị của trường
Tất cả các khóa phải tương ứng với ID hiện có trong bản trình bày. Tất cả giá trị phải là duy nhất trong bản trình bày và phải bắt đầu bằng một ký tự chữ và số hoặc dấu gạch dưới (khớp với biểu thức chính quy Nếu bất kỳ ID đối tượng nguồn nào bị bỏ qua khỏi bản đồ, một ID ngẫu nhiên mới sẽ được chỉ định. Nếu bản đồ trống hoặc không được đặt, tất cả các đối tượng trùng lặp sẽ nhận được một ID ngẫu nhiên mới. |
UpdateTextStyleRequest
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
Các trường | |
---|---|
objectId
|
ID đối tượng của hình dạng hoặc bảng có văn bản cần được tạo kiểu. |
cellLocation
|
Vị trí của ô trong bảng chứa văn bản cần định kiểu. Nếu |
style
|
(Các) kiểu để đặt trên văn bản. Nếu giá trị của một kiểu cụ thể khớp với kiểu gốc, thì kiểu đó sẽ được đặt thành kế thừa.
Một số thay đổi về kiểu văn bản có thể gây ra các thay đổi khác nhằm phản ánh hành vi của trình chỉnh sửa Trang trình bày. Hãy xem tài liệu về |
textRange
|
Phạm vi văn bản để tạo kiểu. Dải ô có thể được mở rộng để bao gồm các dòng mới liền kề. Nếu dải ô chứa hoàn toàn một đoạn thuộc danh sách, thì dấu đầu dòng của đoạn đó cũng được cập nhật bằng kiểu văn bản phù hợp. |
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. Gốc
Ví dụ: để cập nhật kiểu chữ thành in đậm, hãy đặt Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó. |
Thay thế tất cả các hình dạng bằng yêu cầu trang tính biểu đồ
Thay thế tất cả các hình dạng khớp với tiêu chí đã cho bằng biểu đồ trong Google Trang tính cho sẵn. Biểu đồ sẽ được thu nhỏ và căn giữa để vừa với ranh giới của hình dạng ban đầu.
LƯU Ý: Để thay thế hình bằng biểu đồ, bạn cần có ít nhất một trong các bảng tính.chỉ đọc, bảng tính, drive.readonly hoặc Drive phạm vi OAuth.
Biểu diễn dưới dạng JSON |
---|
{ "containsText": { object ( |
Các trường | |
---|---|
containsText
|
Tiêu chí mà hình dạng phải phù hợp để được thay thế. Yêu cầu này sẽ thay thế tất cả các hình dạng có chứa văn bản đã cho. |
spreadsheetId
|
Mã của bảng tính Google Trang tính có chứa biểu đồ. |
chartId
|
Mã của biểu đồ cụ thể trong bảng tính Google Trang tính. |
linkingMode
|
Chế độ mà biểu đồ được liên kết với bảng tính nguồn. Khi không được chỉ định, biểu đồ sẽ là một hình ảnh không được liên kết. |
pageObjectIds[]
|
Nếu không trống, hãy giới hạn các kết quả phù hợp thành các phần tử trang chỉ trên các trang nhất định.
Trả về lỗi yêu cầu 400 không hợp lệ nếu mã đối tượng của trang là |
Chế độ liên kết
Chế độ mà biểu đồ được liên kết với bảng tính nguồn.
Enum | |
---|---|
NOT_LINKED_IMAGE
|
Biểu đồ này không liên kết với bảng tính nguồn và không thể cập nhật. Biểu đồ không được liên kết sẽ được chèn dưới dạng hình ảnh. |
LINKED
|
Việc liên kết biểu đồ sẽ cho phép cập nhật biểu đồ và các cộng tác viên khác sẽ thấy liên kết tới bảng tính. |
Yêu cầu Xóa Đoạn Dấu đầu dòng
Xoá dấu đầu dòng khỏi mọi đoạn văn trùng lặp với chỉ mục văn bản đã cho range
.
Mức lồng ghép của mỗi đoạn văn sẽ được duy trì trực quan bằng cách thêm thụt lề vào đầu đoạn tương ứng.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
Các trường | |
---|---|
objectId
|
Mã đối tượng của hình dạng hoặc bảng chứa văn bản dùng để xoá dấu đầu dòng. |
cellLocation
|
Vị trí ô bảng tùy chọn nếu văn bản cần sửa đổi nằm trong ô bảng. Nếu có, ID đối tượng phải tham chiếu đến một bảng. |
textRange
|
Phạm vi văn bản cần xoá dấu đầu dòng dựa trên chỉ mục của |
Cập nhậtStyleStyleRequest
Cập nhật kiểu cho tất cả các đoạn trong
Shape
hoặc
Table
chồng chéo với dải chỉ mục văn bản đã cho.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
Các trường | |
---|---|
objectId
|
ID đối tượng của hình dạng hoặc bảng có văn bản cần được tạo kiểu. |
cellLocation
|
Vị trí của ô trong bảng chứa(các) đoạn cần tạo kiểu. Nếu |
style
|
Kiểu của đoạn. |
textRange
|
Dải văn bản chứa(các) đoạn văn để tạo kiểu. |
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. Gốc
Ví dụ: để cập nhật căn chỉnh đoạn, hãy đặt Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó. |
UpdateTableBorderPropertiesRequest
Cập nhật các thuộc tính của đường viền bảng trong Table
.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string, "tableRange": { object ( |
Các trường | |
---|---|
objectId
|
Mã đối tượng của bảng. |
tableRange
|
Dải ô của bảng thể hiện tập hợp con của bảng sẽ áp dụng nội dung cập nhật. Nếu một dải ô không được chỉ định, các nội dung cập nhật sẽ áp dụng cho toàn bộ bảng. |
borderPosition
|
Vị trí đường viền trong dải ô mà nội dung cập nhật sẽ áp dụng. Nếu vị trí đường viền không được chỉ định, các nội dung cập nhật sẽ áp dụng cho tất cả đường viền trong dải ô của bảng. |
tableBorderProperties
|
Thuộc tính đường viền bảng cần cập nhật. |
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. Gốc
Ví dụ: để cập nhật màu nền đồng nhất của đường viền bảng, hãy đặt Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó. |
Vị trí đường viền
Vị trí đường viền bảng.
Enum | |
---|---|
ALL
|
Tất cả đường viền trong dải. |
BOTTOM
|
Đường viền ở cuối dải ô. |
INNER
|
Đường viền bên trong dải. |
INNER_HORIZONTAL
|
Đường viền ngang ở bên trong dải ô. |
INNER_VERTICAL
|
Đường viền dọc ở bên trong dải ô. |
LEFT
|
Đường viền ở bên trái của dải. |
OUTER
|
Đường viền dọc bên ngoài dải. |
RIGHT
|
Đường viền ở bên phải dải ô. |
TOP
|
Đường viền ở đầu dải. |
UpdateTableColumnPropertiesRequest
Cập nhật các thuộc tính của cột Table
.
Biểu diễn dưới dạng JSON |
---|
{
"objectId": string,
"columnIndices": [
integer
],
"tableColumnProperties": {
object (
|
Các trường | |
---|---|
objectId
|
Mã đối tượng của bảng. |
columnIndices[]
|
Danh sách chỉ mục dựa trên 0 chỉ định cột nào cần cập nhật. Nếu bạn không cung cấp chỉ mục nào, tất cả các cột trong bảng sẽ được cập nhật. |
tableColumnProperties
|
Các thuộc tính cột của bảng cần cập nhật.
Nếu giá trị của |
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. Gốc
Ví dụ: để cập nhật chiều rộng cột, hãy đặt Nếu '"columnWidth"' được bao gồm trong mặt nạ trường nhưng thuộc tính không được đặt, chiều rộng cột sẽ mặc định là 406.400 EMU (32 điểm). |
UpdateTableRowPropertiesRequest
Cập nhật các thuộc tính của một hàng Table
.
Biểu diễn dưới dạng JSON |
---|
{
"objectId": string,
"rowIndices": [
integer
],
"tableRowProperties": {
object (
|
Các trường | |
---|---|
objectId
|
Mã đối tượng của bảng. |
rowIndices[]
|
Danh sách chỉ mục dựa trên 0 chỉ định hàng nào cần cập nhật. Nếu không có chỉ mục nào được cung cấp, tất cả các hàng trong bảng sẽ được cập nhật. |
tableRowProperties
|
Các thuộc tính của hàng trong bảng cần cập nhật. |
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. Gốc
Ví dụ: để cập nhật chiều cao tối thiểu của hàng, hãy đặt Nếu '"minRowHeight"' được bao gồm trong mặt nạ trường nhưng thuộc tính không được đặt, chiều cao hàng tối thiểu sẽ mặc định là 0. |
MergeTableCellsRequest
Hợp nhất các ô trong một Table
.
Biểu diễn dưới dạng JSON |
---|
{
"objectId": string,
"tableRange": {
object (
|
Các trường | |
---|---|
objectId
|
Mã đối tượng của bảng. |
tableRange
|
Dải ô bảng chỉ định các ô trong bảng cần hợp nhất. Bất kỳ văn bản nào trong các ô đang được hợp nhất đều sẽ được nối và lưu trữ trong ô phía trên bên trái ("đầu") của dải ô. Nếu dải ô không phải là hình chữ nhật (có thể xảy ra trong một số trường hợp dải ô che phủ các ô đã được hợp nhất), lỗi yêu cầu 400 sẽ được trả về. |
Hủy hợp nhất bảngCell
Hủy hợp nhất các ô trong Table
.
Biểu diễn dưới dạng JSON |
---|
{
"objectId": string,
"tableRange": {
object (
|
Các trường | |
---|---|
objectId
|
Mã đối tượng của bảng. |
tableRange
|
Dải ô bảng chỉ định các ô trong bảng cần hủy hợp nhất. Tất cả các ô đã hợp nhất trong dải ô này sẽ không được hợp nhất và các ô đã được hủy hợp nhất sẽ không bị ảnh hưởng. Nếu dải ô không có ô nào được hợp nhất, thì yêu cầu sẽ không thực hiện hành động nào. Nếu có văn bản trong bất kỳ ô đã hợp nhất nào, văn bản sẽ vẫn nằm trong ô phía trên bên trái ("đầu") của khối kết hợp gồm các ô chưa được hợp nhất. |
Yêu cầu nhóm đối tượng
Nhóm các đối tượng để tạo một nhóm đối tượng. Ví dụ: các nhóm PageElements
sẽ tạo một Group
trên cùng một trang với tất cả các phần tử con.
Biểu diễn dưới dạng JSON |
---|
{ "groupObjectId": string, "childrenObjectIds": [ string ] } |
Các trường | |
---|---|
groupObjectId
|
ID đối tượng do người dùng cung cấp cho nhóm sẽ được tạo.
Nếu bạn chỉ định ID thì ID đó phải là duy nhất trong số tất cả các trang và phần tử trang trong bản trình bày. Mã này phải bắt đầu bằng một ký tự chữ-số hoặc dấu gạch dưới (khớp với biểu thức chính quy
Nếu bạn không chỉ định ID, ID duy nhất được tạo. |
childrenObjectIds[]
|
ID đối tượng của các đối tượng để nhóm.
Chỉ có thể nhóm các phần tử trang. Phải có ít nhất hai phần tử trang trên cùng một trang chưa có trong một nhóm khác. Bạn không thể nhóm một số phần tử trang, chẳng hạn như |
Yêu cầu đối tượng không theo nhóm
Tách các đối tượng, chẳng hạn như groups
.
Biểu diễn dưới dạng JSON |
---|
{ "objectIds": [ string ] } |
Các trường | |
---|---|
objectIds[]
|
ID đối tượng của các đối tượng để tách.
Chỉ có thể tách nhóm |
UpdatePageElementAltTextRequest
Cập nhật tiêu đề văn bản thay thế và/hoặc nội dung mô tả về một page element
.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string, "title": string, "description": string } |
Các trường | |
---|---|
objectId
|
Mã đối tượng của phần tử trang áp dụng bản cập nhật. |
title
|
Tiêu đề văn bản thay thế mới của phần tử trang. Nếu bạn không đặt thì giá trị hiện tại sẽ vẫn được giữ nguyên. Người đọc màn hình và các giao diện hỗ trợ tiếp cận khác sẽ nhìn thấy tiêu đề này. Chỉ sử dụng các giá trị dễ đọc liên quan đến nội dung phần tử trang. |
description
|
Mô tả cập nhật văn bản thay thế của phần tử trang. Nếu bạn không đặt thì giá trị hiện tại sẽ vẫn được giữ nguyên. Phần mô tả sẽ hiển thị với trình đọc màn hình và các giao diện hỗ trợ tiếp cận khác. Chỉ sử dụng các giá trị dễ đọc liên quan đến nội dung phần tử trang. |
Thay thế yêu cầu hình ảnh
Thay thế hình ảnh hiện tại bằng hình ảnh mới.
Việc thay thế hình ảnh sẽ xoá một số
image effects
khỏi hình ảnh hiện có.
Biểu diễn dưới dạng JSON |
---|
{ "imageObjectId": string, "imageReplaceMethod": enum ( |
Các trường | |
---|---|
imageObjectId
|
Mã của hình ảnh hiện có sẽ được thay thế. Mã nhận dạng có thể được truy xuất từ phản hồi của yêu cầu nhận. |
imageReplaceMethod
|
Phương thức thay thế. |
Trường nhóm image_source . Loại nguồn hình ảnh.
image_source chỉ có thể là một trong những loại sau đây:
|
|
url
|
URL hình ảnh. Hình ảnh được tìm nạp một lần tại thời điểm chèn và bản sao được lưu trữ để hiển thị bên trong bản trình bày. Hình ảnh phải nhỏ hơn 50 MB, không được vượt quá 25 megapixel và phải ở định dạng PNG, JPEG hoặc GIF.
URL được cung cấp không được dài quá 2 KB. URL này được lưu cùng với hình ảnh và hiển thị thông qua trường |
Cập nhật
Cập nhật các thuộc tính của một Trang trình bày.
Biểu diễn dưới dạng JSON |
---|
{
"objectId": string,
"slideProperties": {
object (
|
Các trường | |
---|---|
objectId
|
Mã đối tượng của trang trình bày mà bạn áp dụng bản cập nhật. |
slideProperties
|
Các thuộc tính của trang trình bày cần cập nhật. |
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. 'slideProperties' gốc được ngụ ý và không được chỉ định. Bạn có thể sử dụng một
Ví dụ: để cập nhật liệu một trang trình bày có bị bỏ qua hay không, hãy đặt Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó. |
UpdatePageElementsZOrderRequest
Cập nhật thứ tự Z của các phần tử trang. Thứ tự Z là thứ tự các phần tử trên trang từ sau ra trước. Phần tử trang ở phía trước có thể bao gồm các phần tử đằng sau.
Biểu diễn dưới dạng JSON |
---|
{
"pageElementObjectIds": [
string
],
"operation": enum (
|
Các trường | |
---|---|
pageElementObjectIds[]
|
ID đối tượng của các phần tử trang cần cập nhật. Tất cả các phần tử trang phải ở trên cùng một trang và không được nhóm lại. |
operation
|
Phép toán theo thứ tự Z để áp dụng cho các phần tử của trang. Khi áp dụng thao tác trên nhiều phần tử trang, các thứ tự Z tương đối trong các phần tử trang này trước khi duy trì thao tác. |
ZOrderOperation
Thao tác cập nhật thứ tự Z của một phần tử trang.
Enum | |
---|---|
Z_ORDER_OPERATION_UNSPECIFIED
|
Thao tác không xác định. |
BRING_TO_FRONT
|
Đưa các phần tử trang lên trước trang. |
BRING_FORWARD
|
Đưa các phần tử trang tiến lên trên một trang bởi một phần tử tương ứng với phần tử tiến trong các phần tử trang được chỉ định. |
SEND_BACKWARD
|
Đưa các phần tử trang lùi lại một trang trong một phần tử được chỉ định. |
SEND_TO_BACK
|
Đưa phần tử trang vào mặt sau của trang. |
Cập nhật Dòng yêu cầu
Cập nhật danh mục của một line
.
Biểu diễn dưới dạng JSON |
---|
{
"objectId": string,
"lineCategory": enum (
|
Các trường | |
---|---|
objectId
|
Mã đối tượng của dòng mà thông tin cập nhật được áp dụng.
Bạn chỉ có thể cập nhật một dòng có Dòng này có thể được định tuyến lại sau khi bạn cập nhật danh mục. |
lineCategory
|
Danh mục dòng để cập nhật.
|
Yêu cầu định tuyến lại
Định tuyến lại line
sao cho nó được kết nối tại hai trang web kết nối gần nhất trên các phần tử của trang được kết nối.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string } |
Các trường | |
---|---|
objectId
|
Mã đối tượng của dòng cần định tuyến lại.
Bạn chỉ có thể định tuyến lại một dòng có
|