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 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.
Các 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ị của 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ã nhận dạng đối tượng trang. Bạn có thể truy xuất giá trị cho thông tin 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ân biệt ngôn ngữ. Các ví dụ được đọc từ bản trình bày mẫu này, trong đó 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 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 của trang 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ể được dùng để chỉ định 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 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ã nhận dạng đố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ã nhận dạng đối tượng phần tử từ một trang
Mã mẫu presentations.pages.get sau đây 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 đố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 các loại đó bằng thông 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 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 đối tượng Page chứa các phần tử hình dạng được yêu cầu. Dấu ngoặc nhọn 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
}
}
}
]
}
}
},
...
]
}