API Google Trang trình bày cho phép bạn đọc dữ liệu về bản trình bày, trang và phần tử trang. Các ví dụ trên trang này cho thấy cách thực hiện các thao tác đọc phổ biến bằng cả phương thức presentations.get và presentations.pages.get.
Các ví dụ này sử dụng các trình giữ chỗ sau:
- PRESENTATION_ID – Cho biết nơi bạn cung cấp mã nhận dạng bản trình bày. Bạn có thể khám phá giá trị cho mã nhận dạng này từ URL bản trình bày.
- PAGE_ID – Cho biết nơi bạn cung cấp mã nhận dạng đối tượng trang. Bạn có thể truy xuất giá trị cho mã nhận dạng này từ URL hoặc bằng cách sử dụng yêu cầu đọc API.
Các ví dụ này được trình bày dưới dạng yêu cầu HTTP để không phụ thuộc vào ngôn ngữ. Các ví dụ đọc từ bản trình bày mẫu, này có 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc làm PRESENTATION_ID. PAGE_ID của
trang trình bày
đầu tiên
trong bản trình bày này là ge63a4b4_1_0.
Các ví dụ ở đây sử dụng mặt nạ trường để chỉ trả về thông tin cụ thể được yêu cầu về bản trình bày, trang trình bày và phần tử trang. Việc sử dụng mặt nạ trường cũng giúp cải thiện hiệu suất.
Đọc mã nhận dạng đối tượng trang trình bày
Mẫu mã
presentations.get sau đây cho biết cách truy xuất danh sách tất cả mã nhận dạng đối tượng trang trình bày từ bản trình bày. Các mã nhận dạng được trả về theo thứ tự trình bày trang trình bày và có thể dùng để cho biết các trang trình bày cụ thể trong các yêu cầu API tiếp theo. Bạn có thể lấy mã nhận dạng đối tượng của các trang chính và trang bố cục theo cùng một cách, bằng cách sử dụng fields=masters.objectId và fields=layout.objectId.
Sau đây là giao thức yêu cầu để đọc mã nhận dạng đối tượng trang trình bày:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId
Phản hồi bao gồm một
Presentation
đối tượng chứa các mã nhận dạng đối tượng được yêu cầu:
{
"slides": [
{
"objectId": "ge63a4b4_1_0"
},
{
"objectId": "ge63a4b4_1_9"
},
{
"objectId": "ge63a4b4_1_23"
},
{
"objectId": "ge63a4b4_1_35"
},
{
"objectId": "ge63a4b4_1_43"
}
]
}Đọc mã nhận dạng đối tượng phần tử từ một trang
Mã mẫu sau đây
presentations.pages.get
cho biết cách truy xuất danh sách mã nhận dạng đối tượng cho tất cả các phần tử trang
trên một trang.
Sau đây là giao thức yêu cầu để đọc mã nhận dạng đối tượng phần tử từ một trang:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.objectId
Phản hồi bao gồm một
Page đối tượng
chứa các mã nhận dạng đối tượng được yêu cầu:
{
"pageElements": [
{
"objectId": "ge63a4b4_1_5"
},
{
"objectId": "ge63a4b4_1_6"
},
{
"objectId": "ge63a4b4_1_7"
},
{
"objectId": "ge63a4b4_1_8"
}
]
}Đọc các phần tử hình dạng từ một trang
Mã mẫu sau đây
presentations.pages.get
cho biết cách truy xuất danh sách tất cả
Shapes
trên một trang. Bạn có thể truy xuất các loại khác
PageElement
bằng cách chỉ định các loại đó bằng tham số fields. Ví dụ:
fields=pageElements(line,table) chỉ trả về thông tin về
line và
table
phần tử trang (nếu có trên trang).
Sau đây là giao thức yêu cầu để đọc các phần tử hình dạng từ một trang:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.shape
Phản hồi bao gồm một
Page đối tượng
chứa các phần tử hình dạng được yêu cầu. Dấu ngoặc nhọn rỗng cho biết các phần tử trang không thuộc loại hình dạng; trong trường hợp này, đó là các phần tử trang hình ảnh.
{ "pageElements": [ {}, {}, { "shape": { "shapeProperties" { "outline" { "dashStyle": "SOLID", "outlineFill": { "solidFill": { "alpha": 1, "color": { "rgbColor": {} } }, }, "propertyState": "NOT_RENDERED", "weight": { "magnitude": 9525, "unit": "EMU" } }, "shadow": { "alignment": "BOTTOM_LEFT", "alpha": 1, "blurRadius": { "unit": "EMU" }, "color": { "rgbColor": {} }, "propertyState": "NOT_RENDERED", "rotateWithShape": false, "transform": { "scaleX": 1, "scaleY": 1, "unit": "EMU" }, "type": "OUTER" }, "shapeBackgroundFill" : { "propertyState": "NOT_RENDERED", "solidFill": { "alpha": 1, "color": { "rgbColor: { "blue": 1, "green": 1, "red": 1 } } } } }, "shapeType": "TEXT_BOX", "text": { "textElements": [ { "endIndex": 11, "paragraphMarker": { "style": { "alignment": "START", "direction": "LEFT_TO_RIGHT", "indentEnd": { "unit": "PT" }, "indentFirstLine": { "unit": "PT" }, "indentStart": { "unit": "PT" }, "lineSpacing": 100, "spaceAbove": { "unit": "PT" }, "spaceBelow": { "unit": "PT" }, "spacingMode": "COLLAPSE_LISTS" } } }, { "endIndex": 11, "textRun": { "content": "Baby Album\n", "style": { "backgroundColor": {}, "baselineOffset": "NONE", "bold": false, "fontFamily": "Arial", "fontSize": { "magnitude": 14, "unit": "PT" }, "foregroundColor": { "opaqueColor": { "rgbColor": {} } }, "italic": false, "smallCaps": false, "strikethrough": false, "underline": false } } } ] } } }, ... ] }