REST Resource: presentations.pages

Tài nguyên: Trang

Một trang trong bản trình bày.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "pageType": enum (PageType),
  "pageElements": [
    {
      object (PageElement)
    }
  ],
  "revisionId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "commentAnchors": [
    {
      object (CommentAnchor)
    }
  ],
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of mutually exclusive fields.
}
Trường
objectId

string

Mã đối tượng của trang này. Mã nhận dạng đối tượng mà Page và PageElement sử dụng có cùng không gian tên.
pageType

enum (PageType)

Loại trang.
pageElements[]

object (PageElement)

Các phần tử trang được hiển thị trên trang.
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ừ lần đọ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ã 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. Mã phiên bản được trả về chỉ được đảm bảo là 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ã nhận dạng bản 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 (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, 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.
pageProperties

object (PageProperties)

Các thuộc tính của trang.
commentAnchors[]

object (CommentAnchor)

Chỉ có đầu ra. Các điểm neo bình luận có trên trang.

comments[]

object (CommentThread)

Chỉ có đầu ra. Các chuỗi bình luận liên kết với trang. Chỉ được điền sẵn nếu trang được tìm nạp thông qua một GetPageRequest có commentsViewMode được điền sẵn. Nếu không, các bình luận sẽ được trả về trong Presentation thông qua GetPresentationRequest.

commentsViewMode

enum (CommentsViewMode)

Chỉ có đầu ra. Chế độ xem bình luận được áp dụng cho trang. Chỉ được điền sẵn nếu trang được tìm nạp thông qua một GetPageRequest có commentsViewMode được điền sẵn.

Các thuộc tính dành riêng cho từng loại trang. Bản gốc không yêu cầu thêm thuộc tính nào. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
slideProperties

object (SlideProperties)

Các thuộc tính cụ thể của trang trình bày. Chỉ đặt nếu pageType = SLIDE.
layoutProperties

object (LayoutProperties)

Thuộc tính cụ thể của bố cục. Chỉ đặt nếu pageType = LAYOUT.
notesProperties

object (NotesProperties)

Ghi chú các thuộc tính cụ thể. Chỉ đặt nếu pageType = NOTES.
masterProperties

object (MasterProperties)

Nắm vững các thuộc tính cụ thể. Chỉ đặt nếu pageType = MASTER.
Kết thúc các trường xung khắc.

PageType

Loại trang.

Enum
SLIDE Một trang trình bày.
MASTER Trang trang trình bày chính.
LAYOUT Một trang bố cục.
NOTES Một trang ghi chú.
NOTES_MASTER Trang cái ghi chú.

PageElement

Một phần tử trực quan được hiển thị trên trang.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  },
  "title": string,
  "description": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "elementGroup": {
    object (Group)
  },
  "shape": {
    object (Shape)
  },
  "image": {
    object (Image)
  },
  "video": {
    object (Video)
  },
  "line": {
    object (Line)
  },
  "table": {
    object (Table)
  },
  "wordArt": {
    object (WordArt)
  },
  "sheetsChart": {
    object (SheetsChart)
  },
  "speakerSpotlight": {
    object (SpeakerSpotlight)
  }
  // End of mutually exclusive fields.
}
Trường
objectId

string

Mã đối tượng cho phần tử trang này. Mã nhận dạng đối tượng mà google.apps.slides.v1.Page và google.apps.slides.v1.PageElement sử dụng có cùng không gian tên.
size

object (Size)

Kích thước của phần tử trang.
transform

object (AffineTransform)

Phép biến đổi của phần tử trang.

Hình thức trực quan của phần tử trang được xác định bằng phép biến đổi tuyệt đối. Để tính toán phép biến đổi tuyệt đối, hãy kết hợp trước phép biến đổi của một phần tử trang với phép biến đổi của tất cả các nhóm mẹ của phần tử đó. Nếu phần tử trang không nằm trong một nhóm, thì phép biến đổi tuyệt đối của phần tử đó sẽ giống với giá trị trong trường này.

Phép biến đổi ban đầu cho Group mới tạo luôn là phép biến đổi nhận dạng.
title

string

Tiêu đề của phần tử trang. Kết hợp với nội dung mô tả để hiển thị văn bản thay thế.

Trường này không được hỗ trợ cho các phần tử Group.
description

string

Nội dung mô tả về phần tử trang. Kết hợp với tiêu đề để hiển thị văn bản thay thế.

Trường này không được hỗ trợ cho các phần tử Group.
Loại phần tử mà PageElement này đại diện. Mỗi thông báo chứa mọi thuộc tính dành riêng cho loại phần tử trang đó. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
elementGroup

