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

Google Trang trình bày API cho phép bạn tạo tệp bản 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 phổ biến về bản trình bày trang 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 bản cập nhật theo lô bằng nhiều ngôn ngữ thông qua 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ã mẫu 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 đề là "My New Presentation".

Bạn cũng có thể tạo tệp bản trình bày trống bằng phương thức API Google Drive files.create 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 bản 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 API Drive thì có. Phương thức (được 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 bản trình bày từ Drive của bạn, cùng với mã tệp, tên tệp và đường liên kết để mở tệp.files.list 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 bản 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 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 toàn bộ bản trình bày do PRESENTATION_IDchỉ định. Bạn có thể khám phá giá trị cho mã bản trình bày từ URL bản trình bày.

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