Blame - docs/dyn/slides_v1.presentations.pages.html - platform/external/python/google-api-python-client

2017-03-24 15:06:46 -0700

[diff] [blame]

80

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

81

<code><a href="#getThumbnail">getThumbnail(presentationId, pageObjectId, thumbnailProperties_thumbnailSize=None, thumbnailProperties_mimeType=None, x__xgafv=None)</a></code></p>

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

82

<p class="firstline">Generates a thumbnail of the latest version of the specified page in the</p>

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

83

<h3>Method Details</h3>

84

85

<code class="details" id="get">get(presentationId, pageObjectId, x__xgafv=None)</code>

86

<pre>Gets the latest version of the specified page in the presentation.

87

88

Args:

89

presentationId: string, The ID of the presentation to retrieve. (required)

90

pageObjectId: string, The object ID of the page to retrieve. (required)

91

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

98

99

{ # A page in a presentation.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

100

"notesProperties": { # The properties of Page that are only # Notes specific properties. Only set if page_type = NOTES.

101

# relevant for pages with page_type NOTES.

102

"speakerNotesObjectId": "A String", # The object ID of the shape on this notes page that contains the speaker

103

# notes for the corresponding slide.

104

# The actual shape may not always exist on the notes page. Inserting text

105

# using this object ID will automatically create the shape. In this case, the

106

# actual shape may have different object ID. The `GetPresentation` or

107

# `GetPage` action will always return the latest object ID.

108

},

109

"masterProperties": { # The properties of Page that are only # Master specific properties. Only set if page_type = MASTER.

110

# relevant for pages with page_type MASTER.

111

"displayName": "A String", # The human-readable name of the master.

112

},

113

"slideProperties": { # The properties of Page that are only # Slide specific properties. Only set if page_type = SLIDE.

114

# relevant for pages with page_type SLIDE.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

115

"masterObjectId": "A String", # The object ID of the master that this slide is based on. This property is

116

# read-only.

117

"layoutObjectId": "A String", # The object ID of the layout that this slide is based on. This property is

118

# read-only.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

119

"notesPage": # Object with schema name: Page # The notes page that this slide is associated with. It defines the visual

120

# appearance of a notes page when printing or exporting slides with speaker

121

# notes. A notes page inherits properties from the

122

# notes master.

123

# The placeholder shape with type BODY on the notes page contains the speaker

124

# notes for this slide. The ID of this shape is identified by the

125

# speakerNotesObjectId field.

126

# The notes page is read-only except for the text content and styles of the

127

# speaker notes shape. This property is read-only.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

128

},

129

"pageElements": [ # The page elements rendered on the page.

130

{ # A visual element rendered on a page.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

131

"description": "A String", # The description of the page element. Combined with title to display alt

132

# text.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

133

"title": "A String", # The title of the page element. Combined with description to display alt

134

# text.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

135

"table": { # A PageElement kind representing a # A table page element.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

136

# table.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

137

"rows": 42, # Number of rows in the table.

138

"tableRows": [ # Properties and contents of each row.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

139

#

140

# Cells that span multiple rows are contained in only one of these rows and

141

# have a row_span greater

142

# than 1.

143

{ # Properties and contents of each row in a table.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

144

"tableCells": [ # Properties and contents of each cell.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

145

#

146

# Cells that span multiple columns are represented only once with a

147

# column_span greater

148

# than 1. As a result, the length of this collection does not always match

149

# the number of columns of the entire table.

150

{ # Properties and contents of each table cell.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

151

"location": { # A location of a single table cell within a table. # The location of the cell within the table.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

152

"columnIndex": 42, # The 0-based column index.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

153

"rowIndex": 42, # The 0-based row index.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

154

},

155

"text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the cell.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

156

# text box or rectangle) or a table cell in a page.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

157

"lists": { # The bulleted lists contained in this text, keyed by list ID.

158

"a_key": { # A List describes the look and feel of bullets belonging to paragraphs

159

# associated with a list. A paragraph that is part of a list has an implicit

160

# reference to that list's ID.

161

"listId": "A String", # The ID of the list.

162

"nestingLevel": { # A map of nesting levels to the properties of bullets at the associated

163

# level. A list has at most nine levels of nesting, so the possible values

164

# for the keys of this map are 0 through 8, inclusive.

165

"a_key": { # Contains properties describing the look and feel of a list bullet at a given

166

# level of nesting.

167

"bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

168

#

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

169

# If this text is contained in a shape with a parent placeholder, then these text styles may be

170

# inherited from the parent. Which text styles are inherited depend on the

171

# nesting level of lists:

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

172

#

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

173

# * A text run in a paragraph that is not in a list will inherit its text style

174

# from the the newline character in the paragraph at the 0 nesting level of

175

# the list inside the parent placeholder.

176

# * A text run in a paragraph that is in a list will inherit its text style

177

# from the newline character in the paragraph at its corresponding nesting

178

# level of the list inside the parent placeholder.

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

179

#

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

180

# Inherited text styles are represented as unset fields in this message. If

181

# text is contained in a shape without a parent placeholder, unsetting these

182

# fields will revert the style to a value matching the defaults in the Slides

183

# editor.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

184

"smallCaps": True or False, # Whether or not the text is in small capital letters.

185

"weightedFontFamily": { # Represents a font family and weight used to style a TextRun. # The font family and rendered weight of the text.

186

#

187

# This field is an extension of `font_family` meant to support explicit font

188

# weights without breaking backwards compatibility. As such, when reading the

189

# style of a range of text, the value of `weighted_font_family#font_family`

190

# will always be equal to that of `font_family`. However, when writing, if

191

# both fields are included in the field mask (either explicitly or through

192

# the wildcard `"*"`), their values are reconciled as follows:

193

#

194

# * If `font_family` is set and `weighted_font_family` is not, the value of

195

# `font_family` is applied with weight `400` ("normal").

196

# * If both fields are set, the value of `font_family` must match that of

197

# `weighted_font_family#font_family`. If so, the font family and weight of

198

# `weighted_font_family` is applied. Otherwise, a 400 bad request error is

199

# returned.

200

# * If `weighted_font_family` is set and `font_family` is not, the font

201

# family and weight of `weighted_font_family` is applied.

202

# * If neither field is set, the font family and weight of the text inherit

203

# from the parent. Note that these properties cannot inherit separately

204

# from each other.

205

#

206

# If an update request specifies values for both `weighted_font_family` and

207

# `bold`, the `weighted_font_family` is applied first, then `bold`.

208

#

209

# If `weighted_font_family#weight` is not set, it defaults to `400`.

210

#

211

# If `weighted_font_family` is set, then `weighted_font_family#font_family`

212

# must also be set with a non-empty value. Otherwise, a 400 bad request error

213

# is returned.

214

"fontFamily": "A String", # The font family of the text.

215

#

216

# The font family can be any font from the Font menu in Slides or from

217

# [Google Fonts] (https://fonts.google.com/). If the font name is

218

# unrecognized, the text is rendered in `Arial`.

219

"weight": 42, # The rendered weight of the text. This field can have any value that is a

220

# multiple of `100` between `100` and `900`, inclusive. This range

221

# corresponds to the numerical values described in the CSS 2.1

222

# Specification,

223

# [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness),

224

# with non-numerical values disallowed. Weights greater than or equal to

225

# `700` are considered bold, and weights less than `700`are not bold. The

226

# default value is `400` ("normal").

227

},

228

"underline": True or False, # Whether or not the text is underlined.

229

"link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links

230

# are not inherited from parent text.

231

#

232

# Changing the link in an update request causes some other changes to the

233

# text style of the range:

234

#

235

# * When setting a link, the text foreground color will be set to

236

# ThemeColorType.HYPERLINK and the text will

237

# be underlined. If these fields are modified in the same

238

# request, those values will be used instead of the link defaults.

239

# * Setting a link on a text range that overlaps with an existing link will

240

# also update the existing link to point to the new URL.

241

# * Links are not settable on newline characters. As a result, setting a link

242

# on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,

243

# will separate the newline character(s) into their own text runs. The

244

# link will be applied separately to the runs before and after the newline.

245

# * Removing a link will update the text style of the range to match the

246

# style of the preceding text (or the default text styles if the preceding

247

# text is another link) unless different styles are being set in the same

248

# request.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

249

"slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index

250

# in the presentation. There may not be a slide at this index.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

251

"pageObjectId": "A String", # If set, indicates this is a link to the specific page in this

252

# presentation with this ID. A page with this ID may not exist.

253

"url": "A String", # If set, indicates this is a link to the external web page at this URL.

254

"relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,

255

# addressed by its position.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

256

},

257

"strikethrough": True or False, # Whether or not the text is struck through.

258

"fontFamily": "A String", # The font family of the text.

259

#

260

# The font family can be any font from the Font menu in Slides or from

261

# [Google Fonts] (https://fonts.google.com/). If the font name is

262

# unrecognized, the text is rendered in `Arial`.

263

#

264

# Some fonts can affect the weight of the text. If an update request

265

# specifies values for both `font_family` and `bold`, the explicitly-set

266

# `bold` value is used.

267

"backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or

268

# transparent, depending on if the `opaque_color` field in it is set.

269

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

270

# a transparent color.

271

"rgbColor": { # An RGB color. # An opaque RGB color.

272

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

273

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

274

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

275

},

276

"themeColor": "A String", # An opaque theme color.

277

},

278

},

279

"fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in

280

# points.

281

"unit": "A String", # The units for magnitude.

282

"magnitude": 3.14, # The magnitude.

283

},

284

"baselineOffset": "A String", # The text's vertical offset from its normal position.

285

#

286

# Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically

287

# rendered in a smaller font size, computed based on the `font_size` field.

288

# The `font_size` itself is not affected by changes in this field.

289

"italic": True or False, # Whether or not the text is italicized.

290

"bold": True or False, # Whether or not the text is rendered as bold.

291

"foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or

292

# transparent, depending on if the `opaque_color` field in it is set.

293

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

294

# a transparent color.

295

"rgbColor": { # An RGB color. # An opaque RGB color.

296

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

297

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

298

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

299

},

300

"themeColor": "A String", # An opaque theme color.

301

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

302

},

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

303

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

304

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

305

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

306

},

307

},

308

"textElements": [ # The text contents broken down into its component parts, including styling

309

# information. This property is read-only.

310

{ # A TextElement describes the content of a range of indices in the text content

311

# of a Shape or TableCell.

312

"paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

313

#

314

# The `start_index` and `end_index` of this TextElement represent the

315

# range of the paragraph. Other TextElements with an index range contained

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

316

# inside this paragraph's range are considered to be part of this

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

317

# paragraph. The range of indices of two separate paragraphs will never

318

# overlap.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

319

"style": { # Styles that apply to a whole paragraph. # The paragraph's style

320

#

321

# If this text is contained in a shape with a parent placeholder, then these paragraph styles may be

322

# inherited from the parent. Which paragraph styles are inherited depend on the

323

# nesting level of lists:

324

#

325

# * A paragraph not in a list will inherit its paragraph style from the

326

# paragraph at the 0 nesting level of the list inside the parent placeholder.

327

# * A paragraph in a list will inherit its paragraph style from the paragraph

328

# at its corresponding nesting level of the list inside the parent

329

# placeholder.

330

#

331

# Inherited paragraph styles are represented as unset fields in this message.

332

"indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to

333

# the end of the text, based on the current text direction. If unset, the

334

# value is inherited from the parent.

335

"unit": "A String", # The units for magnitude.

336

"magnitude": 3.14, # The magnitude.

337

},

338

"spacingMode": "A String", # The spacing mode for the paragraph.

339

"spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space below the paragraph. If unset, the value is

340

# inherited from the parent.

341

"unit": "A String", # The units for magnitude.

342

"magnitude": 3.14, # The magnitude.

343

},

344

"alignment": "A String", # The text alignment for this paragraph.

345

"indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.

346

# If unset, the value is inherited from the parent.

347

"unit": "A String", # The units for magnitude.

348

"magnitude": 3.14, # The magnitude.

349

},

350

"spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is

351

# inherited from the parent.

352

"unit": "A String", # The units for magnitude.

353

"magnitude": 3.14, # The magnitude.

354

},

355

"direction": "A String", # The text direction of this paragraph. If unset, the value defaults to

356

# LEFT_TO_RIGHT since

357

# text direction is not inherited.

358

"lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal

359

# is represented as 100.0. If unset, the value is inherited from the parent.

360

"indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to

361

# the start of the text, based on the current text direction. If unset, the

362

# value is inherited from the parent.

363

"unit": "A String", # The units for magnitude.

364

"magnitude": 3.14, # The magnitude.

365

},

366

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

367

"bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not

368

# belong to a list.

369

"listId": "A String", # The ID of the list this paragraph belongs to.

370

"glyph": "A String", # The rendered bullet glyph for this paragraph.

371

"nestingLevel": 42, # The nesting level of this paragraph in the list.

372

"bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.

373

#

374

# If this text is contained in a shape with a parent placeholder, then these text styles may be

375

# inherited from the parent. Which text styles are inherited depend on the

376

# nesting level of lists:

377

#

378

# * A text run in a paragraph that is not in a list will inherit its text style

379

# from the the newline character in the paragraph at the 0 nesting level of

380

# the list inside the parent placeholder.

381

# * A text run in a paragraph that is in a list will inherit its text style

382

# from the newline character in the paragraph at its corresponding nesting

383

# level of the list inside the parent placeholder.

384

#

385

# Inherited text styles are represented as unset fields in this message. If

386

# text is contained in a shape without a parent placeholder, unsetting these

387

# fields will revert the style to a value matching the defaults in the Slides

388

# editor.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

389

"smallCaps": True or False, # Whether or not the text is in small capital letters.

390

"weightedFontFamily": { # Represents a font family and weight used to style a TextRun. # The font family and rendered weight of the text.

391

#

392

# This field is an extension of `font_family` meant to support explicit font

393

# weights without breaking backwards compatibility. As such, when reading the

394

# style of a range of text, the value of `weighted_font_family#font_family`

395

# will always be equal to that of `font_family`. However, when writing, if

396

# both fields are included in the field mask (either explicitly or through

397

# the wildcard `"*"`), their values are reconciled as follows:

398

#

399

# * If `font_family` is set and `weighted_font_family` is not, the value of

400

# `font_family` is applied with weight `400` ("normal").

401

# * If both fields are set, the value of `font_family` must match that of

402

# `weighted_font_family#font_family`. If so, the font family and weight of

403

# `weighted_font_family` is applied. Otherwise, a 400 bad request error is

404

# returned.

405

# * If `weighted_font_family` is set and `font_family` is not, the font

406

# family and weight of `weighted_font_family` is applied.

407

# * If neither field is set, the font family and weight of the text inherit

408

# from the parent. Note that these properties cannot inherit separately

409

# from each other.

410

#

411

# If an update request specifies values for both `weighted_font_family` and

412

# `bold`, the `weighted_font_family` is applied first, then `bold`.

413

#

414

# If `weighted_font_family#weight` is not set, it defaults to `400`.

415

#

416

# If `weighted_font_family` is set, then `weighted_font_family#font_family`

417

# must also be set with a non-empty value. Otherwise, a 400 bad request error

418

# is returned.

419

"fontFamily": "A String", # The font family of the text.

420

#

421

# The font family can be any font from the Font menu in Slides or from

422

# [Google Fonts] (https://fonts.google.com/). If the font name is

423

# unrecognized, the text is rendered in `Arial`.

424

"weight": 42, # The rendered weight of the text. This field can have any value that is a

425

# multiple of `100` between `100` and `900`, inclusive. This range

426

# corresponds to the numerical values described in the CSS 2.1

427

# Specification,

428

# [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness),

429

# with non-numerical values disallowed. Weights greater than or equal to

430

# `700` are considered bold, and weights less than `700`are not bold. The

431

# default value is `400` ("normal").

432

},

433

"underline": True or False, # Whether or not the text is underlined.

434

"link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links

435

# are not inherited from parent text.

436

#

437

# Changing the link in an update request causes some other changes to the

438

# text style of the range:

439

#

440

# * When setting a link, the text foreground color will be set to

441

# ThemeColorType.HYPERLINK and the text will

442

# be underlined. If these fields are modified in the same

443

# request, those values will be used instead of the link defaults.

444

# * Setting a link on a text range that overlaps with an existing link will

445

# also update the existing link to point to the new URL.

446

# * Links are not settable on newline characters. As a result, setting a link

447

# on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,

448

# will separate the newline character(s) into their own text runs. The

449

# link will be applied separately to the runs before and after the newline.

450

# * Removing a link will update the text style of the range to match the

451

# style of the preceding text (or the default text styles if the preceding

452

# text is another link) unless different styles are being set in the same

453

# request.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

454

"slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index

455

# in the presentation. There may not be a slide at this index.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

456

"pageObjectId": "A String", # If set, indicates this is a link to the specific page in this

457

# presentation with this ID. A page with this ID may not exist.

458

"url": "A String", # If set, indicates this is a link to the external web page at this URL.

459

"relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,

460

# addressed by its position.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

461

},

462

"strikethrough": True or False, # Whether or not the text is struck through.

463

"fontFamily": "A String", # The font family of the text.

464

#

465

# The font family can be any font from the Font menu in Slides or from

466

# [Google Fonts] (https://fonts.google.com/). If the font name is

467

# unrecognized, the text is rendered in `Arial`.

468

#

469

# Some fonts can affect the weight of the text. If an update request

470

# specifies values for both `font_family` and `bold`, the explicitly-set

471

# `bold` value is used.

472

"backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or

473

# transparent, depending on if the `opaque_color` field in it is set.

474

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

475

# a transparent color.

476

"rgbColor": { # An RGB color. # An opaque RGB color.

477

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

478

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

479

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

480

},

481

"themeColor": "A String", # An opaque theme color.

482

},

483

},

