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 は次のいずれか 1 つのみを指定できます。
paragraphMarker

object (ParagraphMarker)

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

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

textRun

object (TextRun)

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

startIndex および endIndex すべての TextRun が、単一の 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

線間のスペースの量を、normal に対するパーセンテージで表したものです。normal は 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)

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

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

更新リクエストで両方の値を指定した場合、 weightedFontFamily および boldweightedFontFamily 最初に適用され、 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 次の間 100 および 900 の範囲内(両端を含む)この範囲は、CSS 2.1 仕様のセクション 15.6 で説明されている数値に対応しています。数値以外の値は使用できません。重みが 700 以上の場合は太字と見なされ、700 未満の場合は太字と見なされません。デフォルト値は 400 (「normal」)。

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 現在のスライド番号を表す自動テキストを入力します。

リスト

List は、リストに関連付けられた段落に属する箇条書きの外観を記述します。リストの一部である段落には、そのリストの 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)

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