object (Group)

Một tập hợp các phần tử trang được kết hợp thành một đơn vị duy nhất.
shape

object (Shape)

Hình dạng chung.
image

object (Image)

Một phần tử trang hình ảnh.
video

object (Video)

Một phần tử trang video.
line

object (Line)

Một phần tử trang đường kẻ.
table

object (Table)

Một phần tử trang bảng.
wordArt

object (WordArt)

Một phần tử trang chữ nghệ thuật.
sheetsChart

object (SheetsChart)

Biểu đồ được liên kết được nhúng từ Google Trang tính. Biểu đồ không được liên kết sẽ xuất hiện dưới dạng hình ảnh.
speakerSpotlight

object (SpeakerSpotlight)

Tiêu điểm của người nói.
Kết thúc các trường xung khắc.

Nhóm

Một loại PageElement đại diện cho một tập hợp kết hợp của PageElement.

Biểu diễn dưới dạng JSON 
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
Trường
children[]

object (PageElement)

Tập hợp các phần tử trong nhóm. Số lượng thành viên tối thiểu của một nhóm là 2.

WordArt

Một loại PageElement đại diện cho chữ nghệ thuật.

Biểu diễn dưới dạng JSON 
{
  "renderedText": string
}
Trường
renderedText

string

Văn bản được hiển thị dưới dạng chữ nghệ thuật.

SpeakerSpotlight

Loại PageElement đại diện cho tính năng Video của người trình bày.

Biểu diễn dưới dạng JSON 
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
Trường
speakerSpotlightProperties

object (SpeakerSpotlightProperties)

Các thuộc tính của tính năng Video của người trình bày.

SpeakerSpotlightProperties

Các thuộc tính của SpeakerSpotlight.

Biểu diễn dưới dạng JSON 
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
Trường
outline

object (Outline)

Đường viền của tính năng Tiêu điểm của người nói. Nếu bạn không đặt, thì nút này sẽ không có đường viền.
shadow

object (Shadow)

Độ bóng của tính năng Tiêu điểm của người nói. Nếu bạn không đặt, thì nút sẽ không có bóng.

SlideProperties

Các thuộc tính của Page chỉ phù hợp với những trang có pageType là SLIDE.

Biểu diễn dưới dạng JSON 
{
  "layoutObjectId": string,
  "masterObjectId": string,
  "notesPage": {
    object (Page)
  },
  "isSkipped": boolean
}
Trường
layoutObjectId

string

Mã đối tượng của bố cục mà trang trình bày này dựa trên. Thuộc tính này ở chế độ chỉ đọc.
masterObjectId

string

Mã đối tượng của mẫu mà trang trình bày này dựa trên. Thuộc tính này ở chế độ chỉ đọc.
notesPage

object (Page)

Trang ghi chú được liên kết với trang trình bày này. Định dạng này xác định giao diện của trang ghi chú khi in hoặc xuất trang trình bày có ghi chú của người thuyết trình. Trang ghi chú kế thừa các thuộc tính từ notes master. Hình dạng phần giữ chỗ có loại BODY trên trang ghi chú chứa ghi chú của người thuyết trình cho trang trình bày này. Mã nhận dạng của hình dạng này được xác định bằng trường speakerNotesObjectId. Trang ghi chú ở chế độ chỉ đọc, ngoại trừ nội dung văn bản và kiểu dáng của hình ghi chú của người thuyết trình. Thuộc tính này ở chế độ chỉ đọc.
isSkipped

boolean

Trang trình bày có bị bỏ qua ở chế độ trình bày hay không. Giá trị mặc định là false.

LayoutProperties

Các thuộc tính của Page chỉ liên quan đến các trang có pageType LAYOUT.

Biểu diễn dưới dạng JSON 
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
Trường
masterObjectId

string

Mã đối tượng của mẫu mà bố cục này dựa trên.
name

string

Tên của bố cục.
displayName

string

Tên dễ đọc của bố cục.

NotesProperties

Các thuộc tính của Page chỉ liên quan đến các trang có pageType NOTES.

Biểu diễn dưới dạng JSON 
{
  "speakerNotesObjectId": string
}
Trường
speakerNotesObjectId

string

