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)

演講者鏡頭畫面。

群組

PageElement 類型代表已彙整的 PageElements 集合。

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 的屬性，僅適用於頁面類型為 MASTER 的網頁。

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

string

主檔案的使用者可讀名稱。

PageProperties

Page 的屬性。

該頁面會繼承父頁面的屬性。階層的定義會根據網頁類型，在 SlideProperties 或 LayoutProperties 中定義。

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

object (PageBackgroundFill)

頁面的背景填充。如果未設定，背景填充會從父項網頁繼承 (如果有)。如果頁面沒有父項，背景填充會預設為相應的填充，並顯示在投影片編輯器中。
colorScheme

object (ColorScheme)

網頁的色彩配置。如果未設定，色彩配置會沿用父項頁面。如果網頁沒有父項，色彩配置會採用預設的 Google 簡報色彩配置，與 Google 簡報編輯器中的預設設定一致。

只有前 12 個 ThemeColorType 的具體顏色可供編輯。此外，您只能更新 Master 頁面上的色彩配置。如要更新這個欄位，您必須提供色彩配置，其中包含從前 12 個 ThemeColorType 到其具體顏色的對應項目。系統會忽略其他 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，且不得超過 2,500 萬像素，格式必須為 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

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