Đọc cơ bản

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.getpresentations.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_i8eXc67Jo2O9C6VucPRESENTATION_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.objectIdfields=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 linetable, 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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}