Mã đối tượng của hình dạng trên trang ghi chú này có chứa ghi chú của người thuyết trình cho trang trình bày tương ứng. Hình dạng thực tế có thể không phải lúc nào cũng xuất hiện trên trang ghi chú. Việc chèn văn bản bằng mã nhận dạng đối tượng này sẽ tự động tạo hình dạng. Trong trường hợp này, hình dạng thực tế có thể có mã nhận dạng đối tượng khác. Thao tác presentations.get hoặc pages.get sẽ luôn trả về mã nhận dạng đối tượng mới nhất.

MasterProperties

Các thuộc tính của Page chỉ liên quan đến những trang có pageType MASTER.

Biểu diễn dưới dạng JSON 
{
  "displayName": string
}
Trường
displayName

string

Tên dễ đọc của bản gốc.

PageProperties

Các thuộc tính của Page.

Trang này sẽ kế thừa các thuộc tính từ trang mẹ. Tuỳ thuộc vào loại trang, hệ thống phân cấp được xác định trong SlideProperties hoặc LayoutProperties.

Biểu diễn dưới dạng JSON 
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
Trường
pageBackgroundFill

object (PageBackgroundFill)

Màu nền của trang. Nếu bạn không đặt giá trị này, thì màu nền sẽ được kế thừa từ trang mẹ (nếu có). Nếu trang không có trang mẹ, thì màu nền sẽ mặc định là màu tương ứng trong trình chỉnh sửa Trang trình bày.
colorScheme

object (ColorScheme)

Bảng phối màu của trang. Nếu bạn không đặt, bảng phối màu sẽ được kế thừa từ trang mẹ. Nếu trang không có trang mẹ, thì bảng phối màu sẽ sử dụng bảng phối màu mặc định của Trang trình bày, khớp với các giá trị mặc định trong trình chỉnh sửa Trang trình bày.

Bạn chỉ có thể chỉnh sửa màu sắc cụ thể của 12 ThemeColorType đầu tiên. Ngoài ra, bạn chỉ có thể cập nhật bảng phối màu trên các trang Master. Để cập nhật trường này, bạn phải cung cấp một bảng phối màu chứa các mối liên kết từ tất cả 12 ThemeColorType đầu tiên đến các màu cụ thể của chúng. Màu cho ThemeColorTypes còn lại sẽ bị bỏ qua.

PageBackgroundFill

Màu nền của trang.

Biểu diễn dưới dạng JSON 
{
  "propertyState": enum (PropertyState),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of mutually exclusive fields.
}
Trường
propertyState

enum (PropertyState)

Trạng thái thuộc tính tô nền.

Việc cập nhật nội dung điền sẵn trên một trang sẽ ngầm cập nhật trường này thành RENDERED, trừ phi bạn chỉ định một giá trị khác trong cùng một yêu cầu. Để không có phần tô trên trang, hãy đặt trường này thành NOT_RENDERED. Trong trường hợp này, mọi trường điền sẵn khác được đặt trong cùng một yêu cầu sẽ bị bỏ qua.
Loại màu nền. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
solidFill

object (SolidFill)

Màu nền đồng nhất.
stretchedPictureFill

object (StretchedPictureFill)

Lấp đầy bằng hình ảnh kéo dài.
Kết thúc các trường xung khắc.

StretchedPictureFill

Hình ảnh được kéo giãn để lấp đầy. Trang hoặc phần tử trang được lấp đầy hoàn toàn bằng hình ảnh đã chỉ định. Hình ảnh bị kéo giãn cho vừa với vùng chứa.

Biểu diễn dưới dạng JSON 
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
Trường
contentUrl

string

Đọc contentUrl:

URL dẫn đến một bức ảnh có thời gian tồn tại mặc định là 30 phút. URL này được gắn thẻ bằng tài khoản của người yêu cầu. Bất kỳ ai có URL này đều có thể truy cập vào hình ảnh với tư cách là người yêu cầu ban đầu. Bạn có thể mất quyền truy cập vào hình ảnh nếu cài đặt cách chia sẻ của bản trình bày thay đổi.

Viết contentUrl:

Hình ảnh được tìm nạp một lần tại thời điểm chèn và một bản sao được lưu trữ để hiển thị trong bản trình bày. Kích thước của hình ảnh phải nhỏ hơn 50 MB, không được vượt quá 25 megapixel và phải ở một trong các định dạng PNG, JPEG hoặc GIF.

URL bạn cung cấp có thể dài tối đa 2 kB.
size

object (Size)

Kích thước ban đầu của phần tô bằng hình ảnh. Trường này ở chế độ chỉ đọc.

ColorScheme

Bảng màu xác định trước cho một trang.

Biểu diễn dưới dạng JSON 
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Trường
colors[]

object (ThemeColorPair)

