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

81

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

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.

100

"layoutProperties": { # The properties of Page are only # Layout specific properties. Only set if page_type = LAYOUT.

101

# relevant for pages with page_type LAYOUT.

Bu Sun Kim

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

[diff] [blame^]

102

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

Jon Wayne Parrott

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

[diff] [blame]

103

"name": "A String", # The name of the layout.

104

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

105

},

106

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

107

{ # A visual element rendered on a page.

108

"wordArt": { # A PageElement kind representing # A word art page element.

109

# word art.

110

"renderedText": "A String", # The text rendered as word art.

111

},

Bu Sun Kim

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

[diff] [blame^]

112

"elementGroup": { # A PageElement kind representing a # A collection of page elements joined as a single unit.

113

# joined collection of PageElements.

114

"children": [ # The collection of elements in the group. The minimum size of a group is 2.

115

# Object with schema name: PageElement

116

],

117

},

Jon Wayne Parrott

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

[diff] [blame]

118

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

119

# google.apps.slides.v1.Page and

120

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

121

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

122

# text.

123

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

124

# image.

125

"contentUrl": "A String", # An URL to an image with a default lifetime of 30 minutes.

126

# This URL is tagged with the account of the requester. Anyone with the URL

127

# effectively accesses the image as the original requester. Access to the

128

# image may be lost if the presentation's sharing settings change.

129

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

Bu Sun Kim

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

[diff] [blame^]

130

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

Jon Wayne Parrott

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

[diff] [blame]

131

#

132

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

133

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

134

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

135

# the page element kind.

Jon Wayne Parrott

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

[diff] [blame]

136

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

137

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

138

# specified color value.

139

#

140

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

141

# if it exists.

142

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

143

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

144

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

145

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

146

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

147

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

148

},

149

},

150

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

151

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

152

#

153

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

154

#

155

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

156

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

157

},

158

},

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

159

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

160

#

Bu Sun Kim

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

[diff] [blame^]

161

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

162

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

163

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

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

164

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

165

# ignored.

166

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

Jon Wayne Parrott

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

[diff] [blame]

167

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

168

"magnitude": 3.14, # The magnitude.

169

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

170

},

171

},

172

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

173

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

174

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

175

# This property is read-only.

176

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

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

177

# stops.

178

#

179

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

180

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

181

# property is read-only.

Jon Wayne Parrott

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

[diff] [blame]

182

{ # A color and position in a gradient band.

183

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

184

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

185

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

186

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

187

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

188

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

189

},

190

},

Jon Wayne Parrott

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

[diff] [blame]

191

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

192

# fully opaque.

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

193

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

194

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

Jon Wayne Parrott

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

[diff] [blame]

195

},

196

],

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

197

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

198

#

199

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

200

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

201

# read-only.

Jon Wayne Parrott

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

[diff] [blame]

202

},

203

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

204

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

Thomas Coffee

2017-03-27 10:39:26 -0700

[diff] [blame]

205

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

206

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

Sai Cheemalapati

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

[diff] [blame]

207

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

208

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

Jon Wayne Parrott

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

[diff] [blame]

209

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

210

# addressed by its position.

211

},

212

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

213

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

214

# This property is read-only.

215

"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.

216

# This property is read-only.

217

# Image.

218

#

219

# The crop properties is represented by the offsets of four edges which define

220

# a crop rectangle. The offsets are measured in percentage from the

221

# corresponding edges of the object's original bounding rectangle towards

222

# inside, relative to the object's original dimensions.

223

#

224

# - If the offset is in the interval (0, 1), the corresponding edge of crop

225

# rectangle is positioned inside of the object's original bounding rectangle.

226

# - If the offset is negative or greater than 1, the corresponding edge of crop

227

# rectangle is positioned outside of the object's original bounding rectangle.

228

# - If the left edge of the crop rectangle is on the right side of its right

229

# edge, the object will be flipped horizontally.

230

# - If the top edge of the crop rectangle is below its bottom edge, the object

231

# will be flipped vertically.

232

# - If all offsets and rotation angle is 0, the object is not cropped.

233

#

234

# After cropping, the content in the crop rectangle will be stretched to fit

235

# its container.

236

"leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to

237

# the right of the original bounding rectangle left edge, relative to the

238

# object's original width.

Bu Sun Kim

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

[diff] [blame^]

239

"bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located

240

# above the original bounding rectangle bottom edge, relative to the object's

241

# original height.

Sai Cheemalapati

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

[diff] [blame]

242

"angle": 3.14, # The rotation angle of the crop window around its center, in radians.

243

# Rotation angle is applied after the offset.

Thomas Coffee

2017-03-27 10:39:26 -0700

[diff] [blame]

244

"rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located

245

# to the left of the original bounding rectangle right edge, relative to the

246

# object's original width.

Sai Cheemalapati

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

[diff] [blame]

247

"topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located

248

# below the original bounding rectangle top edge, relative to the object's

249

# original height.

Jon Wayne Parrott

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

[diff] [blame]

250

},

251

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

252

# is read-only.

253

#

254

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

255

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

256

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

257

# the page element kind.

258

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

259

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

260

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

261

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

262

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

263

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

264

},

265

},

266

"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,

267

# relative to the alignment position.

268

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

269

# according to:

270

#

271

# x' x = shear_y scale_y translate_y

272

# 1 [ 1 ]

273

#

274

# After transformation,

275

#

276

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

277

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

278

#

279

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

280

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

281

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

282

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

283

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

284

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

285

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

286

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

287

},

288

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

289

#

Bu Sun Kim

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

[diff] [blame^]

290

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

291

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

292

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

Jon Wayne Parrott

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

[diff] [blame]

293

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

294

"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

295

# shadow becomes.

296

"magnitude": 3.14, # The magnitude.

297

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

298

},

299

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

Bu Sun Kim

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

[diff] [blame^]

300

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

Jon Wayne Parrott

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

[diff] [blame]

301

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

Bu Sun Kim

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

[diff] [blame^]

302

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

303

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

304

# read-only.

Jon Wayne Parrott

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

[diff] [blame]

305

},

306

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

307

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

308

},

Bu Sun Kim

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

[diff] [blame^]

309

"sourceUrl": "A String", # The source URL is the URL used to insert the image. The source URL can be

310

# empty.

Jon Wayne Parrott

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

[diff] [blame]

311

},

312

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

Bu Sun Kim

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

[diff] [blame^]

313

#

314

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

315

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

316

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

317

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

318

# value in this field.

319

#

320

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

Jon Wayne Parrott

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

[diff] [blame]

321

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

322

# according to:

323

#

324

# x' x = shear_y scale_y translate_y

325

# 1 [ 1 ]

326

#

327

# After transformation,

328

#

329

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

330

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

331

#

332

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

333

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

334

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

335

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

336

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

337

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

338

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

339

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

340

},

341

"shape": { # A PageElement kind representing a # A generic shape.

342

# generic shape that does not have a more specific classification.

343

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

344

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

345

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

346

# information. This property is read-only.

347

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

348

# of a Shape or TableCell.

349

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

350

# replaced with content that can change over time.

351

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

352

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

353

#

354

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

355

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

356

# nesting level of lists:

357

#

358

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

359

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

360

# the list inside the parent placeholder.

361

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

362

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

363

# level of the list inside the parent placeholder.

364

#

365

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

366

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

367

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

368

# editor.

369

"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

370

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

371

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

372

# a transparent color.

373

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

374

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

375

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

376

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

377

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

378

},

379

},

380

},

Bu Sun Kim

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

[diff] [blame^]

381

"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

382

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

383

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

384

# a transparent color.

385

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

386

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

387

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

388

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

389

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

390

},

391

},

392

},

Jon Wayne Parrott

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

[diff] [blame]

393

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

394

#

395

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

396

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

397

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

398

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

Sai Cheemalapati

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

[diff] [blame]

399

"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]

400

#

401

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

402

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

Sai Cheemalapati

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

[diff] [blame]

403

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

404

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

405

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

406

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

407

#

408

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

409

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

410

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

411

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

412

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

413

# returned.

414

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

415

# family and weight of `weighted_font_family` is applied.

416

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

417

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

418

# from each other.

419

#

420

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

421

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

422

#

423

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

424

#

425

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

426

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

427

# is returned.

Sai Cheemalapati

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

[diff] [blame]

428

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

429

#

430

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

431

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

432

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

433

"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]

434

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

435

# corresponds to the numerical values described in the CSS 2.1

Bu Sun Kim

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

[diff] [blame^]

436

# Specification,

437

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

Sai Cheemalapati

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

[diff] [blame]

438

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

439

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

440

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

Sai Cheemalapati

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

[diff] [blame]

441

},

Jon Wayne Parrott

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

[diff] [blame]

442

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

443

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

444

#

445

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

446

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

447

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

448

#

449

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

450

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

451

# `bold` value is used.

Bu Sun Kim

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

[diff] [blame^]

452

"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

453

# points.

454

"magnitude": 3.14, # The magnitude.

455

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

456

},

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

457

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

Jon Wayne Parrott

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

[diff] [blame]

458

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

459

# are not inherited from parent text.

460

#

461

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

462

# text style of the range:

463

#

464

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

465

# ThemeColorType.HYPERLINK and the text will

466

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

467

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

468

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

469

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

470

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

471

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

472

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

473

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

474

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

475

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

476

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

477

# request.

478

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

Thomas Coffee

2017-03-27 10:39:26 -0700

[diff] [blame]

479

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

480

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

Sai Cheemalapati

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

[diff] [blame]

481

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

482

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

Jon Wayne Parrott

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

[diff] [blame]

483

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

484

# addressed by its position.

485

},

Sai Cheemalapati

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

[diff] [blame]

486

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

Bu Sun Kim

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

[diff] [blame^]

487

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

Jon Wayne Parrott

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

[diff] [blame]

488

},

489

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

490

},

491

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

492

# units.

493

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

494

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

495

#

496

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

497

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

498

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

499

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

500

# overlap.

501

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

502

#

503

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

504

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

505

# nesting level of lists:

506

#

507

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

508

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

509

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

510

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

511

# placeholder.

512

#

513

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

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

514

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

515

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

Sai Cheemalapati

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

[diff] [blame]

516

# LEFT_TO_RIGHT since

517

# text direction is not inherited.

Bu Sun Kim

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

[diff] [blame^]

518

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

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

519

# inherited from the parent.

Jon Wayne Parrott

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

[diff] [blame]

520

"magnitude": 3.14, # The magnitude.

521

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

522

},

523

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

524

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

Jon Wayne Parrott

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

[diff] [blame]

