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 は次のいずれか 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 スライドの 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 および 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 スライドの Google Fonts。フォント名を認識できない場合、テキストは Arial

weight

integer

レンダリングされたテキストの太さ。このフィールドには、任意の倍数の値を指定できます。 100 次の間 100 および 900 の範囲内(両端を含む)この範囲は、CSS 2.1 Specification に記載されている数値に対応しています。 セクション 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 現在のスライド番号を表す自動テキストのタイプ。

リスト

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)

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