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

このテキスト要素の 0 から始まる開始インデックス(Unicode コード単位)。

endIndex

integer

このテキスト要素の 0 から始まる終了インデックス。Unicode コード単位で指定します。

共用体フィールド kind。この要素が表すテキストの種類。 kind は次のいずれかになります。
paragraphMarker

object (ParagraphMarker)

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

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

textRun

object (TextRun)

実行のすべての文字が同じ TextStyle であるテキストランを表す TextElement。

TextRuns の startIndexendIndex は、常に単一の 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)

段落の先頭行の先頭のインデント量。未設定の場合、値は親から継承します。

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 リスト要素間では段落間隔がスキップされます。

箇条書き

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

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

string

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

nestingLevel

integer

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

glyph

string

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

bulletStyle

object (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 でレンダリングされます。

フォントによっては、テキストの太さに影響することがあります。更新リクエストで、fontFamilybold の両方の値が指定されている場合は、明示的に設定された 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(標準)で適用されます。
  • 両方のフィールドが設定されている場合、fontFamily の値は weightedFontFamily#fontFamily の値と一致している必要があります。その場合、フォント ファミリーと weightedFontFamily の太さが適用されます。それ以外の場合は、400 不正なリクエスト エラーが返されます。
  • weightedFontFamily が設定され、fontFamily が設定されていない場合、フォント ファミリーと weightedFontFamily の太さが適用されます。
  • どちらのフィールドも設定されていない場合、テキストのフォント ファミリーと太さは親から継承します。これらのプロパティは個別に継承できません。

更新リクエストで weightedFontFamilybold の両方の値を指定した場合は、まず weightedFontFamily が適用され、次に bold が適用されます。

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

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

省略可

完全に不透明な色または完全に透明な色です。

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(通常)です。

TextRun

すべて同じスタイリングを持つテキスト実行を表す TextElement の種類。

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

string

この実行のテキスト。

style

object (TextStyle)

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

自動テキスト

自動テキストを表す 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)

このネストレベルにおける箇条書きのスタイル。