484

"fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in

485

# points.

486

"unit": "A String", # The units for magnitude.

487

"magnitude": 3.14, # The magnitude.

488

},

489

"baselineOffset": "A String", # The text's vertical offset from its normal position.

490

#

491

# Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically

492

# rendered in a smaller font size, computed based on the `font_size` field.

493

# The `font_size` itself is not affected by changes in this field.

494

"italic": True or False, # Whether or not the text is italicized.

495

"bold": True or False, # Whether or not the text is rendered as bold.

496

"foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or

497

# transparent, depending on if the `opaque_color` field in it is set.

498

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

499

# a transparent color.

500

"rgbColor": { # An RGB color. # An opaque RGB color.

501

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

502

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

503

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

504

},

505

"themeColor": "A String", # An opaque theme color.

506

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

507

},

508

},

509

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

510

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

511

"autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically

512

# replaced with content that can change over time.

513

"type": "A String", # The type of this auto text.

514

"content": "A String", # The rendered content of this auto text, if available.

515

"style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

516

#

517

# If this text is contained in a shape with a parent placeholder, then these text styles may be

518

# inherited from the parent. Which text styles are inherited depend on the

519

# nesting level of lists:

520

#

521

# * A text run in a paragraph that is not in a list will inherit its text style

522

# from the the newline character in the paragraph at the 0 nesting level of

523

# the list inside the parent placeholder.

524

# * A text run in a paragraph that is in a list will inherit its text style

525

# from the newline character in the paragraph at its corresponding nesting

526

# level of the list inside the parent placeholder.

527

#

528

# Inherited text styles are represented as unset fields in this message. If

529

# text is contained in a shape without a parent placeholder, unsetting these

530

# fields will revert the style to a value matching the defaults in the Slides

531

# editor.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

532

"smallCaps": True or False, # Whether or not the text is in small capital letters.

533

"weightedFontFamily": { # Represents a font family and weight used to style a TextRun. # The font family and rendered weight of the text.

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

534

#

535

# This field is an extension of `font_family` meant to support explicit font

536

# weights without breaking backwards compatibility. As such, when reading the

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

537

# style of a range of text, the value of `weighted_font_family#font_family`

538

# will always be equal to that of `font_family`. However, when writing, if

539

# both fields are included in the field mask (either explicitly or through

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

540

# the wildcard `"*"`), their values are reconciled as follows:

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

541

#

542

# * If `font_family` is set and `weighted_font_family` is not, the value of

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

543

# `font_family` is applied with weight `400` ("normal").

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

544

# * If both fields are set, the value of `font_family` must match that of

545

# `weighted_font_family#font_family`. If so, the font family and weight of

546

# `weighted_font_family` is applied. Otherwise, a 400 bad request error is

547

# returned.

548

# * If `weighted_font_family` is set and `font_family` is not, the font

549

# family and weight of `weighted_font_family` is applied.

550

# * If neither field is set, the font family and weight of the text inherit

551

# from the parent. Note that these properties cannot inherit separately

552

# from each other.

553

#

554

# If an update request specifies values for both `weighted_font_family` and

555

# `bold`, the `weighted_font_family` is applied first, then `bold`.

556

#

557

# If `weighted_font_family#weight` is not set, it defaults to `400`.

558

#

559

# If `weighted_font_family` is set, then `weighted_font_family#font_family`

560

# must also be set with a non-empty value. Otherwise, a 400 bad request error

561

# is returned.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

562

"fontFamily": "A String", # The font family of the text.

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

563

#

564

# The font family can be any font from the Font menu in Slides or from

565

# [Google Fonts] (https://fonts.google.com/). If the font name is

566

# unrecognized, the text is rendered in `Arial`.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

567

"weight": 42, # The rendered weight of the text. This field can have any value that is a

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

568

# multiple of `100` between `100` and `900`, inclusive. This range

569

# corresponds to the numerical values described in the CSS 2.1

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

570

# Specification,

571

# [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness),

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

572

# with non-numerical values disallowed. Weights greater than or equal to

573

# `700` are considered bold, and weights less than `700`are not bold. The

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

574

# default value is `400` ("normal").

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

575

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

576

"underline": True or False, # Whether or not the text is underlined.

577

"link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

578

# are not inherited from parent text.

579

#

580

# Changing the link in an update request causes some other changes to the

581

# text style of the range:

582

#

583

# * When setting a link, the text foreground color will be set to

584

# ThemeColorType.HYPERLINK and the text will

585

# be underlined. If these fields are modified in the same

586

# request, those values will be used instead of the link defaults.

587

# * Setting a link on a text range that overlaps with an existing link will

588

# also update the existing link to point to the new URL.

589

# * Links are not settable on newline characters. As a result, setting a link

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

590

# on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

591

# will separate the newline character(s) into their own text runs. The

592

# link will be applied separately to the runs before and after the newline.

593

# * Removing a link will update the text style of the range to match the

594

# style of the preceding text (or the default text styles if the preceding

595

# text is another link) unless different styles are being set in the same

596

# request.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

597

"slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index

598

# in the presentation. There may not be a slide at this index.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

599

"pageObjectId": "A String", # If set, indicates this is a link to the specific page in this

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

600

# presentation with this ID. A page with this ID may not exist.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

601

"url": "A String", # If set, indicates this is a link to the external web page at this URL.

602

"relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

603

# addressed by its position.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

604

},

605

"strikethrough": True or False, # Whether or not the text is struck through.

606

"fontFamily": "A String", # The font family of the text.

607

#

608

# The font family can be any font from the Font menu in Slides or from

609

# [Google Fonts] (https://fonts.google.com/). If the font name is

610

# unrecognized, the text is rendered in `Arial`.

611

#

612

# Some fonts can affect the weight of the text. If an update request

613

# specifies values for both `font_family` and `bold`, the explicitly-set

614

# `bold` value is used.

615

"backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or

616

# transparent, depending on if the `opaque_color` field in it is set.

617

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

618

# a transparent color.

619

"rgbColor": { # An RGB color. # An opaque RGB color.

620

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

621

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

622

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

623

},

624

"themeColor": "A String", # An opaque theme color.

625

},

626

},

627

"fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in

628

# points.

629

"unit": "A String", # The units for magnitude.

630

"magnitude": 3.14, # The magnitude.

631

},

632

"baselineOffset": "A String", # The text's vertical offset from its normal position.

633

#

634

# Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically

635

# rendered in a smaller font size, computed based on the `font_size` field.

636

# The `font_size` itself is not affected by changes in this field.

637

"italic": True or False, # Whether or not the text is italicized.

638

"bold": True or False, # Whether or not the text is rendered as bold.

639

"foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or

640

# transparent, depending on if the `opaque_color` field in it is set.

641

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

642

# a transparent color.

643

"rgbColor": { # An RGB color. # An opaque RGB color.

644

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

645

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

646

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

647

},

648

"themeColor": "A String", # An opaque theme color.

649

},

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

650

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

651

},

652

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

653

"textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters

654

# in the run have the same TextStyle.

655

#

656

# The `start_index` and `end_index` of TextRuns will always be fully

657

# contained in the index range of a single `paragraph_marker` TextElement.

658

# In other words, a TextRun will never span multiple paragraphs.

659

# styling.

660

"content": "A String", # The text of this run.

661

"style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.

662

#

663

# If this text is contained in a shape with a parent placeholder, then these text styles may be

664

# inherited from the parent. Which text styles are inherited depend on the

665

# nesting level of lists:

666

#

667

# * A text run in a paragraph that is not in a list will inherit its text style

668

# from the the newline character in the paragraph at the 0 nesting level of

669

# the list inside the parent placeholder.

670

# * A text run in a paragraph that is in a list will inherit its text style

671

# from the newline character in the paragraph at its corresponding nesting

672

# level of the list inside the parent placeholder.

673

#

674

# Inherited text styles are represented as unset fields in this message. If

675

# text is contained in a shape without a parent placeholder, unsetting these

676

# fields will revert the style to a value matching the defaults in the Slides

677

# editor.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

678

"smallCaps": True or False, # Whether or not the text is in small capital letters.

679

