REST Resource: presentations.pages

資源：網頁

簡報中的頁面。

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.
}
欄位
objectId

string

這個網頁的物件 ID。Page 和 PageElement 使用的物件 ID 會共用相同的命名空間。
pageType

enum (PageType)

網頁類型。
pageElements[]

object (PageElement)

在網頁上顯示的網頁元素。
revisionId

string

僅供輸出。簡報的修訂版本 ID。可用於更新要求，以宣告簡報修訂版本自上次讀取作業後並未變更。只有在使用者擁有簡報的編輯權限時，才會填入資料。

修訂版本 ID 不是連續數字，而是不透明字串。修訂版本 ID 的格式可能會隨著時間變更。傳回的修訂版本 ID 必須在傳回後 24 小時內有效，且無法與所有使用者共用。如果每次呼叫之間的修訂版本 ID 沒有變更，表示簡報並未變更。反之，變更 ID (適用於同一個簡報和使用者) 通常表示簡報也已更新。不過，ID 格式變更等內部因素也可能造成 ID 變更。
pageProperties

object (PageProperties)

頁面的屬性。
聯集欄位 properties。各網頁類型專屬的屬性。主投影片不需要任何其他屬性。properties 只能是下列其中一項：
slideProperties

object (SlideProperties)

投影片特定屬性。只有在 pageType = SLIDE 時才需要設定。
layoutProperties

object (LayoutProperties)

版面配置的特定屬性。只有在 pageType = LAYOUT 時，才需要設定。
notesProperties

object (NotesProperties)

附註特定屬性。只有在 pageType = NOTES 的情況下才會設定。
masterProperties

object (MasterProperties)

主要特定屬性。只有在 pageType = MASTER 時，才需要設定。

PageType

網頁類型。

列舉
SLIDE 投影片頁面。
MASTER 主投影片頁面。
LAYOUT 版面配置頁面。
NOTES 附註頁面。
NOTES_MASTER 筆記主頁面。

PageElement

轉譯在網頁上的視覺元素。

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.
}
欄位
objectId

string

這個網頁元素的物件 ID。google.apps.slides.v1.Page 和 google.apps.slides.v1.PageElement 使用的物件 ID 會共用相同的命名空間。
size

object (Size)

網頁元素的大小。
transform

object (AffineTransform)

頁面元素的轉換。

網頁元素的視覺外觀取決於絕對轉換。如要計算絕對轉換，請將網頁元素的轉換與所有父項群組的轉換作業預先串連。如果網頁元素不在群組中，其絕對轉換會與這個欄位中的值相同。

新建 Group 的初始轉換一律是身分轉換。
title

string

網頁元素的標題。結合說明可顯示替代文字。

Group 元素不支援這個欄位。
description

string

網頁元素的說明。結合標題即可顯示替代文字。

Group 元素不支援這個欄位。
聯集欄位 element_kind。這個 PageElement 代表的元素類型。每個訊息都包含該類網頁元素特有的所有屬性。element_kind 只能是下列其中一項：
elementGroup

object (Group)

做為單一單元彙整的一系列網頁元素。
shape

object (Shape)

一般形狀。
image

object (Image)

圖片網頁元素。
video

object (Video)

影片網頁元素。
line

object (Line)

線條網頁元素。
table

object (Table)

表格網頁元素。
wordArt

object (WordArt)

文字藝術網頁元素。
sheetsChart

object (SheetsChart)

嵌入 Google 試算表的連結圖表。已取消連結的圖表則以圖片表示。
speakerSpotlight

object (SpeakerSpotlight)

演講者直播畫面。

群組

代表 PageElements 的彙整集合的 PageElement 種類。

JSON 表示法 
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
欄位
children[]

object (PageElement)

群組中的元素集合。群組大小下限為 2。

WordArt

代表文字藝術的 PageElement 種類。

JSON 表示法 
{
  "renderedText": string
}
欄位
renderedText

string

以文字藝術形式呈現的文字。

SpeakerSpotlight

代表演講者直播畫面的 PageElement 種類。

JSON 表示法 
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
欄位
speakerSpotlightProperties

object (SpeakerSpotlightProperties)

演講者直播畫面的屬性。

SpeakerSpotlightProperties

SpeakerSpotlight 的屬性。

JSON 表示法 
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
欄位
outline

object (Outline)

演講者直播畫面的輪廓。如果未設定，則沒有外框。
shadow

object (Shadow)

演講者直播畫面的陰影。如果未設定，就不會有陰影。

SlideProperties

Page 的屬性與含有 pageType SLIDE 的網頁相關。

JSON 表示法 
{
  "layoutObjectId": string,
  "masterObjectId": string,
  "notesPage": {
    object (Page)
  },
  "isSkipped": boolean
}
欄位
layoutObjectId

string

