Text

TextContent

一般的なテキスト コンテンツ。テキストは、互換性のある図形（テキスト ボックスや長方形など）またはページの表のセルに配置する必要があります。

JSON 表現 
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
フィールド
textElements[]

object (TextElement)

テキストの内容を、スタイル設定情報などの構成要素に分解したもの。このプロパティは読み取り専用です。
lists

map (key: string, value: object ( List))

このテキストに含まれる箇条書きリスト。リスト ID でキー設定されます。

TextElement

TextElement は、Shape または TableCell のテキスト コンテンツ内のインデックス範囲のコンテンツを記述します。

JSON 表現 
{
  "startIndex": integer,
  "endIndex": integer,

  // Union field kind can be only one of the following:
  "paragraphMarker": {
    object (ParagraphMarker)
  },
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  }
  // End of list of possible types for union field kind.
}
フィールド
startIndex

integer

このテキスト要素のゼロベースの開始インデックス（Unicode コード単位）。
endIndex

integer

このテキスト要素の 0 から始まる終了インデックス（Unicode コード単位、終了箇所は含まない）。
共用体フィールド kind。この要素が表すテキストの種類。kind は次のいずれかになります。
paragraphMarker

object (ParagraphMarker)

新しい段落の始まりを表すマーカー。

この TextElement の startIndex と endIndex は、段落の範囲を表します。この段落の範囲内にインデックス範囲が含まれる他の TextElement は、この段落の一部と見なされます。2 つの別々の段落のインデックスの範囲が重複することはありません。
textRun

object (TextRun)

実行内のすべての文字が同じ TextStyle を持つテキストの実行を表す TextElement。

TextRun の startIndex と endIndex は、常に単一の paragraphMarker TextElement のインデックス範囲内に完全に含まれます。つまり、TextRun が複数の段落にまたがることはありません。
autoText

object (AutoText)

時間の経過とともに変化するコンテンツで動的に置き換えられるテキスト内のスポットを表す TextElement。

ParagraphMarker

新しい段落の始まりを表す TextElement の種類。

JSON 表現 
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
フィールド
style

object (ParagraphStyle)

段落のスタイル

bullet

object (Bullet)

この段落の箇条書き。存在しない場合、段落はリストに属しません。

ParagraphStyle

段落全体に適用されるスタイル。

このテキストが親 placeholder を持つ図形に含まれている場合、これらの段落スタイルは親から継承されることがあります。継承される段落スタイルは、リストのネストレベルによって異なります。

  • リストに含まれていない段落は、親プレースホルダ内のリストのネストレベル 0 の段落から段落スタイルを継承します。
  • リスト内の段落は、親プレースホルダ内のリストの対応するネストレベルの段落から段落スタイルを継承します。

継承された段落スタイルは、このメッセージでは設定されていないフィールドとして表されます。

JSON 表現 
{
  "lineSpacing": number,
  "alignment": enum (Alignment),
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "direction": enum (TextDirection),
  "spacingMode": enum (SpacingMode)
}
フィールド
lineSpacing

number

行間のスペースの量。通常の行間のスペースを 100.0 とした場合の割合で表します。設定されていない場合、値は親から継承されます。
alignment

enum (Alignment)

この段落のテキストの配置。
indentStart

object (Dimension)

現在のテキストの方向に基づいて、テキストの開始に対応する側の段落のインデント量。設定されていない場合、値は親から継承されます。
indentEnd

object (Dimension)

現在のテキストの方向に基づいて、テキストの末尾に対応する側の段落のインデント量。設定されていない場合、値は親から継承されます。
spaceAbove

object (Dimension)

段落の上の余白の量。設定されていない場合、値は親から継承されます。
spaceBelow

object (Dimension)

段落の下の余白の量。設定されていない場合、値は親から継承されます。
indentFirstLine

object (Dimension)

段落の 1 行目の先頭のインデント量。設定されていない場合、値は親から継承されます。
direction

enum (TextDirection)

この段落のテキストの方向。設定されていない場合、テキストの方向は継承されないため、値はデフォルトで LEFT_TO_RIGHT になります。
spacingMode

enum (SpacingMode)

段落のスペーシング モード。

アライメント

段落のテキスト配置の種類。