"weightedFontFamily": { # Represents a font family and weight used to style a TextRun. # The font family and rendered weight of the text.

680

#

681

# This field is an extension of `font_family` meant to support explicit font

682

# weights without breaking backwards compatibility. As such, when reading the

683

# style of a range of text, the value of `weighted_font_family#font_family`

684

# will always be equal to that of `font_family`. However, when writing, if

685

# both fields are included in the field mask (either explicitly or through

686

# the wildcard `"*"`), their values are reconciled as follows:

687

#

688

# * If `font_family` is set and `weighted_font_family` is not, the value of

689

# `font_family` is applied with weight `400` ("normal").

690

# * If both fields are set, the value of `font_family` must match that of

691

# `weighted_font_family#font_family`. If so, the font family and weight of

692

# `weighted_font_family` is applied. Otherwise, a 400 bad request error is

693

# returned.

694

# * If `weighted_font_family` is set and `font_family` is not, the font

695

# family and weight of `weighted_font_family` is applied.

696

# * If neither field is set, the font family and weight of the text inherit

697

# from the parent. Note that these properties cannot inherit separately

698

# from each other.

699

#

700

# If an update request specifies values for both `weighted_font_family` and

701

# `bold`, the `weighted_font_family` is applied first, then `bold`.

702

#

703

# If `weighted_font_family#weight` is not set, it defaults to `400`.

704

#

705

# If `weighted_font_family` is set, then `weighted_font_family#font_family`

706

# must also be set with a non-empty value. Otherwise, a 400 bad request error

707

# is returned.

708

"fontFamily": "A String", # The font family of the text.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

709

#

710

# The font family can be any font from the Font menu in Slides or from

711

# [Google Fonts] (https://fonts.google.com/). If the font name is

712

# unrecognized, the text is rendered in `Arial`.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

713

"weight": 42, # The rendered weight of the text. This field can have any value that is a

714

# multiple of `100` between `100` and `900`, inclusive. This range

715

# corresponds to the numerical values described in the CSS 2.1

716

# Specification,

717

# [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness),

718

# with non-numerical values disallowed. Weights greater than or equal to

719

# `700` are considered bold, and weights less than `700`are not bold. The

720

# default value is `400` ("normal").

721

},

722

"underline": True or False, # Whether or not the text is underlined.

723

"link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links

724

# are not inherited from parent text.

725

#

726

# Changing the link in an update request causes some other changes to the

727

# text style of the range:

728

#

729

# * When setting a link, the text foreground color will be set to

730

# ThemeColorType.HYPERLINK and the text will

731

# be underlined. If these fields are modified in the same

732

# request, those values will be used instead of the link defaults.

733

# * Setting a link on a text range that overlaps with an existing link will

734

# also update the existing link to point to the new URL.

735

# * Links are not settable on newline characters. As a result, setting a link

736

# on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,

737

# will separate the newline character(s) into their own text runs. The

738

# link will be applied separately to the runs before and after the newline.

739

# * Removing a link will update the text style of the range to match the

740

# style of the preceding text (or the default text styles if the preceding

741

# text is another link) unless different styles are being set in the same

742

# request.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

743

"slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index

744

# in the presentation. There may not be a slide at this index.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

745

"pageObjectId": "A String", # If set, indicates this is a link to the specific page in this

746

# presentation with this ID. A page with this ID may not exist.

747

"url": "A String", # If set, indicates this is a link to the external web page at this URL.

748

"relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,

749

# addressed by its position.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

750

},

751

"strikethrough": True or False, # Whether or not the text is struck through.

752

"fontFamily": "A String", # The font family of the text.

753

#

754

# The font family can be any font from the Font menu in Slides or from

755

# [Google Fonts] (https://fonts.google.com/). If the font name is

756

# unrecognized, the text is rendered in `Arial`.

757

#

758

# Some fonts can affect the weight of the text. If an update request

759

# specifies values for both `font_family` and `bold`, the explicitly-set

760

# `bold` value is used.

761

"backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or

762

# transparent, depending on if the `opaque_color` field in it is set.

763

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

764

# a transparent color.

765

"rgbColor": { # An RGB color. # An opaque RGB color.

766

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

767

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

768

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

769

},

770

"themeColor": "A String", # An opaque theme color.

771

},

772

},

773

"fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in

774

# points.

775

"unit": "A String", # The units for magnitude.

776

"magnitude": 3.14, # The magnitude.

777

},

778

"baselineOffset": "A String", # The text's vertical offset from its normal position.

779

#

780

# Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically

781

# rendered in a smaller font size, computed based on the `font_size` field.

782

# The `font_size` itself is not affected by changes in this field.

783

"italic": True or False, # Whether or not the text is italicized.

784

"bold": True or False, # Whether or not the text is rendered as bold.

785

"foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or

786

# transparent, depending on if the `opaque_color` field in it is set.

787

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

788

# a transparent color.

789

"rgbColor": { # An RGB color. # An opaque RGB color.

790

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

791

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

792

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

793

},

794

"themeColor": "A String", # An opaque theme color.

795

},

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

796

},

797

},

798

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

799

"endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code

800

# units.

801

"startIndex": 42, # The zero-based start index of this text element, in Unicode code units.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

802

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

803

],

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

804

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

805

"columnSpan": 42, # Column span of the cell.

806

"tableCellProperties": { # The properties of the TableCell. # The properties of the table cell.

807

"tableCellBackgroundFill": { # The table cell background fill. # The background fill of the table cell. The default fill matches the fill

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

808

# for newly created table cells in the Slides editor.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

809

"propertyState": "A String", # The background fill property state.

810

#

811

# Updating the fill on a table cell will implicitly update this field

812

# to `RENDERED`, unless another value is specified in the same request. To

813

# have no fill on a table cell, set this field to `NOT_RENDERED`. In this

814

# case, any other fill fields set in the same request will be ignored.

815

"solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

816

# specified color value.

817

#

818

# If any field is unset, its value may be inherited from a parent placeholder

819

# if it exists.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

820

"color": { # A themeable solid color value. # The color value of the solid fill.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

821

"rgbColor": { # An RGB color. # An opaque RGB color.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

822

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

823

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

824

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

825

},

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

826

"themeColor": "A String", # An opaque theme color.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

827

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

828

"alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

829

# That is, the final pixel color is defined by the equation:

830

#

831

# pixel color = alpha * (color) + (1.0 - alpha) * (background color)

832

#

833

# This means that a value of 1.0 corresponds to a solid color, whereas

834

# a value of 0.0 corresponds to a completely transparent color.

835

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

836

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

837

"contentAlignment": "A String", # The alignment of the content in the table cell. The default alignment

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

838

# matches the alignment for newly created table cells in the Slides editor.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

839

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

840

"rowSpan": 42, # Row span of the cell.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

841

},

842

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

843

"rowHeight": { # A magnitude in a single direction in the specified units. # Height of a row.

844

"unit": "A String", # The units for magnitude.

845

"magnitude": 3.14, # The magnitude.

846

},

847

"tableRowProperties": { # Properties of each row in a table. # Properties of the row.

848

"minRowHeight": { # A magnitude in a single direction in the specified units. # Minimum height of the row. The row will be rendered in the Slides editor at

849

# a height equal to or greater than this value in order to show all the text

850

# in the row's cell(s).

851

"unit": "A String", # The units for magnitude.

852

"magnitude": 3.14, # The magnitude.

853

},

854

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

855

},

856

],

857

"tableColumns": [ # Properties of each column.

858

{ # Properties of each column in a table.

859

"columnWidth": { # A magnitude in a single direction in the specified units. # Width of a column.

860

"unit": "A String", # The units for magnitude.

861

"magnitude": 3.14, # The magnitude.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

862

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

863

},

864

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

865

"columns": 42, # Number of columns in the table.

866

"verticalBorderRows": [ # Properties of vertical cell borders.

867

#

868

# A table's vertical cell borders are represented as a grid. The grid has the

869

# same number of rows as the table and one more column than the number of

870

# columns in the table. For example, if the table is 3 x 3, its vertical

871

# borders will be represented as a grid with 3 rows and 4 columns.

872

{ # Contents of each border row in a table.

873

"tableBorderCells": [ # Properties of each border cell. When a border's adjacent table cells are

874

# merged, it is not included in the response.

875

{ # The properties of each border cell.

876

"location": { # A location of a single table cell within a table. # The location of the border within the border table.

877

"columnIndex": 42, # The 0-based column index.

878

"rowIndex": 42, # The 0-based row index.

879

},

880

"tableBorderProperties": { # The border styling properties of the # The border properties.

881

# TableBorderCell.

882

"dashStyle": "A String", # The dash style of the border.

883

"tableBorderFill": { # The fill of the border. # The fill of the table border.

884

"solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid fill.

885

# specified color value.

886

#

887

# If any field is unset, its value may be inherited from a parent placeholder

888

# if it exists.

889

"color": { # A themeable solid color value. # The color value of the solid fill.

890

"rgbColor": { # An RGB color. # An opaque RGB color.

891

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

892

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

893

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

894

},

895

"themeColor": "A String", # An opaque theme color.

896

},

897

"alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.

898

# That is, the final pixel color is defined by the equation:

899

#

900

# pixel color = alpha * (color) + (1.0 - alpha) * (background color)

901

#

902

# This means that a value of 1.0 corresponds to a solid color, whereas

903

# a value of 0.0 corresponds to a completely transparent color.

904

},

905

},

906

"weight": { # A magnitude in a single direction in the specified units. # The thickness of the border.

907

"unit": "A String", # The units for magnitude.

908

"magnitude": 3.14, # The magnitude.

},

},

},

],

},

],

"horizontalBorderRows": [ # Properties of horizontal cell borders.

916

#

917

# A table's horizontal cell borders are represented as a grid. The grid has

918

# one more row than the number of rows in the table and the same number of

919

# columns as the table. For example, if the table is 3 x 3, its horizontal

920

# borders will be represented as a grid with 4 rows and 3 columns.

921

{ # Contents of each border row in a table.

922

"tableBorderCells": [ # Properties of each border cell. When a border's adjacent table cells are

923

# merged, it is not included in the response.

924

{ # The properties of each border cell.

925

"location": { # A location of a single table cell within a table. # The location of the border within the border table.

926

"columnIndex": 42, # The 0-based column index.

927

"rowIndex": 42, # The 0-based row index.

928

},

929

"tableBorderProperties": { # The border styling properties of the # The border properties.

930

# TableBorderCell.

931

"dashStyle": "A String", # The dash style of the border.

932

"tableBorderFill": { # The fill of the border. # The fill of the table border.

933

"solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid fill.

934

# specified color value.

935

#

936

# If any field is unset, its value may be inherited from a parent placeholder

937

# if it exists.

938

"color": { # A themeable solid color value. # The color value of the solid fill.

939

"rgbColor": { # An RGB color. # An opaque RGB color.

940

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

941

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

942

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

943

},

944

"themeColor": "A String", # An opaque theme color.

945

},

946

"alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.

947

# That is, the final pixel color is defined by the equation:

948

#

949

# pixel color = alpha * (color) + (1.0 - alpha) * (background color)

950

#

951

# This means that a value of 1.0 corresponds to a solid color, whereas

952

# a value of 0.0 corresponds to a completely transparent color.

953

},

954

},

955

"weight": { # A magnitude in a single direction in the specified units. # The thickness of the border.

956

"unit": "A String", # The units for magnitude.

957

"magnitude": 3.14, # The magnitude.

},

},

},

],

},

],

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

964

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

965

"transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # The transform of the page element.

966

#

967

# The visual appearance of the page element is determined by its absolute

968

# transform. To compute the absolute transform, preconcatenate a page

969

# element's transform with the transforms of all of its parent groups. If the

970

# page element is not in a group, its absolute transform is the same as the

971

# value in this field.

972

#

973

# The initial transform for the newly created Group is always the identity transform.

974

# to transform source coordinates (x,y) into destination coordinates (x', y')

975

# according to:

976

#

977

# x' x = shear_y scale_y translate_y

978

# 1 [ 1 ]

979

#

980

# After transformation,

981

#

982

# x' = scale_x * x + shear_x * y + translate_x;

983

# y' = scale_y * y + shear_y * x + translate_y;

984

#

985

# This message is therefore composed of these six matrix elements.

986

"shearY": 3.14, # The Y coordinate shearing element.

987

"scaleY": 3.14, # The Y coordinate scaling element.

988

"translateX": 3.14, # The X coordinate translation element.

989

"translateY": 3.14, # The Y coordinate translation element.

990

"scaleX": 3.14, # The X coordinate scaling element.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

991

"shearX": 3.14, # The X coordinate shearing element.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

992

"unit": "A String", # The units for translate elements.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

993

},

994

"objectId": "A String", # The object ID for this page element. Object IDs used by

995

# google.apps.slides.v1.Page and

996

# google.apps.slides.v1.PageElement share the same namespace.

997

"image": { # A PageElement kind representing an # An image page element.

998

# image.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

999

"imageProperties": { # The properties of the Image. # The properties of the image.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1000

"brightness": 3.14, # The brightness effect of the image. The value should be in the interval

1001

# [-1.0, 1.0], where 0 means no effect. This property is read-only.

1002

"link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.

1003

"slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index

1004

# in the presentation. There may not be a slide at this index.

1005

"pageObjectId": "A String", # If set, indicates this is a link to the specific page in this

1006

# presentation with this ID. A page with this ID may not exist.

1007

"url": "A String", # If set, indicates this is a link to the external web page at this URL.

1008

"relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,

1009

# addressed by its position.

1010

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1011

"outline": { # The outline of a PageElement. # The outline of the image. If not set, the image has no outline.

1012

#

1013

# If these fields are unset, they may be inherited from a parent placeholder

1014

# if it exists. If there is no parent, the fields will default to the value

1015

# used for new page elements created in the Slides editor, which may depend on

1016

# the page element kind.

1017

"outlineFill": { # The fill of the outline. # The fill of the outline.

1018

"solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.

1019

# specified color value.

1020

#

1021

# If any field is unset, its value may be inherited from a parent placeholder

1022

# if it exists.

1023

"color": { # A themeable solid color value. # The color value of the solid fill.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1024

"rgbColor": { # An RGB color. # An opaque RGB color.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1025

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1026

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1027

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1028

},

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1029

"themeColor": "A String", # An opaque theme color.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1030

},

1031

"alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.

1032

# That is, the final pixel color is defined by the equation:

1033

#

1034

# pixel color = alpha * (color) + (1.0 - alpha) * (background color)

1035

#

1036

# This means that a value of 1.0 corresponds to a solid color, whereas

1037

# a value of 0.0 corresponds to a completely transparent color.

1038

},

1039

},

1040

"dashStyle": "A String", # The dash style of the outline.

1041

"propertyState": "A String", # The outline property state.

1042

#

1043

# Updating the outline on a page element will implicitly update this field

1044

# to `RENDERED`, unless another value is specified in the same request. To

1045

# have no outline on a page element, set this field to `NOT_RENDERED`. In

1046

# this case, any other outline fields set in the same request will be

1047

# ignored.

1048

"weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.

1049

"unit": "A String", # The units for magnitude.

1050

"magnitude": 3.14, # The magnitude.

1051

},

1052

},

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1053