這張投影片所參照版面配置的物件 ID。這是唯讀屬性。
masterObjectId

string

這張投影片所參照的主物件 ID。這是唯讀屬性。
notesPage

object (Page)

與這張投影片相關的記事頁面。定義列印或匯出附有演講者備忘稿的投影片時，記事頁面的視覺外觀。附註頁面繼承 notes master 的屬性。備忘稿頁面上名為 BODY 的預留位置圖案，內含這張投影片的演講者備忘稿。此形狀的 ID 是由 speakerNotesObjectId 欄位識別。備忘稿頁面為唯讀狀態，但演講者備忘稿形狀的文字內容和樣式除外。這是唯讀屬性。
isSkipped

boolean

是否在簡報模式中略過投影片。預設值為 false。

LayoutProperties

Page 的屬性僅適用於含有 pageType LAYOUT 的網頁。

JSON 表示法 
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
欄位
masterObjectId

string

這個版面配置所依據的主物件 ID。
name

string

版面配置的名稱。
displayName

string

使用者可理解的版面配置名稱。

NotesProperties

Page 的屬性與含有 pageType NOTES 的網頁相關。

JSON 表示法 
{
  "speakerNotesObjectId": string
}
欄位
speakerNotesObjectId

string

這個記事頁面上的形狀物件 ID，包含對應投影片的演講者備忘稿。附註頁面不一定包含實際的形狀。使用這個物件 ID 插入文字會自動建立形狀。在這種情況下，實際形狀可能會有不同的物件 ID。presentations.get 或 pages.get 動作一律會傳回最新的物件 ID。

MasterProperties

Page 的屬性與具有 pageType MASTER 的網頁相關。

JSON 表示法 
{
  "displayName": string
}
欄位
displayName

string

使用者可理解的主要主要執行個體名稱。

PageProperties

Page 的屬性。

頁面會沿用上層頁面的屬性。階層會依網頁類型定義在 SlideProperties 或 LayoutProperties 中。

JSON 表示法 
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
欄位
pageBackgroundFill

object (PageBackgroundFill)

頁面的背景填滿。如未設定，背景填滿功能會沿用上層頁面 (如果有的話)。如果頁面沒有父項，系統會在簡報編輯器中將背景填滿預設設定。
colorScheme

object (ColorScheme)

網頁的色彩配置。如未設定，系統會沿用上層頁面的色彩配置。如果頁面沒有父項，系統會使用預設的 Google 簡報色彩配置 (與簡報編輯器中的預設值相符)。

您只能編輯前 12 個 ThemeColorType 的具體顏色。此外，您只能更新 Master 頁面的色彩配置。如要更新欄位，您必須提供內含前 12 個 ThemeColorTypes 與具體顏色對應的色彩配置。系統會忽略其餘 ThemeColorType 的顏色。

PageBackgroundFill

網頁背景填滿。

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.
}
欄位
propertyState

enum (PropertyState)

背景填滿屬性狀態。

更新網頁上的填滿時，這個欄位也會以隱含方式更新為 RENDERED，除非同一個要求中指定其他值。如果想在網頁上不填入廣告，請將此欄位設為 NOT_RENDERED。在這種情況下，系統會忽略同一個要求中設定的任何其他填入欄位。
聯集欄位 kind。背景填滿的種類。kind 只能是下列其中一項：
solidFill

object (SolidFill)

純色填滿。
stretchedPictureFill

object (StretchedPictureFill)

延展圖片填滿。

StretchedPictureFill

延展相片填滿。網頁或網頁元素會填滿指定圖片。相片會延展成符合容器大小。

JSON 表示法 
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
欄位
contentUrl

string

讀取 contentUrl：

圖片的網址，預設生命週期為 30 分鐘。這個網址已標記要求者的帳戶。任何知道網址的人，都能以原始要求者的身分存取相片。如果簡報的共用設定變更，您可能無法存取圖片。

寫入 contentUrl：

系統會在插入時擷取相片，並儲存副本以便顯示在簡報中。相片大小不得超過 50 MB，不得超過 2500 萬像素，且必須使用 PNG、JPEG 或 GIF 格式。

提供的網址長度上限為 2 KB。
size

object (Size)

圖片填滿的原始大小。這是唯讀欄位。

ColorScheme

網頁的預先定義顏色調色盤。

JSON 表示法 
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
欄位
colors[]

object (ThemeColorPair)

ThemeColorType 和相應的具體具體色彩組合。

ThemeColorPair

一組主題顏色類型，對應至所代表的具體顏色。

JSON 表示法 
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
欄位
type

enum (ThemeColorType)

主題顏色的類型。
color

object (RgbColor)

與上述主題顏色類型對應的具體顏色。

方法

get

 取得簡報中指定頁面的最新版本。

getThumbnail

 產生簡報中指定網頁的最新版本縮圖，並傳回縮圖的網址。