525

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

526

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

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

527

# value is inherited from the parent.

Jon Wayne Parrott

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

[diff] [blame]

528

"magnitude": 3.14, # The magnitude.

529

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

530

},

531

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

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

532

# inherited from the parent.

Jon Wayne Parrott

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

[diff] [blame]

533

"magnitude": 3.14, # The magnitude.

534

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

535

},

536

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

537

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

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

538

# value is inherited from the parent.

Jon Wayne Parrott

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

[diff] [blame]

539

"magnitude": 3.14, # The magnitude.

540

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

541

},

542

"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.

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

543

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

Jon Wayne Parrott

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

[diff] [blame]

544

"magnitude": 3.14, # The magnitude.

545

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

546

},

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

547

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

Jon Wayne Parrott

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

[diff] [blame]

548

},

549

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

550

# belong to a list.

551

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

552

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

553

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

554

#

555

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

556

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

557

# nesting level of lists:

558

#

559

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

560

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

561

# the list inside the parent placeholder.

562

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

563

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

564

# level of the list inside the parent placeholder.

565

#

566

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

567

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

568

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

569

# editor.

570

"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

571

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

572

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

573

# a transparent color.

574

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

575

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

576

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

577

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

578

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

579

},

580

},

581

},

Bu Sun Kim

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

[diff] [blame^]

582

"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

583

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

584

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

585

# a transparent color.

586

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

587

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

588

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

589

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

590

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

591

},

592

},

593

},

Jon Wayne Parrott

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

[diff] [blame]

594

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

595

#

596

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

597

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

598

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

599

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

Sai Cheemalapati

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

[diff] [blame]

600

"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]

601

#

602

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

603

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

Sai Cheemalapati

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

[diff] [blame]

604

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

605

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

606

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

607

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

608

#

609

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

610

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

611

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

612

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

613

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

614

# returned.

615

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

616

# family and weight of `weighted_font_family` is applied.

617

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

618

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

619

# from each other.

620

#

621

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

622

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

623

#

624

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

625

#

626

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

627

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

628

# is returned.

Sai Cheemalapati

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

[diff] [blame]

629

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

630

#

631

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

632

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

633

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

634

"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]

635

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

636

# corresponds to the numerical values described in the CSS 2.1

Bu Sun Kim

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

[diff] [blame^]

637

# Specification,

638

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

Sai Cheemalapati

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

[diff] [blame]

639

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

640

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

641

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

Sai Cheemalapati

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

[diff] [blame]

642

},

Jon Wayne Parrott

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

[diff] [blame]

643

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

644

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

645

#

646

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

647

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

648

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

649

#

650

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

651

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

652

# `bold` value is used.

Bu Sun Kim

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

[diff] [blame^]

653

"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

654

# points.

655

"magnitude": 3.14, # The magnitude.

656

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

657

},

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

658

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

Jon Wayne Parrott

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

[diff] [blame]

659

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

660

# are not inherited from parent text.

661

#

662

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

663

# text style of the range:

664

#

665

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

666

# ThemeColorType.HYPERLINK and the text will

667

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

668

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

669

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

670

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

671

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

672

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

673

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

674

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

675

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

676

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

677

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

678

# request.

679

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

Thomas Coffee

2017-03-27 10:39:26 -0700

[diff] [blame]

680

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

681

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

Sai Cheemalapati

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

[diff] [blame]

682

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

683

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

Jon Wayne Parrott

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

[diff] [blame]

684

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

685

# addressed by its position.

686

},

Sai Cheemalapati

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

[diff] [blame]

687

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

Bu Sun Kim

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

[diff] [blame^]

688

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

Jon Wayne Parrott

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

[diff] [blame]

689

},

690

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

691

},

692

},

693

"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

694

# in the run have the same TextStyle.

695

#

696

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

697

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

698

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

699

# styling.

700

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

701

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

702

#

703

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

704

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

705

# nesting level of lists:

706

#

707

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

708

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

709

# the list inside the parent placeholder.

710

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

711

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

712

# level of the list inside the parent placeholder.

713

#

714

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

715

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

716

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

717

# editor.

718

"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

719

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

720

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

721

# a transparent color.

722

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

723

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

724

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

725

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

726

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

727

},

728

},

729

},

Bu Sun Kim

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

[diff] [blame^]

730

"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

731

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

732

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

733

# a transparent color.

734

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

735

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

736

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

737

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

738

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

739

},

740

},

741

},

Jon Wayne Parrott

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

[diff] [blame]

742

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

743

#

744

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

745

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

746

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

747

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

Sai Cheemalapati

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

[diff] [blame]

748

"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]

749

#

750

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

751

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

Sai Cheemalapati

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

[diff] [blame]

752

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

753

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

754

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

755

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

756

#

757

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

758

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

759

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

760

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

761

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

762

# returned.

763

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

764

# family and weight of `weighted_font_family` is applied.

765

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

766

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

767

# from each other.

768

#

769

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

770

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

771

#

772

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

773

#

774

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

775

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

776

# is returned.

Sai Cheemalapati

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

[diff] [blame]

777

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

778

#

779

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

780

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

781

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

782

"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]

783

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

784

# corresponds to the numerical values described in the CSS 2.1

Bu Sun Kim

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

[diff] [blame^]

785

# Specification,

786

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

Sai Cheemalapati

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

[diff] [blame]

787

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

788

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

789

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

Sai Cheemalapati

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

[diff] [blame]

790

},

Jon Wayne Parrott

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

[diff] [blame]

791

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

792

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

793

#

794

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

795

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

796

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

797

#

798

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

799

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

800

# `bold` value is used.

Bu Sun Kim

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

[diff] [blame^]

801

"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

802

# points.

803

"magnitude": 3.14, # The magnitude.

804

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

805

},

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

806

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

Jon Wayne Parrott

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

[diff] [blame]

807

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

808

# are not inherited from parent text.

809

#

810

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

811

# text style of the range:

812

#

813

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

814

# ThemeColorType.HYPERLINK and the text will

815

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

816

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

817

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

818

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

819

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

820

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

821

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

822

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

823

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

824

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

825

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

826

# request.

827

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

Thomas Coffee

2017-03-27 10:39:26 -0700

[diff] [blame]

828

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

829

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

Sai Cheemalapati

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

[diff] [blame]

830

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

831

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

Jon Wayne Parrott

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

[diff] [blame]

832

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

833

# addressed by its position.

834

},

Sai Cheemalapati

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

[diff] [blame]

835

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

Bu Sun Kim

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

[diff] [blame^]

836

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

Jon Wayne Parrott

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

[diff] [blame]

},

},

},

],

Bu Sun Kim

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

[diff] [blame^]

841

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

842

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

843

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

844

# reference to that list's ID.

845

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

846

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

847

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

848

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

849

# level of nesting.

850

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

851

#

852

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

853

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

854

# nesting level of lists:

855

#

856

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

857

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

858

# the list inside the parent placeholder.

859

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

860

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

861

# level of the list inside the parent placeholder.

862

#

863

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

864

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

865

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

866

# editor.

867

"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

868

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

869

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

870

# a transparent color.

871

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

872

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

873

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

874

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

875

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

},

},

},

"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

880

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

881

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

882

# a transparent color.

883

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

884

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

885

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

886

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

887

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

},

},

},

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

892

#

893

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

894

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

895

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

896

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

897

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

898

#

899

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

900

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

901

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

902

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

903

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

904

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

905

#

906

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

907

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

908

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

909

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

910

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

911

# returned.

912

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

913

# family and weight of `weighted_font_family` is applied.

914

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

915

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

916

# from each other.

917

#

918

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

919

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

920

#

921

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

922

#

923

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

924

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

925

# is returned.

926

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

927

#

928

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

929

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

930

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

931

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

932

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

933

# corresponds to the numerical values described in the CSS 2.1

934

# Specification,

935

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

936

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

937

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

938

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

939

},

940

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

941

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

942

#

943

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

944

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

945

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

946

#

947

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

948

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

949

# `bold` value is used.

950

"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

951

# points.

952

"magnitude": 3.14, # The magnitude.

953

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

954

},

955

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

956

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

957

# are not inherited from parent text.

958

#

959

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

960

# text style of the range:

961

#

962

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

963

# ThemeColorType.HYPERLINK and the text will

964

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

965

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

966

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

967

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

968

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

969

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

970

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

971

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

972

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

973

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

974

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

975

# request.

976

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

977

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

978

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

979

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

980

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

981

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

982

# addressed by its position.

983

},

984

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

985

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

},

},

},

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

990

},

991

},

Jon Wayne Parrott

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

[diff] [blame]

992

},

993

"shapeProperties": { # The properties of a Shape. # The properties of the shape.

994

#

995

# If the shape is a placeholder shape as determined by the

996

# placeholder field, then these

997

# properties may be inherited from a parent placeholder shape.

998

# Determining the rendered value of the property depends on the corresponding

999

# property_state field value.

1000

"shadow": { # The shadow properties of a page element. # The shadow properties of the shape. If unset, the shadow is inherited from

1001

# a parent placeholder if it exists. If the shape has no parent, then the

1002

# default shadow matches the defaults for new shapes created in the Slides

1003

# editor. This property is read-only.

1004

#

1005

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

1006

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

1007

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

1008

# the page element kind.

1009

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

1010

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

1011

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

1012

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

1013

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

1014

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

1015

},

1016

},

1017

"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,

1018

# relative to the alignment position.

1019

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

1020

# according to:

1021

#

1022

# x' x = shear_y scale_y translate_y

1023

# 1 [ 1 ]

1024

#

1025

# After transformation,

1026

#

1027

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

1028

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

1029

#

1030

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

1031

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

1032

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

1033

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

1034

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

1035

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

1036

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

1037

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

1038

},

1039

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

1040

#

Bu Sun Kim

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

[diff] [blame^]

1041

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

1042

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

1043

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

Jon Wayne Parrott

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

[diff] [blame]

1044

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

1045

"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

1046

# shadow becomes.

1047

"magnitude": 3.14, # The magnitude.

1048

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

1049

},

1050

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

Bu Sun Kim

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

[diff] [blame^]

1051

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

Jon Wayne Parrott

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

[diff] [blame]

1052

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

Bu Sun Kim

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

[diff] [blame^]

1053

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

1054

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

1055

# read-only.

Jon Wayne Parrott

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

[diff] [blame]

1056

},

1057

