Giới thiệu

API Google Trang trình bày cho phép bạn tạo và sửa đổi bản trình bày trên Google Trang trình bày.

Các ứng dụng có thể tích hợp với API Google Trang trình bày để tự động tạo những bản trình bày đẹp mắt từ dữ liệu do người dùng và hệ thống cung cấp. Ví dụ: bạn có thể sử dụng thông tin chi tiết về khách hàng từ một cơ sở dữ liệu và kết hợp chúng với các mẫu được thiết kế sẵn và các lựa chọn cấu hình đã chọn để tạo bản trình bày hoàn thiện trong một khoảng thời gian ngắn để tạo bản trình bày theo cách thủ công.

Tổng quan về API

Bộ sưu tập bản trình bày cung cấp các phương thức cho phép bạn lấy và cập nhật các phần tử trong bản trình bày.

Hầu hết công việc của bạn khi dùng API Trang trình bày có thể là tạo và cập nhật bản trình bày. Bạn sẽ thực hiện việc này bằng cách sử dụng phương thức batchUpdate; phương thức này sẽ lấy danh sách các đối tượng Request (Yêu cầu) cho phép bạn làm những việc như:

  • Tạo trang trình bày
  • Thêm phần tử vào trang trình bày, chẳng hạn như hình dạng hoặc bảng
  • Chèn, thay đổi và xoá văn bản
  • Áp dụng phép biến đổi cho các phần tử
  • Thay đổi thứ tự của các trang trình bày

Xem phần Cập nhật theo lô để biết thêm thông tin chi tiết. Hãy xem hướng dẫn Bắt đầu sử dụng để biết một ví dụ đơn giản từ đầu đến cuối về cách sử dụng API.

Cấu trúc của bản trình bày

Bản trình bày trong API Trang trình bày bao gồm các trang chứa các phần tử của trang.

Mã nhận dạng của bản trình bày có thể được lấy từ URL:

https://docs.google.com/presentation/d/presentationId/edit

Mã nhận dạng bản trình bày là một chuỗi chứa chữ cái, số và một số ký tự đặc biệt. Bạn có thể sử dụng biểu thức chính quy sau để trích xuất mã nhận dạng bản trình bày từ URL trên Google Trang tính:

/presentation/d/([a-zA-Z0-9-_]+)

Nếu bạn đã quen thuộc với API Drive, thì presentationId sẽ tương ứng với mã nhận dạng của tài nguyên File (Tệp).

Các trang và phần tử trang được xác định bằng mã đối tượng.

Pages

Google Trang trình bày có các loại trang sau:

Thạc sĩ Bản trình bày chính xác định kiểu văn bản, nền và các phần tử trang mặc định xuất hiện trong tất cả trang trình bày sử dụng bản chính này. Các phần tử trang phải xuất hiện trên tất cả trang trình bày phải được thêm vào trang chủ. Hầu hết các bản trình bày đều có một bản trình bày chính, nhưng một số bản trình bày có thể có nhiều bản trình bày hoặc không có.
Bố cục Bố cục đóng vai trò là mẫu cho cách sắp xếp các phần tử trang theo mặc định trên trang trình bày sử dụng một bố cục. Mỗi bố cục liên kết với một bố cục chính.
Trang trình bày Những trang này chứa nội dung bạn đang trình bày cho người xem của mình. Hầu hết các trang trình bày đều dựa trên trang chính và bố cục. Bạn có thể chỉ định bố cục sẽ sử dụng cho mỗi trang trình bày khi tạo trang trình bày đó.
Ghi chú Những trang này chứa nội dung cho tài liệu trình bày, bao gồm cả hình dạng chứa ghi chú của người thuyết trình trên trang trình bày. Mỗi trang trình bày có một trang ghi chú tương ứng. Bạn chỉ có thể sửa đổi văn bản trong hình dạng ghi chú của người thuyết trình bằng API Trang trình bày.
Bậc thầy ghi chú Bản ghi chú chính xác định kiểu văn bản và phần tử trang mặc định cho tất cả các trang ghi chú. Các ứng dụng Ghi chú chính đang ở chế độ chỉ đọc trong API Trang trình bày.

Phần tử trang

Phần tử trang là các thành phần hình ảnh được đặt trên trang. API này cho thấy một số loại phần tử trang:

Nhóm Một tập hợp các phần tử trang được xem là một đơn vị riêng lẻ. Bạn có thể di chuyển, điều chỉnh theo tỷ lệ và xoay các tệp này cùng nhau.
Hình dạng Đối tượng trực quan đơn giản, chẳng hạn như hình chữ nhật, hình elip và hộp văn bản. Hình dạng có thể chứa văn bản, vì vậy, hình dạng là phần tử trang phổ biến nhất để tạo trang trình bày.
Bài đăng có hình ảnh Đã nhập một hình ảnh vào Trang trình bày.
Video Đã nhập một video vào Trang trình bày.
Line Một đường thẳng, đường cong hoặc đầu nối trực quan.
Bảng Nội dung theo bố cục lưới.
WordArt Một thành phần văn bản dạng hình ảnh, hoạt động giống một hình dạng hơn.
SheetsChart Một biểu đồ được nhập từ Google Trang tính vào Trang trình bày.

Cập nhật theo lô