"transparency": 3.14, # The transparency effect of the image. The value should be in the interval

1054

# [0.0, 1.0], where 0 means no effect and 1 means completely transparent.

1055

# This property is read-only.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1056

"recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.

1057

# This property is read-only.

1058

"recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color

1059

# stops.

1060

#

1061

# The colors in the gradient will replace the corresponding colors at

1062

# the same position in the color palette and apply to the image. This

1063

# property is read-only.

1064

{ # A color and position in a gradient band.

1065

"alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,

1066

# fully opaque.

1067

"position": 3.14, # The relative position of the color stop in the gradient band measured

1068

# in percentage. The value should be in the interval [0.0, 1.0].

1069

"color": { # A themeable solid color value. # The color of the gradient stop.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1070

"rgbColor": { # An RGB color. # An opaque RGB color.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1071

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1072

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1073

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1074

},

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1075

"themeColor": "A String", # An opaque theme color.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

},

},

],

"name": "A String", # The name of the recolor effect.

1080

#

1081

# The name is determined from the `recolor_stops` by matching the gradient

1082

# against the colors in the page's current color scheme. This property is

1083

# read-only.

1084

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1085

"contrast": 3.14, # The contrast effect of the image. The value should be in the interval

1086

# [-1.0, 1.0], where 0 means no effect. This property is read-only.

1087

"shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property

1088

# is read-only.

1089

#

1090

# If these fields are unset, they may be inherited from a parent placeholder

1091

# if it exists. If there is no parent, the fields will default to the value

1092

# used for new page elements created in the Slides editor, which may depend on

1093

# the page element kind.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1094

"color": { # A themeable solid color value. # The shadow color value.

1095

"rgbColor": { # An RGB color. # An opaque RGB color.

1096

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

1097

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1098

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

1099

},

1100

"themeColor": "A String", # An opaque theme color.

1101

},

1102

"alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,

1103

# scale and skew of the shadow. This property is read-only.

1104

"type": "A String", # The type of the shadow. This property is read-only.

1105

"propertyState": "A String", # The shadow property state.

1106

#

1107

# Updating the shadow on a page element will implicitly update this field to

1108

# `RENDERED`, unless another value is specified in the same request. To have

1109

# no shadow on a page element, set this field to `NOT_RENDERED`. In this

1110

# case, any other shadow fields set in the same request will be ignored.

1111

"rotateWithShape": True or False, # Whether the shadow should rotate with the shape. This property is

1112

# read-only.

1113

"blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the

1114

# shadow becomes.

1115

"unit": "A String", # The units for magnitude.

1116

"magnitude": 3.14, # The magnitude.

1117

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1118

"alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.

1119

"transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,

1120

# relative to the alignment position.

1121

# to transform source coordinates (x,y) into destination coordinates (x', y')

1122

# according to:

1123

#

1124

# x' x = shear_y scale_y translate_y

1125

# 1 [ 1 ]

1126

#

1127

# After transformation,

1128

#

1129

# x' = scale_x * x + shear_x * y + translate_x;

1130

# y' = scale_y * y + shear_y * x + translate_y;

1131

#

1132

# This message is therefore composed of these six matrix elements.

1133

"shearY": 3.14, # The Y coordinate shearing element.

1134

"scaleY": 3.14, # The Y coordinate scaling element.

1135

"translateX": 3.14, # The X coordinate translation element.

1136

"translateY": 3.14, # The Y coordinate translation element.

1137

"scaleX": 3.14, # The X coordinate scaling element.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1138

"shearX": 3.14, # The X coordinate shearing element.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1139

"unit": "A String", # The units for translate elements.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1140

},

1141

},

1142

"cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.

1143

# This property is read-only.

1144

# Image.

1145

#

1146

# The crop properties is represented by the offsets of four edges which define

1147

# a crop rectangle. The offsets are measured in percentage from the

1148

# corresponding edges of the object's original bounding rectangle towards

1149

# inside, relative to the object's original dimensions.

1150

#

1151

# - If the offset is in the interval (0, 1), the corresponding edge of crop

1152

# rectangle is positioned inside of the object's original bounding rectangle.

1153

# - If the offset is negative or greater than 1, the corresponding edge of crop

1154

# rectangle is positioned outside of the object's original bounding rectangle.

1155

# - If the left edge of the crop rectangle is on the right side of its right

1156

# edge, the object will be flipped horizontally.

1157

# - If the top edge of the crop rectangle is below its bottom edge, the object

1158

# will be flipped vertically.

1159

# - If all offsets and rotation angle is 0, the object is not cropped.

1160

#

1161

# After cropping, the content in the crop rectangle will be stretched to fit

1162

# its container.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1163

"topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located

1164

# below the original bounding rectangle top edge, relative to the object's

1165

# original height.

1166

"rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located

1167

# to the left of the original bounding rectangle right edge, relative to the

1168

# object's original width.

1169

"angle": 3.14, # The rotation angle of the crop window around its center, in radians.

1170

# Rotation angle is applied after the offset.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1171

"leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to

1172

# the right of the original bounding rectangle left edge, relative to the

1173

# object's original width.

1174

"bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located

1175

# above the original bounding rectangle bottom edge, relative to the object's

1176

# original height.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1177

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1178

},

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1179

"contentUrl": "A String", # An URL to an image with a default lifetime of 30 minutes.

1180

# This URL is tagged with the account of the requester. Anyone with the URL

1181

# effectively accesses the image as the original requester. Access to the

1182

# image may be lost if the presentation's sharing settings change.

1183

"sourceUrl": "A String", # The source URL is the URL used to insert the image. The source URL can be

1184

# empty.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1185

},

1186

"video": { # A PageElement kind representing a # A video page element.

1187

# video.

1188

"id": "A String", # The video source's unique identifier for this video.

1189

"source": "A String", # The video source.

1190

"url": "A String", # An URL to a video. The URL is valid as long as the source video exists and

1191

# sharing settings do not change.

1192

"videoProperties": { # The properties of the Video. # The properties of the video.

1193

"start": 42, # The time at which to start playback, measured in seconds from the beginning

1194

# of the video.

1195

# If set, the start time should be before the end time.

1196

# If you set this to a value that exceeds the video's length in seconds, the

1197

# video will be played from the last second.

1198

# If not set, the video will be played from the beginning.

1199

"mute": True or False, # Whether to mute the audio during video playback. Defaults to false.

1200

"end": 42, # The time at which to end playback, measured in seconds from the beginning

1201

# of the video.

1202

# If set, the end time should be after the start time.

1203

# If not set or if you set this to a value that exceeds the video's length,

1204

# the video will be played until its end.

1205

"autoPlay": True or False, # Whether to enable video autoplay when the page is displayed in present

1206

# mode. Defaults to false.

1207

"outline": { # The outline of a PageElement. # The outline of the video. The default outline matches the defaults for new

1208

# videos created in the Slides editor.

1209

#

1210

# If these fields are unset, they may be inherited from a parent placeholder

1211

# if it exists. If there is no parent, the fields will default to the value

1212

# used for new page elements created in the Slides editor, which may depend on

1213

# the page element kind.

1214

"outlineFill": { # The fill of the outline. # The fill of the outline.

1215

"solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.

1216

# specified color value.

1217

#

1218

# If any field is unset, its value may be inherited from a parent placeholder

1219

# if it exists.

1220

"color": { # A themeable solid color value. # The color value of the solid fill.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1221

"rgbColor": { # An RGB color. # An opaque RGB color.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1222

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1223

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1224

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1225

},

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1226

"themeColor": "A String", # An opaque theme color.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1227

},

1228

"alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.

1229

# That is, the final pixel color is defined by the equation:

1230

#

1231

# pixel color = alpha * (color) + (1.0 - alpha) * (background color)

1232

#

1233

# This means that a value of 1.0 corresponds to a solid color, whereas

1234

# a value of 0.0 corresponds to a completely transparent color.

1235

},

1236

},

1237

"dashStyle": "A String", # The dash style of the outline.

1238

"propertyState": "A String", # The outline property state.

1239

#

1240

# Updating the outline on a page element will implicitly update this field

1241

# to `RENDERED`, unless another value is specified in the same request. To

1242

# have no outline on a page element, set this field to `NOT_RENDERED`. In

1243

# this case, any other outline fields set in the same request will be

1244

# ignored.

1245

"weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.

1246

"unit": "A String", # The units for magnitude.

1247

"magnitude": 3.14, # The magnitude.

},

},

},

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1252