"shapeBackgroundFill": { # The shape background fill. # The background fill of the shape. If unset, the background fill is

1058

# inherited from a parent placeholder if it exists. If the shape has no

1059

# parent, then the default background fill depends on the shape type,

1060

# matching the defaults for new shapes created in the Slides editor.

1061

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

1062

# specified color value.

1063

#

1064

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

1065

# if it exists.

1066

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

1067

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

1068

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

1069

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

1070

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

1071

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

1072

},

1073

},

1074

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

1075

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

1076

#

1077

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

1078

#

1079

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

1080

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

1081

},

1082

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

1083

#

Bu Sun Kim

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

[diff] [blame^]

1084

# Updating the fill on a shape will implicitly update this field to

Jon Wayne Parrott

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

[diff] [blame]

1085

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

1086

# have no fill on a shape, set this field to `NOT_RENDERED`. In this case,

1087

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

1088

},

1089

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

1090

# are not inherited from parent placeholders.

1091

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

Thomas Coffee

2017-03-27 10:39:26 -0700

[diff] [blame]

1092

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

1093

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

Sai Cheemalapati

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

[diff] [blame]

1094

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

1095

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

Jon Wayne Parrott

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

[diff] [blame]

1096

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

1097

# addressed by its position.

1098

},

1099

"outline": { # The outline of a PageElement. # The outline of the shape. If unset, the outline is inherited from a

1100

# parent placeholder if it exists. If the shape has no parent, then the

1101

# default outline depends on the shape type, matching the defaults for

1102

# new shapes created in the Slides editor.

1103

#

1104

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

1105

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

1106

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

1107

# the page element kind.

Jon Wayne Parrott

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

[diff] [blame]

1108

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

1109

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

1110

# specified color value.

1111

#

1112

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

1113

# if it exists.

1114

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

1115

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

1116

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

1117

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

1118

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

1119

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

1120

},

1121

},

1122

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

1123

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

1124

#

1125

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

1126

#

1127

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

1128

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

1129

},

1130

},

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1131

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

1132

#

Bu Sun Kim

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

[diff] [blame^]

1133

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

1134

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

1135

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

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1136

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

1137

# ignored.

1138

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

Jon Wayne Parrott

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

[diff] [blame]

1139

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

1140

"magnitude": 3.14, # The magnitude.

1141

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

1142

},

1143

},

Bu Sun Kim

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

[diff] [blame^]

1144

"contentAlignment": "A String", # The alignment of the content in the shape. If unspecified,

1145

# the alignment is inherited from a parent placeholder if it exists. If the

1146

# shape has no parent, the default alignment matches the alignment for new

1147

# shapes created in the Slides editor.

Jon Wayne Parrott

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

[diff] [blame]

1148

},

1149

"placeholder": { # The placeholder information that uniquely identifies a placeholder shape. # Placeholders are shapes that are inherit from corresponding placeholders on

1150

# layouts and masters.

1151

#

1152

# If set, the shape is a placeholder shape and any inherited properties

1153

# can be resolved by looking at the parent placeholder identified by the

1154

# Placeholder.parent_object_id field.

1155

"parentObjectId": "A String", # The object ID of this shape's parent placeholder.

1156

# If unset, the parent placeholder shape does not exist, so the shape does

1157

# not inherit properties from any other shape.

Sai Cheemalapati

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

[diff] [blame]

1158

"index": 42, # The index of the placeholder. If the same placeholder types are present in

1159

# the same page, they would have different index values.

Jon Wayne Parrott

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

[diff] [blame]

1160

"type": "A String", # The type of the placeholder.

1161

},

1162

"shapeType": "A String", # The type of the shape.

1163

},

1164

"sheetsChart": { # A PageElement kind representing # A linked chart embedded from Google Sheets. Unlinked charts are

1165

# represented as images.

1166

# a linked chart embedded from Google Sheets.

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1167

"contentUrl": "A String", # The URL of an image of the embedded chart, with a default lifetime of 30

1168

# minutes. This URL is tagged with the account of the requester. Anyone with

1169

# the URL effectively accesses the image as the original requester. Access to

1170

# the image may be lost if the presentation's sharing settings change.

Sai Cheemalapati

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

[diff] [blame]

1171

"spreadsheetId": "A String", # The ID of the Google Sheets spreadsheet that contains the source chart.

Jon Wayne Parrott

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

[diff] [blame]

1172

"sheetsChartProperties": { # The properties of the SheetsChart. # The properties of the Sheets chart.

1173

"chartImageProperties": { # The properties of the Image. # The properties of the embedded chart image.

Bu Sun Kim

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

[diff] [blame^]

1174

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

Jon Wayne Parrott

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

[diff] [blame]

1175

#

1176

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

1177

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

1178

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

1179

# the page element kind.

Jon Wayne Parrott

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

[diff] [blame]

1180

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

1181

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

1182

# specified color value.

1183

#

1184

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

1185

# if it exists.

1186

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

1187

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

1188

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

1189

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

1190

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

1191

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

1192

},

1193

},

1194

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

1195

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

1196

#

1197

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

1198

#

1199

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

1200

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

1201

},

1202

},

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1203

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

1204

#

Bu Sun Kim

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

[diff] [blame^]

1205

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

1206

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

1207

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

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1208

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

1209

# ignored.

1210

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

Jon Wayne Parrott

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

[diff] [blame]

1211

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

1212

"magnitude": 3.14, # The magnitude.

1213

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

1214

},

1215

},

1216

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

1217

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

1218

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

1219

# This property is read-only.

1220

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

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1221

# stops.

1222

#

1223

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

1224

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

1225

# property is read-only.

Jon Wayne Parrott

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

[diff] [blame]

1226

{ # A color and position in a gradient band.

1227

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

1228

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

1229

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

1230

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

1231

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

1232

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

1233

},

1234

},

Jon Wayne Parrott

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

[diff] [blame]

1235

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

1236

# fully opaque.

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1237

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

1238

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

Jon Wayne Parrott

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

[diff] [blame]

1239

},

1240

],

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1241

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

1242

#

1243

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

1244

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

1245

# read-only.

Jon Wayne Parrott

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

[diff] [blame]

1246

},

1247

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

1248

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

Thomas Coffee

2017-03-27 10:39:26 -0700

[diff] [blame]

1249

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

1250

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

Sai Cheemalapati

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

[diff] [blame]

1251

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

1252

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

Jon Wayne Parrott

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

[diff] [blame]

1253

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

1254

# addressed by its position.

1255

},

1256

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

1257

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

1258

# This property is read-only.

1259

"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.

1260

# This property is read-only.

1261

# Image.

1262

#

1263

# The crop properties is represented by the offsets of four edges which define

1264

# a crop rectangle. The offsets are measured in percentage from the

1265

# corresponding edges of the object's original bounding rectangle towards

1266

# inside, relative to the object's original dimensions.

1267

#

1268

# - If the offset is in the interval (0, 1), the corresponding edge of crop

1269

# rectangle is positioned inside of the object's original bounding rectangle.

1270

# - If the offset is negative or greater than 1, the corresponding edge of crop

1271

# rectangle is positioned outside of the object's original bounding rectangle.

1272

# - If the left edge of the crop rectangle is on the right side of its right

1273

# edge, the object will be flipped horizontally.

1274

# - If the top edge of the crop rectangle is below its bottom edge, the object

1275

# will be flipped vertically.

1276

# - If all offsets and rotation angle is 0, the object is not cropped.

1277

#

1278

# After cropping, the content in the crop rectangle will be stretched to fit

1279

# its container.

1280

"leftOffset": 3.14, # The offset specifies the left edge of the crop rectangle that is located to

1281

# the right of the original bounding rectangle left edge, relative to the

1282

# object's original width.

Bu Sun Kim

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

[diff] [blame^]

1283

"bottomOffset": 3.14, # The offset specifies the bottom edge of the crop rectangle that is located

1284

# above the original bounding rectangle bottom edge, relative to the object's

1285

# original height.

Sai Cheemalapati

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

[diff] [blame]

1286

"angle": 3.14, # The rotation angle of the crop window around its center, in radians.

1287

# Rotation angle is applied after the offset.

Thomas Coffee

2017-03-27 10:39:26 -0700

[diff] [blame]

1288

"rightOffset": 3.14, # The offset specifies the right edge of the crop rectangle that is located

1289

# to the left of the original bounding rectangle right edge, relative to the

1290

# object's original width.

Sai Cheemalapati

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

[diff] [blame]

1291

"topOffset": 3.14, # The offset specifies the top edge of the crop rectangle that is located

1292

# below the original bounding rectangle top edge, relative to the object's

1293

# original height.

Jon Wayne Parrott

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

[diff] [blame]

1294

},

1295

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

1296

# is read-only.

1297

#

1298

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

1299

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

1300

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

1301

# the page element kind.

1302

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

1303

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

1304

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

1305

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

1306

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

1307

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

1308

},

1309

},

1310

"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,

1311

# relative to the alignment position.

1312

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

1313

# according to:

1314

#

1315

# x' x = shear_y scale_y translate_y

1316

# 1 [ 1 ]

1317

#

1318

# After transformation,

1319

#

1320

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

1321

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

1322

#

1323

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

1324

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

1325

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

1326

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

1327

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

1328

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

1329

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

1330

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

1331

},

1332

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

1333

#

Bu Sun Kim

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

[diff] [blame^]

1334

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

1335

# `RENDERED`, unless another value is specified in the same request. To have

1336

# no shadow on a page element, set this field to `NOT_RENDERED`. In this

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1337

# case, any other shadow fields set in the same request will be ignored.

1338

"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

1339

# shadow becomes.

1340

"magnitude": 3.14, # The magnitude.

1341

"unit": "A String", # The units for magnitude.

1342

},

1343

"alpha": 3.14, # The alpha of the shadow's color, from 0.0 to 1.0.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

1344

"type": "A String", # The type of the shadow. This property is read-only.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1345

"alignment": "A String", # The alignment point of the shadow, that sets the origin for translate,

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

1346

# scale and skew of the shadow. This property is read-only.

1347

"rotateWithShape": True or False, # Whether the shadow should rotate with the shape. This property is

1348

# read-only.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1349

},

1350

"contrast": 3.14, # The contrast effect of the image. The value should be in the interval

1351

# [-1.0, 1.0], where 0 means no effect. This property is read-only.

1352

},

1353

},

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

1354

"chartId": 42, # The ID of the specific chart in the Google Sheets spreadsheet that is

1355

# embedded.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1356

},

1357

