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 phần 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ị của mã nhận dạng này qua URL của bản trình bày.
- PAGE_ID – Cho biết nơi bạn cung cấp mã đối tượng trang. Bạn có thể truy xuất giá trị cho truy vấn 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 để trung lập về ngôn ngữ. Các ví dụ được đọc từ bản trình bày ví dụ này, 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
.
Những 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ạ cho trường (field mask) cũng giúp cải thiện hiệu suất.
Đọc mã đối tượng của 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 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 để 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 tương tự, 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ã đối tượng của 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 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ả cá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 của 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 đã yêu cầu:
{ "pageElements": [ { "objectId": "ge63a4b4_1_5" }, { "objectId": "ge63a4b4_1_6" }, { "objectId": "ge63a4b4_1_7" }, { "objectId": "ge63a4b4_1_8" } ] }
Đọc các thành phần 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 cách sử dụ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 thành phần 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 đã 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, đó 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 } } } ] } } }, ... ] }