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 trình bày một số thao tác trình bày trang phổ biến sử dụng thời gian 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 việc cập nhật theo lô bằng nhiều ngôn ngữ bằng Google API thư viện ứng dụng, hãy xem các hướng dẫn sau:

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

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

Bạn cũng có thể tạo tệp trình bày trống bằng cách sử dụng API Google Drive files.create bằng cách chỉ định application/vnd.google-apps.presentation làm 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 nhưng API Drive 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 các tệp trình bày từ Drive của bạn, với ID 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 nêu rõ application/vnd.google-apps.presentation làm MIME loại.

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 thông báo này yêu cầu 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

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

Mọi phiên bản của chuỗi "Gizmo Corp." được thay thế bằng văn bản "Tiện ích Inc." Nội dung này bao gồm văn bản trong các hộp văn bản và các hình dạng khác, trên trang trình bày và trong thạc sĩ. 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 theo chế độ cài đặt matchCase đến 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."
      }
    }
  ]
}