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。PagePageElement 使用的物件 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.Pagegoogle.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.getpages.get 動作一律會傳回最新的物件 ID。

MasterProperties

Page 的屬性,只與網頁類型為「MASTER」的網頁相關。

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

string

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

PageProperties

Page 的屬性。

頁面將沿用上層頁面的屬性。階層是由 SlidePropertiesLayoutProperties 定義,視網頁類型而定。

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

object (PageBackgroundFill)

網頁的背景填滿。如未設定,系統會沿用上層頁面的背景填滿設定 (如果有的話)。如果頁面沒有父項,則背景會預設為簡報編輯器中的相應填滿內容。

colorScheme

object (ColorScheme)

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

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

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

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