API Google Trang trình bày giúp bạn tạo và sửa đổi bản trình bày trong 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 bộ trang trình bày tuyệt đẹp 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 các thông tin đó với các mẫu được thiết kế sẵn và các tuỳ chọn cấu hình đã chọn để tạo bản trình bày đã hoàn tất trong thời gian ngắn mà bạn sẽ cầ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 tải 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ể sẽ 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 lấy danh sách các đối tượng 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 như hình dạng hoặc bảng
- Chèn, thay đổi và xóa 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. Vui lòng xem hướng dẫn Bắt đầu sử dụng để biết ví dụ đơn giản 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 bao gồm các trang chứa các phần tử trang.
Mã của một bản trình bày có thể được lấy từ URL:
https://docs.google.com/presentation/d/presentationId/edit
Mã 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ể 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 Google Trang tính:
/presentation/d/([a-zA-Z0-9-_]+)
Nếu bạn đã quen thuộc với API Drive, thì presentationId tương ứng với
mã nhận dạng của tài nguyên Tệp.
Các trang và phần tử trang được xác định theo mã đối tượng.
Trang
Google Trang trình bày có các loại trang sau:
| Thạc sĩ | Trang cái 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ả các trang trình bày sử dụng trang cái này. Bạn phải 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 cái. Hầu hết bản trình bày đều có một bản chính, nhưng một số bản trình bày có thể có một vài bản trình bày chính hoặc không có bản nào. |
| Bố cục | Bố cục đóng vai trò là mẫu cho việc sắp xếp các thành phần của trang theo mặc định trên các trang trình bày bằng cách sử dụng bố cục. Mỗi bố cục được liên kết với một trang chủ. |
| Trang trình bày | Những 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 cái và một bố cục. Bạn có thể chỉ định bố cục nào cần sử dụng cho từng trang trình bày khi tạo. |
| Ghi chú | Những trang này chứa nội dung cho tài liệu thuyết trình 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. 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à thành phần trang mặc định cho mọi trang ghi chú. Bản 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 các trang. API hiển thị một số loại phần tử trang:
| Nhóm | 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, chuyển đổi tỷ lệ và xoay vòng chúng. |
| Hình dạng | Một đối tượng hình ảnh đơn thuầ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, chúng là các phần tử trang phổ biến nhất để tạo trang trình bày. |
| Hình ảnh | 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. |
| Dòng | Một đường kẻ, đường cong hoặc đường nối trực quan. |
| Bảng | Lưới nội dung. |
| Nghệ thuật chữ | Một phần tử văn bản trực quan hoạt động giống một hình dạng hơn. |
| Biểu đồ trên Trang tính | 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 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 với nhau theo lô để nếu một yêu cầu không thành công thì sẽ không có thay đổi nào khác (có thể phụ thuộc) được ghi vào.
Phương thức batchUpdate hoạt động bằng cách lấy một hoặc nhiều đối tượng 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. Dưới đây là bảng phân tích các loại yêu cầu,
được nhóm thành các danh mục khác nhau.
Phương thức batchUpdate trả về một nội dung phản hồi, chứa Phản hồi cho từng 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 tạ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 được thêm.
Làm việc với mã đối tượng
Một bản trình bày trong API Trang trình bày bao gồm các trang và 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 các 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ể tùy ý 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, bạn không nên dựa vào mã đối tượng vì mã này có thể thay đổi. Hãy xem phần sau để biết thêm thông tin chi tiết.
Theo dõi đối tượng mà không sử dụng ID đối tượng
Khi bạn tạo yêu cầu API Trang trình bày, mã đối tượng thường được giữ nguyên. (Mọi ngoại lệ được gọi ra trong tài liệu tham khảo của phương thức.) Việc tạo một bản sao của toàn bộ bản trình bày bằng API Drive cũng giữ nguyên mã đối tượng.
Tuy nhiên, bạn không thể phụ thuộc vào một mã đối tượng không thay đổi sau khi thay đổi bản trình bày trong giao diện người dùng của Trang trình bày. Ví dụ: nếu người dùng sử dụng giao diện người dùng của Trang trình bày để sao chép và dán phần tử trang rồi xoá trang gốc, thì phần tử trang sẽ có mã nhận dạng duy nhất mới và mã nhận dạng trước đó mà bạn đã cung cấp 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 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á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 các trang trình bày, trang cái 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 cách sử dụng đối tượng bản trình bày mà các lệnh gọi đến create() hoặc get() trả về.