"line": { # A PageElement kind representing a # A line page element.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1253

# non-connector line, straight connector, curved connector, or bent connector.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1254

"lineCategory": "A String", # The category of the line.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1255

#

1256

# It matches the `category` specified in CreateLineRequest, and can be updated with

1257

# UpdateLineCategoryRequest.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1258

"lineType": "A String", # The type of the line.

1259

"lineProperties": { # The properties of the Line. # The properties of the line.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1260

#

1261

# When unset, these fields default to values that match the appearance of

1262

# new lines created in the Slides editor.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1263

"startConnection": { # The properties for one end of a Line # The connection at the beginning of the line. If unset, there is no

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1264

# connection.

1265

#

1266

# Only lines with a Type indicating it is

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1267

# a "connector" can have a `start_connection`.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1268

# connection.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1269

"connectionSiteIndex": 42, # The index of the connection site on the connected page element.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1270

#

1271

# In most cases, it corresponds to the predefined connection site index from

1272

# the ECMA-376 standard. More information on those connection sites can be

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1273

# found in the description of the "cnx" attribute in section 20.1.9.9 and

1274

# Annex H. "Predefined DrawingML Shape and Text Geometries" of "Office Open

1275

# XML File Formats-Fundamentals and Markup Language Reference", part 1 of

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1276

# [ECMA-376 5th edition]

1277

# (http://www.ecma-international.org/publications/standards/Ecma-376.htm).

1278

#

1279

# The position of each connection site can also be viewed from Slides editor.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1280

"connectedObjectId": "A String", # The object ID of the connected page element.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1281

#

1282

# Some page elements, such as groups, tables, and lines

1283

# do not have connection sites and therefore cannot be connected to a

1284

# connector line.

1285

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1286

"startArrow": "A String", # The style of the arrow at the beginning of the line.

1287

"weight": { # A magnitude in a single direction in the specified units. # The thickness of the line.

1288

"unit": "A String", # The units for magnitude.

1289

"magnitude": 3.14, # The magnitude.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1290

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1291

"endArrow": "A String", # The style of the arrow at the end of the line.

1292

"lineFill": { # The fill of the line. # The fill of the line. The default line fill matches the defaults for new

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1293

# lines created in the Slides editor.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1294

"solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1295

# specified color value.

1296

#

1297

# If any field is unset, its value may be inherited from a parent placeholder

1298

# if it exists.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1299

"color": { # A themeable solid color value. # The color value of the solid fill.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1300

"rgbColor": { # An RGB color. # An opaque RGB color.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1301

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1302

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1303

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1304

},

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1305

"themeColor": "A String", # An opaque theme color.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1306

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1307

"alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1308

# That is, the final pixel color is defined by the equation:

1309

#

1310

# pixel color = alpha * (color) + (1.0 - alpha) * (background color)

1311

#

1312

# This means that a value of 1.0 corresponds to a solid color, whereas

1313

# a value of 0.0 corresponds to a completely transparent color.

1314

},

1315

},

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1316

"dashStyle": "A String", # The dash style of the line.

1317

"endConnection": { # The properties for one end of a Line # The connection at the end of the line. If unset, there is no connection.

1318

#

1319

# Only lines with a Type indicating it is

1320

# a "connector" can have an `end_connection`.

1321

# connection.

1322

"connectionSiteIndex": 42, # The index of the connection site on the connected page element.

1323

#

1324

# In most cases, it corresponds to the predefined connection site index from

1325

# the ECMA-376 standard. More information on those connection sites can be

1326

# found in the description of the "cnx" attribute in section 20.1.9.9 and

1327

# Annex H. "Predefined DrawingML Shape and Text Geometries" of "Office Open

1328

# XML File Formats-Fundamentals and Markup Language Reference", part 1 of

1329

# [ECMA-376 5th edition]

1330

# (http://www.ecma-international.org/publications/standards/Ecma-376.htm).

1331

#

1332

# The position of each connection site can also be viewed from Slides editor.

1333

"connectedObjectId": "A String", # The object ID of the connected page element.

1334

#

1335

# Some page elements, such as groups, tables, and lines

1336

# do not have connection sites and therefore cannot be connected to a

1337

# connector line.

1338

},

1339

"link": { # A hypertext link. # The hyperlink destination of the line. If unset, there is no link.

1340

"slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index

1341

# in the presentation. There may not be a slide at this index.

1342

"pageObjectId": "A String", # If set, indicates this is a link to the specific page in this

1343

# presentation with this ID. A page with this ID may not exist.

1344

"url": "A String", # If set, indicates this is a link to the external web page at this URL.

1345

"relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,

1346

# addressed by its position.

},

},

},

"sheetsChart": { # A PageElement kind representing # A linked chart embedded from Google Sheets. Unlinked charts are

1351

# represented as images.

1352

# a linked chart embedded from Google Sheets.

1353

"spreadsheetId": "A String", # The ID of the Google Sheets spreadsheet that contains the source chart.

1354

"chartId": 42, # The ID of the specific chart in the Google Sheets spreadsheet that is

1355

# embedded.

1356

"contentUrl": "A String", # The URL of an image of the embedded chart, with a default lifetime of 30

1357

# minutes. This URL is tagged with the account of the requester. Anyone with

1358

# the URL effectively accesses the image as the original requester. Access to

1359

# the image may be lost if the presentation's sharing settings change.

1360

"sheetsChartProperties": { # The properties of the SheetsChart. # The properties of the Sheets chart.

1361

"chartImageProperties": { # The properties of the Image. # The properties of the embedded chart image.

1362

"brightness": 3.14, # The brightness effect of the image. The value should be in the interval

1363

# [-1.0, 1.0], where 0 means no effect. This property is read-only.

1364

"link": { # A hypertext link. # The hyperlink destination of the image. If unset, there is no link.

1365

"slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index

1366

# in the presentation. There may not be a slide at this index.

1367

"pageObjectId": "A String", # If set, indicates this is a link to the specific page in this

1368

# presentation with this ID. A page with this ID may not exist.

1369

"url": "A String", # If set, indicates this is a link to the external web page at this URL.

1370

"relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,

1371

# addressed by its position.

1372

},

1373

"outline": { # The outline of a PageElement. # The outline of the image. If not set, the image has no outline.

1374

#

1375

# If these fields are unset, they may be inherited from a parent placeholder

1376

# if it exists. If there is no parent, the fields will default to the value

1377

# used for new page elements created in the Slides editor, which may depend on

1378

# the page element kind.

1379

"outlineFill": { # The fill of the outline. # The fill of the outline.

1380

"solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.

1381

# specified color value.

1382

#

1383

# If any field is unset, its value may be inherited from a parent placeholder

1384

# if it exists.

1385

"color": { # A themeable solid color value. # The color value of the solid fill.

1386

"rgbColor": { # An RGB color. # An opaque RGB color.

1387

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

1388

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1389

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

1390

},

1391

"themeColor": "A String", # An opaque theme color.

1392

},

1393

"alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.

1394

# That is, the final pixel color is defined by the equation:

1395

#

1396

# pixel color = alpha * (color) + (1.0 - alpha) * (background color)

1397

#

1398

# This means that a value of 1.0 corresponds to a solid color, whereas

1399

# a value of 0.0 corresponds to a completely transparent color.

1400

},

1401

},

1402

"dashStyle": "A String", # The dash style of the outline.

1403

"propertyState": "A String", # The outline property state.

1404

#

1405

# Updating the outline on a page element will implicitly update this field

1406

# to `RENDERED`, unless another value is specified in the same request. To

1407

# have no outline on a page element, set this field to `NOT_RENDERED`. In

1408

# this case, any other outline fields set in the same request will be

1409

# ignored.

1410

"weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.

1411

"unit": "A String", # The units for magnitude.

1412

"magnitude": 3.14, # The magnitude.

1413

},

1414

},

1415

"transparency": 3.14, # The transparency effect of the image. The value should be in the interval

1416

# [0.0, 1.0], where 0 means no effect and 1 means completely transparent.

1417

# This property is read-only.

1418

"recolor": { # A recolor effect applied on an image. # The recolor effect of the image. If not set, the image is not recolored.

1419

# This property is read-only.

1420

"recolorStops": [ # The recolor effect is represented by a gradient, which is a list of color

1421

# stops.

1422

#

1423

# The colors in the gradient will replace the corresponding colors at

1424

# the same position in the color palette and apply to the image. This

1425

# property is read-only.

1426

{ # A color and position in a gradient band.

1427

"alpha": 3.14, # The alpha value of this color in the gradient band. Defaults to 1.0,

1428

# fully opaque.

1429

"position": 3.14, # The relative position of the color stop in the gradient band measured

1430

# in percentage. The value should be in the interval [0.0, 1.0].

1431

"color": { # A themeable solid color value. # The color of the gradient stop.

1432

"rgbColor": { # An RGB color. # An opaque RGB color.

1433

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

1434

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1435

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

1436

},

1437

"themeColor": "A String", # An opaque theme color.

},

},

],

"name": "A String", # The name of the recolor effect.

1442

#

1443

# The name is determined from the `recolor_stops` by matching the gradient

1444

# against the colors in the page's current color scheme. This property is

1445

# read-only.

1446

},

1447

"contrast": 3.14, # The contrast effect of the image. The value should be in the interval

1448

# [-1.0, 1.0], where 0 means no effect. This property is read-only.

1449

"shadow": { # The shadow properties of a page element. # The shadow of the image. If not set, the image has no shadow. This property

1450

# is read-only.

1451

#

1452

# If these fields are unset, they may be inherited from a parent placeholder

1453

# if it exists. If there is no parent, the fields will default to the value

1454

# used for new page elements created in the Slides editor, which may depend on

1455

# the page element kind.

1456

"color": { # A themeable solid color value. # The shadow color value.

1457

"rgbColor": { # An RGB color. # An opaque RGB color.

1458

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

1459

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1460

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

1461

},

1462

"themeColor": "A String", # An opaque theme color.

1463

},

1464

"alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,

1465

# scale and skew of the shadow. This property is read-only.

1466

"type": "A String", # The type of the shadow. This property is read-only.

1467

"propertyState": "A String", # The shadow property state.

1468

#

1469

# Updating the shadow on a page element will implicitly update this field to

1470

# `RENDERED`, unless another value is specified in the same request. To have

1471

# no shadow on a page element, set this field to `NOT_RENDERED`. In this

1472

# case, any other shadow fields set in the same request will be ignored.

1473

"rotateWithShape": True or False, # Whether the shadow should rotate with the shape. This property is

1474

# read-only.

1475

"blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the

1476

# shadow becomes.

1477

"unit": "A String", # The units for magnitude.

1478

"magnitude": 3.14, # The magnitude.

1479

},

1480

"alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.

1481

"transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,

1482

# relative to the alignment position.

1483

# to transform source coordinates (x,y) into destination coordinates (x', y')

1484

# according to:

1485

#

1486

# x' x = shear_y scale_y translate_y

1487

# 1 [ 1 ]

1488

#

1489

# After transformation,

1490

#

1491

# x' = scale_x * x + shear_x * y + translate_x;

1492

# y' = scale_y * y + shear_y * x + translate_y;

1493

#

1494

# This message is therefore composed of these six matrix elements.

1495

"shearY": 3.14, # The Y coordinate shearing element.

1496

"scaleY": 3.14, # The Y coordinate scaling element.

1497

"translateX": 3.14, # The X coordinate translation element.

1498

"translateY": 3.14, # The Y coordinate translation element.

1499

"scaleX": 3.14, # The X coordinate scaling element.

1500

"shearX": 3.14, # The X coordinate shearing element.

1501

"unit": "A String", # The units for translate elements.

1502

},

1503

},

1504

"cropProperties": { # The crop properties of an object enclosed in a container. For example, an # The crop properties of the image. If not set, the image is not cropped.

1505

# This property is read-only.

1506

# Image.

1507

#

1508

# The crop properties is represented by the offsets of four edges which define

1509

# a crop rectangle. The offsets are measured in percentage from the

1510

# corresponding edges of the object's original bounding rectangle towards

1511

# inside, relative to the object's original dimensions.

1512

#

1513

# - If the offset is in the interval (0, 1), the corresponding edge of crop

1514

# rectangle is positioned inside of the object's original bounding rectangle.

1515

# - If the offset is negative or greater than 1, the corresponding edge of crop

1516

# rectangle is positioned outside of the object's original bounding rectangle.

1517

# - If the left edge of the crop rectangle is on the right side of its right

1518

# edge, the object will be flipped horizontally.

1519

# - If the top edge of the crop rectangle is below its bottom edge, the object

1520

# will be flipped vertically.

1521

# - If all offsets and rotation angle is 0, the object is not cropped.

1522

#

1523

# After cropping, the content in the crop rectangle will be stretched to fit

1524

# its container.

1525

"topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located

1526

# below the original bounding rectangle top edge, relative to the object's

1527

# original height.

1528

"rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located

1529

# to the left of the original bounding rectangle right edge, relative to the

1530

# object's original width.

1531

"angle": 3.14, # The rotation angle of the crop window around its center, in radians.

1532

# Rotation angle is applied after the offset.

1533

"leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to

1534

# the right of the original bounding rectangle left edge, relative to the

1535

# object's original width.

1536

"bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located

1537

# above the original bounding rectangle bottom edge, relative to the object's

1538

# original height.

1539

},

1540

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1541

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1542

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1543

"size": { # A width and height. # The size of the page element.

1544

"width": { # A magnitude in a single direction in the specified units. # The width of the object.

1545

"unit": "A String", # The units for magnitude.

1546

"magnitude": 3.14, # The magnitude.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1547

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1548

"height": { # A magnitude in a single direction in the specified units. # The height of the object.

1549

"unit": "A String", # The units for magnitude.

1550

"magnitude": 3.14, # The magnitude.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1551

},

1552

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1553

"elementGroup": { # A PageElement kind representing a # A collection of page elements joined as a single unit.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1554

# joined collection of PageElements.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1555

"children": [ # The collection of elements in the group. The minimum size of a group is 2.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1556

# Object with schema name: PageElement

1557

],

1558

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1559

"shape": { # A PageElement kind representing a # A generic shape.

1560

# generic shape that does not have a more specific classification.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1561

"text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the shape.

1562

# text box or rectangle) or a table cell in a page.

1563

"lists": { # The bulleted lists contained in this text, keyed by list ID.

1564

"a_key": { # A List describes the look and feel of bullets belonging to paragraphs

1565

# associated with a list. A paragraph that is part of a list has an implicit

1566

# reference to that list's ID.

1567

"listId": "A String", # The ID of the list.

1568

"nestingLevel": { # A map of nesting levels to the properties of bullets at the associated

1569

# level. A list has at most nine levels of nesting, so the possible values

1570

# for the keys of this map are 0 through 8, inclusive.

1571

"a_key": { # Contains properties describing the look and feel of a list bullet at a given

1572

# level of nesting.

1573

"bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.

1574

#

1575

# If this text is contained in a shape with a parent placeholder, then these text styles may be

1576

# inherited from the parent. Which text styles are inherited depend on the

1577

# nesting level of lists:

1578

#

1579

# * A text run in a paragraph that is not in a list will inherit its text style

1580

# from the the newline character in the paragraph at the 0 nesting level of

1581

# the list inside the parent placeholder.

1582

# * A text run in a paragraph that is in a list will inherit its text style

1583

# from the newline character in the paragraph at its corresponding nesting

1584

# level of the list inside the parent placeholder.

1585

#

1586

# Inherited text styles are represented as unset fields in this message. If

1587

# text is contained in a shape without a parent placeholder, unsetting these

1588

# fields will revert the style to a value matching the defaults in the Slides

1589

# editor.

1590

"smallCaps": True or False, # Whether or not the text is in small capital letters.

1591

"weightedFontFamily": { # Represents a font family and weight used to style a TextRun. # The font family and rendered weight of the text.

1592

#

1593

# This field is an extension of `font_family` meant to support explicit font

1594

# weights without breaking backwards compatibility. As such, when reading the

1595

# style of a range of text, the value of `weighted_font_family#font_family`

1596

# will always be equal to that of `font_family`. However, when writing, if

1597

# both fields are included in the field mask (either explicitly or through

1598

# the wildcard `"*"`), their values are reconciled as follows:

1599

#

1600

# * If `font_family` is set and `weighted_font_family` is not, the value of

1601

# `font_family` is applied with weight `400` ("normal").

1602

# * If both fields are set, the value of `font_family` must match that of

1603

# `weighted_font_family#font_family`. If so, the font family and weight of

1604

# `weighted_font_family` is applied. Otherwise, a 400 bad request error is

1605

# returned.

1606

# * If `weighted_font_family` is set and `font_family` is not, the font

1607

# family and weight of `weighted_font_family` is applied.

1608

# * If neither field is set, the font family and weight of the text inherit

1609

# from the parent. Note that these properties cannot inherit separately

1610

# from each other.

1611

#

1612

# If an update request specifies values for both `weighted_font_family` and

1613

# `bold`, the `weighted_font_family` is applied first, then `bold`.

1614

#

1615

# If `weighted_font_family#weight` is not set, it defaults to `400`.

1616

#

1617

# If `weighted_font_family` is set, then `weighted_font_family#font_family`

1618

# must also be set with a non-empty value. Otherwise, a 400 bad request error

1619

# is returned.

1620

"fontFamily": "A String", # The font family of the text.

1621

#

1622

# The font family can be any font from the Font menu in Slides or from

1623

# [Google Fonts] (https://fonts.google.com/). If the font name is

1624

# unrecognized, the text is rendered in `Arial`.

1625

"weight": 42, # The rendered weight of the text. This field can have any value that is a

1626

# multiple of `100` between `100` and `900`, inclusive. This range

1627

# corresponds to the numerical values described in the CSS 2.1

1628

# Specification,

1629

# [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness),

1630

# with non-numerical values disallowed. Weights greater than or equal to

1631

# `700` are considered bold, and weights less than `700`are not bold. The

1632

# default value is `400` ("normal").

1633

},

1634

"underline": True or False, # Whether or not the text is underlined.

1635

"link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links

1636

# are not inherited from parent text.

1637

#

1638

# Changing the link in an update request causes some other changes to the

1639

# text style of the range:

1640

#

1641

# * When setting a link, the text foreground color will be set to

1642

# ThemeColorType.HYPERLINK and the text will

1643

# be underlined. If these fields are modified in the same

1644

# request, those values will be used instead of the link defaults.

1645

# * Setting a link on a text range that overlaps with an existing link will

1646

# also update the existing link to point to the new URL.

1647

# * Links are not settable on newline characters. As a result, setting a link

1648

# on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,

1649

# will separate the newline character(s) into their own text runs. The

1650

# link will be applied separately to the runs before and after the newline.

1651

# * Removing a link will update the text style of the range to match the

1652

# style of the preceding text (or the default text styles if the preceding

1653

# text is another link) unless different styles are being set in the same

1654

# request.

1655

"slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index

1656

# in the presentation. There may not be a slide at this index.

1657

"pageObjectId": "A String", # If set, indicates this is a link to the specific page in this

1658

# presentation with this ID. A page with this ID may not exist.

1659

"url": "A String", # If set, indicates this is a link to the external web page at this URL.

1660

"relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,

1661

# addressed by its position.

1662

},

1663

"strikethrough": True or False, # Whether or not the text is struck through.

1664

"fontFamily": "A String", # The font family of the text.

1665

#

1666

# The font family can be any font from the Font menu in Slides or from

1667

# [Google Fonts] (https://fonts.google.com/). If the font name is

1668

# unrecognized, the text is rendered in `Arial`.

1669

#

1670

# Some fonts can affect the weight of the text. If an update request

1671

# specifies values for both `font_family` and `bold`, the explicitly-set

1672

# `bold` value is used.

1673

"backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or

1674

# transparent, depending on if the `opaque_color` field in it is set.

1675

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

1676

# a transparent color.

1677

"rgbColor": { # An RGB color. # An opaque RGB color.

1678

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

1679

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1680

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

1681

},

1682

"themeColor": "A String", # An opaque theme color.

1683

},

1684

},

1685

"fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in

1686

# points.

1687

"unit": "A String", # The units for magnitude.

1688

"magnitude": 3.14, # The magnitude.

1689

},

1690

"baselineOffset": "A String", # The text's vertical offset from its normal position.

1691

#

1692

# Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically

1693

# rendered in a smaller font size, computed based on the `font_size` field.

1694

# The `font_size` itself is not affected by changes in this field.

1695

"italic": True or False, # Whether or not the text is italicized.

1696

"bold": True or False, # Whether or not the text is rendered as bold.

1697

"foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or

1698

# transparent, depending on if the `opaque_color` field in it is set.

1699

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

1700

# a transparent color.

1701

"rgbColor": { # An RGB color. # An opaque RGB color.

1702

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

1703

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1704

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

1705

},

1706

"themeColor": "A String", # An opaque theme color.

},

},

},

},

},

},

},

