REST Resource: presentations.pages

リソース: ページ

プレゼンテーションのページ。

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 は、同じ Namespace を共有します。
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 を介してページが取得された場合にのみ入力されます。
各ページタイプに固有のプロパティ。マスターには追加のプロパティは必要ありません。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
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 は、同じ Namespace を共有します。
size

object (Size)

ページ要素のサイズ。
transform

object (AffineTransform)

ページ要素の変換。

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

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

string

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

このフィールドは Group 要素では対象外です。
description

string

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

このフィールドは Group 要素では対象外です。
この PageElement が表す要素の種類。各メッセージには、その種類のページ要素に固有のプロパティが含まれています。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
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)

スピーカー スポットライト。
相互に排他的なフィールドの終了。

グループ

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)

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

object (ColorScheme)

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

最初の 12 個の ThemeColorType の具体的な色のみ編集できます。また、Master ページのカラーパターンのみを更新できます。フィールドを更新するには、最初の 12 個の ThemeColorTypes から具体的な色へのマッピングを含むカラーパターンを指定する必要があります。残りの 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 に設定します。この場合、同じリクエストで設定された他の塗りつぶしフィールドはすべて無視されます。
背景の塗りつぶしの種類。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
solidFill

object (SolidFill)

単色の塗りつぶし。
stretchedPictureFill

object (StretchedPictureFill)

拡大された画像の塗りつぶし。
相互に排他的なフィールドの終了。

StretchedPictureFill

拡大された画像の塗りつぶし。ページまたはページ要素が指定された画像で完全に埋められています。画像がコンテナに合わせて拡大されます。

JSON 表現 
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
フィールド
contentUrl

string

contentUrl を読み取ります。

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

contentUrl の記述:

画像は挿入時に 1 回取得され、プレゼンテーション内で表示するためにコピーが保存されます。画像のサイズは 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)

上記のテーマカラータイプに対応する具体的な色。

CommentAnchor

同じ anchorId を介して CommentThread にアンカーされている Page 内のすべてのロケーションのリストが含まれます。複数の別々のアンカーが、Page 内または異なるページ間で同じ場所を参照している場合があります。

JSON 表現 
{
  "anchorId": string,
  "objectAnchors": [
    {
      object (ObjectAnchor)
    }
  ]
}
フィールド
anchorId

string

出力専用。コメント アンカーの一意の ID。
objectAnchors[]

object (ObjectAnchor)

出力専用。アンカー ID を参照するページ内のすべてのオブジェクト ID ベースのロケーション。

ObjectAnchor

スライド オブジェクト（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

出力専用。コメント スレッドがアンカーされているページまたはページ要素。
出力専用。コメント スレッドがアンカーされているページ要素内のテキスト範囲。コメント アンカーが要素内のテキスト範囲ではなく、ページ全体またはページ要素を対象としている場合は空になります。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
shapeTextAnchors

object (ShapeTextAnchors)

図形の [text][google.apps.slides.v1.Shape.TextContent] のテキスト範囲にコメントがアンカーされている Shapes に対して入力されます。
tableCellAnchors

object (TableCellAnchors)

1 つ以上のテーブルのセルのテキスト範囲にコメントがアンカーされている 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

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