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 các bộ trang 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 thông tin đó với các mẫu được thiết kế sẵn và các lựa chọn định cấu hình đã chọn để tạo bản trình bày hoàn chỉnh trong một khoảng thời gian ngắn hơn nhiều so với thời gian tạo bản trình bày theo cách thủ công.
Tổng quan về API
Tập hợ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 với 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 phương thức batchUpdate; phương thức này lấy một danh sách các đối tượng Yêu cầu cho phép bạn thực hiện những việc như:
- Tạo trang trình bày
- Thêm các 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 các 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. Hãy xem hướng dẫn Bắt đầu để biế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
Một bản trình bày trong API Trang trình bày được tạo thành từ các trang, chứa các phần tử trang.
Bạn có thể lấy mã nhận dạng của bản trình bà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 các 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 đây để trích xuất mã nhận dạng bản trình bày từ URL 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ệp
tài nguyên.
Các trang và phần tử trang được xác định bằng mã nhận dạng đối tượng.
Pages
Google Trang trình bày có các loại trang sau:
| Thạc sĩ | Trang trình bày chính xác định kiểu văn bản, nền và các phần tử trang xuất hiện trong tất cả các trang trình bày sử dụng trang trình bày chính này. Bạn nên thêm các phần tử trang phải xuất hiện trên tất cả các trang trình bày vào trang trình bày chính. Hầu hết các bản trình bày đều có một trang trình bày chính, nhưng một số bản trình bày có thể có nhiều hoặc không có trang trình bày chính. |
| Bố cục | Bố cục đóng vai trò là mẫu cho cách các phần tử trang sẽ được sắp xếp theo mặc định trên các trang trình bày sử dụng bố cục. Mỗi bố cục được liên kết với một trang trình bày chính. |
| Trang trình bày | Các trang này chứa nội dung mà bạn đang trình bày cho khán giả. Hầu hết các trang trình bày đều dựa trên một trang trình bày chính và một bố cục. Bạn có thể chỉ định bố cục cần sử dụng cho từng trang trình bày khi tạo trang trình bày đó. |
| Ghi chú | Các trang này chứa nội dung cho tài liệu phát bản trình bày, bao gồm một 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. |
| Trang trình bày chính về ghi chú | Trang trình bày chính về ghi chú xác định kiểu văn bản và các phần tử trang mặc định cho tất cả các trang ghi chú. Trang trình bày chính về ghi chú là chỉ đọc trong API Trang trình bày. |
Phần tử trang
Phần tử trang là các thành phần trực quan được đặt trên các trang. API này hiển thị một số loại phần tử trang:
| Nhóm | Một tập hợp các phần tử trang được coi là một đơn vị riêng lẻ. Bạn có thể di chuyển, điều chỉnh tỷ lệ và xoay các phần tử này cùng nhau. |
| Hình dạng | Một đố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, đây là các phần tử trang phổ biến nhất để tạo trang trình bày. |
| Hình ảnh | Một hình ảnh được nhập vào Trang trình bày. |
| Video | Một video được nhập vào Trang trình bày. |
| Line | Một đường thẳng, đường cong hoặc đường kết nối trực quan. |
| Bảng | Một lưới nội dung. |
| WordArt | Một phần tử văn bản trực quan hoạt động giống như một hình dạng. |
| SheetsChart | Một biểu đồ được nhập vào Trang trình bày từ Google Trang tính. |
Cập nhật theo lô
Phương thức batchUpdate method 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 lại trong một 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ó khả năng phụ thuộc) được ghi.
Phương thức batchUpdate hoạt động bằng cách lấy một hoặc nhiều
Yêu cầu
đối tượng, mỗi đối tượng chỉ định một loại yêu cầu duy nhất để thực hiện. Có nhiều loại yêu cầu khác nhau. Dưới đây là thông tin chi tiết về các loại yêu cầu, được nhóm thành nhiều danh mục.
Phương thức batchUpdate trả về một nội dung phản hồi,
chứa một
Phản hồi
cho mỗi yêu cầu. Mỗi phản hồi 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 áp dụng, phản hồi ở chỉ mục đó sẽ trống. Các yêu cầu Create khác nhau thường có phản hồi để bạn biết mã nhận dạng của đối tượng mới thêm.
Làm việc với mã nhận dạng đối tượng
Một bản trình bày trong API Trang trình bày được tạo thành từ các trang và phần tử trang. Các đối tượng này bao gồm một chuỗi mã nhận dạng đối tượng duy nhất trong một bản trình bày.
Chỉ định mã nhận dạng đố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ã nhận dạng đố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 batchUpdate,
giảm thiểu số lượng 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ã nhận dạng đố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, thì 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ã nhận dạng đối tượng vì mã này có thể thay đổi. Hãy xem phần sau để biết thêm thông tin.
Theo dõi các đối tượng mà không cần sử dụng mã nhận dạng đối tượng
Khi bạn đưa ra yêu cầu API Trang trình bày, mã nhận dạng đố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 về 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ữ nguyên mã nhận dạng đối tượng.
Tuy nhiên, bạn không thể dựa vào mã nhận dạng đối tượng 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 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ã nhận dạng đối tượng trong bộ nhớ của ứng dụng. Thay vào đó, bạn nên tìm 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ác bản trình bày mới tạo thường sử dụng một tập hợp mã nhận dạng nhất quán cho các trang trình bày, trang trình bày 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ử mà bạn muốn sửa đổi bằng đối tượng bản trình bày do các lệnh gọi để tạo() hoặc get() trả về.