"textElements": [ # The text contents broken down into its component parts, including styling

1715

# information. This property is read-only.

1716

{ # A TextElement describes the content of a range of indices in the text content

1717

# of a Shape or TableCell.

1718

"paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.

1719

#

1720

# The `start_index` and `end_index` of this TextElement represent the

1721

# range of the paragraph. Other TextElements with an index range contained

1722

# inside this paragraph's range are considered to be part of this

1723

# paragraph. The range of indices of two separate paragraphs will never

1724

# overlap.

1725

"style": { # Styles that apply to a whole paragraph. # The paragraph's style

1726

#

1727

# If this text is contained in a shape with a parent placeholder, then these paragraph styles may be

1728

# inherited from the parent. Which paragraph styles are inherited depend on the

1729

# nesting level of lists:

1730

#

1731

# * A paragraph not in a list will inherit its paragraph style from the

1732

# paragraph at the 0 nesting level of the list inside the parent placeholder.

1733

# * A paragraph in a list will inherit its paragraph style from the paragraph

1734

# at its corresponding nesting level of the list inside the parent

1735

# placeholder.

1736

#

1737

# Inherited paragraph styles are represented as unset fields in this message.

1738

"indentEnd": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to

1739

# the end of the text, based on the current text direction. If unset, the

1740

# value is inherited from the parent.

1741

"unit": "A String", # The units for magnitude.

1742

"magnitude": 3.14, # The magnitude.

1743

},

1744

"spacingMode": "A String", # The spacing mode for the paragraph.

1745

"spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space below the paragraph. If unset, the value is

1746

# inherited from the parent.

1747

"unit": "A String", # The units for magnitude.

1748

"magnitude": 3.14, # The magnitude.

1749

},

1750

"alignment": "A String", # The text alignment for this paragraph.

1751

"indentFirstLine": { # A magnitude in a single direction in the specified units. # The amount of indentation for the start of the first line of the paragraph.

1752

# If unset, the value is inherited from the parent.

1753

"unit": "A String", # The units for magnitude.

1754

"magnitude": 3.14, # The magnitude.

1755

},

1756

"spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is

1757

# inherited from the parent.

1758

"unit": "A String", # The units for magnitude.

1759

"magnitude": 3.14, # The magnitude.

1760

},

1761

"direction": "A String", # The text direction of this paragraph. If unset, the value defaults to

1762

# LEFT_TO_RIGHT since

1763

# text direction is not inherited.

1764

"lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal

1765

# is represented as 100.0. If unset, the value is inherited from the parent.

1766

"indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to

1767

# the start of the text, based on the current text direction. If unset, the

1768

# value is inherited from the parent.

1769

"unit": "A String", # The units for magnitude.

1770

"magnitude": 3.14, # The magnitude.

1771

},

1772

},

1773

"bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not

1774

# belong to a list.

1775

"listId": "A String", # The ID of the list this paragraph belongs to.

1776

"glyph": "A String", # The rendered bullet glyph for this paragraph.

1777

"nestingLevel": 42, # The nesting level of this paragraph in the list.

1778

"bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.

1779

#

1780

# If this text is contained in a shape with a parent placeholder, then these text styles may be

1781

# inherited from the parent. Which text styles are inherited depend on the

1782

# nesting level of lists:

1783

#

1784

# * A text run in a paragraph that is not in a list will inherit its text style

1785

# from the the newline character in the paragraph at the 0 nesting level of

1786

# the list inside the parent placeholder.

1787

# * A text run in a paragraph that is in a list will inherit its text style

1788

# from the newline character in the paragraph at its corresponding nesting

1789

# level of the list inside the parent placeholder.

1790

#

1791

# Inherited text styles are represented as unset fields in this message. If

1792

# text is contained in a shape without a parent placeholder, unsetting these

1793

# fields will revert the style to a value matching the defaults in the Slides

1794

# editor.

1795

"smallCaps": True or False, # Whether or not the text is in small capital letters.

1796

"weightedFontFamily": { # Represents a font family and weight used to style a TextRun. # The font family and rendered weight of the text.

1797

#

1798

# This field is an extension of `font_family` meant to support explicit font

1799

# weights without breaking backwards compatibility. As such, when reading the

1800

# style of a range of text, the value of `weighted_font_family#font_family`

1801

# will always be equal to that of `font_family`. However, when writing, if

1802

# both fields are included in the field mask (either explicitly or through

1803

# the wildcard `"*"`), their values are reconciled as follows:

1804

#

1805

# * If `font_family` is set and `weighted_font_family` is not, the value of

1806

# `font_family` is applied with weight `400` ("normal").

1807

# * If both fields are set, the value of `font_family` must match that of

1808

# `weighted_font_family#font_family`. If so, the font family and weight of

1809

# `weighted_font_family` is applied. Otherwise, a 400 bad request error is

1810

# returned.

1811

# * If `weighted_font_family` is set and `font_family` is not, the font

1812

# family and weight of `weighted_font_family` is applied.

1813

# * If neither field is set, the font family and weight of the text inherit

1814

# from the parent. Note that these properties cannot inherit separately

1815

# from each other.

1816

#

1817

# If an update request specifies values for both `weighted_font_family` and

1818

# `bold`, the `weighted_font_family` is applied first, then `bold`.

1819

#

1820

# If `weighted_font_family#weight` is not set, it defaults to `400`.

1821

#

1822

# If `weighted_font_family` is set, then `weighted_font_family#font_family`

1823

# must also be set with a non-empty value. Otherwise, a 400 bad request error

1824

# is returned.

1825

"fontFamily": "A String", # The font family of the text.

1826

#

1827

# The font family can be any font from the Font menu in Slides or from

1828

# [Google Fonts] (https://fonts.google.com/). If the font name is

1829

# unrecognized, the text is rendered in `Arial`.

1830

"weight": 42, # The rendered weight of the text. This field can have any value that is a

1831

# multiple of `100` between `100` and `900`, inclusive. This range

1832

# corresponds to the numerical values described in the CSS 2.1

1833

# Specification,

1834

# [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness),

1835

# with non-numerical values disallowed. Weights greater than or equal to

1836

# `700` are considered bold, and weights less than `700`are not bold. The

1837

# default value is `400` ("normal").

1838

},

1839

"underline": True or False, # Whether or not the text is underlined.

1840

"link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links

1841

# are not inherited from parent text.

1842

#

1843

# Changing the link in an update request causes some other changes to the

1844

# text style of the range:

1845

#

1846

# * When setting a link, the text foreground color will be set to

1847

# ThemeColorType.HYPERLINK and the text will

1848

# be underlined. If these fields are modified in the same

1849

# request, those values will be used instead of the link defaults.

1850

# * Setting a link on a text range that overlaps with an existing link will

1851

# also update the existing link to point to the new URL.

1852

# * Links are not settable on newline characters. As a result, setting a link

1853

# on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,

1854

# will separate the newline character(s) into their own text runs. The

1855

# link will be applied separately to the runs before and after the newline.

1856

# * Removing a link will update the text style of the range to match the

1857

# style of the preceding text (or the default text styles if the preceding

1858

# text is another link) unless different styles are being set in the same

1859

# request.

1860

"slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index

1861

# in the presentation. There may not be a slide at this index.

1862

"pageObjectId": "A String", # If set, indicates this is a link to the specific page in this

1863

# presentation with this ID. A page with this ID may not exist.

1864

"url": "A String", # If set, indicates this is a link to the external web page at this URL.

1865

"relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,

1866

# addressed by its position.

1867

},

1868

"strikethrough": True or False, # Whether or not the text is struck through.

1869

"fontFamily": "A String", # The font family of the text.

1870

#

1871

# The font family can be any font from the Font menu in Slides or from

1872

# [Google Fonts] (https://fonts.google.com/). If the font name is

1873

# unrecognized, the text is rendered in `Arial`.

1874

#

1875

# Some fonts can affect the weight of the text. If an update request

1876

# specifies values for both `font_family` and `bold`, the explicitly-set

1877

# `bold` value is used.

1878

"backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or

1879

# transparent, depending on if the `opaque_color` field in it is set.

1880

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

1881

# a transparent color.

1882

"rgbColor": { # An RGB color. # An opaque RGB color.

1883

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

1884

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1885

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

1886

},

1887

"themeColor": "A String", # An opaque theme color.

1888

},

1889

},

1890

"fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in

1891

# points.

1892

"unit": "A String", # The units for magnitude.

1893

"magnitude": 3.14, # The magnitude.

1894

},

1895

"baselineOffset": "A String", # The text's vertical offset from its normal position.

1896

#

1897

# Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically

1898

# rendered in a smaller font size, computed based on the `font_size` field.

1899

# The `font_size` itself is not affected by changes in this field.

1900

"italic": True or False, # Whether or not the text is italicized.

1901

"bold": True or False, # Whether or not the text is rendered as bold.

1902

"foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or

1903

# transparent, depending on if the `opaque_color` field in it is set.

1904

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

1905

# a transparent color.

1906

"rgbColor": { # An RGB color. # An opaque RGB color.

1907

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

1908

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1909

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

1910

},

1911

"themeColor": "A String", # An opaque theme color.

},

},

},

},

},

"autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically

1918

# replaced with content that can change over time.

1919

"type": "A String", # The type of this auto text.

1920

"content": "A String", # The rendered content of this auto text, if available.

1921

"style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.

1922

#

1923

# If this text is contained in a shape with a parent placeholder, then these text styles may be

1924

# inherited from the parent. Which text styles are inherited depend on the

1925

# nesting level of lists:

1926

#

1927

# * A text run in a paragraph that is not in a list will inherit its text style

1928

# from the the newline character in the paragraph at the 0 nesting level of

1929

# the list inside the parent placeholder.

1930

# * A text run in a paragraph that is in a list will inherit its text style

1931

# from the newline character in the paragraph at its corresponding nesting

1932

# level of the list inside the parent placeholder.

1933

#

1934

# Inherited text styles are represented as unset fields in this message. If

1935

# text is contained in a shape without a parent placeholder, unsetting these

1936

# fields will revert the style to a value matching the defaults in the Slides

1937

# editor.

1938

"smallCaps": True or False, # Whether or not the text is in small capital letters.

1939

