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. Các mã đối tượng mà Page và PageElement sử dụng có chung không gian tên.
pageType

enum (PageType)

Loại trang.
pageElements[]

object (PageElement)

Các thành phần trang 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ể 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 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ố tuần 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ã bản sửa đổi được trả về chỉ được đảm bảo 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 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, mã nhận dạng được thay đổi cũng có thể do các yếu tố nội bộ, chẳng hạn như các thay đổi về định dạng mã nhận dạng.
pageProperties

object (PageProperties)

Các thuộc tính của trang.
Trường hợp properties. Thuộc tính dành riêng cho từng loại trang. Bản 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:
slideProperties

object (SlideProperties)

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

object (LayoutProperties)

Thuộc tính cụ thể về bố cục. Chỉ đặt nếu pageType = LA nềnT.
notesProperties

object (NotesProperties)

Thuộc tính cụ thể của ghi chú. Chỉ được đặt nếu pageType = NOTES.
masterProperties

object (MasterProperties)

Chính các thuộc tính cụ thể. Chỉ được đặ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 Một trang ghi chú chính.

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. Các mã đối tượng mà google.apps.slides.v1.Page và google.apps.slides.v1.PageElement sử dụng có chung không gian tên.
size

object (Size)

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

object (AffineTransform)

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

Giao diện trực quan của phần tử trang được xác định bởi sự biến đổi tuyệt đối của phần tử đó. Để tính toán 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 các 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ử đó 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

Mô tả phần tử trang. Được 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 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:
elementGroup

object (Group)

Tập hợp các phần tử trang được kết hợp dưới dạng 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)

Phần tử trang dòng.
table

object (Table)

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

object (WordArt)

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

object (SheetsChart)

Một biểu đồ liên kết được nhúng từ Google Trang tính. Biểu đồ chưa được liên kết sẽ được biểu thị 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ử trang đã 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. 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 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)

Thuộc tính của tính năng Tiêu điểm người nói.

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 người nói. Nếu bạn không đặt chính sách này, thì chính sách sẽ không có đường viền.
shadow

object (Shadow)

Bóng của tính năng Tiêu điểm người nói. Nếu bạn không đặt chính sách này, khung này sẽ không có bóng.

SlideProperties

Các thuộc tính của Page chỉ liên quan đến 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 chính 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ú liên kết với trang trình bày này. Nó 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 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 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ỉ liên quan đến những trang có pageType LA YOUT.

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 chính mà bố cục này dựa trên.
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 cho 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 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ế 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ã đố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 cho các trang có pageType MASTER.

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

string

Tên quản trị viên 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 sản phẩm từ trang gốc. Tuỳ thuộc vào loại trang, hệ thống phân cấp sẽ đượ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ó thành phần mẹ, thì màu nền sẽ được mặc định 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ừ trang gốc. Nếu trang không có thành phần 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 giá trị mặc định trong trình chỉnh sửa Trang trình bày.

Chỉ có màu cụ thể của 12 ThemeColorType đầu tiên là có thể chỉnh sửa. 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 có chứa các ánh xạ từ tất cả 12 ThemeColorTypes đầu tiên đến màu cụ thể. Màu 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 điền nền.

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

object (SolidFill)

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

object (StretchedPictureFill)

Điền hình ảnh kéo giãn.

StretchedPictureFill

Ảnh kéo giãn sẽ được lấp đầy. Trang hoặc phần tử trang được tô hoàn toàn bằng ảnh được chỉ đị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 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ả vào ảnh như 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.

Ghi 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 đượ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 ảnh lấp đầy hình ảnh. Trường này chỉ để đọc.

ColorScheme

Bảng màu gồm các màu được xác định trước cho 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ạ một kiểu màu giao diện với màu cụ thể mà kiểu màu đó biểu thị.

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 thu nhỏ.