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)
  },

  // Union field properties can be only one of the following:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of list of possible types for union field properties.
}
Trường
objectId

string

Mã đối tượng cho trang này. Mã đối tượng mà Page và PageElement sử dụng có cùng một 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ã 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ờ. Định dạng của mã bản sửa đổi có thể thay đổi theo thời gian. 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.
pageProperties

object (PageProperties)

Các thuộc tính của trang.
Trường kết hợp properties. Các thuộc tính dành riêng cho từng loại trang. Bản chính không yêu cầu thêm thuộc tính nào. properties chỉ có thể là một trong những giá trị sau:
slideProperties

object (SlideProperties)

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

object (LayoutProperties)

Bố cục các thuộc tính cụ thể. 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)

Tìm hiểu các thuộc tính cụ thể. Chỉ đặt nếu pageType = MASTER.

PageType

Loại trang.

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

PageElement

Một phần tử hình ảnh được kết xuất trên một trang.

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

  // Union field element_kind can be only one of the following:
  "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 list of possible types for union field element_kind.
}
Trường
objectId

string

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

object (Size)

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

object (AffineTransform)

Biến đổi của phần tử trang.

Hình thức hiển thị của phần tử trang được xác định bằng phép biến đổi tuyệt đối của phần tử đó. Để tính toán phép biến đổi tuyệt đối, hãy nối 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ẹ. 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.

Biến đổi ban đầu cho Group mới tạo luôn là 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ả 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.
Trường hợp hợp nhất element_kind. 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 đó. element_kind chỉ có thể là một trong những giá trị sau:
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ị.
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)

Phần tử trang dòng.
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 đồ chưa được liên kết được biểu thị dưới dạng hình ảnh.
speakerSpotlight

object (SpeakerSpotlight)

Một video của người trình bày.

Nhóm

Loại PageElement đại diện cho một bộ sưu tập PageElements đã kết hợp.

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. Kích thước 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 một 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)

Nội dung của video của người trình bày. Nếu không được đặt, thì đường viền sẽ không có.
shadow

object (Shadow)

Bóng của Tiêu điểm của người nói. Nếu không được đặt, thì thành phần hiển thị sẽ không có bóng.

SlideProperties

Các thuộc tính của Page chỉ liên quan đến các 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ỉ có thể đọc.
masterObjectId

string

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

object (Page)

Trang ghi chú liên kết với trang trình bày này. Thuộc tính này xác định giao diện của trang ghi chú khi in hoặc xuất các 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ỉ có thể đọc, ngoại trừ nội dung văn bản và kiểu của hình dạng ghi chú của người thuyết trình. Tài sản này đang ở chế độ chỉ có thể đọc.
isSkipped

boolean

Liệu 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ã nhận dạng đối tượng của bản chính mà bố cục này dựa trên.
name

string

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

string

Tên bố cục mà con người có thể đọc được.

NotesProperties

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

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

string

Mã nhận dạng đối tượng của hình dạng trên trang ghi chú này chứa ghi chú của người nói 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 tồn tại 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ã đối tượng khác. Thao tác presentations.get hoặc pages.get sẽ luôn trả về mã đối tượng mới nhất.

MasterProperties

Các thuộc tính của Page chỉ liên quan đến các 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 chính.

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ệ 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 chính sách này, thì màu nền sẽ được kế thừa từ trang gốc (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 không được đặt, bảng phối màu sẽ được kế thừa từ trang mẹ. Nếu trang không có trang mẹ, 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 bảng phối màu mặc định trong trình chỉnh sửa Trang trình bày.

Chỉ có thể chỉnh sửa màu 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 ThemeColorTypes đầu tiên đến các màu cụ thể của chúng. Màu sắc cho các ThemeColorTypes còn lại sẽ bị bỏ qua.

PageBackgroundFill

Màu nền trang.

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

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of list of possible types for union field kind.
}
Trường
propertyState

enum (PropertyState)

Trạng thái thuộc tính màu 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 một giá trị khác được chỉ định trong cùng một yêu cầu. Để không có nội dung 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 khác được đặt trong cùng một yêu cầu sẽ bị bỏ qua.
Trường hợp hợp nhất kind. Loại màu nền. kind chỉ có thể là một trong những giá trị sau:
solidFill

object (SolidFill)

Tô màu đồng nhất.
stretchedPictureFill

object (StretchedPictureFill)

Lấp đầy hình ảnh bị kéo giãn.

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 được chỉ định. Hình ảnh được kéo giãn để 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 đến một hình ảnh có thời gian tồn tại mặc định là 30 phút. URL này được gắn thẻ với 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 dưới vai trò 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 chế độ cài đặt chia sẻ của bản trình bày thay đổi.

Ghi 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ị bên trong bản trình bày. Ảnh phải có kích thước 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 được cung cấp có thể dài tối đa 2 kB.
size

object (Size)

Kích thước ban đầu của hình ảnh lấp đầy. Trường này chỉ có thể đọc.

ColorScheme

Bảng màu gồm các màu được 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 đến màu cụ thể mà nó đại diệ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 bê tông tương ứng với loại màu chủ đề ở trên.

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ề URL đến hình thu nhỏ.