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. Chiến lược phát hành đĩa đơn
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ách sử dụng 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 nơi bạn cung cấp bản trình bày Mã nhận dạng. 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 đối tượng trang Mã nhận dạng. Bạn có thể truy xuất giá trị cho việc 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ữ. Chiến lược phát hành đĩa đơn
các ví dụ đọc từ ví dụ này
trình bày,
có 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc là
PRESENTATION_ID. PAGE_ID của
đầu tiên
trang trình bày
trong bản trình bày này là ge63a4b4_1_0.
Các ví dụ ở đây chỉ 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à 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
Nội dung sau đây
Mã presentations.get
mẫu cho biết cách truy xuất danh sách tất cả ID đố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ự trong bản trình bày và có thể là
được sử 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ùng một 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 trang trình bày:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId
Phản hồi bao gồm
Presentation
đối tượng chứa ID đối tượng đã 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
Nội dung sau đây
presentations.pages.get
mã mẫu 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ử của trang
trên 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
Đố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
Nội dung sau đây
presentations.pages.get
mã mẫu cho biết cách truy xuất danh sách tất cả
Shapes
trên trang. Bạn có thể truy xuất
PageElement
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ề
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 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
Đố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 biểu thị các phần tử trang
không thuộc kiểu 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
}
}
}
]
}
}
},
...
]
}