"weightedFontFamily": { # Represents a font family and weight used to style a TextRun. # The font family and rendered weight of the text.

1940

#

1941

# This field is an extension of `font_family` meant to support explicit font

1942

# weights without breaking backwards compatibility. As such, when reading the

1943

# style of a range of text, the value of `weighted_font_family#font_family`

1944

# will always be equal to that of `font_family`. However, when writing, if

1945

# both fields are included in the field mask (either explicitly or through

1946

# the wildcard `"*"`), their values are reconciled as follows:

1947

#

1948

# * If `font_family` is set and `weighted_font_family` is not, the value of

1949

# `font_family` is applied with weight `400` ("normal").

1950

# * If both fields are set, the value of `font_family` must match that of

1951

# `weighted_font_family#font_family`. If so, the font family and weight of

1952

# `weighted_font_family` is applied. Otherwise, a 400 bad request error is

1953

# returned.

1954

# * If `weighted_font_family` is set and `font_family` is not, the font

1955

# family and weight of `weighted_font_family` is applied.

1956

# * If neither field is set, the font family and weight of the text inherit

1957

# from the parent. Note that these properties cannot inherit separately

1958

# from each other.

1959

#

1960

# If an update request specifies values for both `weighted_font_family` and

1961

# `bold`, the `weighted_font_family` is applied first, then `bold`.

1962

#

1963

# If `weighted_font_family#weight` is not set, it defaults to `400`.

1964

#

1965

# If `weighted_font_family` is set, then `weighted_font_family#font_family`

1966

# must also be set with a non-empty value. Otherwise, a 400 bad request error

1967

# is returned.

1968

"fontFamily": "A String", # The font family of the text.

1969

#

1970

# The font family can be any font from the Font menu in Slides or from

1971

# [Google Fonts] (https://fonts.google.com/). If the font name is

1972

# unrecognized, the text is rendered in `Arial`.

1973

"weight": 42, # The rendered weight of the text. This field can have any value that is a

1974

# multiple of `100` between `100` and `900`, inclusive. This range

1975

# corresponds to the numerical values described in the CSS 2.1

1976

# Specification,

1977

# [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness),

1978

# with non-numerical values disallowed. Weights greater than or equal to

1979

# `700` are considered bold, and weights less than `700`are not bold. The

1980

# default value is `400` ("normal").

1981

},

1982

"underline": True or False, # Whether or not the text is underlined.

1983

"link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links

1984

# are not inherited from parent text.

1985

#

1986

# Changing the link in an update request causes some other changes to the

1987

# text style of the range:

1988

#

1989

# * When setting a link, the text foreground color will be set to

1990

# ThemeColorType.HYPERLINK and the text will

1991

# be underlined. If these fields are modified in the same

1992

# request, those values will be used instead of the link defaults.

1993

# * Setting a link on a text range that overlaps with an existing link will

1994

# also update the existing link to point to the new URL.

1995

# * Links are not settable on newline characters. As a result, setting a link

1996

# on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,

1997

# will separate the newline character(s) into their own text runs. The

1998

# link will be applied separately to the runs before and after the newline.

1999

# * Removing a link will update the text style of the range to match the

2000

# style of the preceding text (or the default text styles if the preceding

2001

# text is another link) unless different styles are being set in the same

2002

# request.

2003

"slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index

2004

# in the presentation. There may not be a slide at this index.

2005

"pageObjectId": "A String", # If set, indicates this is a link to the specific page in this

2006

# presentation with this ID. A page with this ID may not exist.

2007

"url": "A String", # If set, indicates this is a link to the external web page at this URL.

2008

"relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,

2009

# addressed by its position.

2010

},

2011

"strikethrough": True or False, # Whether or not the text is struck through.

2012

"fontFamily": "A String", # The font family of the text.

2013

#

2014

# The font family can be any font from the Font menu in Slides or from

2015

# [Google Fonts] (https://fonts.google.com/). If the font name is

2016

# unrecognized, the text is rendered in `Arial`.

2017

#

2018

# Some fonts can affect the weight of the text. If an update request

2019

# specifies values for both `font_family` and `bold`, the explicitly-set

2020

# `bold` value is used.

2021

"backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or

2022

# transparent, depending on if the `opaque_color` field in it is set.

2023

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

2024

# a transparent color.

2025

"rgbColor": { # An RGB color. # An opaque RGB color.

2026

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

2027

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

2028

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

2029

},

2030

"themeColor": "A String", # An opaque theme color.

2031

},

2032

},

2033

"fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in

2034

# points.

2035

"unit": "A String", # The units for magnitude.

2036

"magnitude": 3.14, # The magnitude.

2037

},

2038

"baselineOffset": "A String", # The text's vertical offset from its normal position.

2039

#

2040

# Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically

2041

# rendered in a smaller font size, computed based on the `font_size` field.

2042

# The `font_size` itself is not affected by changes in this field.

2043

"italic": True or False, # Whether or not the text is italicized.

2044

"bold": True or False, # Whether or not the text is rendered as bold.

2045

"foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or

2046

# transparent, depending on if the `opaque_color` field in it is set.

2047

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

2048

# a transparent color.

2049

"rgbColor": { # An RGB color. # An opaque RGB color.

2050

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

2051

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

2052

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

2053

},

2054

"themeColor": "A String", # An opaque theme color.

},

},

},

},

"textRun": { # A TextElement kind that represents a run of text that all has the same # A TextElement representing a run of text where all of the characters

2060

# in the run have the same TextStyle.

2061

#

2062

# The `start_index` and `end_index` of TextRuns will always be fully

2063

# contained in the index range of a single `paragraph_marker` TextElement.

2064

# In other words, a TextRun will never span multiple paragraphs.

2065

# styling.

2066

"content": "A String", # The text of this run.

2067

"style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.

2068

#

2069

# If this text is contained in a shape with a parent placeholder, then these text styles may be

2070

# inherited from the parent. Which text styles are inherited depend on the

2071

# nesting level of lists:

2072

#

2073

# * A text run in a paragraph that is not in a list will inherit its text style

2074

# from the the newline character in the paragraph at the 0 nesting level of

2075

# the list inside the parent placeholder.

2076

# * A text run in a paragraph that is in a list will inherit its text style

2077

# from the newline character in the paragraph at its corresponding nesting

2078

# level of the list inside the parent placeholder.

2079

#

2080

# Inherited text styles are represented as unset fields in this message. If

2081

# text is contained in a shape without a parent placeholder, unsetting these

2082

# fields will revert the style to a value matching the defaults in the Slides

2083

# editor.

2084

"smallCaps": True or False, # Whether or not the text is in small capital letters.

2085

"weightedFontFamily": { # Represents a font family and weight used to style a TextRun. # The font family and rendered weight of the text.

2086

#

2087

# This field is an extension of `font_family` meant to support explicit font

2088

# weights without breaking backwards compatibility. As such, when reading the

2089

# style of a range of text, the value of `weighted_font_family#font_family`

2090

# will always be equal to that of `font_family`. However, when writing, if

2091

# both fields are included in the field mask (either explicitly or through

2092

# the wildcard `"*"`), their values are reconciled as follows:

2093

#

2094

# * If `font_family` is set and `weighted_font_family` is not, the value of

2095

# `font_family` is applied with weight `400` ("normal").

2096

# * If both fields are set, the value of `font_family` must match that of

2097

# `weighted_font_family#font_family`. If so, the font family and weight of

2098

# `weighted_font_family` is applied. Otherwise, a 400 bad request error is

2099

# returned.

2100

# * If `weighted_font_family` is set and `font_family` is not, the font

2101

# family and weight of `weighted_font_family` is applied.

2102

# * If neither field is set, the font family and weight of the text inherit

2103

# from the parent. Note that these properties cannot inherit separately

2104

# from each other.

2105

#

2106

# If an update request specifies values for both `weighted_font_family` and

2107

# `bold`, the `weighted_font_family` is applied first, then `bold`.

2108

#

2109

# If `weighted_font_family#weight` is not set, it defaults to `400`.

2110

#

2111

# If `weighted_font_family` is set, then `weighted_font_family#font_family`

2112

# must also be set with a non-empty value. Otherwise, a 400 bad request error

2113

# is returned.

2114

"fontFamily": "A String", # The font family of the text.

2115

#

2116

# The font family can be any font from the Font menu in Slides or from

2117

# [Google Fonts] (https://fonts.google.com/). If the font name is

2118

# unrecognized, the text is rendered in `Arial`.

2119

"weight": 42, # The rendered weight of the text. This field can have any value that is a

2120

# multiple of `100` between `100` and `900`, inclusive. This range

2121

# corresponds to the numerical values described in the CSS 2.1

2122

# Specification,

2123

# [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness),

2124

# with non-numerical values disallowed. Weights greater than or equal to

2125

# `700` are considered bold, and weights less than `700`are not bold. The

2126

# default value is `400` ("normal").

2127

},

2128

"underline": True or False, # Whether or not the text is underlined.

2129

"link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links

2130

# are not inherited from parent text.

2131

#

2132

# Changing the link in an update request causes some other changes to the

2133

# text style of the range:

2134

#

2135

# * When setting a link, the text foreground color will be set to

2136

# ThemeColorType.HYPERLINK and the text will

2137

# be underlined. If these fields are modified in the same

2138

# request, those values will be used instead of the link defaults.

2139

# * Setting a link on a text range that overlaps with an existing link will

2140

# also update the existing link to point to the new URL.

2141

# * Links are not settable on newline characters. As a result, setting a link

2142

# on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,

2143

# will separate the newline character(s) into their own text runs. The

2144

# link will be applied separately to the runs before and after the newline.

2145

# * Removing a link will update the text style of the range to match the

2146

# style of the preceding text (or the default text styles if the preceding

2147

# text is another link) unless different styles are being set in the same

2148

# request.

2149

"slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index

2150

# in the presentation. There may not be a slide at this index.

2151

"pageObjectId": "A String", # If set, indicates this is a link to the specific page in this

2152

# presentation with this ID. A page with this ID may not exist.

2153

"url": "A String", # If set, indicates this is a link to the external web page at this URL.

2154

"relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,

2155

# addressed by its position.

2156

},

2157

"strikethrough": True or False, # Whether or not the text is struck through.

2158

"fontFamily": "A String", # The font family of the text.

2159

#

2160

# The font family can be any font from the Font menu in Slides or from

2161

# [Google Fonts] (https://fonts.google.com/). If the font name is

2162

# unrecognized, the text is rendered in `Arial`.

2163

#

2164

# Some fonts can affect the weight of the text. If an update request

2165

# specifies values for both `font_family` and `bold`, the explicitly-set

2166

# `bold` value is used.

2167

"backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either opaque or

2168

# transparent, depending on if the `opaque_color` field in it is set.

2169

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

2170

# a transparent color.

2171

"rgbColor": { # An RGB color. # An opaque RGB color.

2172

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

2173

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

2174

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

2175

},

2176

"themeColor": "A String", # An opaque theme color.

2177

},

2178

},

2179

"fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font. When read, the `font_size` will specified in

2180

# points.

2181

"unit": "A String", # The units for magnitude.

2182

"magnitude": 3.14, # The magnitude.

2183

},

2184

"baselineOffset": "A String", # The text's vertical offset from its normal position.

2185

#

2186

# Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically

2187

# rendered in a smaller font size, computed based on the `font_size` field.

2188

# The `font_size` itself is not affected by changes in this field.

2189

"italic": True or False, # Whether or not the text is italicized.

2190

"bold": True or False, # Whether or not the text is rendered as bold.

2191

"foregroundColor": { # A color that can either be fully opaque or fully transparent. # The color of the text itself. If set, the color is either opaque or

2192

# transparent, depending on if the `opaque_color` field in it is set.

2193

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

2194

# a transparent color.

2195

"rgbColor": { # An RGB color. # An opaque RGB color.

2196

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

2197

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

2198

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

2199

},

2200

"themeColor": "A String", # An opaque theme color.

},

},

},

},

"endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code

2206

# units.

2207

"startIndex": 42, # The zero-based start index of this text element, in Unicode code units.

},

],

},

"shapeType": "A String", # The type of the shape.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2212

"placeholder": { # The placeholder information that uniquely identifies a placeholder shape. # Placeholders are shapes that are inherit from corresponding placeholders on

2213

# layouts and masters.

2214

#

2215

# If set, the shape is a placeholder shape and any inherited properties

2216

# can be resolved by looking at the parent placeholder identified by the

2217

# Placeholder.parent_object_id field.

2218

"index": 42, # The index of the placeholder. If the same placeholder types are present in

2219

# the same page, they would have different index values.

2220

"type": "A String", # The type of the placeholder.

2221

"parentObjectId": "A String", # The object ID of this shape's parent placeholder.

2222

# If unset, the parent placeholder shape does not exist, so the shape does

2223

# not inherit properties from any other shape.

2224

},

2225