ThemeColorType và các cặp màu cụ thể tương ứng.

ThemeColorPair

Một cặp ánh xạ loại màu giao diện với màu cụ thể mà loại màu đó thể hiện.

Biểu diễn dưới dạng JSON 
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
Trường
type

enum (ThemeColorType)

Loại màu giao diện.
color

object (RgbColor)

Màu cụ thể tương ứng với loại màu chủ đề ở trên.

CommentAnchor

Chứa danh sách tất cả các vị trí trong một Page được liên kết với một CommentThread thông qua cùng một anchorId. Nhiều điểm neo riêng biệt có thể tham chiếu đến cùng một vị trí, trong một Page hoặc trên nhiều trang,

Biểu diễn dưới dạng JSON 
{
  "anchorId": string,
  "objectAnchors": [
    {
      object (ObjectAnchor)
    }
  ]
}
Trường
anchorId

string

Chỉ có đầu ra. Mã nhận dạng duy nhất của điểm neo bình luận.
objectAnchors[]

object (ObjectAnchor)

Chỉ có đầu ra. Tất cả vị trí dựa trên mã nhận dạng đối tượng trong một trang tham chiếu đến mã nhận dạng điểm neo.

ObjectAnchor

Biểu thị dữ liệu điểm neo của bình luận được liên kết với một đối tượng trên Trang trình bày, chẳng hạn như Page hoặc PageElement.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "shapeTextAnchors": {
    object (ShapeTextAnchors)
  },
  "tableCellAnchors": {
    object (TableCellAnchors)
  }
  // End of mutually exclusive fields.
}
Trường
objectId

string

Chỉ có đầu ra. Trang hoặc phần tử trang mà chuỗi bình luận được liên kết.
Chỉ có đầu ra. Phạm vi văn bản trong phần tử trang mà chuỗi bình luận được liên kết. Sẽ trống nếu điểm neo bình luận là cho toàn bộ trang hoặc phần tử trang thay vì một dải văn bản trong phần tử. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
shapeTextAnchors

object (ShapeTextAnchors)

Được điền sẵn cho Shapes có nhận xét được liên kết với các dải văn bản trong [text][google.apps.slides.v1.Shape.TextContent] của hình dạng.
tableCellAnchors

object (TableCellAnchors)

Được điền sẵn cho Tables có nhận xét được liên kết với các dải văn bản trong một hoặc nhiều ô của bảng.
Kết thúc các trường xung khắc.

ShapeTextAnchors

Biểu thị các dải văn bản trong một hình được bao phủ bởi một điểm neo chú thích.

Biểu diễn dưới dạng JSON 
{
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
Trường
ranges[]

object (TextRange)

Danh sách các dải văn bản được neo bởi chú thích.

TextRange

Chỉ định một dải văn bản liền kề trong text của một ô trong hình dạng hoặc bảng.

Biểu diễn dưới dạng JSON 
{
  "startIndex": integer,
  "endIndex": integer
}
Trường
startIndex

integer

Chỉ mục bắt đầu của phạm vi (dựa trên 0). Trường này là Int32Value để đáp ứng các trường hợp sử dụng trong tương lai với các phạm vi mở.
endIndex

integer

Chỉ mục dựa trên 0 của điểm cuối của phạm vi. Trường này là Int32Value để đáp ứng các trường hợp sử dụng trong tương lai với các phạm vi mở.

TableCellAnchors

Biểu thị dải ô trong bảng nằm trong một bảng được bao phủ bởi một điểm neo chú thích.

Biểu diễn dưới dạng JSON 
{
  "cellRanges": [
    {
      object (TableCellTextRanges)
    }
  ]
}
Trường
cellRanges[]

object (TableCellTextRanges)

Danh sách tất cả các ô trong bảng có văn bản được neo trong bảng.

TableCellTextRanges

Biểu thị các dải văn bản trong một ô của bảng được bao phủ bởi một điểm neo nhận xét.

Biểu diễn dưới dạng JSON 
{
  "cellLocation": {
    object (TableCellLocation)
  },
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
Trường
cellLocation

object (TableCellLocation)

Vị trí của ô trong bảng.
ranges[]

object (TextRange)

Danh sách tất cả các dải văn bản được neo trong ô này.

Phương thức

get

 Lấy phiên bản mới nhất của trang được chỉ định trong bản trình bày.

getThumbnail

 Tạo hình thu nhỏ của phiên bản mới nhất của trang được chỉ định trong bản trình bày và trả về một URL đến hình thu nhỏ.