Một ứng dụng hữu ích của API Google Trang trình bày là hợp nhất thông tin từ một hoặc nhiều nguồn dữ liệu khác vào một bản trình bày theo mẫu.
Trang này trình bày cách bạn có thể lấy dữ liệu từ một nguồn bên ngoài và chèn vào bản trình bày mẫu hiện có. Khái niệm này tương tự như tính năng hợp nhất thư bằng trình xử lý văn bản và bảng tính.
Có một vài lý do khiến phương pháp này hữu ích:
Nhà thiết kế có thể dễ dàng tinh chỉnh thiết kế của bản trình bày bằng cách sử dụng trình chỉnh sửa Google Trang trình bày. Việc này dễ dàng hơn nhiều so với việc điều chỉnh các tham số trong ứng dụng của bạn để thiết kế thiết kế trang trình bày được kết xuất.
Tách nội dung khỏi bản trình bày là một thiết kế nổi tiếng với nhiều lợi ích.
Một công thức cơ bản
Sau đây là ví dụ về cách bạn có thể sử dụng API Trang trình bày để hợp nhất dữ liệu vào một bản trình bày:
Tạo bản trình bày theo cách bạn muốn bằng cách sử dụng nội dung phần giữ chỗ để giúp bạn thiết kế.
Đối với mỗi phần tử nội dung bạn sẽ chèn, hãy thay thế phần giữ chỗ nội dung có thẻ. Thẻ là các hộp văn bản hoặc hình dạng có một chuỗi duy nhất. Hãy đảm bảo sử dụng các chuỗi ít có khả năng xảy ra bình thường. Ví dụ:
{{account-holder-name}}
có thể là thẻ tốt.Trong mã của bạn, hãy sử dụng API Google Drive để tạo bản sao của bản trình bày.
Trong mã của bạn, hãy sử dụng
batchUpdate
với một tập hợpreplaceAllText
để thực hiện tất cả thay thế văn bản trong suốt bản trình bày. Sử dụngreplaceAllShapesWithImage
yêu cầu thay thế hình ảnh trong suốt quá trình hiển thị.
Sau khi tạo một bản trình bày có chứa thẻ, đừng quên tạo một bản sao và sử dụng API Trang trình bày để thao tác với bản sao. Không sử dụng API Trang trình bày để thao túng "mẫu" chính của bạn sao chép!
Các phần sau bao gồm đoạn mã minh hoạ một số điều này của chúng tôi. Bạn cũng có thể xem video trên để biết ví dụ hoàn chỉnh (Python) kết hợp một số khái niệm từ các phần riêng lẻ bên dưới.
Hợp nhất văn bản
Bạn có thể sử dụng replaceAllText
yêu cầu thay thế tất cả các bản sao của một chuỗi văn bản nhất định trong một
bản trình bày có văn bản mới. Để hợp nhất, việc này đơn giản hơn
tìm và thay thế từng lần xuất hiện của văn bản riêng lẻ. Một lý do là
phương pháp tinh vi nhất là khó dự đoán ID phần tử trang,
đặc biệt là khi cộng tác viên tinh chỉnh và duy trì mẫu
bản trình bày.
Ví dụ:
Ví dụ này sử dụng API Drive để sao chép bản trình bày mẫu, tạo một bản trình bày mới. Sau đó, dịch vụ này sử dụng API Google Trang tính để đọc dữ liệu từ bảng tính Trang tính và cuối cùng sử dụng API Trang trình bày để cập nhật bản trình bày mới.
Ví dụ này lấy dữ liệu từ 3 ô trong một hàng của dải ô được đặt tên trong
bảng tính. Sau đó, công cụ này sẽ thay thế dữ liệu đó vào bản trình bày ở bất cứ nơi nào
các chuỗi {{customer-name}}
,
{{case-description}}
hoặc
Có {{total-portfolio}}
.
Apps Script
Go
Java
JavaScript
Node.js
PHP
Python
Ruby
Hợp nhất hình ảnh
Bạn cũng có thể hợp nhất hình ảnh vào bản trình bày bằng cách sử dụng
replaceAllShapesWithImage
của bạn. Yêu cầu này thay thế tất cả các phiên bản của hình dạng có chứa
chuỗi văn bản đã cung cấp cùng với hình ảnh đã cho. Tự động gửi yêu cầu
vị trí và điều chỉnh tỷ lệ hình ảnh cho vừa với giới hạn của hình dạng thẻ trong khi
và giữ nguyên tỷ lệ khung hình của hình ảnh.
Ví dụ:
Ví dụ này sử dụng API Google Drive để sao chép bản trình bày mẫu, tạo
một bản trình bày mới. Sau đó, dịch vụ này sử dụng API Trang trình bày để tìm
mọi hình dạng có chữ {{company-logo}}
và thay thế bằng hình ảnh biểu trưng của công ty. Yêu cầu này cũng thay thế bất kỳ
hình dạng có chữ {{customer-graphic}}
bằng một hình ảnh khác.
Apps Script
Go
Java
JavaScript
Node.js
PHP
Python
Ruby
Thay thế hộp văn bản hoặc các trường hợp hình ảnh cụ thể
replaceAllText
và replaceAllShapesWithImage
rất hữu ích cho việc thay thế thẻ trong suốt quá trình hiển thị, nhưng
đôi khi bạn chỉ cần thay thế các yếu tố theo một tiêu chí khác, chẳng hạn như
trên một trang trình bày cụ thể.
Trong các trường hợp này, bạn phải truy xuất mã nhận dạng của các hình dạng thẻ mà bạn muốn thay thế. Để thay thế văn bản, bạn xoá văn bản bằng các hình dạng đó rồi chèn văn bản mới (xem mẫu Chỉnh sửa văn bản ở một hình dạng được chỉ định).
Việc thay thế hình ảnh phức tạp hơn. Để hợp nhất trong một hình ảnh, bạn cần phải:
- Lấy mã nhận dạng của hình dạng thẻ.
- Sao chép kích thước và biến đổi thông tin từ thẻ.
- Thêm hình ảnh của bạn vào trang bằng cách sử dụng thông tin về kích thước và biến đổi.
- Xoá hình dạng thẻ.
Việc duy trì tỷ lệ khung hình của hình ảnh trong khi điều chỉnh tỷ lệ đến kích thước mong muốn có thể cần được chăm sóc cẩn thận, như được mô tả trong phần sau. Xem thêm mẫu này: Thay thế thẻ hình dạng bằng hình ảnh.
Giữ nguyên tỷ lệ khung hình
Khi bạn tạo hình ảnh bằng API Trang trình bày, tỷ lệ phù hợp chỉ dựa trên
kích thước hình ảnh, chứ không phải dựa trên kích thước và chuyển đổi dữ liệu. Dữ liệu kích thước mà bạn cung cấp
trong createImage
được coi là kích thước hình ảnh mong muốn. API phù hợp với
tỷ lệ khung hình của hình ảnh với kích thước mong muốn này, sau đó áp dụng phép biến đổi được cung cấp.
Khi thay thế thẻ bằng một hình ảnh, bạn sẽ giữ nguyên khía cạnh của hình ảnh bằng cách đặt kích thước và chia tỷ lệ của hình ảnh như sau:
- width: được đặt thành tích của
width
vàscaleX
của thẻ - height: đặt thành sản phẩm của
height
vàscaleY
của thẻ - scale_x: đã đặt thành
1
- scale_y: đã đặt thành
1
Điều này giúp cho API Trang trình bày khớp với hình ảnh theo
kích thước trực quan của thẻ thay vì kích thước không được điều chỉnh theo tỷ lệ (xem
Thay thế thẻ hình dạng bằng hình ảnh).
Việc đặt tham số tỷ lệ thành 1
sẽ ngăn việc điều chỉnh tỷ lệ hình ảnh
2 lần.
Cách sắp xếp này đảm bảo tỷ lệ khung hình của hình ảnh được giữ nguyên và tránh hình ảnh vượt quá kích thước của hình dạng thẻ. Hình ảnh có cùng một điểm giữa với hình dạng thẻ.
Quản lý mẫu
Đối với các bản trình bày mẫu mà ứng dụng xác định và sở hữu, hãy tạo mẫu bằng một tài khoản chuyên biệt đại diện cho ứng dụng. Tài khoản dịch vụ là một lựa chọn phù hợp và tránh được những rắc rối khi các chính sách của Google Workspace hạn chế chia sẻ.
Khi bạn tạo các bản sao của bản trình bày từ mẫu, hãy luôn sử dụng thông tin xác thực của người dùng cuối. Điều này cho phép người dùng có toàn quyền kiểm soát kết quả trình bày và ngăn chặn các vấn đề về việc mở rộng quy mô liên quan đến mỗi người dùng trong Google Drive.
Để tạo mẫu bằng tài khoản dịch vụ, hãy thực hiện các bước sau với thông tin đăng nhập của ứng dụng:
- Tạo bản trình bày bằng presentations.create trong API Trang trình bày.
- Cập nhật quyền để cho phép người nhận bản trình bày đọc bản trình bày đó bằng permissions.create trong API Drive.
- Cập nhật quyền để cho phép tác giả mẫu ghi vào mẫu đó bằng permissions.create trong API Drive.
- Chỉnh sửa mẫu theo yêu cầu.
Để tạo một phiên bản của bản trình bày, hãy thực hiện các bước sau bằng thông tin đăng nhập của người dùng:
- Tạo bản sao của mẫu bằng cách sử dụng files.copy trong API Drive.
- Thay thế các giá trị bằng presentation.batchUpdate trong API Trang trình bày.