列挙型
ALIGNMENT_UNSPECIFIED 段落の配置は親から継承されます。
START 段落は行の先頭に揃えられます。LTR テキストの場合は左揃え、それ以外の場合は右揃え。
CENTER 段落が中央揃えになっています。
END 段落が行の末尾に揃えられています。LTR テキストの場合は右揃え、それ以外の場合は左揃え。
JUSTIFIED 段落が均等割り付けされます。

TextDirection

経路のテキストは流れるように表示されます。

列挙型
TEXT_DIRECTION_UNSPECIFIED テキストの方向は親から継承されます。
LEFT_TO_RIGHT テキストは左から右に流れます。
RIGHT_TO_LEFT テキストは右から左に流れます。

SpacingMode

段落間隔のさまざまなモード。

列挙型
SPACING_MODE_UNSPECIFIED スペーシング モードは親から継承されます。
NEVER_COLLAPSE 段落間隔は常にレンダリングされます。
COLLAPSE_LISTS リスト要素間の段落間隔はスキップされます。

Bullet

段落の箇条書きを記述します。

JSON 表現 
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
フィールド
listId

string

この段落が属するリストの ID。
nestingLevel

integer

リスト内のこの段落のネストレベル。
glyph

string

この段落のレンダリングされた箇条書きグリフ。
bulletStyle

object (TextStyle)

この箇条書きに適用される段落固有のテキスト スタイル。

TextStyle

TextRun に適用できるスタイル設定を表します。

このテキストが親 placeholder を持つシェイプに含まれている場合、これらのテキスト スタイルは親から継承されることがあります。継承されるテキスト スタイルは、リストのネストレベルによって異なります。

  • リストに含まれていない段落内のテキスト ランは、親プレースホルダ内のリストのネストレベル 0 の段落の改行文字からテキスト スタイルを継承します。
  • リスト内の段落のテキスト ランは、親プレースホルダ内のリストの対応するネストレベルにある段落の改行文字からテキスト スタイルを継承します。

継承されたテキスト スタイルは、このメッセージで未設定のフィールドとして表されます。親プレースホルダのない図形にテキストが含まれている場合、これらのフィールドの設定を解除すると、スタイルはスライド エディタのデフォルト値に一致する値に戻ります。

JSON 表現 
{
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "bold": boolean,
  "italic": boolean,
  "fontFamily": string,
  "fontSize": {
    object (Dimension)
  },
  "link": {
    object (Link)
  },
  "baselineOffset": enum (BaselineOffset),
  "smallCaps": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "weightedFontFamily": {
    object (WeightedFontFamily)
  }
}
フィールド
backgroundColor

object (OptionalColor)

テキストの背景色。設定されている場合、色は不透明または透明になります。これは、その中の opaqueColor フィールドが設定されているかどうかによって異なります。
foregroundColor

object (OptionalColor)

テキスト自体の色。設定されている場合、色は不透明または透明になります。これは、その中の opaqueColor フィールドが設定されているかどうかによって異なります。
bold

boolean

テキストが太字でレンダリングされるかどうか。

italic

boolean

テキストが斜体かどうか。

fontFamily

string

テキストのフォント ファミリー。

フォント ファミリーには、スライドの [フォント] メニューまたは Google Fonts の任意のフォントを使用できます。フォント名が認識されない場合、テキストは Arial でレンダリングされます。

一部のフォントは、テキストの太さに影響を与える可能性があります。更新リクエストで fontFamily と bold の両方の値が指定されている場合は、明示的に設定された bold の値が使用されます。
fontSize

object (Dimension)

テキストのフォントサイズ。読み取り時に、fontSize はポイントで指定されます。
baselineOffset

enum (BaselineOffset)

テキストの通常の位置からの垂直オフセット。

SUPERSCRIPT または SUBSCRIPT のベースライン オフセットを含むテキストは、fontSize フィールドに基づいて計算された、より小さいフォントサイズで自動的にレンダリングされます。fontSize 自体は、このフィールドの変更の影響を受けません。
smallCaps

boolean

テキストがスモール キャップかどうか。

strikethrough

boolean

テキストが取り消し線で消されているかどうか。
underline

boolean

テキストに下線が引かれているかどうか。

weightedFontFamily

object (WeightedFontFamily)

テキストのフォント ファミリーとレンダリングされた太さ。

