REST Resource: presentations.pages

資源：Page

簡報中的一頁。

JSON 表示法 
{
  "objectId": string,
  "pageType": enum (PageType),
  "pageElements": [
    {
      object (PageElement)
    }
  ],
  "revisionId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "commentAnchors": [
    {
      object (CommentAnchor)
    }
  ],
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of mutually exclusive fields.
}
欄位
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)

頁面的屬性。
commentAnchors[]

object (CommentAnchor)

僅供輸出。頁面上的註解錨點。
comments[]

object (CommentThread)

僅供輸出。與網頁相關聯的留言串。只有透過已填入 commentsViewMode 的 GetPageRequest 擷取網頁時，才會填入這個欄位。否則，系統會透過 GetPresentationRequest 在 Presentation 中傳回留言。
commentsViewMode

enum (CommentsViewMode)

僅供輸出。套用至頁面的留言檢視模式。只有透過已填入 commentsViewMode 的 GetPageRequest 擷取網頁時，才會填入這個欄位。
各頁面類型專屬的屬性。母帶不需要任何其他屬性。以下列出互斥的欄位。回應中最多只會設定一個欄位：
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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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 mutually exclusive fields.
}
欄位
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 元素不支援這個欄位。
這個 PageElement 代表的元素種類。每則訊息都包含特定網頁元素種類的屬性。以下列出互斥的欄位。回應中最多只會設定一個欄位：
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 類型，代表已加入的 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

僅適用於 pageType 為 SLIDE 的網頁的 Page 屬性。

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

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

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

string

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

MasterProperties

僅適用於 pageType 為 MASTER 的網頁的 Page 屬性。

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

string

使用者可解讀的主機名稱。

PageProperties

Page 的屬性。

這個頁面會沿用父項頁面的屬性。視網頁類型而定，階層會在 SlideProperties 或 LayoutProperties 中定義。

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

object (PageBackgroundFill)

頁面的背景填滿。如未設定，背景填滿顏色會沿用父項頁面 (如有)。如果頁面沒有父項，背景填滿顏色會預設為 Google 簡報編輯器中的對應填滿顏色。
colorScheme

object (ColorScheme)

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

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

PageBackgroundFill

頁面背景填滿。

JSON 表示法 
{
  "propertyState": enum (PropertyState),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of mutually exclusive fields.
}
欄位
propertyState

enum (PropertyState)

背景填滿屬性狀態。

更新網頁上的填寫內容時，這個欄位會隱含更新為 RENDERED，除非在同一要求中指定其他值。如要在頁面上不填入任何內容，請將這個欄位設為 NOT_RENDERED。在這種情況下，系統會忽略在同一要求中設定的其他任何填寫欄位。
背景填滿類型。以下列出互斥的欄位。回應中最多只會設定一個欄位：
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)

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

CommentAnchor

包含 Page 中所有位置的清單，這些位置透過相同的 anchorId 錨定至 CommentThread。多個獨立錨點可能會參照相同位置 (無論是在 Page 內或不同網頁之間)，

JSON 表示法 
{
  "anchorId": string,
  "objectAnchors": [
    {
      object (ObjectAnchor)
    }
  ]
}
欄位
anchorId

string

僅供輸出。留言錨點的專屬 ID。
objectAnchors[]

object (ObjectAnchor)

僅供輸出。網頁中所有參照錨點 ID 的物件 ID 型位置。

ObjectAnchor

代表與 Google 簡報物件 (例如 Page 或 PageElement) 相關聯的註解錨點資料。

JSON 表示法 
{
  "objectId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "shapeTextAnchors": {
    object (ShapeTextAnchors)
  },
  "tableCellAnchors": {
    object (TableCellAnchors)
  }
  // End of mutually exclusive fields.
}
欄位
objectId

string

僅供輸出。註解串錨定的頁面或網頁元素。
僅供輸出。註解討論串錨定的頁面元素內文字範圍。如果留言錨點適用於整個網頁或網頁元素，而非元素內的文字範圍，則此欄位會空白。以下列出互斥的欄位。回應中最多只會設定一個欄位：
shapeTextAnchors

object (ShapeTextAnchors)

如果註解錨定至形狀 [text][google.apps.slides.v1.Shape.TextContent] 中的文字範圍，系統就會填入這個欄位。Shapes
tableCellAnchors

object (TableCellAnchors)

如果一或多個表格儲存格的文字範圍有錨定註解，系統就會填入這項屬性。Tables
互斥欄位的結尾。

ShapeTextAnchors

代表註解錨點涵蓋的形狀內文字範圍。

JSON 表示法 
{
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
欄位
ranges[]

object (TextRange)

註解錨點涵蓋的文字範圍清單。

TextRange

指定形狀或表格儲存格 text 內的連續文字範圍。

JSON 表示法 
{
  "startIndex": integer,
  "endIndex": integer
}
欄位
startIndex

integer

範圍開頭的索引，從零開始。這個欄位是 Int32Value，可因應日後用途的開放式範圍。
endIndex

integer

範圍結尾的索引，從零開始。這個欄位是 Int32Value，可因應日後用途的開放式範圍。

TableCellAnchors

代表註解錨點所涵蓋表格中的表格儲存格範圍。

JSON 表示法 
{
  "cellRanges": [
    {
      object (TableCellTextRanges)
    }
  ]
}
欄位
cellRanges[]

object (TableCellTextRanges)

表格中所有含有文字的儲存格清單，這些文字會由表格中的錨點涵蓋。

TableCellTextRanges

代表註解錨定點涵蓋的表格儲存格內文字範圍。

JSON 表示法 
{
  "cellLocation": {
    object (TableCellLocation)
  },
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
欄位
cellLocation

object (TableCellLocation)

表格儲存格的位置。
ranges[]

object (TextRange)

這個儲存格中錨點涵蓋的所有文字範圍清單。

方法

get

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

getThumbnail

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