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 は同じ Namespace を共有します。
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 は同じ Namespace を共有します。
size

object (Size)

ページ要素のサイズ。
transform

object (AffineTransform)

ページ要素の変換。

ページ要素の視覚的な外観は、その絶対変換によって決まります。絶対変換を計算するには、ページ要素の変換をすべての親グループの変換と事前連結します。ページ要素がグループにない場合、その絶対変換は、このフィールドの値と同じになります。

新しく作成された Group の初期変換は常に ID 変換です。
title

string

ページ要素のタイトル。説明と組み合わせて代替テキストを表示します。

このフィールドは、Group 要素ではサポートされていません。
description

string

ページ要素の説明。タイトルと組み合わせて、代替テキストを表示します。

このフィールドは、Group 要素ではサポートされていません。
共用体フィールド element_kind。この PageElement が表す要素の種類。各メッセージには、その種類のページ要素に固有のプロパティが含まれます。element_kind は次のいずれかになります。
elementGroup

object (Group)

1 つの単位として結合されたページ要素のコレクション。
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

pageType のスライドがあるページにのみ関連する 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)

ページの背景の塗りつぶし。設定されていない場合、背景塗りつぶしは親ページから継承されます（親ページが存在する場合）。ページに親がない場合、背景塗りつぶしはデフォルトでスライド エディタの対応する塗りつぶしになります。
colorScheme

object (ColorScheme)

ページの配色。設定しなかった場合、カラー スキームは親ページから継承されます。ページに親要素がない場合、カラーパターンはスライド エディタのデフォルトと同じスライドのデフォルト カラーパターンを使用します。

編集できるのは、最初の 12 個の ThemeColorType のコンクリート色のみです。また、更新できるのは Master ページの配色のみです。このフィールドを更新するには、最初の 12 個の ThemeColorType すべてから具体的な色へのマッピングを含むカラーパターンを指定する必要があります。残りの 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 の読み取り:

画像の URL。デフォルトの有効期間は 30 分です。この URL にはリクエスト元のアカウントがタグ付けされます。URL を知っているユーザーは、元の報告者として画像にアクセスできます。プレゼンテーションの共有設定を変更すると、写真にアクセスできなくなる可能性があります。

contentUrl の記述:

画像は挿入時に一度取得され、プレゼンテーション内に表示するためにコピーが保存されます。画像のサイズは 50 MB 未満で、25 メガピクセル以下である必要があります。また、PNG、JPEG、GIF のいずれかの形式にする必要があります。

指定する URL の長さは 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

 プレゼンテーション内の指定したページの最新バージョンのサムネイルを生成し、サムネイル画像の URL を返します。