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ì 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 cả nội dung được cung cấp, đều 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 với 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)
  },
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode)
}
Trường
presentationId

string

Mã nhận dạng 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. Một trang trình bày sẽ 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)

Mẫu trang trình bày trong bản trình bày. Trang chiếu gốc chứa tất cả các phần tử trang phổ biến và các thuộc tính phổ biến cho một nhóm bố cục. Các chỉ số này có 3 mục đích:

  • Các hình giữ chỗ trên trang mẫu 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ả các hình giữ chỗ trên những trang sử dụng trang mẫu đó.
  • Các thuộc tính của trang chính xác định các thuộc tính chung của trang mà bố cục của trang đó kế thừa.
  • 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 mẫu đó, 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ột mẫu xác định cách sắp xếp và tạo kiểu cho 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ã phiên bản 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 rằng 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 sẵn nếu người dùng có quyền chỉnh sửa bản trình bày.

Mã nhận dạng phiên bản không phải là một số tuần tự mà là một chuỗi không rõ ràng. Định dạng của mã nhận dạng bản sửa đổi có thể thay đổi theo thời gian, vì vậy, bạn nên coi mã này là không rõ ràng. Chúng tôi chỉ đảm bảo mã phiên bản được trả về là hợp lệ trong 24 giờ sau khi được trả về và không thể chia sẻ mã này giữa các người dùng. Nếu mã phiên bản 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 thay đổi cũng có thể là 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)

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

  • Các hình dạng giữ chỗ trên trang ghi chú chính chứa 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 dạng 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 thuộc tính trang cái ghi chú xác định các thuộc tính trang chung mà tất cả notes pages đều kế thừa.
  • Mọi hình dạng khác trên trang ghi chú chính đều xuất hiện trên tất cả notes pages.

Mẫu ghi chú ở chế độ chỉ có thể đọc.
comments[]

object (CommentThread)

Chỉ có đầu ra. Các chuỗi bình luận liên kết với bản trình bày.
commentsViewMode

enum (CommentsViewMode)

Chỉ có đầu ra. Chế độ xem bình luận được áp dụng cho bản trình bày.

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.