API Google Trang trình bày cho phép bạn đọc bản trình bày, trang và dữ liệu phần tử trang. Ví dụ trên trang này cho biết 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
.
Những ví dụ này sử dụng các phần giữ chỗ sau:
- PRESENTATION_ID – Cho biết vị trí 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 của bản trình bày.
- PAGE_ID – Cho biết vị trí bạn cung cấp mã đối tượng trang. Bạn có thể truy xuất giá trị cho URL này từ URL hoặc bằng cách sử dụng yêu cầu đọc API.
Những ví dụ này được trình bày dưới dạng yêu cầu HTTP nhằm đảm bảo trung lập về ngôn ngữ. Các ví dụ được đọc từ bản trình bày mẫu này, trong đó có 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc
là 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 cải thiện hiệu suất.
Đọc mã đối tượng trang trình bày
Mã mẫu presentations.get
sau đây cho biết cách truy xuất danh sách tất cả mã đối tượng trang trình bày trong bản trình bày. Mã nhận dạng được trả về theo thứ tự bản trình bày và có thể dùng để biểu thị 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ã đối tượng của trang chính và trang bố cục theo cách như nhau, sử dụng fields=masters.objectId
và fields=layout.objectId
.
Sau đây là giao thức yêu cầu đọc mã đố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 đối tượng Presentation
chứa các mã đố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ã đối tượng của phần tử trên một trang
Mã mẫu presentations.pages.get
sau đây cho biết cách truy xuất danh sách mã đối tượng cho tất cả phần tử trang trên một trang.
Sau đây là giao thức yêu cầu đọc mã đối tượng phần tử trên 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 đối tượng Page
chứa mã đố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 presentations.pages.get
sau đây 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 PageElement
khác bằng cách chỉ định chúng bằng tham số fields
. Ví dụ: fields=pageElements(line,table)
chỉ trả về thông tin về các phần tử trang line
và table
, 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 trên 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 đối tượng Page
chứa các phần tử hình dạng được yêu cầu. Dấu ngoặc trố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, chúng 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 } } } ] } } }, ... ] }