Method: presentations.create

Tạo một bản trình bày trống bằng cách sử dụng tiêu đề đã cho trong yêu cầu. Nếu bạn cung cấp presentationId, thì mã này 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, một mã nhận dạng mới sẽ được tạo. Các trường khác trong yêu cầu, bao gồm mọi nội dung đã 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ã nhận dạng của bản trình bày.

pageSize

object (Size)

Kích thướ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. Một trang trình bày kế thừa các thuộc tính của một bố cục trang trình bày.

title

string

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

masters[]

object (Page)

Trang trình bày chính trong bản trình bày. Một trang trình bày chính chứa tất cả các phần tử trang phổ biến và các thuộc tính chung của một bộ bố cục. Chúng phục vụ ba mục đích:

  • Hình dạng phần giữ chỗ trên một trang cái 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ả hình dạng phần giữ chỗ trên những trang sử dụng hình dạng chính đó.
  • Tài sản trang chính xác định các thuộc tính trang phổ biến mà bố cục kế thừa.
  • Mọi hình dạng khác trên trang trình bày chính 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 chính đó, bất kể bố cục của chúng.
layouts[]

object (Page)

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

locale

string

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

revisionId

string

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

Mã bản sửa đổi không phải là một số thứ 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 sử dụng định dạng này không rõ ràng. Mã bản sửa đổi được trả về chỉ được đảm bảo là có hiệu lực trong vòng 24 giờ sau khi được trả về và không thể chia sẻ cho nhiều 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 sẽ không thay đổi. Ngược lại, mã nhận dạng được thay đổi (cho 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, giấy tờ tuỳ thân đã thay đổi cũng có thể do các yếu tố nội bộ, chẳng hạn như việc thay đổi định dạng của giấy tờ tuỳ thân.

notesMaster

object (Page)

Ghi chú chính trong bản trình bày. Quy trình này phục vụ ba mục đích:

  • Hình dạng phần giữ chỗ trên một bản ghi chú chính chứa kiểu văn bản và thuộc tính hình dạng mặc định của tất cả hình dạng phần 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 thuyết trình.
  • Các tài sản trang chính ghi chú xác định những 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 cái ghi chú đều xuất hiện trên tất cả notes pages.

Phần ghi chú chính ở 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ể mới tạo của Presentation.

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.