"video": { # A PageElement kind representing a # A video page element.

1358

# video.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

1359

"url": "A String", # An URL to a video. The URL is valid as long as the source video exists and

1360

# sharing settings do not change.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1361

"videoProperties": { # The properties of the Video. # The properties of the video.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

1362

"start": 42, # The time at which to start playback, measured in seconds from the beginning

1363

# of the video.

1364

# If set, the start time should be before the end time.

1365

# If you set this to a value that exceeds the video's length in seconds, the

1366

# video will be played from the last second.

1367

# If not set, the video will be played from the beginning.

1368

"autoPlay": True or False, # Whether to enable video autoplay when the page is displayed in present

1369

# mode. Defaults to false.

1370

"end": 42, # The time at which to end playback, measured in seconds from the beginning

1371

# of the video.

1372

# If set, the end time should be after the start time.

1373

# If not set or if you set this to a value that exceeds the video's length,

1374

# the video will be played until its end.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1375

"outline": { # The outline of a PageElement. # The outline of the video. The default outline matches the defaults for new

1376

# videos created in the Slides editor.

1377

#

1378

# If these fields are unset, they may be inherited from a parent placeholder

1379

# if it exists. If there is no parent, the fields will default to the value

1380

# used for new page elements created in the Slides editor, which may depend on

1381

# the page element kind.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1382

"outlineFill": { # The fill of the outline. # The fill of the outline.

1383

"solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.

1384

# specified color value.

1385

#

1386

# If any field is unset, its value may be inherited from a parent placeholder

1387

# if it exists.

1388

"color": { # A themeable solid color value. # The color value of the solid fill.

1389

"themeColor": "A String", # An opaque theme color.

1390

"rgbColor": { # An RGB color. # An opaque RGB color.

1391

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

1392

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1393

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

1394

},

1395

},

1396

"alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.

1397

# That is, the final pixel color is defined by the equation:

1398

#

1399

# pixel color = alpha * (color) + (1.0 - alpha) * (background color)

1400

#

1401

# This means that a value of 1.0 corresponds to a solid color, whereas

1402

# a value of 0.0 corresponds to a completely transparent color.

1403

},

1404

},

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1405

"propertyState": "A String", # The outline property state.

1406

#

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

1407

# Updating the outline on a page element will implicitly update this field

1408

# to `RENDERED`, unless another value is specified in the same request. To

1409

# have no outline on a page element, set this field to `NOT_RENDERED`. In

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1410

# this case, any other outline fields set in the same request will be

1411

# ignored.

1412

"dashStyle": "A String", # The dash style of the outline.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1413

"weight": { # A magnitude in a single direction in the specified units. # The thickness of the outline.

1414

"magnitude": 3.14, # The magnitude.

1415

"unit": "A String", # The units for magnitude.

1416

},

1417

},

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

1418

"mute": True or False, # Whether to mute the audio during video playback. Defaults to false.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1419

},

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

1420

"id": "A String", # The video source's unique identifier for this video.

1421

"source": "A String", # The video source.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1422

},

1423

"table": { # A PageElement kind representing a # A table page element.

1424

# table.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

1425

"rows": 42, # Number of rows in the table.

1426

"horizontalBorderRows": [ # Properties of horizontal cell borders.

1427

#

1428

# A table's horizontal cell borders are represented as a grid. The grid has

1429

# one more row than the number of rows in the table and the same number of

1430

# columns as the table. For example, if the table is 3 x 3, its horizontal

1431

# borders will be represented as a grid with 4 rows and 3 columns.

1432

{ # Contents of each border row in a table.

1433

"tableBorderCells": [ # Properties of each border cell. When a border's adjacent table cells are

1434

# merged, it is not included in the response.

1435

{ # The properties of each border cell.

1436

"tableBorderProperties": { # The border styling properties of the # The border properties.

1437

# TableBorderCell.

1438

"tableBorderFill": { # The fill of the border. # The fill of the table border.

1439

"solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid fill.

1440

# specified color value.

1441

#

1442

# If any field is unset, its value may be inherited from a parent placeholder

1443

# if it exists.

1444

"color": { # A themeable solid color value. # The color value of the solid fill.

1445

"themeColor": "A String", # An opaque theme color.

1446

"rgbColor": { # An RGB color. # An opaque RGB color.

1447

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

1448

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1449

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

1450

},

1451

},

1452

"alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.

1453

# That is, the final pixel color is defined by the equation:

1454

#

1455

# pixel color = alpha * (color) + (1.0 - alpha) * (background color)

1456

#

1457

# This means that a value of 1.0 corresponds to a solid color, whereas

1458

# a value of 0.0 corresponds to a completely transparent color.

1459

},

1460

},

1461

"dashStyle": "A String", # The dash style of the border.

1462

"weight": { # A magnitude in a single direction in the specified units. # The thickness of the border.

1463

"magnitude": 3.14, # The magnitude.

1464

"unit": "A String", # The units for magnitude.

1465

},

1466

},

1467

"location": { # A location of a single table cell within a table. # The location of the border within the border table.

1468

"rowIndex": 42, # The 0-based row index.

1469

"columnIndex": 42, # The 0-based column index.

},

},

],

},

],

"verticalBorderRows": [ # Properties of vertical cell borders.

1476

#

1477

# A table's vertical cell borders are represented as a grid. The grid has the

1478

# same number of rows as the table and one more column than the number of

1479

# columns in the table. For example, if the table is 3 x 3, its vertical

1480

# borders will be represented as a grid with 3 rows and 4 columns.

1481

{ # Contents of each border row in a table.

1482

"tableBorderCells": [ # Properties of each border cell. When a border's adjacent table cells are

1483

# merged, it is not included in the response.

1484

{ # The properties of each border cell.

1485

"tableBorderProperties": { # The border styling properties of the # The border properties.

1486

# TableBorderCell.

1487

"tableBorderFill": { # The fill of the border. # The fill of the table border.

1488

"solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid fill.

1489

# specified color value.

1490

#

1491

# If any field is unset, its value may be inherited from a parent placeholder

1492

# if it exists.

1493

"color": { # A themeable solid color value. # The color value of the solid fill.

1494

"themeColor": "A String", # An opaque theme color.

1495

"rgbColor": { # An RGB color. # An opaque RGB color.

1496

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

1497

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1498

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

1499

},

1500

},

1501

"alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.

1502

# That is, the final pixel color is defined by the equation:

1503

#

1504

# pixel color = alpha * (color) + (1.0 - alpha) * (background color)

1505

#

1506

# This means that a value of 1.0 corresponds to a solid color, whereas

1507

# a value of 0.0 corresponds to a completely transparent color.

1508

},

1509

},

1510

"dashStyle": "A String", # The dash style of the border.

1511

"weight": { # A magnitude in a single direction in the specified units. # The thickness of the border.

1512

"magnitude": 3.14, # The magnitude.

1513

"unit": "A String", # The units for magnitude.

1514

},

1515

},

1516

"location": { # A location of a single table cell within a table. # The location of the border within the border table.

1517

"rowIndex": 42, # The 0-based row index.

1518

"columnIndex": 42, # The 0-based column index.

},

},

],

},

],

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1524

"tableColumns": [ # Properties of each column.

1525

{ # Properties of each column in a table.

1526

"columnWidth": { # A magnitude in a single direction in the specified units. # Width of a column.

1527

"magnitude": 3.14, # The magnitude.

1528

"unit": "A String", # The units for magnitude.

},

},

],

