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

API Google Trang trình bày cho phép bạn tạo, di chuyển và xoá trang trình bày. Các ví dụ trên trang này minh hoạ một số thao tác phổ biến trên trang trình bày khi sử dụng phương thức presentations.batchUpdate.

Những ví dụ này sử dụng các biến sau:

  • PRESENTATION_ID – Cho biết vị trí bạn cung cấp mã nhận dạng bản trình bày. Bạn có thể khám phá giá trị cho mã nhận dạng này từ URL của bản trình bày.
  • PAGE_IDPAGE_ID2 – Cho biết vị trí bạn cung cấp mã đối tượng trang. Bạn có thể truy xuất giá trị cho URL này từ URL hoặc bằng cách sử dụng yêu cầu đọc API.

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ô cho nhiều ngôn ngữ bằng thư viện ứng dụng API của Google, hãy xem những hướng dẫn sau: Tạo trang trình bàyThêm hình dạng và văn bản.

Sao chép trang trình bày

Mã mẫu presentations.batchUpdate sau đây cho biết cách sử dụng phương thức DuplicateObjectRequest để sao chép một trang trình bày và chèn trang trình bày đó vào sau bản gốc trong bản trình bày. Trang trình bày gốc do PAGE_ID chỉ định.

Yêu cầu này cho phép bạn chỉ định xem một số hay tất cả mã phần tử trang sẽ nằm trong bản sao (kèm theo một số hạn chế). Trong ví dụ này, trang trình bày gốc chứa một phần tử bảng (do TABLE_ELEMENT_ID chỉ định), được liên kết với một bảng mới (do COPY_TABLE_ELEMENT_ID chỉ định) trong bản sao trang trình bày (do COPY_PAGE_ID chỉ định). Tất cả phần tử khác trên bản sao đều được cấp mã nhận dạng ngẫu nhiên.

Để biết thêm thông tin về cách sao chép PageElement, bao gồm hộp văn bản, hình ảnh, bảng, hình dạng cơ bản, đường kẻ và video được nhúng, hãy xem mẫu Sao chép và chỉnh sửa phần tử.

Sau đây là giao thức yêu cầu sao chép trang trình bày:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "duplicateObject": {
        "objectId": PAGE_ID,
        "objectIds": {
          "PAGE_ID": "COPY_PAGE_ID",
          "TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID"
        }
      }
    }
  ]
}

Tạo trang trình bày

Mã mẫu presentations.batchUpdate sau đây cho biết cách sử dụng phương thức CreateSlideRequest để tạo một trang trình bày và chèn trang trình bày đó làm trang trình bày thứ tư (sử dụng insertionIndex dựa trên 0) trong bản trình bày.

Trang trình bày mới sẽ được sử dụng PredefinedLayout của TITLE_AND_TWO_COLUMNS. Bạn có thể chỉ định một chuỗi để sử dụng làm PAGE_ID cho trang trình bày (với một số hạn chế), hoặc cho phép API tạo PAGE_ID bằng cách bỏ qua trường trong yêu cầu.

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

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createSlide": {
        "objectId": "PAGE_ID",
        "insertionIndex": 3,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        }
      }
    }
  ]
}

Tạo trang trình bày và sửa đổi phần giữ chỗ

Mã mẫu presentations.batchUpdate sau đây cho biết cách sử dụng phương thức CreateSlideRequest để tạo trang trình bày bằng PredefinedLayout của TITLE_AND_TWO_COLUMNS.

Bạn có thể chỉ định một chuỗi để sử dụng làm PAGE_ID cho trang trình bày (kèm theo một số hạn chế). placeholderIdMappings sử dụng Type của TITLE. TITLE_ID tham chiếu đến hình dạng phần giữ chỗ của trang trình bày để có thể sửa đổi.

Sau đây là giao thức yêu cầu tạo trang trình bày và sửa đổi phần giữ chỗ:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createSlide": {
        "objectId": PAGE_ID,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        },
        "placeholderIdMappings": [
          {
            "layoutPlaceholder": {
              "type": "TITLE",
              "index": 0
            },
            "objectId": TITLE_ID,
           },
        ],
      }
    },
    {
      "insertText": {
        "objectId": TITLE_ID,
        "text": "This is my slide title",
      }
    },
  ]
}

Di chuyển các trang trình bày đến một vị trí mới

Mã mẫu presentations.batchUpdate sau đây cho biết cách sử dụng phương thức UpdateSlidesPositionRequest để lấy hai trang trình bày đã chỉ định và chuyển chúng lên đầu bản trình bày, giữ nguyên thứ tự tương đối.

Mã trang trình bày được chỉ định (PAGE_IDPAGE_ID2) phải được cung cấp theo thứ tự bản trình bày hiện có, không được trùng lặp. insertionIndex dựa trên 0 biểu thị vị trí các trang trình bày sẽ được chèn, dựa trên thứ tự trước khi quá trình di chuyển diễn ra. Giá trị phải nằm trong khoảng từ 0 đến số lượng trang trình bày trong bản trình bày, tính toàn bộ.

Sau đây là giao thức yêu cầu di chuyển trang trình bày sang một vị trí mới:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "updateSlidesPosition": {
        "slideObjectIds": [
          PAGE_ID,
          PAGE_ID2
          ],
        "insertionIndex": 0
      }
    }
  ]
}

Đặt hình nền cho trang trình bày

Mã mẫu presentations.batchUpdate sau đây cho biết cách sử dụng phương thức UpdatePagePropertiesRequest để đặt hình nền của trang trình bày do PAGE_ID chỉ định. API truy xuất hình ảnh bằng cách sử dụng IMAGE_URL.

Mặt nạ trường được dùng để chỉ định rằng chỉ nên thay đổi nền trang trình bày để giữ lại các thuộc tính khác. Việc sử dụng mặt nạ thực địa cũng giúp cải thiện hiệu suất.

Ngoài ra, bạn có thể sử dụng phương thức UpdatePagePropertiesRequest để đặt nền của trang trình bày thành một màu đồng nhất.

Sau đây là giao thức yêu cầu đặt hình nền trang trình bày:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "updatePageProperties": {
        "objectId": PAGE_ID,
        "pageProperties": {
          "pageBackgroundFill": {
            "stretchedPictureFill": {
              "contentUrl": IMAGE_URL
            }
          }
        },
        "fields": "pageBackgroundFill"
      }
    }
  ]
}

Tạo hình thu nhỏ

Bạn có thể tạo hình thu nhỏ của phiên bản mới nhất của một trang cụ thể trong bản trình bày bằng cách gọi phương thức presentations.pages.getThumbnail. Phương thức này sẽ trả về hình thu nhỏ của trang dưới dạng URL nội dung. URL hình ảnh có thời gian tồn tại mặc định là 30 phút.

Bạn cũng có thể chỉ định mimeTypethumbnailSize được trả về bằng cách sử dụng trường ThumbnailProperties làm tham số truy vấn.

Sau đây là giao thức yêu cầu để tạo hình thu nhỏ của trang bằng tập hợp ThumbnailProperties:

 GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM
{
  "width": 800,
  "height": 450,
  "contentUrl": "CONTENT_URL"
}