En esta página, se explica cómo editar el texto de tu presentación y cómo aplicarle estilo con la API de Presentaciones.
Acerca del texto
El texto de tu presentación siempre está contenido dentro de una forma o una celda de la tabla. La API te permite modificar este texto de varias maneras:
- Puedes insertar, borrar o reemplazar texto en la presentación.
- Puedes agregar formato de párrafo para crear listas con viñetas.
- Puedes cambiar el formato de caracteres, como la negrita, la cursiva, el color, el tamaño de fuente o los hipervínculos.
Consulta la página de conceptos Estructura y diseño de texto para obtener una descripción general del funcionamiento de los estilos de texto en la API de Presentaciones. Consulta también el video anterior para ver un ejemplo completo (Python) en el que se combinan varios de los conceptos de formato de las secciones siguientes.
Inserción, eliminación o reemplazo de texto
Existen dos maneras de reemplazar texto en una presentación con la API de Presentaciones: realizando una búsqueda y reemplazo globales o borrando y agregando texto de forma explícita. En ambas maneras, se usa el método batchUpdate, pero con diferentes tipos de solicitudes.
Búsqueda y reemplazo global
Usa ReplaceAllTextRequest para realizar un procedimiento global de búsqueda y reemplazo en tu presentación.
En la sección Combinar texto de la guía Combinar datos, se proporciona un ejemplo de cómo puedes usar este tipo de solicitud.
Cómo reemplazar texto dentro de una forma
La API de Presentaciones te permite modificar el contenido de texto de una forma. Puedes quitar rangos de texto individuales y, luego, insertar texto en una ubicación específica.
Usa InsertTextRequest y DeleteTextRequest para realizar estas operaciones.
El reemplazo de una región de texto específica consiste en una eliminación y, luego, una inserción. Puedes realizar los siguientes pasos:
- Identifica el elemento de página que contiene el texto.
- Identifica la posición inicial y final del texto que se reemplazará.
- Llama a
batchUpdatecon las siguientes dos solicitudes:- DeleteTextRequest y especifica el rango de texto que se borrará.
- InsertTextRequest, que especifica la misma posición de inicio, así como la string de texto que se insertará.
Para garantizar atomicidad cuando reemplaces el texto de esta manera, asegúrate de incluir ambas solicitudes en la misma llamada al método Key. Esto se muestra en el siguiente ejemplo, en el que se reemplaza todo el texto de una forma por texto nuevo:
Apps Script
slides/api/Snippets.gs
/**
* Remove existing text in the shape, then insert new text.
* @param {string} presentationId
* @param {string?} shapeId
* @param {string} replacementText
* @returns {*}
*/
function simpleTextReplace(presentationId, shapeId, replacementText) {
const requests = [{
deleteText: {
objectId: shapeId,
textRange: {
type: 'ALL'
}
}
}, {
insertText: {
objectId: shapeId,
insertionIndex: 0,
text: replacementText
}
}];
// Execute the requests.
try {
const batchUpdateResponse = Slides.Presentations.batchUpdate({
requests: requests
}, presentationId);
console.log('Replaced text in shape with ID: %s', shapeId);
return batchUpdateResponse;
} catch (err) {
// TODO (Developer) - Handle exception
console.log('Failed with error: %s', err.error);
}
};
Go
diapositivas/fragmentos/presentaciones.go
// Remove existing text in the shape, then insert the new text.
requests := []*slides.Request{{
DeleteText: &slides.DeleteTextRequest{
ObjectId: shapeId,
TextRange: &slides.Range{
Type: "All",
},
},
}, {
InsertText: &slides.InsertTextRequest{
ObjectId: shapeId,
InsertionIndex: 0,
Text: replacementText,
},
}}
// Execute the requests.
body := &slides.BatchUpdatePresentationRequest{Requests: requests}
response, _ := slidesService.Presentations.BatchUpdate(presentationId, body).Do()
fmt.Printf("Replaced text in shape with ID: %s", shapeId)
Java
slides/snippets/src/main/java/SimpleTextReplace.java
import com.google.api.client.googleapis.json.GoogleJsonError;
import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.slides.v1.Slides;
import com.google.api.services.slides.v1.SlidesScopes;
import com.google.api.services.slides.v1.model.BatchUpdatePresentationRequest;
import com.google.api.services.slides.v1.model.BatchUpdatePresentationResponse;
import com.google.api.services.slides.v1.model.DeleteTextRequest;
import com.google.api.services.slides.v1.model.InsertTextRequest;
import com.google.api.services.slides.v1.model.Range;
import com.google.api.services.slides.v1.model.Request;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
/* Class to demonstrate the use of Slides Replace Text API */
public class SimpleTextReplace {
/**
* Remove existing text in the shape, then insert new text.
*
* @param presentationId - id of the presentation.
* @param shapeId - id of the shape.
* @param replacementText - New replacement text.
* @return response
* @throws IOException - if credentials file not found.
*/
public static BatchUpdatePresentationResponse simpleTextReplace(
String presentationId, String shapeId, String replacementText) throws IOException {
/* Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity for
guides on implementing OAuth2 for your application. */
GoogleCredentials credentials = GoogleCredentials.getApplicationDefault()
.createScoped(Collections.singleton(SlidesScopes.PRESENTATIONS));
HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(
credentials);
// Create the slides API client
Slides service = new Slides.Builder(new NetHttpTransport(),
GsonFactory.getDefaultInstance(),
requestInitializer)
.setApplicationName("Slides samples")
.build();
// Remove existing text in the shape, then insert the new text.
List<Request> requests = new ArrayList<>();
requests.add(new Request()
.setDeleteText(new DeleteTextRequest()
.setObjectId(shapeId)
.setTextRange(new Range()
.setType("ALL"))));
requests.add(new Request()
.setInsertText(new InsertTextRequest()
.setObjectId(shapeId)
.setInsertionIndex(0)
.setText(replacementText)));
BatchUpdatePresentationResponse response = null;
try {
// Execute the requests.
BatchUpdatePresentationRequest body =
new BatchUpdatePresentationRequest().setRequests(requests);
response = service.presentations().batchUpdate(presentationId, body).execute();
System.out.println("Replaced text in shape with ID: " + shapeId);
} catch (GoogleJsonResponseException e) {
// TODO(developer) - handle error appropriately
GoogleJsonError error = e.getDetails();
if (error.getCode() == 400) {
System.out.printf("Shape not found with id '%s'.\n", shapeId);
} else if (error.getCode() == 404) {
System.out.printf("Presentation not found with id '%s'.\n", presentationId);
} else {
throw e;
}
}
return response;
}
}
JavaScript
slides/snippets/slides_simple_text_replace.js
function simpleTextReplace(presentationId, shapeId, replacementText, callback) {
// Remove existing text in the shape, then insert new text.
const requests = [{
deleteText: {
objectId: shapeId,
textRange: {
type: 'ALL',
},
},
}, {
insertText: {
objectId: shapeId,
insertionIndex: 0,
text: replacementText,
},
}];
// Execute the requests.
try {
gapi.client.slides.presentations.batchUpdate({
presentationId: presentationId,
requests: requests,
}).then((batchUpdateResponse) => {
console.log(`Replaced text in shape with ID: ${shapeId}`);
if (callback) callback(batchUpdateResponse.result);
});
} catch (err) {
document.getElementById('content').innerText = err.message;
return;
}
}
Node.js
slides/snippets/slides_simple_text_replace.js
/**
* Replaces text in the provided shape ID.
* @param {string} presentationId The presentation ID.
* @param {string} shapeId The shape ID to delete existing text and insert new text into.
* @param {string} replacementText The new replacement text.
*/
async function simpleTextReplace(presentationId, shapeId, replacementText) {
const {GoogleAuth} = require('google-auth-library');
const {google} = require('googleapis');
const auth = new GoogleAuth({
scopes: 'https://www.googleapis.com/auth/presentations',
});
const service = google.slides({version: 'v1', auth});
// Remove existing text in the shape, then insert new text.
const requests = [
{
deleteText: {
objectId: shapeId,
textRange: {
type: 'ALL',
},
},
},
{
insertText: {
objectId: shapeId,
insertionIndex: 0,
text: replacementText,
},
},
];
// Execute the requests.
try {
const batchUpdateResponse = await service.presentations.batchUpdate({
presentationId,
resource: {
requests,
},
});
console.log(`Replaced text in shape with ID: ${shapeId}`);
return batchUpdateResponse.data;
} catch (err) {
// TODO (developer) - Handle exception
throw err;
}
}
PHP
slides/snippets/src/SlidesSimpleTextReplace.php
use Google\Client;
use Google\Service\Drive;
use Google\Service\Slides;
use Google\Service\Slides\Request;
function simpleTextReplace($presentationId, $shapeId, $replacementText)
{
/* Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity for
guides on implementing OAuth2 for your application. */
$client = new Google\Client();
$client->useApplicationDefaultCredentials();
$client->addScope(Google\Service\Drive::DRIVE);
$slidesService = new Google_Service_Slides($client);
// Remove existing text in the shape, then insert new text.
$requests = array();
$requests[] = new Google_Service_Slides_Request(array(
'deleteText' => array(
'objectId' => $shapeId,
'textRange' => array(
'type' => 'ALL'
)
)
));
$requests[] = new Google_Service_Slides_Request(array(
'insertText' => array(
'objectId' => $shapeId,
'insertionIndex' => 0,
'text' => $replacementText
)
));
// Execute the requests.
$batchUpdateRequest = new Google_Service_Slides_BatchUpdatePresentationRequest(array(
'requests' => $requests
));
$response = $slidesService->presentations->batchUpdate($presentationId, $batchUpdateRequest);
printf("Replaced text in shape with ID: %s", $shapeId);
return $response;
}
Python
slides/snippets/slides_simple_text_replace.py
import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
def simple_text_replace(presentation_id, shape_id, replacement_text):
"""
Run simple_text_replace the user has access to.
Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity
for guides on implementing OAuth2 for the application.
"""
creds, _ = google.auth.default()
# pylint: disable=maybe-no-member
try:
slides_service = build("slides", "v1", credentials=creds)
# Remove existing text in the shape, then insert new text.
requests = []
requests.append(
{"deleteText": {"objectId": shape_id, "textRange": {"type": "ALL"}}}
)
requests.append(
{
"insertText": {
"objectId": shape_id,
"insertionIndex": 0,
"text": replacement_text,
}
}
)
# Execute the requests.
body = {"requests": requests}
response = (
slides_service.presentations()
.batchUpdate(presentationId=presentation_id, body=body)
.execute()
)
print(f"Replaced text in shape with ID: {shape_id}")
return response
except HttpError as error:
print(f"An error occurred: {error}")
print("Text is not merged")
return error
if __name__ == "__main__":
# Put the presentation_id, shape_id and replacement_text
simple_text_replace(
"10QnVUx1X2qHsL17WUidGpPh_SQhXYx40CgIxaKk8jU4",
"MyTextBox_6",
"GWSpace_now",
)
Rita
slides/snippets/lib/file_snippets.rb
# Remove existing text in the shape, then insert new text.
requests = [] << {
delete_text: {
object_id_prop: shape_id,
text_range: {
type: 'ALL'
}
}
} << {
insert_text: {
object_id_prop: shape_id,
insertion_index: 0,
text: replacement_text
}
}
# Execute the requests.
req = Google::Apis::SlidesV1::BatchUpdatePresentationRequest.new(requests: requests)
response = slides_service.batch_update_presentation(
presentation_id,
req
)
puts "Replaced text in shape with ID: #{shape_id}"
Cambiar el formato de caracteres
El formato de caracteres determina la renderización de caracteres de texto en tu presentación, incluidos el tipo de letra, el color y los hipervínculos.
En la página de conceptos Estructura y estilo de texto, se describe cómo la API de Presentaciones representa la información de estilo de texto.
Para cambiar el formato de caracteres del texto, usa batchUpdate con UpdateTextStyleRequest.
Debes proporcionar el ID de la forma o la celda de la tabla que contiene el texto, así como un valor de Range que incluya la siguiente información:
- El especificador
FIXED_RANGE, junto con los índices de inicio y finalización que definen el rango de texto al que deseas aplicarle diseño. - El especificador
FROM_START_INDEX, junto con un índice de inicio que define el comienzo del rango de texto al que deseas aplicarle diseño. - El especificador
ALL, sin índices, para aplicar diseño a todo el texto en la forma de destino.
En el siguiente ejemplo, se realizan varias operaciones de diseño en el texto contenido en una forma:
- Define la fuente de los caracteres 0-4 en negrita y cursiva.
- Establece el color de los caracteres 5-9 en
blue, fuente Times New Roman de tamaño 14 pt. - Se hipervinculan los caracteres 10-14 a
www.example.com.
Una forma directa de hacerlo es crear una lista de solicitudes y, luego, usar una llamada a batchUpdate:
Apps Script
slides/api/Snippets.gs
/**
* Update the text style so that the first 5 characters are bolded
* and italicized, the next 5 are displayed in blue 14 pt Times
* New Roman font, and the next 5 are hyperlinked.
* @param {string} presentationId
* @param {string} shapeId
* @returns {*}
*/
function textStyleUpdate(presentationId, shapeId) {
const requests = [{
updateTextStyle: {
objectId: shapeId,
textRange: {
type: 'FIXED_RANGE',
startIndex: 0,
endIndex: 5
},
style: {
bold: true,
italic: true
},
fields: 'bold,italic'
}
}, {
updateTextStyle: {
objectId: shapeId,
textRange: {
type: 'FIXED_RANGE',
startIndex: 5,
endIndex: 10
},
style: {
fontFamily: 'Times New Roman',
fontSize: {
magnitude: 14,
unit: 'PT'
},
foregroundColor: {
opaqueColor: {
rgbColor: {
blue: 1.0,
green: 0.0,
red: 0.0
}
}
}
},
fields: 'foregroundColor,fontFamily,fontSize'
}
}, {
updateTextStyle: {
objectId: shapeId,
textRange: {
type: 'FIXED_RANGE',
startIndex: 10,
endIndex: 15
},
style: {
link: {
url: 'www.example.com'
}
},
fields: 'link'
}
}];
// Execute the requests.
try {
const batchUpdateResponse = Slides.Presentations.batchUpdate({
requests: requests
}, presentationId);
console.log('Updated the text style for shape with ID: %s', shapeId);
return batchUpdateResponse;
} catch (err) {
// TODO (Developer) - Handle exception
console.log('Failed with error: %s', err.error);
}
};
Go
diapositivas/fragmentos/presentaciones.go
// Update the text style so that the first 5 characters are bolded
// and italicized, and the next 5 are displayed in blue 14 pt Times
// New Roman font, and the next five are hyperlinked.
requests := []*slides.Request{{
UpdateTextStyle: &slides.UpdateTextStyleRequest{
ObjectId: shapeId,
TextRange: &slides.Range{
Type: "FIXED_RANGE",
StartIndex: ptrInt64(0),
EndIndex: ptrInt64(5),
ForceSendFields: []string{"StartIndex"},
},
Style: &slides.TextStyle{
Bold: true,
Italic: true,
},
Fields: "bold,italic",
},
}, {
UpdateTextStyle: &slides.UpdateTextStyleRequest{
ObjectId: shapeId,
TextRange: &slides.Range{
Type: "FIXED_RANGE",
StartIndex: ptrInt64(5),
EndIndex: ptrInt64(10),
},
Style: &slides.TextStyle{
FontFamily: "Times New Roman",
FontSize: &slides.Dimension{
Magnitude: 14.0,
Unit: "PT",
},
ForegroundColor: &slides.OptionalColor{
OpaqueColor: &slides.OpaqueColor{
RgbColor: &slides.RgbColor{
Blue: 1.0,
Green: 0.0,
Red: 0.0,
},
},
},
},
Fields: "foregroundColor,fontFamily,fontSize",
},
}, {
UpdateTextStyle: &slides.UpdateTextStyleRequest{
ObjectId: shapeId,
TextRange: &slides.Range{
Type: "FIXED_RANGE",
StartIndex: ptrInt64(10),
EndIndex: ptrInt64(15),
},
Style: &slides.TextStyle{
Link: &slides.Link{
Url: "www.example.com",
},
},
Fields: "link",
},
}}
// Execute the requests.
body := &slides.BatchUpdatePresentationRequest{Requests: requests}
response, _ := slidesService.Presentations.BatchUpdate(presentationId, body).Do()
fmt.Printf("Updated text style for shape with ID: %s", shapeId)
Java
slides/snippets/src/main/java/TextStyleUpdate.java
import com.google.api.client.googleapis.json.GoogleJsonError;
import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.slides.v1.Slides;
import com.google.api.services.slides.v1.SlidesScopes;
import com.google.api.services.slides.v1.model.BatchUpdatePresentationRequest;
import com.google.api.services.slides.v1.model.BatchUpdatePresentationResponse;
import com.google.api.services.slides.v1.model.Dimension;
import com.google.api.services.slides.v1.model.Link;
import com.google.api.services.slides.v1.model.OpaqueColor;
import com.google.api.services.slides.v1.model.OptionalColor;
import com.google.api.services.slides.v1.model.Range;
import com.google.api.services.slides.v1.model.Request;
import com.google.api.services.slides.v1.model.RgbColor;
import com.google.api.services.slides.v1.model.TextStyle;
import com.google.api.services.slides.v1.model.UpdateTextStyleRequest;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
/* Class to demonstrate the use of Slide Text Structure and Styling API */
public class TextStyleUpdate {
/**
* Styles text in the shape.
*
* @param presentationId - id of the presentation.
* @param shapeId - id of the shape.
* @return shape id
* @throws IOException - if credentials file not found.
*/
public static BatchUpdatePresentationResponse textStyleUpdate(String presentationId,
String shapeId)
throws IOException {
/* Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity for
guides on implementing OAuth2 for your application. */
GoogleCredentials credentials = GoogleCredentials.getApplicationDefault()
.createScoped(Collections.singleton(SlidesScopes.PRESENTATIONS));
HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(
credentials);
// Create the slides API client
Slides service = new Slides.Builder(new NetHttpTransport(),
GsonFactory.getDefaultInstance(),
requestInitializer)
.setApplicationName("Slides samples")
.build();
// Update the text style so that the first 5 characters are bolded
// and italicized, and the next 5 are displayed in blue 14 pt Times
// New Roman font, and the next five are hyperlinked.
List<Request> requests = new ArrayList<>();
requests.add(new Request()
.setUpdateTextStyle(new UpdateTextStyleRequest()
.setObjectId(shapeId)
.setTextRange(new Range()
.setType("FIXED_RANGE")
.setStartIndex(0)
.setEndIndex(5))
.setStyle(new TextStyle()
.setBold(true)
.setItalic(true))
.setFields("bold,italic")));
requests.add(new Request()
.setUpdateTextStyle(new UpdateTextStyleRequest()
.setObjectId(shapeId)
.setTextRange(new Range()
.setType("FIXED_RANGE")
.setStartIndex(5)
.setEndIndex(10))
.setStyle(new TextStyle()
.setFontFamily("Times New Roman")
.setFontSize(new Dimension()
.setMagnitude(14.0)
.setUnit("PT"))
.setForegroundColor(new OptionalColor()
.setOpaqueColor(new OpaqueColor()
.setRgbColor(new RgbColor()
.setBlue(1.0F)
.setGreen(0.0F)
.setRed(0.0F)))))
.setFields("foregroundColor,fontFamily,fontSize")));
requests.add(new Request()
.setUpdateTextStyle(new UpdateTextStyleRequest()
.setObjectId(shapeId)
.setTextRange(new Range()
.setType("FIXED_RANGE")
.setStartIndex(10)
.setEndIndex(15))
.setStyle(new TextStyle()
.setLink(new Link()
.setUrl("www.example.com")))
.setFields("link")));
BatchUpdatePresentationResponse response = null;
try {
// Execute the requests.
BatchUpdatePresentationRequest body =
new BatchUpdatePresentationRequest().setRequests(requests);
response = service.presentations().batchUpdate(presentationId, body).execute();
System.out.println("Updated text style for shape with ID: " + shapeId);
} catch (GoogleJsonResponseException e) {
// TODO(developer) - handle error appropriately
GoogleJsonError error = e.getDetails();
if (error.getCode() == 400) {
System.out.printf("Shape not found with id '%s'.\n", shapeId);
} else if (error.getCode() == 404) {
System.out.printf("Presentation not found with id '%s'.\n", presentationId);
} else {
throw e;
}
}
return response;
}
}
JavaScript
slides/snippets/slides_text_style_update.js
function textStyleUpdate(presentationId, shapeId, callback) {
// Update the text style so that the first 5 characters are bolded
// and italicized, the next 5 are displayed in blue 14 pt Times
// New Roman font, and the next 5 are hyperlinked.
const requests = [{
updateTextStyle: {
objectId: shapeId,
textRange: {
type: 'FIXED_RANGE',
startIndex: 0,
endIndex: 5,
},
style: {
bold: true,
italic: true,
},
fields: 'bold,italic',
},
}, {
updateTextStyle: {
objectId: shapeId,
textRange: {
type: 'FIXED_RANGE',
startIndex: 5,
endIndex: 10,
},
style: {
fontFamily: 'Times New Roman',
fontSize: {
magnitude: 14,
unit: 'PT',
},
foregroundColor: {
opaqueColor: {
rgbColor: {
blue: 1.0,
green: 0.0,
red: 0.0,
},
},
},
},
fields: 'foregroundColor,fontFamily,fontSize',
},
}, {
updateTextStyle: {
objectId: shapeId,
textRange: {
type: 'FIXED_RANGE',
startIndex: 10,
endIndex: 15,
},
style: {
link: {
url: 'www.example.com',
},
},
fields: 'link',
},
}];
// Execute the requests.
try {
gapi.client.slides.presentations.batchUpdate({
presentationId: presentationId,
requests: requests,
}).then((batchUpdateResponse) => {
console.log(`Updated the text style for shape with ID: ${shapeId}`);
if (callback) callback(batchUpdateResponse.result);
});
} catch (err) {
document.getElementById('content').innerText = err.message;
return;
}
}
Node.js
slides/snippets/slides_text_style_update.js
/**
* Updates text style for a specific presentation's shape ID.
* @param {string} presentationId The presentation ID.
* @param {string} shapeId The shape ID.
*/
async function textStyleUpdate(presentationId, shapeId) {
// Update the text style so that the first 5 characters are bolded
// and italicized, the next 5 are displayed in blue 14 pt Times
// New Roman font, and the next 5 are hyperlinked.
const {GoogleAuth} = require('google-auth-library');
const {google} = require('googleapis');
const auth = new GoogleAuth({
scopes: 'https://www.googleapis.com/auth/presentations',
});
const service = google.slides({version: 'v1', auth});
const requests = [
{
updateTextStyle: {
objectId: shapeId,
textRange: {
type: 'FIXED_RANGE',
startIndex: 0,
endIndex: 5,
},
style: {
bold: true,
italic: true,
},
fields: 'bold,italic',
},
},
{
updateTextStyle: {
objectId: shapeId,
textRange: {
type: 'FIXED_RANGE',
startIndex: 5,
endIndex: 10,
},
style: {
fontFamily: 'Times New Roman',
fontSize: {
magnitude: 14,
unit: 'PT',
},
foregroundColor: {
opaqueColor: {
rgbColor: {
blue: 1.0,
green: 0.0,
red: 0.0,
},
},
},
},
fields: 'foregroundColor,fontFamily,fontSize',
},
},
{
updateTextStyle: {
objectId: shapeId,
textRange: {
type: 'FIXED_RANGE',
startIndex: 10,
endIndex: 15,
},
style: {
link: {
url: 'www.example.com',
},
},
fields: 'link',
},
},
];
// Execute the requests.
try {
const batchUpdateResponse = await service.presentations.batchUpdate({
presentationId,
resource: {
requests,
},
});
console.log(`Updated the text style for shape with ID: ${shapeId}`);
return batchUpdateResponse.data;
} catch (err) {
// TODO (developer) - Handle exceptions
throw err;
}
}
PHP
slides/snippets/src/SlidesTextStyleUpdate.php
use Google\Client;
use Google\Service\Drive;
use Google\Service\Slides;
use Google\Service\Slides\Request;
use Google\Service\Slides\BatchUpdatePresentationRequest;
function textStyleUpdate($presentationId, $shapeId)
{
/* Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity for
guides on implementing OAuth2 for your application. */
$client = new Google\Client();
$client->useApplicationDefaultCredentials();
$client->addScope(Google\Service\Drive::DRIVE);
$slidesService = new Google_Service_Slides($client);
$requests = array();
$requests[] = new Google_Service_Slides_Request(array(
'updateTextStyle' => array(
'objectId' => $shapeId,
'textRange' => array(
'type' => 'FIXED_RANGE',
'startIndex' => 0,
'endIndex' => 5
),
'style' => array(
'bold' => true,
'italic' => true
),
'fields' => 'bold,italic'
)
));
$requests[] = new Google_Service_Slides_Request(array(
'updateTextStyle' => array(
'objectId' => $shapeId,
'textRange' => array(
'type' => 'FIXED_RANGE',
'startIndex' => 5,
'endIndex' => 10
),
'style' => array(
'fontFamily' => 'Times New Roman',
'fontSize' => array(
'magnitude' => 14,
'unit' => 'PT'
),
'foregroundColor' => array(
'opaqueColor' => array(
'rgbColor' => array(
'blue' => 1.0,
'green' => 0.0,
'red' => 0.0
)
)
)
),
'fields' => 'foregroundColor,fontFamily,fontSize'
)
));
$requests[] = new Google_Service_Slides_Request(array(
'updateTextStyle' => array(
'objectId' => $shapeId,
'textRange' => array(
'type' => 'FIXED_RANGE',
'startIndex' => 10,
'endIndex' => 15
),
'style' => array(
'link' => array(
'url' => 'www.example.com'
)
),
'fields' => 'link'
)
));
// Execute the requests.
$batchUpdateRequest = new Google_Service_Slides_BatchUpdatePresentationRequest(array(
'requests' => $requests
));
$response = $slidesService->presentations->batchUpdate($presentationId, $batchUpdateRequest);
printf("Updated the text style for shape with ID: %s", $shapeId);
return $response;
}
Python
slides/snippets/slides_text_style_update.py
import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
def text_style_update(presentation_id, shape_id):
"""
create_sheets_chart the user has access to.
Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity
for guides on implementing OAuth2 for the application.
"""
creds, _ = google.auth.default()
# pylint: disable=maybe-no-member
try:
service = build("slides", "v1", credentials=creds)
# Update the text style so that the first 5 characters are bolded
# and italicized, the next 5 are displayed in blue 14 pt Times
# New Roman font, and the next 5 are hyperlinked.
requests = [
{
"updateTextStyle": {
"objectId": shape_id,
"textRange": {
"type": "FIXED_RANGE",
"startIndex": 0,
"endIndex": 5,
},
"style": {"bold": True, "italic": True},
"fields": "bold,italic",
}
},
{
"updateTextStyle": {
"objectId": shape_id,
"textRange": {
"type": "FIXED_RANGE",
"startIndex": 5,
"endIndex": 10,
},
"style": {
"fontFamily": "Times New Roman",
"fontSize": {"magnitude": 14, "unit": "PT"},
"foregroundColor": {
"opaqueColor": {
"rgbColor": {
"blue": 1.0,
"green": 0.0,
"red": 0.0,
}
}
},
},
"fields": "foregroundColor,fontFamily,fontSize",
}
},
{
"updateTextStyle": {
"objectId": shape_id,
"textRange": {
"type": "FIXED_RANGE",
"startIndex": 10,
"endIndex": 15,
},
"style": {"link": {"url": "www.example.com"}},
"fields": "link",
}
},
]
# Execute the requests.
body = {"requests": requests}
response = (
service.presentations()
.batchUpdate(presentationId=presentation_id, body=body)
.execute()
)
print(f"Updated the text style for shape with ID:{shape_id}")
return response
except HttpError as error:
print(f"An error occurred: {error}")
return error
if __name__ == "__main__":
# Put the presentation_id, shape_id of slides
# to be submitted.
text_style_update(
"10QnVUx1X2qHsL17WUidGpPh_SQhXYx40CgIxaKk8jU4", "MyTextBox_9"
)
Rita
slides/snippets/lib/file_snippets.rb
# Update the text style so that the first 5 characters are bolded
# and italicized, the next 5 are displayed in blue 14 pt Times
# New Roman font, and the next 5 are hyperlinked.
requests = [] << {
update_text_style: {
object_id_prop: shape_id,
text_range: {
type: 'FIXED_RANGE',
start_index: 0,
end_index: 5
},
style: {
bold: true,
italic: true
},
fields: 'bold,italic'
}
} << {
update_text_style: {
object_id_prop: shape_id,
text_range: {
type: 'FIXED_RANGE',
start_index: 5,
end_index: 10
},
style: {
font_family: 'Times New Roman',
font_size: {
magnitude: 14,
unit: 'PT'
},
foreground_color: {
opaque_color: {
rgb_color: {
blue: 1.0,
green: 0.0,
red: 0.0
}
}
}
},
fields: 'foreground_color,font_family,font_size'
}
} << {
update_text_style: {
object_id_prop: shape_id,
text_range: {
type: 'FIXED_RANGE',
start_index: 10,
end_index: 15
},
style: {
link: {
url: 'www.example.com'
}
},
fields: 'link'
}
}
# Execute the requests.
req = Google::Apis::SlidesV1::BatchUpdatePresentationRequest.new(requests: requests)
response = slides_service.batch_update_presentation(presentation_id, req)
puts "Updated the text style for shape with ID: #{shape_id}"
Cómo cambiar el formato de párrafo
El formato de párrafo determina cómo se renderizan los bloques de texto en tu presentación, lo que incluye la alineación, las sangrías y la ornamentación de listas.
En la página de conceptos Estructura y estilo de texto, se describe cómo [[slides_api_short]] representa información de estilo de párrafo.
La API de Presentaciones admite la actualización de estilos de párrafos, la conversión de párrafos sin formato en listas con viñetas y la eliminación de viñetas de los párrafos.
Convertir párrafos en una lista
Una operación común de formato de párrafos es convertirlos en una lista con viñetas. En el siguiente ejemplo, se convierten todos los párrafos de una forma en una lista con viñetas y se especifica un glifo de viñeta explícito que se usará.
Apps Script
slides/api/Snippets.gs
/**
* Add arrow-diamond-disc bullets to all text in the shape.
*/
function createBulletedText(presentationId, shapeId) {
const requests = [{
createParagraphBullets: {
objectId: shapeId,
textRange: {
type: 'ALL'
},
bulletPreset: 'BULLET_ARROW_DIAMOND_DISC'
}
}];
// Execute the requests.
try {
const batchUpdateResponse = Slides.Presentations.batchUpdate({
requests: requests
}, presentationId);
console.log('Added bullets to text in shape with ID: %s', shapeId);
return batchUpdateResponse;
} catch (err) {
// TODO (Developer) - Handle exception
console.log('Failed with error: %s', err.error);
}
};
Go
diapositivas/fragmentos/presentaciones.go
// Add arrow-diamond-disc bullets to all text in the shape.
requests := []*slides.Request{{
CreateParagraphBullets: &slides.CreateParagraphBulletsRequest{
ObjectId: shapeId,
TextRange: &slides.Range{
Type: "ALL",
},
BulletPreset: "BULLET_ARROW_DIAMOND_DISC",
},
}}
// Execute the requests.
body := &slides.BatchUpdatePresentationRequest{Requests: requests}
response, _ := slidesService.Presentations.BatchUpdate(presentationId, body).Do()
fmt.Printf("Added a linked Sheets chart with ID %s", shapeId)
Java
slides/snippets/src/main/java/CreateBulletedText.java
import com.google.api.client.googleapis.json.GoogleJsonError;
import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.slides.v1.Slides;
import com.google.api.services.slides.v1.SlidesScopes;
import com.google.api.services.slides.v1.model.BatchUpdatePresentationRequest;
import com.google.api.services.slides.v1.model.BatchUpdatePresentationResponse;
import com.google.api.services.slides.v1.model.CreateParagraphBulletsRequest;
import com.google.api.services.slides.v1.model.Range;
import com.google.api.services.slides.v1.model.Request;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
/* Class to demonstrate the use of Slide Create Bulleted Text API */
public class CreateBulletedText {
/**
* Add arrow-diamond-disc bullets to all text in the shape.
*
* @param presentationId - id of the presentation.
* @param shapeId - id of the shape.
* @return response
* @throws IOException - if credentials file not found.
*/
public static BatchUpdatePresentationResponse createBulletedText(String presentationId,
String shapeId)
throws IOException {
/* Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity for
guides on implementing OAuth2 for your application. */
GoogleCredentials credentials = GoogleCredentials.getApplicationDefault()
.createScoped(Collections.singleton(SlidesScopes.PRESENTATIONS));
HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(
credentials);
// Create the slides API client
Slides service = new Slides.Builder(new NetHttpTransport(),
GsonFactory.getDefaultInstance(),
requestInitializer)
.setApplicationName("Slides samples")
.build();
// Add arrow-diamond-disc bullets to all text in the shape.
List<Request> requests = new ArrayList<>();
requests.add(new Request()
.setCreateParagraphBullets(new CreateParagraphBulletsRequest()
.setObjectId(shapeId)
.setTextRange(new Range()
.setType("ALL"))
.setBulletPreset("BULLET_ARROW_DIAMOND_DISC")));
BatchUpdatePresentationResponse response = null;
try {
// Execute the request.
BatchUpdatePresentationRequest body =
new BatchUpdatePresentationRequest().setRequests(requests);
response = service.presentations().batchUpdate(presentationId, body).execute();
System.out.println("Added bullets to text in shape with ID: " + shapeId);
} catch (GoogleJsonResponseException e) {
// TODO(developer) - handle error appropriately
GoogleJsonError error = e.getDetails();
if (error.getCode() == 400) {
System.out.printf("Shape not found with id '%s'.\n", shapeId);
} else if (error.getCode() == 404) {
System.out.printf("Presentation not found with id '%s'.\n", presentationId);
} else {
throw e;
}
}
return response;
}
}
JavaScript
slides/snippets/slides_create_bulleted_text.js
function createBulletedText(presentationId, shapeId, callback) {
// Add arrow-diamond-disc bullets to all text in the shape.
const requests = [{
createParagraphBullets: {
objectId: shapeId,
textRange: {
type: 'ALL',
},
bulletPreset: 'BULLET_ARROW_DIAMOND_DISC',
},
}];
// Execute the requests.
try {
gapi.client.slides.presentations.batchUpdate({
presentationId: presentationId,
requests: requests,
}).then((batchUpdateResponse) => {
console.log(`Added bullets to text in shape with ID: ${shapeId}`);
if (callback) callback(batchUpdateResponse.result);
});
} catch (err) {
document.getElementById('content').innerText = err.message;
return;
}
}
Node.js
slides/snippets/slides_create_bulleted_text.js
/**
* Creates bulleted text for a presentation.
* @param {string} presentationId The presentation ID.
* @param {string} shapeId The shape ID to add bulleted text to.
*/
async function createBulletedText(presentationId, shapeId) {
const {GoogleAuth} = require('google-auth-library');
const {google} = require('googleapis');
const auth = new GoogleAuth({
scopes: 'https://www.googleapis.com/auth/presentations',
});
const service = google.slides({version: 'v1', auth});
// Add arrow-diamond-disc bullets to all text in the shape.
const requests = [
{
createParagraphBullets: {
objectId: shapeId,
textRange: {
type: 'ALL',
},
bulletPreset: 'BULLET_ARROW_DIAMOND_DISC',
},
},
];
// Execute the requests.
try {
const batchUpdateResponse = await service.presentations.batchUpdate({
presentationId,
resource: {
requests,
},
});
console.log(`Added bullets to text in shape with ID: ${shapeId}`);
return batchUpdateResponse.data;
} catch (err) {
// TODO (developer) - Handle exception
throw err;
}
}
PHP
slides/snippets/src/SlidesCreateBulletedText.php
use Google\Client;
use Google\Service\Drive;
use Google\Service\Slides;
use Google\Service\Slides\Request;
function createBulletedText($presentationId, $shapeId)
{
/* Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity for
guides on implementing OAuth2 for your application. */
$client = new Google\Client();
$client->useApplicationDefaultCredentials();
$client->addScope(Google\Service\Drive::DRIVE);
$slidesService = new Google_Service_Slides($client);
// Add arrow-diamond-disc bullets to all text in the shape.
$requests = array();
$requests[] = new Google_Service_Slides_Request(array(
'createParagraphBullets' => array(
'objectId' => $shapeId,
'textRange' => array(
'type' => 'ALL'
),
'bulletPreset' => 'BULLET_ARROW_DIAMOND_DISC'
)
));
// Execute the request.
$batchUpdateRequest = new Google_Service_Slides_BatchUpdatePresentationRequest(array(
'requests' => $requests
));
$response = $slidesService->presentations->batchUpdate($presentationId, $batchUpdateRequest);
printf("Added bullets to text in shape with ID: %s", $shapeId);
return $response;
}
Python
slides/snippets/slides_create_bulleted_text.py
import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
def create_bulleted_text(presentation_id, shape_id):
"""
Run create_bulleted_text the user has access to.
Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity
for guides on implementing OAuth2 for the application.
"""
creds, _ = google.auth.default()
# pylint: disable=maybe-no-member
try:
slides_service = build("slides", "v1", credentials=creds)
# Add arrow-diamond-disc bullets to all text in the shape.
requests = [
{
"createParagraphBullets": {
"objectId": shape_id,
"textRange": {"type": "ALL"},
"bulletPreset": "BULLET_ARROW_DIAMOND_DISC",
}
}
]
# Execute the requests.
body = {"requests": requests}
response = (
slides_service.presentations()
.batchUpdate(presentationId=presentation_id, body=body)
.execute()
)
print(f"Added bullets to text in shape with ID: {shape_id}")
return response
except HttpError as error:
print(f"An error occurred: {error}")
return error
if __name__ == "__main__":
# Put the presentation_id and shape_id
# to be submitted.
create_bulleted_text(
"1VD1xmi1-9DonI4zmCKENTzlVxIL5SdGGTmbHmnBjQ1E", "MyTextBox_9"
)
Rita
slides/snippets/lib/file_snippets.rb
# Add arrow-diamond-disc bullets to all text in the shape.
requests = [] << {
create_paragraph_bullets: {
object_id_prop: shape_id,
text_range: {
type: 'ALL'
},
bulletPreset: 'BULLET_ARROW_DIAMOND_DISC'
}
}
# Execute the requests.
req = Google::Apis::SlidesV1::BatchUpdatePresentationRequest.new(requests: requests)
response = slides_service.batch_update_presentation(presentation_id, req)
puts "Added bullets to text in shape with ID: #{shape_id}"