Method: presentations.create

Tạo một bản trình bày trống bằng tiêu đề được cung cấp trong yêu cầu. Nếu bạn cung cấp presentationId, thì presentationId sẽ được dùng làm mã nhận dạng của bản trình bày mới. Nếu không, hệ thống sẽ tạo một mã nhận dạng mới. Các trường khác trong yêu cầu, bao gồm cả mọi nội dung được cung cấp, sẽ bị bỏ qua. Trả về bản trình bày đã tạo.

Yêu cầu HTTP

POST https://slides.googleapis.com/v1/presentations

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "presentationId": string,
  "pageSize": {
    object (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  }
}
Trường
presentationId

string

Mã của bản trình bày.
pageSize

object (Size)

Kích thước của các trang trong bản trình bày.
slides[]

object (Page)

Các trang trình bày trong bản trình bày. Trang trình bày kế thừa các thuộc tính từ bố cục trang trình bày.
title

string

Tiêu đề của bản trình bày.
masters[]

object (Page)

Bản chính trang trình bày trong bản trình bày. Bảng điều khiển trang trình bày chứa tất cả các thành phần trang phổ biến và các thuộc tính phổ biến cho một nhóm bố cục. Các thẻ này phục vụ 3 mục đích:

  • Các hình giữ chỗ trên trang mẫu chứa các kiểu văn bản và thuộc tính hình dạng mặc định của tất cả các hình giữ chỗ trên các trang sử dụng trang mẫu đó.
  • Thuộc tính trang chính xác định các thuộc tính trang chung được kế thừa theo bố cục của trang.
  • Mọi hình dạng khác trên trang trình bày mẫu sẽ xuất hiện trên tất cả các trang trình bày sử dụng trang trình bày mẫu đó, bất kể bố cục của các trang trình bày đó.
layouts[]

object (Page)

Bố cục trong bản trình bày. Bố cục là một mẫu xác định cách sắp xếp và tạo kiểu nội dung trên các trang trình bày kế thừa từ bố cục đó.
locale

string

Ngôn ngữ của bản trình bày, dưới dạng thẻ ngôn ngữ IETF BCP 47.
revisionId

string

Chỉ có đầu ra. Mã sửa đổi của bản trình bày. Có thể dùng trong các yêu cầu cập nhật để xác nhận bản sửa đổi bản trình bày không thay đổi kể từ thao tác đọc gần đây nhất. Chỉ được điền nếu người dùng có quyền chỉnh sửa bản trình bày.

Mã sửa đổi không phải là số tuần tự mà là một chuỗi mơ hồ. Định dạng của mã bản sửa đổi có thể thay đổi theo thời gian, vì vậy, bạn nên xử lý mã này một cách không rõ ràng. Mã sửa đổi được trả về chỉ được đảm bảo hợp lệ trong 24 giờ sau khi được trả về và không thể chia sẻ giữa các người dùng. Nếu mã sửa đổi không thay đổi giữa các lệnh gọi, thì bản trình bày không thay đổi. Ngược lại, mã nhận dạng đã thay đổi (đối với cùng một bản trình bày và người dùng) thường có nghĩa là bản trình bày đã được cập nhật. Tuy nhiên, mã nhận dạng cũng có thể thay đổi do các yếu tố nội bộ, chẳng hạn như thay đổi định dạng mã nhận dạng.
notesMaster

object (Page)

Bản ghi chú chính trong bản trình bày. Mã này có ba mục đích:

  • Các hình giữ chỗ trên trang tổng quan ghi chú chứa các kiểu văn bản mặc định và thuộc tính hình dạng của tất cả các hình giữ chỗ trên notes pages. Cụ thể, hình dạng phần giữ chỗ SLIDE_IMAGE chứa hình thu nhỏ của trang trình bày và hình dạng phần giữ chỗ BODY chứa ghi chú của người nói.
  • Thuộc tính trang chính của ghi chú xác định các thuộc tính trang phổ biến mà tất cả notes pages kế thừa.
  • Mọi hình dạng khác trên trang tổng quan ghi chú sẽ xuất hiện trên tất cả notes pages.

Trang tổng quan ghi chú ở chế độ chỉ có thể đọc.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể Presentation mới tạo.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.