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

Google Slides API 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 minh hoạ một số thao tác trình bày trang phổ biến bằng phương thức presentations.batchUpdate.

Các ví dụ này được trình bày dưới dạng yêu cầu HTTP để không phụ thuộc vào ngôn ngữ. Để tìm hiểu cách triển khai một bản cập nhật hàng loạt bằng nhiều ngôn ngữ bằng cách sử dụng thư viện ứng dụng Google API, hãy xem các hướng dẫn sau:

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

Mẫu mã presentations.create sau đây cho biết cách tạo một tệp bản 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 tệp trình bày trống bằng phương thức files.create của Google Drive API 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 một 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ó

Slides API không cung cấp phương thức truy xuất danh sách bản trình bày nhưng Drive API thì có. Phương thức files.list (được trình bày bên dưới) sử dụng mặt nạ trường để trả về danh sách tệp trình bày trên Drive của bạn, kèm theo mã nhận dạng tệp, tên tệp và đườ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 đối với 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 bản trình bày do PRESENTATION_ID chỉ định. Bạn có thể tìm thấy giá trị cho mã nhận dạng bản trình bày trong URL của bản trình bày.

Mọi trường hợp của chuỗi "Gizmo Corp." đều được thay thế bằng văn bản "Gadget Inc." Nội dung 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 mẫu. Trong trường hợp này, việc thay thế văn bản 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 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."
      }
    }
  ]
}