このフィールドは fontFamily の拡張機能で、下位互換性を損なうことなく明示的なフォントの太さをサポートすることを目的としています。そのため、テキスト範囲のスタイルを読み取る場合、weightedFontFamily#fontFamily の値は常に fontFamily の値と等しくなります。ただし、書き込み時に両方のフィールドがフィールド マスクに含まれている場合（明示的に、またはワイルドカード "*" を介して）、それらの値は次のように調整されます。

  • fontFamily が設定されていて weightedFontFamily が設定されていない場合、fontFamily の値は重み 400（「normal」）で適用されます。
  • 両方のフィールドが設定されている場合、fontFamily の値は weightedFontFamily#fontFamily の値と一致する必要があります。その場合、weightedFontFamily のフォント ファミリーと太さが適用されます。それ以外の場合は、400 不正なリクエスト エラーが返されます。
  • weightedFontFamily が設定され、fontFamily が設定されていない場合、weightedFontFamily のフォント ファミリーと太さが適用されます。
  • どちらのフィールドも設定されていない場合、テキストのフォント ファミリーとウェイトは親から継承されます。これらのプロパティは、互いに個別に継承することはできません。

更新リクエストで weightedFontFamily と bold の両方の値が指定されている場合、最初に weightedFontFamily が適用され、次に bold が適用されます。

weightedFontFamily#weight が設定されていない場合、デフォルトは 400 です。

weightedFontFamily が設定されている場合、weightedFontFamily#fontFamily も空でない値で設定する必要があります。それ以外の場合は、400 不正なリクエスト エラーが返されます。

OptionalColor

完全に不透明または完全に透明にできる色。

JSON 表現 
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
フィールド
opaqueColor

object (OpaqueColor)

設定されている場合、不透明な色として使用されます。設定されていない場合、これは透明な色を表します。

BaselineOffset

テキストを通常の配置位置から垂直方向にオフセットする方法。

列挙型
BASELINE_OFFSET_UNSPECIFIED テキストのベースライン オフセットは親から継承されます。
NONE テキストは垂直方向にオフセットされません。
SUPERSCRIPT テキストが上方向に垂直にオフセットされます（上付き文字）。
SUBSCRIPT テキストが下方向に垂直にオフセットされます（下付き文字）。

WeightedFontFamily

TextRun のスタイル設定に使用されるフォント ファミリーと太さを表します。

JSON 表現 
{
  "fontFamily": string,
  "weight": integer
}
フィールド
fontFamily

string

テキストのフォント ファミリー。

フォント ファミリーには、スライドの [フォント] メニューまたは Google Fonts の任意のフォントを使用できます。フォント名が認識されない場合、テキストは Arial でレンダリングされます。
weight

integer

テキストのレンダリングされた太さ。このフィールドには、100～900 の範囲内の 100 の倍数である任意の値を指定できます。この範囲は、CSS 2.1 仕様の セクション 15.6 で説明されている数値に対応しており、数値以外の値は許可されません。700 以上の太さは太字と見なされ、700 未満の太さは太字と見なされません。デフォルト値は 400（「normal」）です。

TextRun

すべて同じスタイル設定が適用されたテキストの実行を表す TextElement の種類。

JSON 表現 
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
フィールド
content

string

この実行のテキスト。
style

object (TextStyle)

この実行に適用されるスタイル。

AutoText

自動テキストを表す TextElement の種類。

JSON 表現 
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
フィールド
type

enum (Type)

この自動テキストのタイプ。

content

string

この自動テキストのレンダリングされたコンテンツ（利用可能な場合）。
style

object (TextStyle)

この自動テキストに適用されるスタイル設定。

タイプ

自動テキストの種類

列挙型
TYPE_UNSPECIFIED 指定されていない自動テキスト タイプ。
SLIDE_NUMBER 現在のスライド番号を表す自動テキストの型。

リスト

リストは、リストに関連付けられた段落に属する箇条書きのルック アンド フィールを表します。リストの一部である段落には、そのリストの ID への暗黙的な参照があります。

JSON 表現 
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
フィールド
listId

string

リストの ID。
nestingLevel

map (key: integer, value: object ( NestingLevel))

ネストレベルと、関連付けられたレベルの箇条書きのプロパティのマップ。リストのネストは最大 9 レベルであるため、このマップのキーに設定できる値は 0 ～ 8 です。

NestingLevel

特定のネストレベルのリストの箇条書きの外観を説明するプロパティが含まれています。

JSON 表現 
{
  "bulletStyle": {
    object (TextStyle)
  }
}
フィールド
bulletStyle

object (TextStyle)

このネストレベルの箇条書きのスタイル。