Toán tử bản trình bày

API Google Trang trình bày cho phép bạn tạo tệp trình bày và quản lý các tệp hiện có. Các ví dụ trên trang này cho thấy một số thao tác trình bày trang phổ biến khi sử dụng phương thức presentations.batchUpdate.

Những ví dụ này được trình bày dưới dạng yêu cầu HTTP nhằm đảm bảo trung lập về ngôn ngữ. Để tìm hiểu cách triển khai quá trình cập nhật theo lô cho nhiều ngôn ngữ bằng thư viện ứng dụng API của Google, hãy xem các hướng dẫn sau:

Tạo bản trình bày

Mã mẫu presentations.create sau đây cho biết cách tạo một tệp trình bày trống có tiêu đề "Bản trình bày mới của tôi".

Bạn cũng có thể tạo các tệp trình bày trống thông qua phương thức files.create của API Google Drive bằng cách chỉ định application/vnd.google-apps.presentation làm loại MIME.

Sau đây là giao thức yêu cầu để tạo bản trình bày:

POST https://slides.googleapis.com/v1/presentations
{
  "title": "My New Presentation"
}

Liệt kê các tệp trình bày hiện có

API Trang trình bày không cung cấp phương thức để truy xuất danh sách bản trình bày nhưng API Drive thì có. Phương thức files.list (trình bày bên dưới) sử dụng mặt nạ trường để trả về danh sách các tệp trình bày từ Drive của bạn, cùng với mã tệp, tên tệp và một đường liên kết để mở tệp. Yêu cầu này cũng chỉ định application/vnd.google-apps.presentation làm loại MIME.

Sau đây là giao thức yêu cầu để liệt kê các tệp trình bày hiện có:

GET https://www.googleapis.com/drive/v3/files?q="mimeType=application/vnd.google-apps.presentation"&fields=files(id,name,webViewLink)

Phản hồi cho yêu cầu này có cấu trúc như sau:

{
 "files": [
    {
     "id": "abcdefghijklmnopqrstuvwxyz0123456789",
     "name": "Project Vision",
     "webViewLink": "https://docs.google.com/a/google.com/presentation/d/abcdefghijklmnopqrstuvwxyz0123456789/edit?usp=drivesdk"
    },
    {
     "id": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789",
     "name": "Untitled Presentation",
     "webViewLink": "https://docs.google.com/a/google.com/presentation/d/ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/edit?usp=drivesdk"
    },
    ...
  ]
}

Thay thế văn bản trong toàn bộ bản trình bày

Mã mẫu presentations.batchUpdate sau đây cho biết cách sử dụng phương thức ReplaceAllTextRequest để thay thế văn bản trong suốt quá trình trình bày do PRESENTATION_ID chỉ định. Bạn có thể khám phá giá trị cho mã bản trình bày từ URL của bản trình bày.

Mọi phiên bản của chuỗi "Gizmo Corp." đều được thay thế bằng văn bản "tiện ích Inc". Thành phần này bao gồm văn bản trong hộp văn bản và các hình dạng khác, trên trang trình bày và trong trang chính. Trong trường hợp này, việc thay thế văn bản có phân biệt chữ hoa chữ thường bằng cách đặt matchCase thành true.

Sau đây là giao thức yêu cầu thay thế văn bản trong suốt bản trình bày:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "replaceAllText": {
          "containsText": {
            "text": "Gizmo Corp.",
            "matchCase": true
          },
          "replaceText": "Gadget Inc."
      }
    }
  ]
}