"tableRows": [ # Properties and contents of each row.

1533

#

1534

# Cells that span multiple rows are contained in only one of these rows and

1535

# have a row_span greater

1536

# than 1.

1537

{ # Properties and contents of each row in a table.

1538

"tableCells": [ # Properties and contents of each cell.

1539

#

1540

# Cells that span multiple columns are represented only once with a

1541

# column_span greater

1542

# than 1. As a result, the length of this collection does not always match

1543

# the number of columns of the entire table.

1544

{ # Properties and contents of each table cell.

1545

"text": { # The general text content. The text must reside in a compatible shape (e.g. # The text content of the cell.

1546

# text box or rectangle) or a table cell in a page.

1547

"textElements": [ # The text contents broken down into its component parts, including styling

1548

# information. This property is read-only.

1549

{ # A TextElement describes the content of a range of indices in the text content

1550

# of a Shape or TableCell.

1551

"autoText": { # A TextElement kind that represents auto text. # A TextElement representing a spot in the text that is dynamically

1552

# replaced with content that can change over time.

1553

"content": "A String", # The rendered content of this auto text, if available.

1554

"style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this auto text.

1555

#

1556

# If this text is contained in a shape with a parent placeholder, then these text styles may be

1557

# inherited from the parent. Which text styles are inherited depend on the

1558

# nesting level of lists:

1559

#

1560

# * A text run in a paragraph that is not in a list will inherit its text style

1561

# from the the newline character in the paragraph at the 0 nesting level of

1562

# the list inside the parent placeholder.

1563

# * A text run in a paragraph that is in a list will inherit its text style

1564

# from the newline character in the paragraph at its corresponding nesting

1565

# level of the list inside the parent placeholder.

1566

#

1567

# Inherited text styles are represented as unset fields in this message. If

1568

# text is contained in a shape without a parent placeholder, unsetting these

1569

# fields will revert the style to a value matching the defaults in the Slides

1570

# editor.

1571

"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

1572

# transparent, depending on if the `opaque_color` field in it is set.

1573

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

1574

# a transparent color.

1575

"themeColor": "A String", # An opaque theme color.

1576

"rgbColor": { # An RGB color. # An opaque RGB color.

1577

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

1578

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1579

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

1580

},

1581

},

1582

},

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

1583

"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

1584

# transparent, depending on if the `opaque_color` field in it is set.

1585

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

1586

# a transparent color.

1587

"themeColor": "A String", # An opaque theme color.

1588

"rgbColor": { # An RGB color. # An opaque RGB color.

1589

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

1590

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1591

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

1592

},

1593

},

1594

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1595

"baselineOffset": "A String", # The text's vertical offset from its normal position.

1596

#

1597

# Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically

1598

# rendered in a smaller font size, computed based on the `font_size` field.

1599

# The `font_size` itself is not affected by changes in this field.

1600

"strikethrough": True or False, # Whether or not the text is struck through.

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

1601

"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]

1602

#

1603

# This field is an extension of `font_family` meant to support explicit font

1604

# weights without breaking backwards compatibility. As such, when reading the

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

1605

# style of a range of text, the value of `weighted_font_family#font_family`

1606

# will always be equal to that of `font_family`. However, when writing, if

1607

# both fields are included in the field mask (either explicitly or through

1608

# the wildcard `"*"`), their values are reconciled as follows:

1609

#

1610

# * If `font_family` is set and `weighted_font_family` is not, the value of

1611

# `font_family` is applied with weight `400` ("normal").

1612

# * If both fields are set, the value of `font_family` must match that of

1613

# `weighted_font_family#font_family`. If so, the font family and weight of

1614

# `weighted_font_family` is applied. Otherwise, a 400 bad request error is

1615

# returned.

1616

# * If `weighted_font_family` is set and `font_family` is not, the font

1617

# family and weight of `weighted_font_family` is applied.

1618

# * If neither field is set, the font family and weight of the text inherit

1619

# from the parent. Note that these properties cannot inherit separately

1620

# from each other.

1621

#

1622

# If an update request specifies values for both `weighted_font_family` and

1623

# `bold`, the `weighted_font_family` is applied first, then `bold`.

1624

#

1625

# If `weighted_font_family#weight` is not set, it defaults to `400`.

1626

#

1627

# If `weighted_font_family` is set, then `weighted_font_family#font_family`

1628

# must also be set with a non-empty value. Otherwise, a 400 bad request error

1629

# is returned.

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

1630

"fontFamily": "A String", # The font family of the text.

1631

#

1632

# The font family can be any font from the Font menu in Slides or from

1633

# [Google Fonts] (https://fonts.google.com/). If the font name is

1634

# unrecognized, the text is rendered in `Arial`.

1635

"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]

1636

# multiple of `100` between `100` and `900`, inclusive. This range

1637

# corresponds to the numerical values described in the CSS 2.1

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

1638

# Specification,

1639

# [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness),

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

1640

# with non-numerical values disallowed. Weights greater than or equal to

1641

# `700` are considered bold, and weights less than `700`are not bold. The

1642

# default value is `400` ("normal").

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

1643

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1644

"smallCaps": True or False, # Whether or not the text is in small capital letters.

1645

"fontFamily": "A String", # The font family of the text.

1646

#

1647

# The font family can be any font from the Font menu in Slides or from

1648

# [Google Fonts] (https://fonts.google.com/). If the font name is

1649

# unrecognized, the text is rendered in `Arial`.

1650

#

1651

# Some fonts can affect the weight of the text. If an update request

1652

# specifies values for both `font_family` and `bold`, the explicitly-set

1653

# `bold` value is used.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

1654

"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

1655

# points.

1656

"magnitude": 3.14, # The magnitude.

1657

"unit": "A String", # The units for magnitude.

1658

},

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1659

"italic": True or False, # Whether or not the text is italicized.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1660

"link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links

1661

# are not inherited from parent text.

1662

#

1663

# Changing the link in an update request causes some other changes to the

1664

# text style of the range:

1665

#

1666

# * When setting a link, the text foreground color will be set to

1667

# ThemeColorType.HYPERLINK and the text will

1668

# be underlined. If these fields are modified in the same

1669

# request, those values will be used instead of the link defaults.

1670

# * Setting a link on a text range that overlaps with an existing link will

1671

# also update the existing link to point to the new URL.

1672

# * Links are not settable on newline characters. As a result, setting a link

1673

# on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,

1674

# will separate the newline character(s) into their own text runs. The

1675

# link will be applied separately to the runs before and after the newline.

1676

# * Removing a link will update the text style of the range to match the

1677

# style of the preceding text (or the default text styles if the preceding

1678

# text is another link) unless different styles are being set in the same

1679

# request.

1680

"url": "A String", # If set, indicates this is a link to the external web page at this URL.

Thomas Coffee

2017-03-27 10:39:26 -0700

[diff] [blame]

1681

"slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index

1682

# in the presentation. There may not be a slide at this index.

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

1683

"pageObjectId": "A String", # If set, indicates this is a link to the specific page in this

1684

# presentation with this ID. A page with this ID may not exist.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1685

"relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,

1686

# addressed by its position.

1687

},

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

1688

"underline": True or False, # Whether or not the text is underlined.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

1689

"bold": True or False, # Whether or not the text is rendered as bold.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1690

},

1691

"type": "A String", # The type of this auto text.

1692

},

1693

"endIndex": 42, # The zero-based end index of this text element, exclusive, in Unicode code

1694

# units.

1695

"startIndex": 42, # The zero-based start index of this text element, in Unicode code units.

1696

"paragraphMarker": { # A TextElement kind that represents the beginning of a new paragraph. # A marker representing the beginning of a new paragraph.

1697

#

1698

# The `start_index` and `end_index` of this TextElement represent the

1699

# range of the paragraph. Other TextElements with an index range contained

1700

# inside this paragraph's range are considered to be part of this

1701

# paragraph. The range of indices of two separate paragraphs will never

1702

# overlap.

1703

"style": { # Styles that apply to a whole paragraph. # The paragraph's style

1704

#

1705

# If this text is contained in a shape with a parent placeholder, then these paragraph styles may be

1706

# inherited from the parent. Which paragraph styles are inherited depend on the

1707

# nesting level of lists:

1708

#

1709

# * A paragraph not in a list will inherit its paragraph style from the

1710

# paragraph at the 0 nesting level of the list inside the parent placeholder.

1711

# * A paragraph in a list will inherit its paragraph style from the paragraph

1712

# at its corresponding nesting level of the list inside the parent

1713

# placeholder.

1714

#

1715

# Inherited paragraph styles are represented as unset fields in this message.

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1716

"spacingMode": "A String", # The spacing mode for the paragraph.

1717

"direction": "A String", # The text direction of this paragraph. If unset, the value defaults to

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

1718

# LEFT_TO_RIGHT since

1719

# text direction is not inherited.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

1720

"spaceBelow": { # A magnitude in a single direction in the specified units. # The amount of extra space below the paragraph. If unset, the value is

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1721

# inherited from the parent.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1722

"magnitude": 3.14, # The magnitude.

1723

"unit": "A String", # The units for magnitude.

1724

},

1725

"lineSpacing": 3.14, # The amount of space between lines, as a percentage of normal, where normal

1726

# is represented as 100.0. If unset, the value is inherited from the parent.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1727

"indentStart": { # A magnitude in a single direction in the specified units. # The amount indentation for the paragraph on the side that corresponds to

1728

# the start of the text, based on the current text direction. If unset, the

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1729

# value is inherited from the parent.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1730

"magnitude": 3.14, # The magnitude.

1731

"unit": "A String", # The units for magnitude.

1732

},

1733

"spaceAbove": { # A magnitude in a single direction in the specified units. # The amount of extra space above the paragraph. If unset, the value is

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1734

# inherited from the parent.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1735

"magnitude": 3.14, # The magnitude.

1736

"unit": "A String", # The units for magnitude.

1737

},

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

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1740

# value is inherited from the parent.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1741

"magnitude": 3.14, # The magnitude.

1742

"unit": "A String", # The units for magnitude.

1743

},

1744

"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.

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1745

# If unset, the value is inherited from the parent.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1746

"magnitude": 3.14, # The magnitude.

1747

"unit": "A String", # The units for magnitude.

1748

},

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1749

"alignment": "A String", # The text alignment for this paragraph.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1750

},

1751

"bullet": { # Describes the bullet of a paragraph. # The bullet for this paragraph. If not present, the paragraph does not

1752

# belong to a list.

1753

"nestingLevel": 42, # The nesting level of this paragraph in the list.

1754

"listId": "A String", # The ID of the list this paragraph belongs to.

1755

"bulletStyle": { # Represents the styling that can be applied to a TextRun. # The paragraph specific text style applied to this bullet.

1756

#

1757

# If this text is contained in a shape with a parent placeholder, then these text styles may be

1758

# inherited from the parent. Which text styles are inherited depend on the

1759

# nesting level of lists:

1760

#

1761

# * A text run in a paragraph that is not in a list will inherit its text style

1762

# from the the newline character in the paragraph at the 0 nesting level of

1763

# the list inside the parent placeholder.

1764

# * A text run in a paragraph that is in a list will inherit its text style

1765

# from the newline character in the paragraph at its corresponding nesting

1766

# level of the list inside the parent placeholder.

1767

#

1768

# Inherited text styles are represented as unset fields in this message. If

1769

# text is contained in a shape without a parent placeholder, unsetting these

1770

# fields will revert the style to a value matching the defaults in the Slides

1771

# editor.

1772

"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

1773

# transparent, depending on if the `opaque_color` field in it is set.

1774

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

1775

# a transparent color.

1776

"themeColor": "A String", # An opaque theme color.

1777

"rgbColor": { # An RGB color. # An opaque RGB color.

1778

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

1779

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1780

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

1781

},

1782

},

1783

},

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

1784

"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

1785

# transparent, depending on if the `opaque_color` field in it is set.

1786

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

1787

# a transparent color.

1788

"themeColor": "A String", # An opaque theme color.

1789

"rgbColor": { # An RGB color. # An opaque RGB color.

1790

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

1791

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1792

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

1793

},

1794

},

1795

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1796

"baselineOffset": "A String", # The text's vertical offset from its normal position.

1797

#

1798

# Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically

1799

# rendered in a smaller font size, computed based on the `font_size` field.

1800

# The `font_size` itself is not affected by changes in this field.

1801

"strikethrough": True or False, # Whether or not the text is struck through.

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

1802

"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]

1803

#

1804

# This field is an extension of `font_family` meant to support explicit font

1805

# weights without breaking backwards compatibility. As such, when reading the

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

1806

# style of a range of text, the value of `weighted_font_family#font_family`

1807

# will always be equal to that of `font_family`. However, when writing, if

1808

# both fields are included in the field mask (either explicitly or through

1809

# the wildcard `"*"`), their values are reconciled as follows:

1810

#

1811

# * If `font_family` is set and `weighted_font_family` is not, the value of

1812

# `font_family` is applied with weight `400` ("normal").

1813

# * If both fields are set, the value of `font_family` must match that of

1814

# `weighted_font_family#font_family`. If so, the font family and weight of

1815

# `weighted_font_family` is applied. Otherwise, a 400 bad request error is

1816

# returned.

1817

# * If `weighted_font_family` is set and `font_family` is not, the font

1818

# family and weight of `weighted_font_family` is applied.

1819

# * If neither field is set, the font family and weight of the text inherit

1820

# from the parent. Note that these properties cannot inherit separately

1821

# from each other.

1822

#

1823

# If an update request specifies values for both `weighted_font_family` and

1824

# `bold`, the `weighted_font_family` is applied first, then `bold`.

1825

#

1826

# If `weighted_font_family#weight` is not set, it defaults to `400`.

1827

#

1828

# If `weighted_font_family` is set, then `weighted_font_family#font_family`

1829

# must also be set with a non-empty value. Otherwise, a 400 bad request error

1830

# is returned.

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

