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)

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 の注記があるページにのみ関連する 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),

  // 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 分である画像の URL。この 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 を返します。