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ạo ra những bản trình bày đẹp mắt tự động dựa trên 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 công cụ thiết kế sẵn các mẫu và chế độ cấu hình đã chọn để tạo bản trình bày hoàn chỉnh chỉ tốn một phần nhỏ thời gian để tạo quảng cáo 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 cho phép bạn nhận 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 cách sử dụng phương thức batchUpdate; phương thức này lấy danh sách 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 thành phần 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 chi tiết. Xem hướng dẫn Bắt đầu để xem ví dụ từ đầu đến cuối đơ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, trong đó có các trang phần tử.

Mã của 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ự. Biểu thức chính quy sau đây có thể được sử dụng để trích xuất biểu thức chính quy mã 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, presentationId tương ứng với Mã của tệp nguồn.

Trang và phần tử trang được xác định theo mã đố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à 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. Trang các phần tử phải xuất hiện trên tất cả trang trình bày phải được thêm vào trang cái. Thường gặp nhất các bản trình bày có một trang cái nhưng một số bản trình bày có thể có một vài hoặc không có.
Bố cục Bố cục đóng vai trò là mẫu về cách sắp xếp các phần tử trang mặc định trên 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 trình bày Các trang này chứa nội dung mà bạn đang trình bày cho người xem. 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 để sử dụng cho từng trang trình bày khi trang trình bày được tạo.
Ghi chú Các trang này chứa nội dung cho các bản trình bày, bao gồm một hình 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ỉ văn bản trong hình dạng ghi chú của người thuyết trình mới có thể được sửa đổi bằng API Trang trình bày.
Ghi chú chính 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ả ghi chú của bạn. Bản ghi chú chính ở 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 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ẻ. Chúng có thể được di chuyển, điều chỉnh theo tỷ lệ và xoay cùng nhau.
Hình dạng Đối tượng trực quan thuần tuý, 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à phần tử trang phổ biến nhất để tạo trang trình bày.
Bài đăng có hình ảnh Một hình ảnh đồ hoạ được nhập vào Trang trình bày.
Video Đã nhập video vào Trang trình bày.
Line Đường kẻ trực quan, đường cong hoặc đường nối.
Bảng Chế độ xem lưới nội dung.
WordArt Phần tử văn bản trực quan hoạt động giống 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 lại với nhau trong một lô để nếu một yêu cầu không thành công, không yêu cầu nào còn lại (có thể phụ thuộc) sẽ được ghi thay đổi.

Phương thức batchUpdate hoạt động bằng cách lấy một hoặc nhiều Yêu cầu 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à bảng phân tích về các loại yêu cầu: được nhóm thành các danh mục khác nhau.

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

Phương thức batchUpdate trả về nội dung phản hồi, có chứa Phản hồi cho từng yêu cầu. Mỗi câu trả lời có cùng chỉ mục với câu trả lời tương ứng yêu cầu; đối với các yêu cầu không có phản hồi thích hợp, 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, vì vậy mà 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 được tạo thành từ trangphần tử trang. Các đối tượng này bao gồm một chuỗi mã đối tượng. Đây là chuỗi duy nhất trong một bản trình bày.

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

Khi tạo trang hoặc phần tử trang bằng cách sử dụng batchUpdate, bạn có thể tuỳ ý chỉ định 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 BulkUpdate, giảm thiểu số lượng đối tượng lệnh gọi đến API Trang trình bày và giảm hạn mức sử dụng.

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 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. Xem các mục sau để biết thêm chi tiết.

Theo dõi các đối tượng mà không 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ã đối tượng sẽ được giữ nguyên như bình thường. (Bất kỳ ngoại lệ được gọi ra trong tài liệu tham khảo về phương thức.) Tạo bản sao của toàn bộ bản trình bày bằng API Drive cũng lưu giữ mã nhận dạng đối tượng.

Tuy nhiên, bạn không thể phụ thuộc vào việc mã đối tượng không bị thay đổi sau khi trình bày sẽ được thay đổi trong giao diện người dùng Trang trình bày. Ví dụ: nếu ai đó sử dụng Trang trình bày Giao diện người dùng để sao chép và dán một phần tử trang, sau đó xoá phần tử trang gốc giờ đây 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 đây 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 nên tìm đối tượng trong bản trình bày bằng cách 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 theo mặc định trang trình bày, trang cái và hộp văn bản. 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ùng 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 các lệnh gọi trả về create() hoặc get().