1831

"fontFamily": "A String", # The font family of the text.

1832

#

1833

# The font family can be any font from the Font menu in Slides or from

1834

# [Google Fonts] (https://fonts.google.com/). If the font name is

1835

# unrecognized, the text is rendered in `Arial`.

1836

"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]

1837

# multiple of `100` between `100` and `900`, inclusive. This range

1838

# corresponds to the numerical values described in the CSS 2.1

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

1839

# Specification,

1840

# [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness),

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

1841

# with non-numerical values disallowed. Weights greater than or equal to

1842

# `700` are considered bold, and weights less than `700`are not bold. The

1843

# default value is `400` ("normal").

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

1844

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1845

"smallCaps": True or False, # Whether or not the text is in small capital letters.

1846

"fontFamily": "A String", # The font family of the text.

1847

#

1848

# The font family can be any font from the Font menu in Slides or from

1849

# [Google Fonts] (https://fonts.google.com/). If the font name is

1850

# unrecognized, the text is rendered in `Arial`.

1851

#

1852

# Some fonts can affect the weight of the text. If an update request

1853

# specifies values for both `font_family` and `bold`, the explicitly-set

1854

# `bold` value is used.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

1855

"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

1856

# points.

1857

"magnitude": 3.14, # The magnitude.

1858

"unit": "A String", # The units for magnitude.

1859

},

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

1860

"italic": True or False, # Whether or not the text is italicized.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1861

"link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links

1862

# are not inherited from parent text.

1863

#

1864

# Changing the link in an update request causes some other changes to the

1865

# text style of the range:

1866

#

1867

# * When setting a link, the text foreground color will be set to

1868

# ThemeColorType.HYPERLINK and the text will

1869

# be underlined. If these fields are modified in the same

1870

# request, those values will be used instead of the link defaults.

1871

# * Setting a link on a text range that overlaps with an existing link will

1872

# also update the existing link to point to the new URL.

1873

# * Links are not settable on newline characters. As a result, setting a link

1874

# on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,

1875

# will separate the newline character(s) into their own text runs. The

1876

# link will be applied separately to the runs before and after the newline.

1877

# * Removing a link will update the text style of the range to match the

1878

# style of the preceding text (or the default text styles if the preceding

1879

# text is another link) unless different styles are being set in the same

1880

# request.

1881

"url": "A String", # If set, indicates this is a link to the external web page at this URL.

Thomas Coffee

2017-03-27 10:39:26 -0700

[diff] [blame]

1882

"slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index

1883

# in the presentation. There may not be a slide at this index.

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

1884

"pageObjectId": "A String", # If set, indicates this is a link to the specific page in this

1885

# presentation with this ID. A page with this ID may not exist.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1886

"relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,

1887

# addressed by its position.

1888

},

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

1889

"underline": True or False, # Whether or not the text is underlined.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

1890

"bold": True or False, # Whether or not the text is rendered as bold.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1891

},

1892

"glyph": "A String", # The rendered bullet glyph for this paragraph.

1893

},

1894

},

1895

"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

1896

# in the run have the same TextStyle.

1897

#

1898

# The `start_index` and `end_index` of TextRuns will always be fully

1899

# contained in the index range of a single `paragraph_marker` TextElement.

1900

# In other words, a TextRun will never span multiple paragraphs.

1901

# styling.

1902

"content": "A String", # The text of this run.

1903

"style": { # Represents the styling that can be applied to a TextRun. # The styling applied to this run.

1904

#

1905

# If this text is contained in a shape with a parent placeholder, then these text styles may be

1906

# inherited from the parent. Which text styles are inherited depend on the

1907

# nesting level of lists:

1908

#

1909

# * A text run in a paragraph that is not in a list will inherit its text style

1910

# from the the newline character in the paragraph at the 0 nesting level of

1911

# the list inside the parent placeholder.

1912

# * A text run in a paragraph that is in a list will inherit its text style

1913

# from the newline character in the paragraph at its corresponding nesting

1914

# level of the list inside the parent placeholder.

1915

#

1916

# Inherited text styles are represented as unset fields in this message. If

1917

# text is contained in a shape without a parent placeholder, unsetting these

1918

# fields will revert the style to a value matching the defaults in the Slides

1919

# editor.

1920

"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

1921

# transparent, depending on if the `opaque_color` field in it is set.

1922

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

1923

# a transparent color.

1924

"themeColor": "A String", # An opaque theme color.

1925

"rgbColor": { # An RGB color. # An opaque RGB color.

1926

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

1927

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1928

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

1929

},

1930

},

1931

},

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

1932

"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

1933

# transparent, depending on if the `opaque_color` field in it is set.

1934

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

1935

# a transparent color.

1936

"themeColor": "A String", # An opaque theme color.

1937

"rgbColor": { # An RGB color. # An opaque RGB color.

1938

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

1939

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

1940

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

1941

},

1942

},

1943

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1944

"baselineOffset": "A String", # The text's vertical offset from its normal position.

1945

#

1946

# Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically

1947

# rendered in a smaller font size, computed based on the `font_size` field.

1948

# The `font_size` itself is not affected by changes in this field.

1949

"strikethrough": True or False, # Whether or not the text is struck through.

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

1950

"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]

1951

#

1952

# This field is an extension of `font_family` meant to support explicit font

1953

# weights without breaking backwards compatibility. As such, when reading the

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

1954

# style of a range of text, the value of `weighted_font_family#font_family`

1955

# will always be equal to that of `font_family`. However, when writing, if

1956

# both fields are included in the field mask (either explicitly or through

1957

# the wildcard `"*"`), their values are reconciled as follows:

1958

#

1959

# * If `font_family` is set and `weighted_font_family` is not, the value of

1960

# `font_family` is applied with weight `400` ("normal").

1961

# * If both fields are set, the value of `font_family` must match that of

1962

# `weighted_font_family#font_family`. If so, the font family and weight of

1963

# `weighted_font_family` is applied. Otherwise, a 400 bad request error is

1964

# returned.

1965

# * If `weighted_font_family` is set and `font_family` is not, the font

1966

# family and weight of `weighted_font_family` is applied.

1967

# * If neither field is set, the font family and weight of the text inherit

1968

# from the parent. Note that these properties cannot inherit separately

1969

# from each other.

1970

#

1971

# If an update request specifies values for both `weighted_font_family` and

1972

# `bold`, the `weighted_font_family` is applied first, then `bold`.

1973

#

1974

# If `weighted_font_family#weight` is not set, it defaults to `400`.

1975

#

1976

# If `weighted_font_family` is set, then `weighted_font_family#font_family`

1977

# must also be set with a non-empty value. Otherwise, a 400 bad request error

1978

# is returned.

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

1979

"fontFamily": "A String", # The font family of the text.

1980

#

1981

# The font family can be any font from the Font menu in Slides or from

1982

# [Google Fonts] (https://fonts.google.com/). If the font name is

1983

# unrecognized, the text is rendered in `Arial`.

1984

"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]

1985

# multiple of `100` between `100` and `900`, inclusive. This range

1986

# corresponds to the numerical values described in the CSS 2.1

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

1987

# Specification,

1988

# [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness),

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

1989

# with non-numerical values disallowed. Weights greater than or equal to

1990

# `700` are considered bold, and weights less than `700`are not bold. The

1991

# default value is `400` ("normal").

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

1992

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

1993

"smallCaps": True or False, # Whether or not the text is in small capital letters.

1994

"fontFamily": "A String", # The font family of the text.

1995

#

1996

# The font family can be any font from the Font menu in Slides or from

1997

# [Google Fonts] (https://fonts.google.com/). If the font name is

1998

# unrecognized, the text is rendered in `Arial`.

1999

#

2000

# Some fonts can affect the weight of the text. If an update request

2001

# specifies values for both `font_family` and `bold`, the explicitly-set

2002

# `bold` value is used.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

2003

"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

2004

# points.

2005

"magnitude": 3.14, # The magnitude.

2006

"unit": "A String", # The units for magnitude.

2007

},

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

2008

"italic": True or False, # Whether or not the text is italicized.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2009

"link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links

2010

# are not inherited from parent text.

2011

#

2012

# Changing the link in an update request causes some other changes to the

2013

# text style of the range:

2014

#

2015

# * When setting a link, the text foreground color will be set to

2016

# ThemeColorType.HYPERLINK and the text will

2017

# be underlined. If these fields are modified in the same

2018

# request, those values will be used instead of the link defaults.

2019

# * Setting a link on a text range that overlaps with an existing link will

2020

# also update the existing link to point to the new URL.

2021

# * Links are not settable on newline characters. As a result, setting a link

2022

# on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,

2023

# will separate the newline character(s) into their own text runs. The

2024

# link will be applied separately to the runs before and after the newline.

2025

# * Removing a link will update the text style of the range to match the

2026

# style of the preceding text (or the default text styles if the preceding

2027

# text is another link) unless different styles are being set in the same

2028

# request.

2029

"url": "A String", # If set, indicates this is a link to the external web page at this URL.

Thomas Coffee

2017-03-27 10:39:26 -0700

[diff] [blame]

2030

"slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index

2031

# in the presentation. There may not be a slide at this index.

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

2032

"pageObjectId": "A String", # If set, indicates this is a link to the specific page in this

2033

# presentation with this ID. A page with this ID may not exist.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2034

"relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,

2035

# addressed by its position.

2036

},

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

2037

"underline": True or False, # Whether or not the text is underlined.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

2038

"bold": True or False, # Whether or not the text is rendered as bold.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

},

},

},

],

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

2043