"shapeProperties": { # The properties of a Shape. # The properties of the shape.

2226

#

2227

# If the shape is a placeholder shape as determined by the

2228

# placeholder field, then these

2229

# properties may be inherited from a parent placeholder shape.

2230

# Determining the rendered value of the property depends on the corresponding

2231

# property_state field value.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2232

"shapeBackgroundFill": { # The shape background fill. # The background fill of the shape. If unset, the background fill is

2233

# inherited from a parent placeholder if it exists. If the shape has no

2234

# parent, then the default background fill depends on the shape type,

2235

# matching the defaults for new shapes created in the Slides editor.

2236

"propertyState": "A String", # The background fill property state.

2237

#

2238

# Updating the fill on a shape will implicitly update this field to

2239

# `RENDERED`, unless another value is specified in the same request. To

2240

# have no fill on a shape, set this field to `NOT_RENDERED`. In this case,

2241

# any other fill fields set in the same request will be ignored.

2242

"solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.

2243

# specified color value.

2244

#

2245

# If any field is unset, its value may be inherited from a parent placeholder

2246

# if it exists.

2247

"color": { # A themeable solid color value. # The color value of the solid fill.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2248

"rgbColor": { # An RGB color. # An opaque RGB color.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

2249

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2250

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

2251

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2252

},

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

2253

"themeColor": "A String", # An opaque theme color.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2254

},

2255

"alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.

2256

# That is, the final pixel color is defined by the equation:

2257

#

2258

# pixel color = alpha * (color) + (1.0 - alpha) * (background color)

2259

#

2260

# This means that a value of 1.0 corresponds to a solid color, whereas

2261

# a value of 0.0 corresponds to a completely transparent color.

2262

},

2263

},

2264

"outline": { # The outline of a PageElement. # The outline of the shape. If unset, the outline is inherited from a

2265

# parent placeholder if it exists. If the shape has no parent, then the

2266

# default outline depends on the shape type, matching the defaults for

2267

# new shapes created in the Slides editor.

2268

#

2269

# If these fields are unset, they may be inherited from a parent placeholder

2270

# if it exists. If there is no parent, the fields will default to the value

2271

# used for new page elements created in the Slides editor, which may depend on

2272

# the page element kind.

2273

"outlineFill": { # The fill of the outline. # The fill of the outline.

2274

"solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.

2275

# specified color value.

2276

#

2277

# If any field is unset, its value may be inherited from a parent placeholder

2278

# if it exists.

2279

"color": { # A themeable solid color value. # The color value of the solid fill.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2280

"rgbColor": { # An RGB color. # An opaque RGB color.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

2281

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2282

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

2283

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2284

},

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

2285

"themeColor": "A String", # An opaque theme color.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2286

},

2287

"alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.

2288

# That is, the final pixel color is defined by the equation:

2289

#

2290

# pixel color = alpha * (color) + (1.0 - alpha) * (background color)

2291

#

2292

# This means that a value of 1.0 corresponds to a solid color, whereas

2293

# a value of 0.0 corresponds to a completely transparent color.

2294

},

2295

},

2296

"dashStyle": "A String", # The dash style of the outline.

2297

"propertyState": "A String", # The outline property state.

2298

#

2299

# Updating the outline on a page element will implicitly update this field

2300

# to `RENDERED`, unless another value is specified in the same request. To

2301

# have no outline on a page element, set this field to `NOT_RENDERED`. In

2302

# this case, any other outline fields set in the same request will be

2303

# ignored.

2304

"weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.

2305

"unit": "A String", # The units for magnitude.

2306

"magnitude": 3.14, # The magnitude.

2307

},

2308

},

2309

"shadow": { # The shadow properties of a page element. # The shadow properties of the shape. If unset, the shadow is inherited from

2310

# a parent placeholder if it exists. If the shape has no parent, then the

2311

# default shadow matches the defaults for new shapes created in the Slides

2312

# editor. This property is read-only.

2313

#

2314

# If these fields are unset, they may be inherited from a parent placeholder

2315

# if it exists. If there is no parent, the fields will default to the value

2316

# used for new page elements created in the Slides editor, which may depend on

2317

# the page element kind.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

2318

"color": { # A themeable solid color value. # The shadow color value.

2319

"rgbColor": { # An RGB color. # An opaque RGB color.

2320

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

2321

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

2322

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

2323

},

2324

"themeColor": "A String", # An opaque theme color.

2325

},

2326

"alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,

2327

# scale and skew of the shadow. This property is read-only.

2328

"type": "A String", # The type of the shadow. This property is read-only.

2329

"propertyState": "A String", # The shadow property state.

2330

#

2331

# Updating the shadow on a page element will implicitly update this field to

2332

# `RENDERED`, unless another value is specified in the same request. To have

2333

# no shadow on a page element, set this field to `NOT_RENDERED`. In this

2334

# case, any other shadow fields set in the same request will be ignored.

2335

"rotateWithShape": True or False, # Whether the shadow should rotate with the shape. This property is

2336

# read-only.

2337

"blurRadius": { # A magnitude in a single direction in the specified units. # The radius of the shadow blur. The larger the radius, the more diffuse the

2338

# shadow becomes.

2339

"unit": "A String", # The units for magnitude.

2340

"magnitude": 3.14, # The magnitude.

2341

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2342

"alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.

2343

"transform": { # AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] # Transform that encodes the translate, scale, and skew of the shadow,

2344

# relative to the alignment position.

2345

# to transform source coordinates (x,y) into destination coordinates (x', y')

2346

# according to:

2347

#

2348

# x' x = shear_y scale_y translate_y

2349

# 1 [ 1 ]

2350

#

2351

# After transformation,

2352

#

2353

# x' = scale_x * x + shear_x * y + translate_x;

2354

# y' = scale_y * y + shear_y * x + translate_y;

2355

#

2356

# This message is therefore composed of these six matrix elements.

2357

"shearY": 3.14, # The Y coordinate shearing element.

2358

"scaleY": 3.14, # The Y coordinate scaling element.

2359

"translateX": 3.14, # The X coordinate translation element.

2360

"translateY": 3.14, # The Y coordinate translation element.

2361

"scaleX": 3.14, # The X coordinate scaling element.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2362

"shearX": 3.14, # The X coordinate shearing element.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

2363

"unit": "A String", # The units for translate elements.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2364

},

2365

},

2366

"contentAlignment": "A String", # The alignment of the content in the shape. If unspecified,

2367

# the alignment is inherited from a parent placeholder if it exists. If the

2368

# shape has no parent, the default alignment matches the alignment for new

2369

# shapes created in the Slides editor.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

2370

"link": { # A hypertext link. # The hyperlink destination of the shape. If unset, there is no link. Links

2371

# are not inherited from parent placeholders.

2372

"slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index

2373

# in the presentation. There may not be a slide at this index.

2374

"pageObjectId": "A String", # If set, indicates this is a link to the specific page in this

2375

# presentation with this ID. A page with this ID may not exist.

2376

"url": "A String", # If set, indicates this is a link to the external web page at this URL.

2377

"relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,

2378

# addressed by its position.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2379

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2380

},

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

2381

},

2382

"wordArt": { # A PageElement kind representing # A word art page element.

2383

# word art.

2384

"renderedText": "A String", # The text rendered as word art.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2385

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2386

},

2387

],

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2388

"revisionId": "A String", # The revision ID of the presentation containing this page. Can be used in

2389

# update requests to assert that the presentation revision hasn't changed

Sai Cheemalapati

c30d2b5

2017-03-13 12:12:03 -0400

[diff] [blame]

2390

# since the last read operation. Only populated if the user has edit access

2391

# to the presentation.

2392

#

2393

# The format of the revision ID may change over time, so it should be treated

2394

# opaquely. A returned revision ID is only guaranteed to be valid for 24

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

2395

# hours after it has been returned and cannot be shared across users. If the

2396

# revision ID is unchanged between calls, then the presentation has not

2397

# changed. Conversely, a changed ID (for the same presentation and user)

2398

# usually means the presentation has been updated; however, a changed ID can

2399

# also be due to internal factors such as ID format changes.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

2400

"objectId": "A String", # The object ID for this page. Object IDs used by

2401

# Page and

2402

# PageElement share the same namespace.

2403

"pageProperties": { # The properties of the Page. # The properties of the page.

2404

#

2405

# The page will inherit properties from the parent page. Depending on the page

2406

# type the hierarchy is defined in either

2407

# SlideProperties or

2408

# LayoutProperties.

2409

"pageBackgroundFill": { # The page background fill. # The background fill of the page. If unset, the background fill is inherited

2410

# from a parent page if it exists. If the page has no parent, then the

2411

# background fill defaults to the corresponding fill in the Slides editor.

2412

"stretchedPictureFill": { # The stretched picture fill. The page or page element is filled entirely with # Stretched picture fill.

2413

# the specified picture. The picture is stretched to fit its container.

2414

"contentUrl": "A String", # Reading the content_url:

2415

#

2416

# An URL to a picture with a default lifetime of 30 minutes.

2417

# This URL is tagged with the account of the requester. Anyone with the URL

2418

# effectively accesses the picture as the original requester. Access to the

2419

# picture may be lost if the presentation's sharing settings change.

2420

#

2421

# Writing the content_url:

2422

#

2423

# The picture is fetched once at insertion time and a copy is stored for

2424

# display inside the presentation. Pictures must be less than 50MB in size,

2425

# cannot exceed 25 megapixels, and must be in one of PNG, JPEG, or GIF

2426

# format.

2427

#

2428

# The provided URL can be at most 2 kB in length.

2429

"size": { # A width and height. # The original size of the picture fill. This field is read-only.

2430

"width": { # A magnitude in a single direction in the specified units. # The width of the object.

2431

"unit": "A String", # The units for magnitude.

2432

"magnitude": 3.14, # The magnitude.

2433

},

2434

"height": { # A magnitude in a single direction in the specified units. # The height of the object.

2435

"unit": "A String", # The units for magnitude.

2436

"magnitude": 3.14, # The magnitude.

},

},

},

"propertyState": "A String", # The background fill property state.

2441

#

2442

# Updating the fill on a page will implicitly update this field to

2443

# `RENDERED`, unless another value is specified in the same request. To

2444

# have no fill on a page, set this field to `NOT_RENDERED`. In this case,

2445

# any other fill fields set in the same request will be ignored.

2446

"solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.

2447

# specified color value.

2448

#

2449

# If any field is unset, its value may be inherited from a parent placeholder

2450

# if it exists.

2451

"color": { # A themeable solid color value. # The color value of the solid fill.

2452

"rgbColor": { # An RGB color. # An opaque RGB color.

2453

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

2454

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

2455

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

2456

},

2457

"themeColor": "A String", # An opaque theme color.

2458

},

2459

"alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.

2460

# That is, the final pixel color is defined by the equation:

2461

#

2462

# pixel color = alpha * (color) + (1.0 - alpha) * (background color)

2463

#

2464

# This means that a value of 1.0 corresponds to a solid color, whereas

2465

# a value of 0.0 corresponds to a completely transparent color.

2466

},

2467

},

2468

"colorScheme": { # The palette of predefined colors for a page. # The color scheme of the page. If unset, the color scheme is inherited from

2469

# a parent page. If the page has no parent, the color scheme uses a default

2470

# Slides color scheme, matching the defaults in the Slides editor.

2471

#

2472

# Only the concrete colors of the first 12 ThemeColorTypes are editable. In addition, only

2473

# the color scheme on `Master` pages can be updated. To update the field, a

2474

# color scheme containing mappings from all the first 12 ThemeColorTypes to

2475

# their concrete colors must be provided. Colors for the remaining

2476

# ThemeColorTypes will be ignored.

2477

"colors": [ # The ThemeColorType and corresponding concrete color pairs.

2478

{ # A pair mapping a theme color type to the concrete color it represents.

2479

"type": "A String", # The type of the theme color.

2480

"color": { # An RGB color. # The concrete color corresponding to the theme color type above.

2481

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

2482

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

2483

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

},

},

],

},

},

"layoutProperties": { # The properties of Page are only # Layout specific properties. Only set if page_type = LAYOUT.

2490

# relevant for pages with page_type LAYOUT.

2491

"masterObjectId": "A String", # The object ID of the master that this layout is based on.

2492

"displayName": "A String", # The human-readable name of the layout.

2493

"name": "A String", # The name of the layout.

2494

},

2495

"pageType": "A String", # The type of the page.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

}</pre>

</div>

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

2499

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2500

<code class="details" id="getThumbnail">getThumbnail(presentationId, pageObjectId, thumbnailProperties_thumbnailSize=None, thumbnailProperties_mimeType=None, x__xgafv=None)</code>

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

2501

<pre>Generates a thumbnail of the latest version of the specified page in the

2502

presentation and returns a URL to the thumbnail image.

2503

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

2504

This request counts as an [expensive read request](/slides/limits) for

2505

quota purposes.

2506

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

2507

Args:

2508

presentationId: string, The ID of the presentation to retrieve. (required)

2509

pageObjectId: string, The object ID of the page whose thumbnail to retrieve. (required)

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

2510

thumbnailProperties_thumbnailSize: string, The optional thumbnail image size.

2511

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2512

If you don't specify the size, the server chooses a default size of the

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

2513

image.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2514

thumbnailProperties_mimeType: string, The optional mime type of the thumbnail image.

2515

2516

If you don't specify the mime type, the mime type defaults to PNG.

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

2517

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

2524

2525

{ # The thumbnail of a page.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

2526

"width": 42, # The positive width in pixels of the thumbnail image.

2527

"height": 42, # The positive height in pixels of the thumbnail image.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2528

"contentUrl": "A String", # The content URL of the thumbnail image.

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

2529

#

2530

# The URL to the image has a default lifetime of 30 minutes.

2531

# This URL is tagged with the account of the requester. Anyone with the URL

2532

# effectively accesses the image as the original requester. Access to the

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

2533

# image may be lost if the presentation's sharing settings change.

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

2534

# The mime type of the thumbnail image is the same as specified in the

2535

# `GetPageThumbnailRequest`.

Sai Cheemalapati