Richiesta
Un singolo tipo di aggiornamento da applicare a una presentazione.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
kind . Il tipo di aggiornamento. È richiesto esattamente un campo.
kind
può essere solo uno dei seguenti:
|
|
createSlide
|
Crea una nuova slide. |
createShape
|
Crea una nuova forma. |
createTable
|
Crea una nuova tabella. |
insertText
|
Inserisce il testo in una forma o in una cella di tabella. |
insertTableRows
|
Inserisce righe in una tabella. |
insertTableColumns
|
Inserisce colonne in una tabella. |
deleteTableRow
|
Elimina una riga da una tabella. |
deleteTableColumn
|
Elimina una colonna da una tabella. |
replaceAllText
|
Sostituisce tutte le istanze del testo specificato. |
deleteObject
|
Elimina una pagina o un elemento di pagina dalla presentazione. |
updatePageElementTransform
|
Aggiorna la trasformazione di un elemento di pagina. |
updateSlidesPosition
|
Consente di aggiornare la posizione di un insieme di slide nella presentazione. |
deleteText
|
Elimina il testo da una forma o da una cella di tabella. |
createImage
|
Crea un'immagine. |
createVideo
|
Crea un video. |
createSheetsChart
|
Crea un grafico di Fogli Google incorporato. |
createLine
|
Crea una linea. |
refreshSheetsChart
|
Aggiorna un grafico di Fogli Google. |
updateShapeProperties
|
Aggiorna le proprietà di un
|
updateImageProperties
|
Aggiorna le proprietà di un
|
updateVideoProperties
|
Aggiorna le proprietà di un
|
updatePageProperties
|
Aggiorna le proprietà di un
|
updateTableCellProperties
|
Aggiorna le proprietà di un
|
updateLineProperties
|
Aggiorna le proprietà di un
|
createParagraphBullets
|
Crea elenchi puntati per i paragrafi. |
replaceAllShapesWithImage
|
Sostituisce tutte le forme che corrispondono ad alcuni criteri con un'immagine. |
duplicateObject
|
Duplica una slide o un elemento della pagina. |
updateTextStyle
|
Aggiorna lo stile del testo all'interno di un
|
replaceAllShapesWithSheetsChart
|
Sostituisce tutte le forme che corrispondono ad alcuni criteri con un grafico di Fogli Google. |
deleteParagraphBullets
|
Elimina i punti elenco dai paragrafi. |
updateParagraphStyle
|
Aggiorna lo stile dei paragrafi all'interno di una
|
updateTableBorderProperties
|
Aggiorna le proprietà dei bordi della tabella in un
|
updateTableColumnProperties
|
Aggiorna le proprietà di un
|
updateTableRowProperties
|
Aggiorna le proprietà di un
|
mergeTableCells
|
Unisce le celle in un
|
unmergeTableCells
|
Divide le celle in un
|
groupObjects
|
Raggruppa gli oggetti, come gli elementi della pagina. |
ungroupObjects
|
Separa gli oggetti, ad esempio
|
updatePageElementAltText
|
Aggiorna il titolo del testo alternativo e/o la descrizione di un
|
replaceImage
|
Sostituisce un'immagine esistente con una nuova. |
updateSlideProperties
|
Aggiorna le proprietà di una slide |
updatePageElementsZOrder
|
Aggiorna l'ordine Z di
|
updateLineCategory
|
Aggiorna la categoria di un
|
rerouteLine
|
Reindirizza un
|
CreateSlideRequest
Crea una slide.
Rappresentazione JSON |
---|
{ "objectId": string, "insertionIndex": integer, "slideLayoutReference": { object ( |
Campi | |
---|---|
objectId
|
Un ID oggetto fornito dall'utente.
Se specifichi un ID, questo deve essere univoco tra tutte le pagine e gli elementi di pagina nella presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde all'espressione regolare
Se non specifichi un ID, ne viene generato uno univoco. |
insertionIndex
|
L'indice facoltativo in base zero che indica dove inserire le slide. Se non specifichi un indice, la slide viene creata alla fine. |
slideLayoutReference
|
Riferimento al layout della slide da inserire, in base al master attuale, che è uno dei seguenti:
Se LayoutReference non viene trovato nell'istanza master corrente, viene restituito un errore di richiesta errata 400.
Se non specifichi un riferimento al layout, la slide utilizza i valori predefiniti
|
placeholderIdMappings[]
|
Un elenco facoltativo di mappature di ID oggetto
|
LayoutReference
Informazioni sul layout delle slide. Può riferirsi a:
- Un layout predefinito
- Uno dei layout della presentazione.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
kind . Il tipo di LayoutReference.
kind
può essere solo uno dei seguenti:
|
|
predefinedLayout
|
Layout predefinito. |
layoutId
|
ID layout: l'ID oggetto di uno dei layout della presentazione. |
PredefinedLayout
Tipi di layout predefiniti. Si tratta di layout che si trovano comunemente nelle presentazioni. Tuttavia, non vi è alcuna garanzia che questi layout siano presenti nell'attuale schema, in quanto potrebbero essere stati eliminati o non far parte del tema utilizzato. Inoltre, i segnaposto di ciascun layout potrebbero essere stati modificati.
Enum | |
---|---|
PREDEFINED_LAYOUT_UNSPECIFIED
|
Layout non specificato. |
BLANK
|
Layout vuoto, senza segnaposto. |
CAPTION_ONLY
|
Layout con didascalia in basso. |
TITLE
|
Layout con titolo e sottotitolo. |
TITLE_AND_BODY
|
Layout con titolo e corpo. |
TITLE_AND_TWO_COLUMNS
|
Layout con un titolo e due colonne. |
TITLE_ONLY
|
Layout con solo un titolo. |
SECTION_HEADER
|
Layout con titolo di sezione. |
SECTION_TITLE_AND_DESCRIPTION
|
Layout con titolo e sottotitolo su un lato e descrizione sull'altro. |
ONE_COLUMN_TEXT
|
Layout con un titolo e un corpo, disposti in una singola colonna. |
MAIN_POINT
|
Layout con un punto principale. |
BIG_NUMBER
|
Layout con un'intestazione con un numero elevato. |
LayoutPlaceholderIdMapping
La mappatura dell'ID specificato dall'utente per un segnaposto che verrà creato su una slide da un layout specificato.
Rappresentazione JSON |
---|
{ "objectId": string, // Union field |
Campi | |
---|---|
objectId
|
Un ID oggetto fornito dall'utente per il segnaposto identificato in precedenza che deve essere creato su una slide.
Se specifichi un ID, questo deve essere univoco tra tutte le pagine e gli elementi di pagina nella presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde all'espressione regolare
Se non specifichi un ID, ne viene generato uno univoco. |
Campo unione
kind . Il tipo per identificare un segnaposto su un layout.
kind
può essere solo uno dei seguenti:
|
|
layoutPlaceholder
|
Il segnaposto su un layout che verrà applicato a una slide. Solo
|
layoutPlaceholderObjectId
|
L'ID oggetto del segnaposto su un layout che verrà applicato a una slide. |
CreateShapeRequest
Crea una nuova forma.
Rappresentazione JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
Campi | |
---|---|
objectId
|
Un ID oggetto fornito dall'utente.
Se specifichi un ID, questo deve essere univoco tra tutte le pagine e gli elementi di pagina nella presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde all'espressione regolare
|
elementProperties
|
Le proprietà dell'elemento per la forma. |
shapeType
|
Il tipo di forma. |
PageElementProperties
Proprietà comuni a un elemento di pagina.
Nota: quando inizialmente crei un
PageElement
, l'API può modificare i valori di entrambi
size
e
transform
, ma le dimensioni visive rimarranno invariate.
Rappresentazione JSON |
---|
{ "pageObjectId": string, "size": { object ( |
Campi | |
---|---|
pageObjectId
|
L'ID oggetto della pagina in cui si trova l'elemento. |
size
|
Le dimensioni dell'elemento. |
transform
|
La trasformazione dell'elemento. |
CreateTableRequest
Crea una nuova tabella.
Rappresentazione JSON |
---|
{
"objectId": string,
"elementProperties": {
object (
|
Campi | |
---|---|
objectId
|
Un ID oggetto fornito dall'utente.
Se specifichi un ID, questo deve essere univoco tra tutte le pagine e gli elementi di pagina nella presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde all'espressione regolare
Se non specifichi un ID, ne viene generato uno univoco. |
elementProperties
|
Le proprietà degli elementi della tabella. La tabella verrà creata alle dimensioni fornite, rispettando le dimensioni minime. Se non viene fornita alcuna dimensione, la tabella verrà ridimensionata automaticamente. Le trasformazioni di tabella devono avere una scala di 1 e nessun componente di taglio. Se non viene fornita alcuna trasformazione, la tabella sarà centrata sulla pagina. |
rows
|
Numero di righe nella tabella. |
columns
|
Numero di colonne nella tabella. |
InsertTextRequest
Inserisce testo in una forma o in una cella di tabella.
Rappresentazione JSON |
---|
{
"objectId": string,
"cellLocation": {
object (
|
Campi | |
---|---|
objectId
|
L'ID oggetto della forma o della tabella in cui verrà inserito il testo. |
cellLocation
|
La posizione facoltativa della cella della tabella se il testo deve essere inserito in una cella. Se presente, l'oggetto objectId deve fare riferimento a una tabella. |
text
|
Il testo da inserire.
L'inserimento di un carattere di nuova riga creerà implicitamente un nuovo
Gli stili del testo per il testo inserito vengono determinati automaticamente, mantenendo in genere lo stile del testo vicino. Nella maggior parte dei casi, il testo verrà aggiunto
Alcuni caratteri di controllo (U+0000-U+0008, U+000C-U+001F) e caratteri dell'area a uso privato del piano multilingue di base di Unicode (U+E000-U+F8FF) verranno rimossi dal testo inserito. |
insertionIndex
|
L'indice in cui verrà inserito il testo, in unità di codice Unicode, basato su
L'indice è in base zero e viene calcolato dall'inizio della stringa. L'indice può essere modificato per impedire inserimenti all'interno dei cluster di grafema Unicode. In questi casi, il testo verrà inserito immediatamente dopo il cluster di grafeme. |
InsertTableRowsRequest
Inserisce righe in una tabella.
Rappresentazione JSON |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
Campi | |
---|---|
tableObjectId
|
La tabella in cui inserire le righe. |
cellLocation
|
La posizione della cella della tabella di riferimento da cui verranno inserite le righe. Una nuova riga verrà inserita sopra (o sotto) la riga in cui si trova la cella di riferimento. Se la cella di riferimento è unita, verrà inserita una nuova riga sopra (o sotto) la cella unita. |
insertBelow
|
Indica se inserire nuove righe sotto la posizione della cella di riferimento.
|
number
|
Il numero di righe da inserire. Massimo 20 per richiesta. |
InsertTableColumnsRequest
Inserisce colonne in una tabella.
Le altre colonne della tabella verranno ridimensionate per adattarsi alla nuova colonna.
Rappresentazione JSON |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
Campi | |
---|---|
tableObjectId
|
La tabella in cui inserire le colonne. |
cellLocation
|
La posizione della cella della tabella di riferimento da cui verranno inserite le colonne. Una nuova colonna verrà inserita a sinistra (o a destra) della colonna in cui si trova la cella di riferimento. Se la cella di riferimento è una cella unita, verrà inserita una nuova colonna a sinistra (o a destra) della cella unita. |
insertRight
|
Indica se inserire nuove colonne a destra della posizione della cella di riferimento.
|
number
|
Il numero di colonne da inserire. Massimo 20 per richiesta. |
DeleteTableRowRequest
Elimina una riga da una tabella.
Rappresentazione JSON |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
Campi | |
---|---|
tableObjectId
|
La tabella da cui eliminare le righe. |
cellLocation
|
La posizione della cella della tabella di riferimento da cui verrà eliminata una riga. La riga coperta da questa cella verrà eliminata. Se questa è una cella unita, verranno eliminate più righe. Se non rimangono righe nella tabella dopo questa eliminazione, viene eliminata l'intera tabella. |
DeleteTableColumnRequest
Elimina una colonna da una tabella.
Rappresentazione JSON |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
Campi | |
---|---|
tableObjectId
|
La tabella da cui eliminare le colonne. |
cellLocation
|
La posizione della cella della tabella di riferimento da cui verrà eliminata una colonna. La colonna coperta da questa cella verrà eliminata. Se questa è una cella unita, verranno eliminate più colonne. Se dopo questa eliminazione non rimane nessuna colonna nella tabella, viene eliminata l'intera tabella. |
ReplaceAllTextRequest
Sostituisce tutte le istanze di testo che corrispondono a un criterio con
replace text
.
Rappresentazione JSON |
---|
{ "replaceText": string, "pageObjectIds": [ string ], // Union field |
Campi | |
---|---|
replaceText
|
Il testo che sostituirà il testo corrispondente. |
pageObjectIds[]
|
Se il campo non è vuoto, limita le corrispondenze agli elementi della pagina solo nelle pagine specificate.
Restituisce un errore 400 di richiesta non valida se fornito l'ID oggetto della pagina di un
|
Campo unione
criteria . I criteri utilizzati per trovare una corrispondenza con il testo da sostituire.
criteria
può essere solo uno dei seguenti:
|
|
containsText
|
Trova il testo in una forma corrispondente a questa sottostringa. |
SubstringMatchCriteria
Un criterio che corrisponde a una stringa specifica di testo in una forma o tabella.
Rappresentazione JSON |
---|
{ "text": string, "matchCase": boolean } |
Campi | |
---|---|
text
|
Il testo da cercare nella forma o nella tabella. |
matchCase
|
Indica se la ricerca deve rispettare le maiuscole/minuscole:
|
DeleteObjectRequest
Elimina un oggetto,
pages
o
page elements
, della presentazione.
Rappresentazione JSON |
---|
{ "objectId": string } |
Campi | |
---|---|
objectId
|
L'ID oggetto della pagina o dell'elemento di pagina da eliminare.
Se, dopo un'operazione di eliminazione,
Se in un layout viene eliminato un segnaposto, vengono eliminati anche tutti i segnaposto ereditari vuoti. |
UpdatePageElementTransformRequest
Aggiorna la trasformazione di un elemento di pagina.
L'aggiornamento della trasformazione di un gruppo modificherà la trasformazione assoluta degli elementi della pagina in quel gruppo, il che può modificarne l'aspetto visivo. Consulta la documentazione per
PageElement.transform
per ulteriori dettagli.
Rappresentazione JSON |
---|
{ "objectId": string, "transform": { object ( |
Campi | |
---|---|
objectId
|
L'ID oggetto dell'elemento della pagina da aggiornare. |
transform
|
La matrice di trasformazione dell'input utilizzata per aggiornare l'elemento della pagina. |
applyMode
|
La modalità di applicazione dell'aggiornamento della trasformazione. |
ApplyMode
Le modalità di applicazione dell'aggiornamento della trasformazione.
Enum | |
---|---|
APPLY_MODE_UNSPECIFIED
|
Modalità non specificata. |
RELATIVE
|
Applica la nuova matrice AffineTransform a quella esistente e sostituisce quella esistente con la concatenazione risultante. |
ABSOLUTE
|
Sostituisce la matrice AffineTransform esistente con quella nuova. |
UpdateSlidesPositionRequest
Consente di aggiornare la posizione delle slide nella presentazione.
Rappresentazione JSON |
---|
{ "slideObjectIds": [ string ], "insertionIndex": integer } |
Campi | |
---|---|
slideObjectIds[]
|
Gli ID delle slide della presentazione da spostare. Le slide in questo elenco devono essere nell'ordine della presentazione esistente, senza duplicati. |
insertionIndex
|
L'indice in cui inserire le slide, in base alla disposizione delle slide prima che avvenga lo spostamento. Deve essere compreso tra zero e il numero di slide della presentazione (incluso). |
DeleteTextRequest
Elimina il testo da una forma o da una cella di tabella.
Rappresentazione JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
Campi | |
---|---|
objectId
|
L'ID oggetto della forma o della tabella da cui verrà eliminato il testo. |
cellLocation
|
La posizione facoltativa della cella della tabella se il testo deve essere eliminato dalla cella. Se presente, l'oggetto objectId deve fare riferimento a una tabella. |
textRange
|
L'intervallo di testo da eliminare, in base a
È sempre presente un carattere di nuova riga implicito alla fine del testo di una forma o di una cella di tabella che non può essere eliminato.
L'eliminazione di un testo che supera il limite di un paragrafo può comportare modifiche agli stili e agli elenchi dei paragrafi quando i due paragrafi vengono uniti. Gli intervalli che includono solo un'unità di codice di una coppia di surrogati vengono espansi per includere entrambe le unità di codice. |
Intervallo
Specifica un intervallo contiguo di una raccolta indicizzata, ad esempio i caratteri nel testo.
Rappresentazione JSON |
---|
{
"startIndex": integer,
"endIndex": integer,
"type": enum (
|
Campi | |
---|---|
startIndex
|
L'indice facoltativo in base zero dell'inizio della raccolta. Obbligatorio per
|
endIndex
|
L'indice facoltativo in base zero della fine della raccolta. Obbligatorio per
|
type
|
Il tipo di intervallo. |
Tipo
I tipi di intervalli.
Enum | |
---|---|
RANGE_TYPE_UNSPECIFIED
|
Tipo di intervallo non specificato. Questo valore non deve essere utilizzato. |
FIXED_RANGE
|
Un intervallo fisso. Entrambi i campi
startIndex
e
endIndex
è necessario specificare un valore.
|
FROM_START_INDEX
|
Inizia l'intervallo in
startIndex
e continua fino alla fine della raccolta. La
endIndex
non deve essere specificato.
|
ALL
|
Imposta l'intervallo in modo che corrisponda all'intera durata della raccolta. Entrambi i campi
startIndex
e ai
endIndex
non deve essere specificato.
|
CreateImageRequest
Crea un'immagine.
Rappresentazione JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
Campi | |
---|---|
objectId
|
Un ID oggetto fornito dall'utente.
Se specifichi un ID, questo deve essere univoco tra tutte le pagine e gli elementi di pagina nella presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde all'espressione regolare
Se non specifichi un ID, ne viene generato uno univoco. |
elementProperties
|
Le proprietà dell'elemento dell'immagine. Se le proporzioni delle dimensioni fornite non corrispondono a quelle dell'immagine, l'immagine viene ridimensionata e centrata rispetto alle dimensioni in modo da mantenere le proporzioni. La trasformazione fornita viene applicata dopo questa operazione.
La
La
|
Campo unione
image_source . Il tipo di origine dell'immagine.
image_source
può essere solo uno dei seguenti:
|
|
url
|
L'URL dell'immagine. L'immagine viene recuperata una volta al momento dell'inserimento e viene archiviata una copia da visualizzare all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.
L'URL fornito deve essere accessibile pubblicamente e avere una lunghezza massima di 2 kB. L'URL viene salvato con l'immagine ed esposto tramite
|
CreateVideoRequest
Crea un video.
NOTA: per creare un video da Google Drive è necessario che l'app richiedente abbia almeno uno degli ambiti OAuth drive, drive.readonly o drive.file.
Rappresentazione JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
Campi | |
---|---|
objectId
|
Un ID oggetto fornito dall'utente.
Se specifichi un ID, questo deve essere univoco tra tutte le pagine e gli elementi di pagina nella presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde all'espressione regolare
Se non specifichi un ID, ne viene generato uno univoco. |
elementProperties
|
Le proprietà degli elementi per il video.
La
La
|
source
|
L'origine del video. |
id
|
L'identificatore univoco della sorgente video per questo video. ad es. Per video di YouTube https://www.youtube.com/watch?v=7U3axjORYZ0, l'ID è 7U3axjORYZ0. Per un video di Google Drive https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q l'ID è 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q. Per accedere a un file video di Google Drive, potrebbe essere necessario aggiungere una chiave risorsa all'intestazione HTTP per un sottoinsieme di file precedenti. Per ulteriori informazioni, vedi Accedi ai file condivisi tramite link utilizzando le chiavi delle risorse. |
CreateSheetsChartRequest
Crea un grafico di Fogli Google incorporato.
NOTA: per la creazione di grafici è necessario almeno uno degli ambiti OAuth spreadsheet.readonly, spreadsheet, drive.readonly, drive.file o drive.
Rappresentazione JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
Campi | |
---|---|
objectId
|
Un ID oggetto fornito dall'utente. Se specificato, l'ID deve essere univoco tra tutte le pagine e gli elementi di pagina nella presentazione. L'ID deve iniziare con un carattere [a-zA-Z0-9_] seguito da un numero qualsiasi dei seguenti caratteri [a-zA-Z0-9_-:]. La lunghezza dell'ID non deve essere inferiore a 5 o superiore a 50. Se vuoto, verrà generato un identificatore univoco. |
elementProperties
|
Le proprietà degli elementi per il grafico. Quando le proporzioni delle dimensioni fornite non corrispondono a quelle del grafico, quest'ultimo viene ridimensionato e centrato rispetto alle dimensioni per mantenere le proporzioni. La trasformazione fornita viene applicata dopo questa operazione. |
spreadsheetId
|
L'ID del foglio di lavoro di Fogli Google che contiene il grafico. Potresti dover aggiungere una chiave risorsa all'intestazione HTTP per un sottoinsieme di file precedenti. Per ulteriori informazioni, vedi Accedi ai file condivisi tramite link utilizzando le chiavi delle risorse. |
chartId
|
L'ID del grafico specifico nel foglio di lavoro di Fogli Google. |
linkingMode
|
La modalità con cui il grafico è collegato al foglio di lavoro di origine. Se non specificato, il grafico sarà un'immagine non collegata. |
LinkingMode
La modalità con cui il grafico è collegato al foglio di lavoro di origine.
Enum | |
---|---|
NOT_LINKED_IMAGE
|
Il grafico non è associato al foglio di lavoro di origine e non può essere aggiornato. Un grafico non collegato verrà inserito come immagine. |
LINKED
|
Se colleghi il grafico, puoi aggiornarlo e gli altri collaboratori vedranno un link al foglio di lavoro. |
CreateLineRequest
Crea una linea.
Rappresentazione JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
Campi | |
---|---|
objectId
|
Un ID oggetto fornito dall'utente.
Se specifichi un ID, questo deve essere univoco tra tutte le pagine e gli elementi di pagina nella presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde all'espressione regolare
Se non specifichi un ID, ne viene generato uno univoco. |
elementProperties
|
Le proprietà dell'elemento della linea. |
lineCategory
|
La categoria della riga da creare.
Deprecato
.
: usa
L'esatto
Se specifichi sia un valore
|
category
|
La categoria della riga da creare.
L'esatto
Se specifichi sia un valore
Se non specifichi un valore per
Se non specifichi nessuna di queste due modalità,
|
Categoria
Le categorie di linee.
Enum | |
---|---|
STRAIGHT
|
Connettori dritti, incluso il connettore dritto 1. Se non è specificata, è la categoria predefinita. |
BENT
|
Connettori piegati, incluso i connettori piegati da 2 a 5. |
CURVED
|
Connettori curvi, incluso quello curvo da 2 a 5. |
RefreshSheetsChartRequest
Aggiorna un grafico di Fogli Google incorporato sostituendolo con l'ultima versione del grafico di Fogli Google.
NOTA: l'aggiornamento dei grafici richiede almeno uno degli ambiti fogli di lavoro.readonly, fogli di lavoro, drive.readonly o ambiti OAuth di Drive.
Rappresentazione JSON |
---|
{ "objectId": string } |
Campi | |
---|---|
objectId
|
L'ID oggetto del grafico da aggiornare. |
UpdateShapePropertiesRequest
Aggiorna le proprietà di un
Shape
.
Rappresentazione JSON |
---|
{
"objectId": string,
"shapeProperties": {
object (
|
Campi | |
---|---|
objectId
|
L'ID oggetto della forma a cui vengono applicati gli aggiornamenti. |
shapeProperties
|
Le proprietà della forma da aggiornare. |
fields
|
I campi che devono essere aggiornati.
È necessario specificare almeno un campo. La radice
Ad esempio, per aggiornare il colore di riempimento a tinta unita dello sfondo di forma, imposta
Per ripristinare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato. |
UpdateImagePropertiesRequest
Aggiorna le proprietà di un
Image
.
Rappresentazione JSON |
---|
{
"objectId": string,
"imageProperties": {
object (
|
Campi | |
---|---|
objectId
|
L'ID oggetto dell'immagine a cui vengono applicati gli aggiornamenti. |
imageProperties
|
Le proprietà dell'immagine da aggiornare. |
fields
|
I campi che devono essere aggiornati.
È necessario specificare almeno un campo. La radice
Ad esempio, per aggiornare il colore dei contorni dell'immagine, imposta
Per ripristinare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato. |
UpdateVideoPropertiesRequest
Aggiorna le proprietà di un
Video
.
Rappresentazione JSON |
---|
{
"objectId": string,
"videoProperties": {
object (
|
Campi | |
---|---|
objectId
|
L'ID oggetto del video a cui vengono applicati gli aggiornamenti. |
videoProperties
|
Le proprietà video da aggiornare. |
fields
|
I campi che devono essere aggiornati.
È necessario specificare almeno un campo. La radice
Ad esempio, per aggiornare il colore dei contorni del video, imposta
Per ripristinare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato. |
UpdatePagePropertiesRequest
Aggiorna le proprietà di un
Page
.
Rappresentazione JSON |
---|
{
"objectId": string,
"pageProperties": {
object (
|
Campi | |
---|---|
objectId
|
L'ID oggetto della pagina a cui viene applicato l'aggiornamento. |
pageProperties
|
Le proprietà della pagina da aggiornare. |
fields
|
I campi che devono essere aggiornati.
È necessario specificare almeno un campo. La radice
Ad esempio, per aggiornare il colore di riempimento a tinta unita dello sfondo della pagina, imposta
Per ripristinare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato. |
UpdateTableCellPropertiesRequest
Aggiorna le proprietà di un
TableCell
.
Rappresentazione JSON |
---|
{ "objectId": string, "tableRange": { object ( |
Campi | |
---|---|
objectId
|
L'ID oggetto della tabella. |
tableRange
|
L'intervallo di tabelle che rappresenta il sottoinsieme della tabella a cui vengono applicati gli aggiornamenti. Se non viene specificato un intervallo di tabella, gli aggiornamenti verranno applicati all'intera tabella. |
tableCellProperties
|
Le proprietà della cella della tabella da aggiornare. |
fields
|
I campi che devono essere aggiornati.
È necessario specificare almeno un campo. La radice
Ad esempio, per aggiornare il colore di riempimento in tinta unita
dallo sfondo delle celle di una tabella,
Per ripristinare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato. |
TableRange
Un intervallo di tabella rappresenta un riferimento a un sottoinsieme di una tabella.
È importante notare che le celle specificate da un intervallo di tabella non formano necessariamente un rettangolo. Ad esempio, supponiamo di avere una tabella 3 x 3 in cui tutte le celle dell'ultima riga sono unite insieme. La tabella ha il seguente aspetto:
[ ][ ][ ]
[ ][ ][ ]
[ ]
Un intervallo di tabella con posizione = (0, 0), intervallo di righe = 3 e intervallo di colonne = 2 specifica le celle seguenti:
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
Rappresentazione JSON |
---|
{
"location": {
object (
|
Campi | |
---|---|
location
|
La posizione iniziale dell'intervallo della tabella. |
rowSpan
|
L'intervallo di righe dell'intervallo della tabella. |
columnSpan
|
L'estensione delle colonne dell'intervallo della tabella. |
UpdateLinePropertiesRequest
Aggiorna le proprietà di un
Line
.
Rappresentazione JSON |
---|
{
"objectId": string,
"lineProperties": {
object (
|
Campi | |
---|---|
objectId
|
L'ID oggetto della riga a cui viene applicato l'aggiornamento. |
lineProperties
|
Le proprietà della riga da aggiornare. |
fields
|
I campi che devono essere aggiornati.
È necessario specificare almeno un campo. La radice
Ad esempio, per aggiornare il colore di
riempimento a tinta unita, imposta
Per reimpostare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato. |
CreateParagraphBulletsRequest
Crea elenchi puntati per tutti i paragrafi che si sovrappongono all'intervallo di indice di testo specificato.
Il livello di nidificazione di ogni paragrafo sarà determinato contando le tabulazioni iniziali prima di ogni paragrafo. Per evitare lo spazio eccessivo tra il punto elenco e il paragrafo corrispondente, queste tabulazioni iniziali vengono rimosse da questa richiesta. Gli indici di alcune parti del testo potrebbero cambiare.
Se il paragrafo subito prima dei paragrafi in fase di aggiornamento si trova in un elenco con una preimpostazione corrispondente, i paragrafi in fase di aggiornamento vengono aggiunti all'elenco precedente.
Rappresentazione JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
Campi | |
---|---|
objectId
|
L'ID oggetto della forma o della tabella contenente il testo a cui aggiungere punti elenco. |
cellLocation
|
La posizione facoltativa della cella della tabella se il testo da modificare si trova in una cella. Se presente, l'oggetto objectId deve fare riferimento a una tabella. |
textRange
|
L'intervallo di testo a cui applicare i punti predefiniti, in base a
|
bulletPreset
|
I tipi di glifi punti elenco da utilizzare. Il valore predefinito è
|
BulletGlyphPreset
Pattern preimpostati di glifi punti elenco per gli elenchi nel testo.
Questi pattern utilizzano i seguenti tipi di punti elenco:
-
ARROW
: una freccia corrispondente a un punto di codice Unicode U+2794 -
ARROW3D
: una freccia con ombreggiatura 3D, corrispondente a un punto di codice Unicode U+27a2 -
CHECKBOX
: un quadrato vuoto corrispondente a un punto codice Unicode U+274f -
CIRCLE
: un cerchio vuoto corrispondente a un punto codice Unicode U+25cb -
DIAMOND
: un rombo pieno, corrispondente a un punto codice Unicode U+25c6 -
DIAMONDX
: un rombo con una "x", corrispondente a un punto di codice Unicode U+2756 -
HOLLOWDIAMOND
: un rombo vuoto corrispondente a un punto codice Unicode U+25c7 -
DISC
: un cerchio solido corrispondente a un punto di codice Unicode U+25cf -
SQUARE
: un quadrato pieno, corrispondente a un punto codice Unicode U+25a0 -
STAR
: una stella corrispondente a un punto di codice Unicode U+2605 -
ALPHA
: una lettera minuscola, ad esempio "a", "b" o "c". -
UPPERALPHA
: una lettera maiuscola, ad esempio "A", "B" o "C". -
DIGIT
: un numero, ad esempio "1", "2" o "3". -
ZERODIGIT
: un numero in cui i numeri a una sola cifra sono preceduti da uno zero, ad esempio "01", "02" o "03". I numeri con più di una cifra non devono essere preceduti dal prefisso zero. -
ROMAN
: un numero romano minuscolo, ad esempio "i", "ii" o "iii". -
UPPERROMAN
: un numero romano maiuscolo, ad esempio "I", "II" o "III". -
LEFTTRIANGLE
: un triangolo rivolto a sinistra, corrispondente a un punto di codice Unicode U+25c4
Enum | |
---|---|
BULLET_DISC_CIRCLE_SQUARE
|
Un elenco puntato con
DISC ,
CIRCLE
e
SQUARE
glifo bullet per i primi 3 livelli di nidificazione dell'elenco.
|
BULLET_DIAMONDX_ARROW3D_SQUARE
|
Un elenco puntato con
DIAMONDX ,
ARROW3D
e
SQUARE
glifo bullet per i primi 3 livelli di nidificazione dell'elenco.
|
BULLET_CHECKBOX
|
Un elenco puntato contenente
CHECKBOX
glifi punti elenco per tutti i livelli di nidificazione degli elenchi.
|
BULLET_ARROW_DIAMOND_DISC
|
Un elenco puntato con
ARROW ,
DIAMOND
e
DISC
glifo bullet per i primi 3 livelli di nidificazione dell'elenco.
|
BULLET_STAR_CIRCLE_SQUARE
|
Un elenco puntato con
STAR ,
CIRCLE
e
SQUARE
glifo bullet per i primi 3 livelli di nidificazione dell'elenco.
|
BULLET_ARROW3D_CIRCLE_SQUARE
|
Un elenco puntato con
ARROW3D ,
CIRCLE
e
SQUARE
glifo bullet per i primi 3 livelli di nidificazione dell'elenco.
|
BULLET_LEFTTRIANGLE_DIAMOND_DISC
|
Un elenco puntato con
LEFTTRIANGLE ,
DIAMOND
e
DISC
glifo bullet per i primi 3 livelli di nidificazione dell'elenco.
|
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE
|
Un elenco puntato con
DIAMONDX ,
HOLLOWDIAMOND
e
SQUARE
glifo bullet per i primi 3 livelli di nidificazione dell'elenco.
|
BULLET_DIAMOND_CIRCLE_SQUARE
|
Un elenco puntato con
DIAMOND ,
CIRCLE
e
SQUARE
glifo bullet per i primi 3 livelli di nidificazione dell'elenco.
|
NUMBERED_DIGIT_ALPHA_ROMAN
|
Un elenco numerato con
DIGIT ,
ALPHA
e
ROMAN
i glifi numerici per i primi tre livelli di nidificazione, seguiti da punti.
|
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS
|
Un elenco numerato con
DIGIT ,
ALPHA
e
ROMAN
i glifi numerici per i primi 3 livelli di nidificazione, seguiti da parentesi.
|
NUMBERED_DIGIT_NESTED
|
Un elenco numerato con
DIGIT
glifi numerici separati da punti, dove ogni livello di nidificazione utilizza il glifo del livello di nidificazione precedente come prefisso. Ad esempio: "1.", "1.1.", "2.", "2.2."
|
NUMBERED_UPPERALPHA_ALPHA_ROMAN
|
Un elenco numerato con
UPPERALPHA ,
ALPHA
e
ROMAN
i glifi numerici per i primi tre livelli di nidificazione, seguiti da punti.
|
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT
|
Un elenco numerato con
UPPERROMAN ,
UPPERALPHA
e
DIGIT
i glifi numerici per i primi tre livelli di nidificazione, seguiti da punti.
|
NUMBERED_ZERODIGIT_ALPHA_ROMAN
|
Un elenco numerato con
ZERODIGIT ,
ALPHA
e
ROMAN
i glifi numerici per i primi tre livelli di nidificazione, seguiti da punti.
|
ReplaceAllShapesWithImageRequest
Sostituisce tutte le forme che soddisfano i criteri specificati con l'immagine fornita.
Dopo essere state inserite nella presentazione, le immagini che sostituiscono le forme sono rettangolari e non assumono le forme delle forme.
Rappresentazione JSON |
---|
{ "replaceMethod": enum ( |
Campi | |
---|---|
replaceMethod
|
Il metodo di sostituzione.
Deprecato
.
: usa
Se specifichi sia un valore
|
imageReplaceMethod
|
Il metodo di sostituzione delle immagini.
Se specifichi sia un valore
Se non specifichi un valore per
Se non specifichi nessuna delle due, viene utilizzato CENTER_INSIDE. |
pageObjectIds[]
|
Se il campo non è vuoto, limita le corrispondenze agli elementi della pagina solo nelle pagine specificate.
Restituisce un errore 400 di richiesta non valida se fornito l'ID oggetto della pagina di un
|
Campo unione
criteria . I criteri a cui le forme devono corrispondere per poter essere sostituite.
criteria
può essere solo uno dei seguenti:
|
|
containsText
|
Se impostato, questa richiesta sostituirà tutte le forme che contengono il testo specificato. |
Campo unione
image_source . Il tipo di origine dell'immagine.
image_source
può essere solo uno dei seguenti:
|
|
imageUrl
|
L'URL dell'immagine. L'immagine viene recuperata una volta al momento dell'inserimento e viene archiviata una copia da visualizzare all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.
L'URL fornito può avere una lunghezza massima di 2 kB. L'URL viene salvato con l'immagine ed esposto tramite
|
ReplaceMethod
Il metodo di sostituzione.
Enum | |
---|---|
CENTER_INSIDE
|
Ridimensiona e centra l'immagine per adattarla ai limiti della forma originale e mantiene le proporzioni dell'immagine. Le dimensioni dell'immagine sottoposte a rendering potrebbero essere inferiori a quelle della forma. Questo è il metodo predefinito quando non ne è specificato uno. |
CENTER_CROP
|
Ridimensiona e centra l'immagine per riempire i margini della forma originale. È possibile che l'immagine venga ritagliata per riempire la forma. Le dimensioni dell'immagine sottoposte a rendering saranno le stesse della forma originale. |
ImageReplaceMethod
Il metodo di sostituzione delle immagini.
Enum | |
---|---|
IMAGE_REPLACE_METHOD_UNSPECIFIED
|
Metodo di sostituzione immagine non specificato. Questo valore non deve essere utilizzato. |
CENTER_INSIDE
|
Ridimensiona e centra l'immagine per adattarla ai limiti della forma originale e mantiene le proporzioni dell'immagine. Le dimensioni dell'immagine sottoposte a rendering potrebbero essere inferiori a quelle della forma. Questo è il metodo predefinito quando non ne è specificato uno. |
CENTER_CROP
|
Ridimensiona e centra l'immagine per riempire i margini della forma originale. È possibile che l'immagine venga ritagliata per riempire la forma. Le dimensioni dell'immagine sottoposte a rendering saranno le stesse della forma originale. |
DuplicateObjectRequest
Duplica una slide o un elemento della pagina.
Quando duplichi una slide, la slide duplicata viene creata subito dopo quella specificata. Quando duplichi un elemento della pagina, il duplicato viene inserito nella stessa pagina e nella stessa posizione dell'originale.
Rappresentazione JSON |
---|
{ "objectId": string, "objectIds": { string: string, ... } } |
Campi | |
---|---|
objectId
|
L'ID dell'oggetto da duplicare. |
objectIds
|
L'oggetto duplicato potrebbe contenere altri oggetti, ad esempio durante la duplicazione di una slide o di un elemento di pagina di gruppo. Questa mappa definisce il modo in cui vengono generati gli ID degli oggetti duplicati: le chiavi sono gli ID degli oggetti originali e i loro valori sono gli ID che vengono assegnati all'oggetto duplicato corrispondente. L'ID del duplicato dell'oggetto di origine può essere specificato anche in questa mappa, utilizzando lo stesso valore del parametro
Tutte le chiavi devono corrispondere agli ID esistenti nella presentazione. Tutti i valori devono essere univoci nella presentazione e devono iniziare con un carattere alfanumerico o un trattino basso (corrisponde all'espressione regolare
Se alcuni ID degli oggetti di origine vengono omessi dalla mappa, verrà assegnato un nuovo ID casuale. Se la mappa è vuota o se non viene impostata, tutti gli oggetti duplicati riceveranno un nuovo ID casuale. |
UpdateTextStyleRequest
Rappresentazione JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
Campi | |
---|---|
objectId
|
L'ID oggetto della forma o della tabella con il testo a cui applicare lo stile. |
cellLocation
|
La posizione della cella nella tabella contenente il testo di cui applicare uno stile. Se
|
style
|
Gli stili da impostare per il testo. Se il valore di un particolare stile corrisponde a quello dell'elemento principale, quello stile verrà impostato in modo da ereditare.
Alcune modifiche allo stile del testo potrebbero causare altre modifiche volte a rispecchiare il comportamento dell'editor di Presentazioni. Visualizza la documentazione di
|
textRange
|
L'intervallo di testo a cui applicare uno stile. L'intervallo può essere esteso per includere nuove righe adiacenti. Se l'intervallo contiene interamente un paragrafo appartenente a un elenco, il punto elenco del paragrafo viene aggiornato con lo stile di testo corrispondente. |
fields
|
I campi che devono essere aggiornati.
È necessario specificare almeno un campo. La radice
Ad esempio, per aggiornare lo stile del testo in grassetto, imposta
Per reimpostare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato. |
ReplaceAllShapesWithSheetsChartRequest
Sostituisce tutte le forme che corrispondono ai criteri specificati con il grafico di Fogli Google fornito. Il grafico verrà ridimensionato e centrato per adattarsi ai limiti della forma originale.
NOTA: per sostituire le forme con un grafico, è necessario almeno uno degli ambiti Chromebooks.readonly, spreadsheet, drive.readonly o drive OAuth.
Rappresentazione JSON |
---|
{ "containsText": { object ( |
Campi | |
---|---|
containsText
|
I criteri a cui le forme devono corrispondere per poter essere sostituite. La richiesta sostituirà tutte le forme che contengono il testo specificato. |
spreadsheetId
|
L'ID del foglio di lavoro di Fogli Google che contiene il grafico. |
chartId
|
L'ID del grafico specifico nel foglio di lavoro di Fogli Google. |
linkingMode
|
La modalità con cui il grafico è collegato al foglio di lavoro di origine. Se non specificato, il grafico sarà un'immagine non collegata. |
pageObjectIds[]
|
Se il campo non è vuoto, limita le corrispondenze agli elementi della pagina solo nelle pagine specificate.
Restituisce un errore 400 di richiesta non valida se fornito l'ID oggetto della pagina di un
|
LinkingMode
La modalità con cui il grafico è collegato al foglio di lavoro di origine.
Enum | |
---|---|
NOT_LINKED_IMAGE
|
Il grafico non è associato al foglio di lavoro di origine e non può essere aggiornato. Un grafico non collegato verrà inserito come immagine. |
LINKED
|
Se colleghi il grafico, puoi aggiornarlo e gli altri collaboratori vedranno un link al foglio di lavoro. |
DeleteParagraphBulletsRequest
Elimina punti elenco da tutti i paragrafi che si sovrappongono all'indice di testo specificato
range
.
Il livello di annidamento di ogni paragrafo verrà mantenuto visivamente aggiungendo un rientro all'inizio del paragrafo corrispondente.
Rappresentazione JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
Campi | |
---|---|
objectId
|
L'ID oggetto della forma o della tabella contenente il testo da cui eliminare i punti elenco. |
cellLocation
|
La posizione facoltativa della cella della tabella se il testo da modificare si trova in una cella. Se presente, l'oggetto objectId deve fare riferimento a una tabella. |
textRange
|
L'intervallo di testo da cui eliminare un elenco puntato, in base a
|
UpdateParagraphStyleRequest
Aggiorna lo stile di tutti i paragrafi in un
Shape
o
Table
che si sovrappongono all'intervallo di indice di testo specificato.
Rappresentazione JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
Campi | |
---|---|
objectId
|
L'ID oggetto della forma o della tabella con il testo a cui applicare lo stile. |
cellLocation
|
La posizione della cella nella tabella contenente i paragrafi da applicare a uno stile. Se
|
style
|
Lo stile del paragrafo. |
textRange
|
L'intervallo di testo contenente i paragrafi da applicare allo stile. |
fields
|
I campi che devono essere aggiornati.
È necessario specificare almeno un campo. La radice
Ad esempio, per aggiornare l'allineamento del paragrafo, imposta
Per reimpostare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato. |
UpdateTableBorderPropertiesRequest
Aggiorna le proprietà dei bordi della tabella in un
Table
.
Rappresentazione JSON |
---|
{ "objectId": string, "tableRange": { object ( |
Campi | |
---|---|
objectId
|
L'ID oggetto della tabella. |
tableRange
|
L'intervallo di tabelle che rappresenta il sottoinsieme della tabella a cui vengono applicati gli aggiornamenti. Se non viene specificato un intervallo di tabella, gli aggiornamenti verranno applicati all'intera tabella. |
borderPosition
|
La posizione del bordo nell'intervallo di tabella a cui devono essere applicati gli aggiornamenti. Se non viene specificata una posizione del bordo, gli aggiornamenti verranno applicati a tutti i bordi nell'intervallo della tabella. |
tableBorderProperties
|
Le proprietà dei bordi della tabella da aggiornare. |
fields
|
I campi che devono essere aggiornati.
È necessario specificare almeno un campo. La radice
Ad esempio, per aggiornare il colore di riempimento in tinta unita del bordo della tabella,
Per reimpostare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato. |
BorderPosition
La posizione del bordo della tabella.
Enum | |
---|---|
ALL
|
Tutti i bordi nell'intervallo. |
BOTTOM
|
Bordi nella parte inferiore dell'intervallo. |
INNER
|
Bordi all'interno dell'intervallo. |
INNER_HORIZONTAL
|
Bordi orizzontali all'interno dell'intervallo. |
INNER_VERTICAL
|
Bordi verticali all'interno dell'intervallo. |
LEFT
|
Bordi a sinistra dell'intervallo. |
OUTER
|
Bordi lungo l'esterno dell'intervallo. |
RIGHT
|
Bordi a destra dell'intervallo. |
TOP
|
Bordi nella parte superiore dell'intervallo. |
UpdateTableColumnPropertiesRequest
Aggiorna le proprietà di un
Table
colonna.
Rappresentazione JSON |
---|
{
"objectId": string,
"columnIndices": [
integer
],
"tableColumnProperties": {
object (
|
Campi | |
---|---|
objectId
|
L'ID oggetto della tabella. |
columnIndices[]
|
L'elenco di indici a base zero che specifica quali colonne aggiornare. Se non vengono forniti indici, tutte le colonne della tabella verranno aggiornate. |
tableColumnProperties
|
Le proprietà della colonna della tabella da aggiornare.
Se il valore
|
fields
|
I campi che devono essere aggiornati.
È necessario specificare almeno un campo. La radice
Ad esempio, per aggiornare la larghezza delle colonne, imposta
Se "columnwidth"' è incluso nella maschera del campo ma la proprietà non viene impostata, la larghezza della colonna verrà impostata su 406.400 EMU (32 punti). |
UpdateTableRowPropertiesRequest
Aggiorna le proprietà di un
Table
riga di comando.
Rappresentazione JSON |
---|
{
"objectId": string,
"rowIndices": [
integer
],
"tableRowProperties": {
object (
|
Campi | |
---|---|
objectId
|
L'ID oggetto della tabella. |
rowIndices[]
|
L'elenco di indici a base zero che specifica quali righe aggiornare. Se non vengono forniti indici, tutte le righe della tabella verranno aggiornate. |
tableRowProperties
|
Le proprietà delle righe della tabella da aggiornare. |
fields
|
I campi che devono essere aggiornati.
È necessario specificare almeno un campo. La radice
Ad esempio, per aggiornare l'altezza minima della riga, imposta
Se "minRowHeight"' è incluso nella maschera del campo ma la proprietà non è impostata, l'altezza minima della riga viene impostata su 0 per impostazione predefinita. |
MergeTableCellsRequest
Unisce le celle in un
Table
.
Rappresentazione JSON |
---|
{
"objectId": string,
"tableRange": {
object (
|
Campi | |
---|---|
objectId
|
L'ID oggetto della tabella. |
tableRange
|
L'intervallo di tabella che specifica quali celle della tabella unire. Il testo nelle celle che vengono unite verrà concatenato e archiviato nella cella in alto a sinistra ("head") dell'intervallo. Se l'intervallo non è rettangolare (cosa che può verificarsi in alcuni casi in cui l'intervallo copre celle già unite), viene restituito un errore di richiesta non valida 400. |
UnmergeTableCellsRequest
Divide le celle in un
Table
.
Rappresentazione JSON |
---|
{
"objectId": string,
"tableRange": {
object (
|
Campi | |
---|---|
objectId
|
L'ID oggetto della tabella. |
tableRange
|
L'intervallo di tabella che specifica quali celle della tabella dividere. Tutte le celle unite in questo intervallo verranno divise e le celle già separate non saranno interessate. Se l'intervallo non ha celle unite, la richiesta non produce alcun effetto. Se è presente del testo in una delle celle unite, questo rimarrà nella cella in alto a sinistra ("head") del blocco risultante di celle non unite. |
GroupObjectsRequest
Raggruppa gli oggetti per creare un gruppo di oggetti. Ad esempio, i gruppi
PageElements
per creare un
Group
sulla stessa pagina di tutti i publisher secondari.
Rappresentazione JSON |
---|
{ "groupObjectId": string, "childrenObjectIds": [ string ] } |
Campi | |
---|---|
groupObjectId
|
Un ID oggetto fornito dall'utente per il gruppo da creare.
Se specifichi un ID, questo deve essere univoco tra tutte le pagine e gli elementi di pagina nella presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde all'espressione regolare
Se non specifichi un ID, ne viene generato uno univoco. |
childrenObjectIds[]
|
Gli ID degli oggetti da raggruppare.
Solo gli elementi della pagina possono essere raggruppati. La stessa pagina deve contenere almeno due elementi che non si trovano già in un altro gruppo. Alcuni elementi della pagina, ad esempio
|
UngroupObjectsRequest
Separa gli oggetti, ad esempio
groups
.
Rappresentazione JSON |
---|
{ "objectIds": [ string ] } |
Campi | |
---|---|
objectIds[]
|
Gli ID degli oggetti da separare.
Solo
|
UpdatePageElementAltTextRequest
Aggiorna il titolo del testo alternativo e/o la descrizione di un
page element
.
Rappresentazione JSON |
---|
{ "objectId": string, "title": string, "description": string } |
Campi | |
---|---|
objectId
|
L'ID oggetto dell'elemento della pagina a cui vengono applicati gli aggiornamenti. |
title
|
Il titolo del testo alternativo aggiornato dell'elemento della pagina. Se il criterio non viene configurato, il valore esistente verrà mantenuto. Il titolo è esposto agli screen reader e ad altre interfacce di accessibilità. Utilizza solo valori leggibili relativi ai contenuti dell'elemento della pagina. |
description
|
La descrizione del testo alternativo aggiornata dell'elemento della pagina. Se il criterio non viene configurato, il valore esistente verrà mantenuto. La descrizione è esposta a screen reader e ad altre interfacce di accessibilità. Utilizza solo valori leggibili relativi ai contenuti dell'elemento della pagina. |
ReplaceImageRequest
Sostituisce un'immagine esistente con una nuova.
La sostituzione di un'immagine ne comporta la rimozione
image effects
dall'immagine esistente.
Rappresentazione JSON |
---|
{ "imageObjectId": string, "imageReplaceMethod": enum ( |
Campi | |
---|---|
imageObjectId
|
L'ID dell'immagine esistente che verrà sostituita. L'ID può essere recuperato dalla risposta di una richiesta get. |
imageReplaceMethod
|
Il metodo di sostituzione. |
Campo unione
image_source . Il tipo di origine dell'immagine.
image_source
può essere solo uno dei seguenti:
|
|
url
|
L'URL dell'immagine. L'immagine viene recuperata una volta al momento dell'inserimento e viene archiviata una copia da visualizzare all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non più di 25 megapixel e devono essere in formato PNG, JPEG o GIF.
L'URL fornito non può superare i 2 kB. L'URL viene salvato con l'immagine ed esposto tramite
|
UpdateSlidePropertiesRequest
Aggiorna le proprietà di una slide.
Rappresentazione JSON |
---|
{
"objectId": string,
"slideProperties": {
object (
|
Campi | |
---|---|
objectId
|
L'ID oggetto della slide a cui viene applicato l'aggiornamento. |
slideProperties
|
Le proprietà della slide da aggiornare. |
fields
|
I campi che devono essere aggiornati.
È necessario specificare almeno un campo. La directory principale "slideProperties" è implicito e non deve essere specificato. Un singolo
Ad esempio, per aggiornare se una slide viene saltata, imposta
Per reimpostare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato. |
UpdatePageElementsZOrderRequest
Consente di aggiornare l'ordine Z degli elementi di pagina. L'ordine Z è un ordine degli elementi della pagina dal retro verso il lato anteriore. L'elemento della pagina nella parte anteriore potrebbe coprire gli elementi sottostanti.
Rappresentazione JSON |
---|
{
"pageElementObjectIds": [
string
],
"operation": enum (
|
Campi | |
---|---|
pageElementObjectIds[]
|
Gli ID oggetto degli elementi della pagina da aggiornare. Tutti gli elementi della pagina devono trovarsi sulla stessa pagina e non devono essere raggruppati. |
operation
|
L'operazione di ordinamento Z da applicare agli elementi della pagina. Quando l'operazione viene applicata su più elementi della pagina, l'ordine Z relativo all'interno di questi elementi della pagina viene mantenuto. |
ZOrderOperation
L'operazione per aggiornare l'ordine Z di un elemento di pagina.
Enum | |
---|---|
Z_ORDER_OPERATION_UNSPECIFIED
|
Operazione non specificata. |
BRING_TO_FRONT
|
Porta gli elementi della pagina in primo piano. |
BRING_FORWARD
|
Porta gli elementi in avanti nella pagina di un elemento rispetto a quello più avanti negli elementi della pagina specificati. |
SEND_BACKWARD
|
Invia gli elementi della pagina indietro sulla pagina di un elemento rispetto a quello più lontano a uno negli elementi della pagina specificati. |
SEND_TO_BACK
|
Invia gli elementi della pagina in fondo alla pagina. |
UpdateLineCategoryRequest
Aggiorna la categoria di un
line
.
Rappresentazione JSON |
---|
{
"objectId": string,
"lineCategory": enum (
|
Campi | |
---|---|
objectId
|
L'ID oggetto della riga a cui viene applicato l'aggiornamento.
Solo una riga con un
La linea può essere reindirizzata dopo l'aggiornamento della categoria. |
lineCategory
|
La categoria della linea da utilizzare per l'aggiornamento.
L'esatto
|
RerouteLineRequest
Reindirizza un
line
in modo che sia collegato ai due siti di connessione più vicini negli elementi della pagina collegati.
Rappresentazione JSON |
---|
{ "objectId": string } |
Campi | |
---|---|
objectId
|
L'ID oggetto della linea da reindirizzare.
Solo una riga con un
|