Phương thức batchUpdate cho phép bạn cập nhật nhiều khía cạnh của bản trình bày. Các thay đổi được nhóm với nhau theo lô để nếu một yêu cầu không thành công, thì không có thay đổi nào khác (có thể phụ thuộc) được ghi.

Phương thức batchUpdate hoạt động bằng cách nhận một hoặc nhiều đối tượng Request (Yêu cầu), mỗi đối tượng chỉ định một loại yêu cầu để thực hiện. Có nhiều loại yêu cầu khác nhau. Dưới đây là bảng chi tiết về các loại yêu cầu, được nhóm thành các danh mục khác nhau.

Làm việc với Trang trình bày: CreateSlideRequest
UpdateSlidesPositionRequest
DuplicateObjectRequest
UpdatePagePropertiesRequest
DeleteObjectRequest
Làm việc với các phần tử trang: CreateShapeRequest
CreateLineRequest
UpdatePageElementTransformRequest
UpdateShapePropertiesRequest
DuplicateObjectRequest
DeleteObjectRequest
Làm việc với bảng: CreateTableRequest
InsertTableRowsRequest
InsertTableColumnsRequest
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableRowPropertiesRequest
UpdateTableColumnPropertiesRequest
UpdateTableBorderPropertiesRequest
UpdateTableCellPropertiesRequest
MergeTableCellsRequest
UnmergeTableCellsRequest
DeleteObjectRequest
Cách xử lý Biểu đồ: CreateSheetsChartRequest
RefreshSheetsChartRequest
ReplaceAllShapesWithSheetsChartRequest
DeleteObjectRequest
Làm việc với hình ảnh và video: CreateImageRequest
CreateVideoRequest
UpdateImagePropertiesRequest
UpdateVideoPropertiesRequest
ReplaceAllShapesWithImageRequest
DuplicateObjectRequest
DeleteObjectRequest
Làm việc với văn bản: InsertTextRequest
DeleteTextRequest
ReplaceAllTextRequest
CreateParagraphBulletsRequest
DeleteParagraphBulletsRequest
UpdateTextStyleRequest
UpdateParagraphStyleRequest

Phương thức batchUpdate trả về một nội dung phản hồi, trong đó chứa một Phản hồi cho mỗi yêu cầu. Mỗi phản hồi sẽ chiếm cùng một chỉ mục với yêu cầu tương ứng; đối với các yêu cầu không có phản hồi phù hợp, phản hồi tại chỉ mục đó sẽ trống. Nhiều yêu cầu Create thường có phản hồi để bạn biết mã nhận dạng của đối tượng mới được thêm vào.

Làm việc với mã đối tượng

Bản trình bày trong API Trang trình bày bao gồm các trangcác phần tử trang. Các đối tượng này bao gồm một chuỗi mã đối tượng duy nhất trong một bản trình bày.

Chỉ định mã đối tượng khi tạo

Khi tạo các trang hoặc phần tử trang bằng phương thức batchUpdate, bạn có thể tuỳ ý chỉ định một mã đối tượng cho đối tượng mới. Điều này cho phép bạn tạo một đối tượng và sửa đổi đối tượng đó trong cùng một yêu cầu lôUpdate, giảm thiểu số lệnh gọi đến API Trang trình bày và giảm mức sử dụng hạn mức.

Bạn nên tạo mã đối tượng ngẫu nhiên trong hầu hết các trường hợp. Ví dụ: nếu bạn đang sử dụng Java, java.util.UUID.randomUUID().toString() sẽ hoạt động tốt.

Khi ứng dụng của bạn muốn theo dõi các đối tượng trong một khoảng thời gian dài hơn, đừng dựa vào mã đối tượng vì mã này có thể thay đổi. Hãy xem phần sau đây để biết thêm thông tin chi tiết.

Theo dõi các đối tượng mà không cần sử dụng mã đối tượng

Khi bạn đưa ra yêu cầu API Trang trình bày, mã đối tượng thường được giữ nguyên. (Mọi trường hợp ngoại lệ đều được nêu trong tài liệu tham khảo của phương thức.) Việc tạo bản sao của toàn bộ bản trình bày bằng API Drive cũng giữ lại mã đối tượng.

Tuy nhiên, bạn không thể phụ thuộc vào việc mã đối tượng sẽ không thay đổi sau khi bản trình bày được thay đổi trong giao diện người dùng Trang trình bày. Ví dụ: nếu ai đó sử dụng giao diện người dùng của Trang trình bày để sao chép và dán một phần tử trang rồi xoá phần tử gốc, thì phần tử trang đó sẽ có một mã nhận dạng duy nhất mới và mã nhận dạng mà bạn đã cung cấp trước đó thông qua API sẽ bị mất. Do đó, bạn không nên lưu trữ mã đối tượng trong bộ nhớ của ứng dụng. Thay vào đó, bạn sẽ tìm thấy các đối tượng trong bản trình bày theo nội dung văn bản hoặc văn bản thay thế của bản trình bày đó.

Các bản trình bày mới tạo thường sử dụng một bộ mã nhận dạng nhất quán cho trang trình bày, trang chính và hộp văn bản mặc định. Các mã nhận dạng này có thể thay đổi theo thời gian, vì vậy, bạn không nên dựa vào tính năng này. Thay vào đó, hãy tìm các phần tử bạn muốn sửa đổi bằng cách sử dụng đối tượng bản trình bày được trả về bởi các lệnh gọi đến create() hoặc get().