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 của trang này. Mã đối tượng mà PagePageElement 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ã 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ờ. Định dạng của mã sửa đổi có thể thay đổi theo thời gian. Mã nhận dạng 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 đã 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.

pageProperties

object (PageProperties)

Thuộc tính của trang.

Trường kết hợp properties. Những thuộc tính cụ thể cho từng loại trang. Quảng cáo chính không yêu cầu bất kỳ thuộc tính bổ sung nào. properties chỉ có thể là một trong những trạng thái sau đây:
slideProperties

object (SlideProperties)

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

Hãy điều chỉnh 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 Một trang trình bày chính.
LAYOUT Trang bố cục.
NOTES Trang ghi chú.
NOTES_MASTER Trang chính ghi chú.

PageElement

Một phần tử hình ảnh hiển thị 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.Pagegoogle.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)

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

Giao diện trực quan của phần tử trang được xác định bởi biến đổi tuyệt đối của phần tử đó. Để tính toán biến đổi tuyệt đối, hãy liên kết trước biến đổi của một phần tử trang với các 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ì 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 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.

Trường kết hợp element_kind. Loại phần tử mà PageElement này đại diện. Mỗi thông báo chứa bất kỳ thuộc tính nào dành riêng cho loại phần tử trang đó. element_kind chỉ có thể là một trong những trạng thái sau đây:
elementGroup

object (Group)

Tập hợp các phần tử trang đã kết hợp dưới dạng một đơn vị duy nhất.

shape

object (Shape)

Hình dạng chung chung.

image

object (Image)

Phần tử trang hình ảnh.

video

object (Video)

Phần tử trang video.

line

object (Line)

Phần tử trang dòng.

table

object (Table)

Phần tử trang của bảng.

wordArt

object (WordArt)

Phần tử trang nghệ thuật chữ.

sheetsChart

object (SheetsChart)

Một biểu đồ được liên kết được nhúng từ Google Trang tính. Các biểu đồ chưa liên kết được thể hiện dưới dạng hình ảnh.

speakerSpotlight

object (SpeakerSpotlight)

Tiêu điểm người nói.

Nhóm

Một loại PageElement đại diện cho một tập hợp các phần tử PageElements đã tham gia.

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. Quy mô tối thiểu của 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 Tiêu điểm người nói.

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)

Hình dáng của tính năng Video của người trình bày. Nếu bạn không đặt chính sách này, thì hình ảnh sẽ không có đường viền.

shadow

object (Shadow)

Bóng của Tiêu điểm người nói. Nếu bạn không đặt chính sách này, thì mô hình này 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 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. Tài sản này đang ở chế độ 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. Tài sản này đang ở chế độ chỉ có thể đọc.

notesPage

object (Page)

Trang ghi chú mà trang trình bày này được liên kết. Định dạng này xác định giao diện trực quan 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ỗ thuộc kiểu 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 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 trong 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ỉ phù hợp với 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 trang cái mà bố cục này dựa vào.

name

string

Tên 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 những trang có GHI CHÚ CỦA pageType.

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 tồn tại trên trang ghi chú. Việc chèn văn bản bằng cách sử dụng mã đố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ỉ phù hợp với những trang có pageType MASTER.

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

string

Tên của thiết bị chính mà con người có thể đọc được.

PageProperties

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

Trang sẽ kế thừa các tài sản từ trang gốc. 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ó phần tử mẹ, thì màu nền mặc định sẽ là màu nền 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 chính sách này, bảng phối màu sẽ được kế thừa từ một trang gốc. Nếu trang không có thành phần cha, 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, phù hợp với giá trị 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 bảng phối màu chứa các bản đồ ánh xạ từ tất cả 12 ThemeColorTypes đầu tiên đến màu cụ thể. Màu của các ThemeColorTypes còn lại sẽ bị bỏ qua.

PageBackgroundFill

Lấp đầy 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 lấp đầy nền.

Việc cập nhật phần điề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 yêu cầu đó. Để không điền vào một 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 đã đặt trong cùng một yêu cầu sẽ bị bỏ qua.

Trường kết hợp kind. Loại màu nền. kind chỉ có thể là một trong những trạng thái sau đây:
solidFill

object (SolidFill)

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

stretchedPictureFill

object (StretchedPictureFill)

Căng ảnh lấp đầy.

StretchedPictureFill

Ảnh kéo giãn. 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 bị 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 đều truy cập hiệu quả bức ảnh này với tư cách là người yêu cầu ban đầu. Quyền truy cập vào hình ảnh có thể bị mất nếu cài đặt chia sẻ của bản trình bày thay đổi.

Viết contentUrl:

Ảnh được tìm nạp một lần tại thời điểm chèn và một bản sao sẽ đượ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 toàn bộ hình ảnh. Trường này ở chế độ chỉ đọ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ặp màu cụ thể tương ứng.

ThemeColorPair

Một cặp màu liên kết một loại màu giao diện với 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 cụ thể tương ứng với loại màu giao diện ở 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 cho hình ảnh thu nhỏ.