"lists": { # The bulleted lists contained in this text, keyed by list ID.

2044

"a_key": { # A List describes the look and feel of bullets belonging to paragraphs

2045

# associated with a list. A paragraph that is part of a list has an implicit

2046

# reference to that list's ID.

2047

"nestingLevel": { # A map of nesting levels to the properties of bullets at the associated

2048

# level. A list has at most nine levels of nesting, so the possible values

2049

# for the keys of this map are 0 through 8, inclusive.

2050

"a_key": { # Contains properties describing the look and feel of a list bullet at a given

2051

# level of nesting.

2052

"bulletStyle": { # Represents the styling that can be applied to a TextRun. # The style of a bullet at this level of nesting.

2053

#

2054

# If this text is contained in a shape with a parent placeholder, then these text styles may be

2055

# inherited from the parent. Which text styles are inherited depend on the

2056

# nesting level of lists:

2057

#

2058

# * A text run in a paragraph that is not in a list will inherit its text style

2059

# from the the newline character in the paragraph at the 0 nesting level of

2060

# the list inside the parent placeholder.

2061

# * A text run in a paragraph that is in a list will inherit its text style

2062

# from the newline character in the paragraph at its corresponding nesting

2063

# level of the list inside the parent placeholder.

2064

#

2065

# Inherited text styles are represented as unset fields in this message. If

2066

# text is contained in a shape without a parent placeholder, unsetting these

2067

# fields will revert the style to a value matching the defaults in the Slides

2068

# editor.

2069

"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

2070

# transparent, depending on if the `opaque_color` field in it is set.

2071

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

2072

# a transparent color.

2073

"themeColor": "A String", # An opaque theme color.

2074

"rgbColor": { # An RGB color. # An opaque RGB color.

2075

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

2076

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

2077

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

},

},

},

"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

2082

# transparent, depending on if the `opaque_color` field in it is set.

2083

"opaqueColor": { # A themeable solid color value. # If set, this will be used as an opaque color. If unset, this represents

2084

# a transparent color.

2085

"themeColor": "A String", # An opaque theme color.

2086

"rgbColor": { # An RGB color. # An opaque RGB color.

2087

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

2088

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

2089

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

},

},

},

"baselineOffset": "A String", # The text's vertical offset from its normal position.

2094

#

2095

# Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically

2096

# rendered in a smaller font size, computed based on the `font_size` field.

2097

# The `font_size` itself is not affected by changes in this field.

2098

"strikethrough": True or False, # Whether or not the text is struck through.

2099

"weightedFontFamily": { # Represents a font family and weight used to style a TextRun. # The font family and rendered weight of the text.

2100

#

2101

# This field is an extension of `font_family` meant to support explicit font

2102

# weights without breaking backwards compatibility. As such, when reading the

2103

# style of a range of text, the value of `weighted_font_family#font_family`

2104

# will always be equal to that of `font_family`. However, when writing, if

2105

# both fields are included in the field mask (either explicitly or through

2106

# the wildcard `"*"`), their values are reconciled as follows:

2107

#

2108

# * If `font_family` is set and `weighted_font_family` is not, the value of

2109

# `font_family` is applied with weight `400` ("normal").

2110

# * If both fields are set, the value of `font_family` must match that of

2111

# `weighted_font_family#font_family`. If so, the font family and weight of

2112

# `weighted_font_family` is applied. Otherwise, a 400 bad request error is

2113

# returned.

2114

# * If `weighted_font_family` is set and `font_family` is not, the font

2115

# family and weight of `weighted_font_family` is applied.

2116

# * If neither field is set, the font family and weight of the text inherit

2117

# from the parent. Note that these properties cannot inherit separately

2118

# from each other.

2119

#

2120

# If an update request specifies values for both `weighted_font_family` and

2121

# `bold`, the `weighted_font_family` is applied first, then `bold`.

2122

#

2123

# If `weighted_font_family#weight` is not set, it defaults to `400`.

2124

#

2125

# If `weighted_font_family` is set, then `weighted_font_family#font_family`

2126

# must also be set with a non-empty value. Otherwise, a 400 bad request error

2127

# is returned.

2128

"fontFamily": "A String", # The font family of the text.

2129

#

2130

# The font family can be any font from the Font menu in Slides or from

2131

# [Google Fonts] (https://fonts.google.com/). If the font name is

2132

# unrecognized, the text is rendered in `Arial`.

2133

"weight": 42, # The rendered weight of the text. This field can have any value that is a

2134

# multiple of `100` between `100` and `900`, inclusive. This range

2135

# corresponds to the numerical values described in the CSS 2.1

2136

# Specification,

2137

# [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness),

2138

# with non-numerical values disallowed. Weights greater than or equal to

2139

# `700` are considered bold, and weights less than `700`are not bold. The

2140

# default value is `400` ("normal").

2141

},

2142

"smallCaps": True or False, # Whether or not the text is in small capital letters.

2143

"fontFamily": "A String", # The font family of the text.

2144

#

2145

# The font family can be any font from the Font menu in Slides or from

2146

# [Google Fonts] (https://fonts.google.com/). If the font name is

2147

# unrecognized, the text is rendered in `Arial`.

2148

#

2149

# Some fonts can affect the weight of the text. If an update request

2150

# specifies values for both `font_family` and `bold`, the explicitly-set

2151

# `bold` value is used.

2152

"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

2153

# points.

2154

"magnitude": 3.14, # The magnitude.

2155

"unit": "A String", # The units for magnitude.

2156

},

2157

"italic": True or False, # Whether or not the text is italicized.

2158

"link": { # A hypertext link. # The hyperlink destination of the text. If unset, there is no link. Links

2159

# are not inherited from parent text.

2160

#

2161

# Changing the link in an update request causes some other changes to the

2162

# text style of the range:

2163

#

2164

# * When setting a link, the text foreground color will be set to

2165

# ThemeColorType.HYPERLINK and the text will

2166

# be underlined. If these fields are modified in the same

2167

# request, those values will be used instead of the link defaults.

2168

# * Setting a link on a text range that overlaps with an existing link will

2169

# also update the existing link to point to the new URL.

2170

# * Links are not settable on newline characters. As a result, setting a link

2171

# on a text range that crosses a paragraph boundary, such as `"ABC\n123"`,

2172

# will separate the newline character(s) into their own text runs. The

2173

# link will be applied separately to the runs before and after the newline.

2174

# * Removing a link will update the text style of the range to match the

2175

# style of the preceding text (or the default text styles if the preceding

2176

# text is another link) unless different styles are being set in the same

2177

# request.

2178

"url": "A String", # If set, indicates this is a link to the external web page at this URL.

2179

"slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index

2180

# in the presentation. There may not be a slide at this index.

2181

"pageObjectId": "A String", # If set, indicates this is a link to the specific page in this

2182

# presentation with this ID. A page with this ID may not exist.

2183

"relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,

2184

# addressed by its position.

2185

},

2186

"underline": True or False, # Whether or not the text is underlined.

2187

"bold": True or False, # Whether or not the text is rendered as bold.

},

},

},

"listId": "A String", # The ID of the list.

2192

},

2193

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2194

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2195

"tableCellProperties": { # The properties of the TableCell. # The properties of the table cell.

2196

"tableCellBackgroundFill": { # The table cell background fill. # The background fill of the table cell. The default fill matches the fill

2197

# for newly created table cells in the Slides editor.

2198

"solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.

2199

# specified color value.

2200

#

2201

# If any field is unset, its value may be inherited from a parent placeholder

2202

# if it exists.

2203

"color": { # A themeable solid color value. # The color value of the solid fill.

2204

"themeColor": "A String", # An opaque theme color.

2205

"rgbColor": { # An RGB color. # An opaque RGB color.

2206

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

2207

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

2208

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

2209

},

2210

},

2211

"alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.

2212

# That is, the final pixel color is defined by the equation:

2213

#

2214

# pixel color = alpha * (color) + (1.0 - alpha) * (background color)

2215

#

2216

# This means that a value of 1.0 corresponds to a solid color, whereas

2217

# a value of 0.0 corresponds to a completely transparent color.

2218

},

2219

"propertyState": "A String", # The background fill property state.

2220

#

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

2221

# Updating the fill on a table cell will implicitly update this field

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2222

# to `RENDERED`, unless another value is specified in the same request. To

2223

# have no fill on a table cell, set this field to `NOT_RENDERED`. In this

2224

# case, any other fill fields set in the same request will be ignored.

2225

},

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

2226

"contentAlignment": "A String", # The alignment of the content in the table cell. The default alignment

2227

# matches the alignment for newly created table cells in the Slides editor.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2228

},

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

2229

"rowSpan": 42, # Row span of the cell.

2230

"columnSpan": 42, # Column span of the cell.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2231

"location": { # A location of a single table cell within a table. # The location of the cell within the table.

2232

"rowIndex": 42, # The 0-based row index.

2233

"columnIndex": 42, # The 0-based column index.

2234

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2235

},

2236

],

2237

"rowHeight": { # A magnitude in a single direction in the specified units. # Height of a row.

2238

"magnitude": 3.14, # The magnitude.

2239

"unit": "A String", # The units for magnitude.

2240

},

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

2241

"tableRowProperties": { # Properties of each row in a table. # Properties of the row.

2242

"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

2243

# a height equal to or greater than this value in order to show all the text

2244

# in the row's cell(s).

2245

"magnitude": 3.14, # The magnitude.

2246

"unit": "A String", # The units for magnitude.

2247

},

2248

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2249

},

2250

],

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2251

"columns": 42, # Number of columns in the table.

2252

},

2253

"line": { # A PageElement kind representing a # A line page element.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

2254

# non-connector line, straight connector, curved connector, or bent connector.

2255

"lineCategory": "A String", # The category of the line.

2256

#

2257

# It matches the `category` specified in CreateLineRequest, and can be updated with

2258

# UpdateLineCategoryRequest.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2259

"lineProperties": { # The properties of the Line. # The properties of the line.

2260

#

2261

# When unset, these fields default to values that match the appearance of

2262

# new lines created in the Slides editor.

2263

"dashStyle": "A String", # The dash style of the line.

2264

"weight": { # A magnitude in a single direction in the specified units. # The thickness of the line.

2265

"magnitude": 3.14, # The magnitude.

2266

"unit": "A String", # The units for magnitude.

2267

},

2268

"endArrow": "A String", # The style of the arrow at the end of the line.

2269

"link": { # A hypertext link. # The hyperlink destination of the line. If unset, there is no link.

2270

"url": "A String", # If set, indicates this is a link to the external web page at this URL.

Thomas Coffee

2017-03-27 10:39:26 -0700

[diff] [blame]

2271

"slideIndex": 42, # If set, indicates this is a link to the slide at this zero-based index

2272

# in the presentation. There may not be a slide at this index.

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

2273

"pageObjectId": "A String", # If set, indicates this is a link to the specific page in this

2274

# presentation with this ID. A page with this ID may not exist.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2275

"relativeLink": "A String", # If set, indicates this is a link to a slide in this presentation,

2276

# addressed by its position.

2277

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2278

"lineFill": { # The fill of the line. # The fill of the line. The default line fill matches the defaults for new

2279

# lines created in the Slides editor.

2280

"solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.

2281

# specified color value.

2282

#

2283

# If any field is unset, its value may be inherited from a parent placeholder

2284

# if it exists.

2285

"color": { # A themeable solid color value. # The color value of the solid fill.

2286

"themeColor": "A String", # An opaque theme color.

2287

"rgbColor": { # An RGB color. # An opaque RGB color.

2288

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

2289

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

2290

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

2291

},

2292

},

2293

"alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.

2294

# That is, the final pixel color is defined by the equation:

2295

#

2296

# pixel color = alpha * (color) + (1.0 - alpha) * (background color)

2297

#

2298

# This means that a value of 1.0 corresponds to a solid color, whereas

2299

# a value of 0.0 corresponds to a completely transparent color.

2300

},

2301

},

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

2302

"startConnection": { # The properties for one end of a Line # The connection at the beginning of the line. If unset, there is no

2303

# connection.

2304

#

2305

# Only lines with a Type indicating it is

2306

# a "connector" can have a `start_connection`.

2307

# connection.

2308

"connectionSiteIndex": 42, # The index of the connection site on the connected page element.

2309

#

2310

# In most cases, it corresponds to the predefined connection site index from

2311

# the ECMA-376 standard. More information on those connection sites can be

2312

# found in the description of the "cnx" attribute in section 20.1.9.9 and

2313

# Annex H. "Predefined DrawingML Shape and Text Geometries" of "Office Open

2314

# XML File Formats-Fundamentals and Markup Language Reference", part 1 of

2315

# [ECMA-376 5th edition]

2316

# (http://www.ecma-international.org/publications/standards/Ecma-376.htm).

2317

#

2318

# The position of each connection site can also be viewed from Slides editor.

2319

"connectedObjectId": "A String", # The object ID of the connected page element.

2320

#

2321

# Some page elements, such as groups, tables, and lines

2322

# do not have connection sites and therefore cannot be connected to a

2323

# connector line.

2324

},

2325

"endConnection": { # The properties for one end of a Line # The connection at the end of the line. If unset, there is no connection.

2326

#

2327

# Only lines with a Type indicating it is

2328

# a "connector" can have an `end_connection`.

2329

# connection.

2330

"connectionSiteIndex": 42, # The index of the connection site on the connected page element.

2331

#

2332

# In most cases, it corresponds to the predefined connection site index from

2333

# the ECMA-376 standard. More information on those connection sites can be

2334

# found in the description of the "cnx" attribute in section 20.1.9.9 and

2335

# Annex H. "Predefined DrawingML Shape and Text Geometries" of "Office Open

2336

# XML File Formats-Fundamentals and Markup Language Reference", part 1 of

2337

# [ECMA-376 5th edition]

2338

# (http://www.ecma-international.org/publications/standards/Ecma-376.htm).

2339

#

2340

# The position of each connection site can also be viewed from Slides editor.

2341

"connectedObjectId": "A String", # The object ID of the connected page element.

2342

#

2343

# Some page elements, such as groups, tables, and lines

2344

# do not have connection sites and therefore cannot be connected to a

2345

# connector line.

2346

},

Sai Cheemalapati

2017-03-24 15:06:46 -0700

[diff] [blame]

2347

"startArrow": "A String", # The style of the arrow at the beginning of the line.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2348

},

2349

"lineType": "A String", # The type of the line.

2350

},

2351

"size": { # A width and height. # The size of the page element.

2352

"width": { # A magnitude in a single direction in the specified units. # The width of the object.

2353

"magnitude": 3.14, # The magnitude.

2354

"unit": "A String", # The units for magnitude.

2355

},

2356

"height": { # A magnitude in a single direction in the specified units. # The height of the object.

2357

"magnitude": 3.14, # The magnitude.

2358

"unit": "A String", # The units for magnitude.

2359

},

2360

},

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

2361

"description": "A String", # The description of the page element. Combined with title to display alt

2362

# text.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2363

},

2364

],

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

2365

"notesProperties": { # The properties of Page that are only # Notes specific properties. Only set if page_type = NOTES.

2366

# relevant for pages with page_type NOTES.

2367

"speakerNotesObjectId": "A String", # The object ID of the shape on this notes page that contains the speaker

2368

# notes for the corresponding slide.

2369

# The actual shape may not always exist on the notes page. Inserting text

2370

# using this object ID will automatically create the shape. In this case, the

2371

# actual shape may have different object ID. The `GetPresentation` or

2372

# `GetPage` action will always return the latest object ID.

2373

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2374

"objectId": "A String", # The object ID for this page. Object IDs used by

2375

# Page and

2376

# PageElement share the same namespace.

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

2377

"revisionId": "A String", # The revision ID of the presentation containing this page. Can be used in

2378

# update requests to assert that the presentation revision hasn't changed

2379

# since the last read operation. Only populated if the user has edit access

2380

# to the presentation.

2381

#

2382

# The format of the revision ID may change over time, so it should be treated

2383

# opaquely. A returned revision ID is only guaranteed to be valid for 24

Sai Cheemalapati

2017-06-06 18:46:08 -0400

[diff] [blame]

2384

# hours after it has been returned and cannot be shared across users. If the

2385

# revision ID is unchanged between calls, then the presentation has not

2386

# changed. Conversely, a changed ID (for the same presentation and user)

2387

# usually means the presentation has been updated; however, a changed ID can

2388

# also be due to internal factors such as ID format changes.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

2389

"masterProperties": { # The properties of Page that are only # Master specific properties. Only set if page_type = MASTER.

2390

# relevant for pages with page_type MASTER.

2391

"displayName": "A String", # The human-readable name of the master.

2392

},

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2393

"pageProperties": { # The properties of the Page. # The properties of the page.

2394

#

2395

# The page will inherit properties from the parent page. Depending on the page

2396

# type the hierarchy is defined in either

2397

# SlideProperties or

2398

# LayoutProperties.

2399

"pageBackgroundFill": { # The page background fill. # The background fill of the page. If unset, the background fill is inherited

2400

# from a parent page if it exists. If the page has no parent, then the

2401

# background fill defaults to the corresponding fill in the Slides editor.

2402

"solidFill": { # A solid color fill. The page or page element is filled entirely with the # Solid color fill.

2403

# specified color value.

2404

#

2405

# If any field is unset, its value may be inherited from a parent placeholder

2406

# if it exists.

2407

"color": { # A themeable solid color value. # The color value of the solid fill.

2408

"themeColor": "A String", # An opaque theme color.

2409

"rgbColor": { # An RGB color. # An opaque RGB color.

2410

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

2411

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

2412

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

2413

},

2414

},

2415

"alpha": 3.14, # The fraction of this `color` that should be applied to the pixel.

2416

# That is, the final pixel color is defined by the equation:

2417

#

2418

# pixel color = alpha * (color) + (1.0 - alpha) * (background color)

2419

#

2420

# This means that a value of 1.0 corresponds to a solid color, whereas

2421

# a value of 0.0 corresponds to a completely transparent color.

2422

},

2423

"propertyState": "A String", # The background fill property state.

2424

#

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

2425

# Updating the fill on a page will implicitly update this field to

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2426

# `RENDERED`, unless another value is specified in the same request. To

2427

# have no fill on a page, set this field to `NOT_RENDERED`. In this case,

2428

# any other fill fields set in the same request will be ignored.

2429

"stretchedPictureFill": { # The stretched picture fill. The page or page element is filled entirely with # Stretched picture fill.

2430

# the specified picture. The picture is stretched to fit its container.

2431

"contentUrl": "A String", # Reading the content_url:

2432

#

2433

# An URL to a picture with a default lifetime of 30 minutes.

2434

# This URL is tagged with the account of the requester. Anyone with the URL

2435

# effectively accesses the picture as the original requester. Access to the

2436

# picture may be lost if the presentation's sharing settings change.

2437

#

2438

# Writing the content_url:

2439

#

2440

# The picture is fetched once at insertion time and a copy is stored for

2441

# display inside the presentation. Pictures must be less than 50MB in size,

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

2442

# cannot exceed 25 megapixels, and must be in one of PNG, JPEG, or GIF

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2443

# format.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

2444

#

2445

# The provided URL can be at most 2 kB in length.

Jon Wayne Parrott

2017-01-06 09:58:29 -0800

[diff] [blame]

2446

"size": { # A width and height. # The original size of the picture fill. This field is read-only.

2447

"width": { # A magnitude in a single direction in the specified units. # The width of the object.

2448

"magnitude": 3.14, # The magnitude.

2449

"unit": "A String", # The units for magnitude.

2450

},

2451

"height": { # A magnitude in a single direction in the specified units. # The height of the object.

2452

"magnitude": 3.14, # The magnitude.

2453

"unit": "A String", # The units for magnitude.

},

},

},

},

"colorScheme": { # The palette of predefined colors for a page. # The color scheme of the page. If unset, the color scheme is inherited from

2459

# a parent page. If the page has no parent, the color scheme uses a default

2460

# Slides color scheme. This field is read-only.

2461

"colors": [ # The ThemeColorType and corresponding concrete color pairs.

2462

{ # A pair mapping a theme color type to the concrete color it represents.

2463

"color": { # An RGB color. # The concrete color corresponding to the theme color type above.

2464

"blue": 3.14, # The blue component of the color, from 0.0 to 1.0.

2465

"green": 3.14, # The green component of the color, from 0.0 to 1.0.

2466

"red": 3.14, # The red component of the color, from 0.0 to 1.0.

2467

},

2468

"type": "A String", # The type of the theme color.

},

],

},

},

"pageType": "A String", # The type of the page.

2474

"slideProperties": { # The properties of Page that are only # Slide specific properties. Only set if page_type = SLIDE.

2475

# relevant for pages with page_type SLIDE.

Sai Cheemalapati

2017-03-13 12:12:03 -0400

[diff] [blame]

2476

"notesPage": # Object with schema name: Page # The notes page that this slide is associated with. It defines the visual

2477

# appearance of a notes page when printing or exporting slides with speaker

2478

# notes. A notes page inherits properties from the

2479

# notes master.

2480

# The placeholder shape with type BODY on the notes page contains the speaker

2481

# notes for this slide. The ID of this shape is identified by the

2482

# speakerNotesObjectId field.

2483

# The notes page is read-only except for the text content and styles of the

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame^]

2484

# speaker notes shape. This property is read-only.

2485

"masterObjectId": "A String", # The object ID of the master that this slide is based on. This property is

2486

# read-only.

2487

"layoutObjectId": "A String", # The object ID of the layout that this slide is based on. This property is

2488

# read-only.

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]

2493

2494

<code class="details" id="getThumbnail">getThumbnail(presentationId, pageObjectId, thumbnailProperties_mimeType=None, thumbnailProperties_thumbnailSize=None, x__xgafv=None)</code>

2495

<pre>Generates a thumbnail of the latest version of the specified page in the

2496

presentation and returns a URL to the thumbnail image.

2497

Bu Sun Kim