Richiesta
Un singolo aggiornamento da applicare a un documento.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
request . La richiesta specifica da applicare. È richiesto esattamente un campo.
request
può essere solo uno dei seguenti:
|
|
replaceAllText
|
Sostituisce tutte le istanze del testo specificato. |
insertText
|
Inserisce il testo nella posizione specificata. |
updateTextStyle
|
Consente di aggiornare lo stile del testo nell'intervallo specificato. |
createParagraphBullets
|
Crea elenchi puntati per i paragrafi. |
deleteParagraphBullets
|
Elimina i punti elenco dai paragrafi. |
createNamedRange
|
Crea un intervallo denominato. |
deleteNamedRange
|
Elimina un intervallo denominato. |
updateParagraphStyle
|
Aggiorna lo stile del paragrafo nell'intervallo specificato. |
deleteContentRange
|
Elimina i contenuti dal documento. |
insertInlineImage
|
Inserisce un'immagine in linea nella posizione specificata. |
insertTable
|
Inserisce una tabella nella posizione specificata. |
insertTableRow
|
Inserisce una riga vuota in una tabella. |
insertTableColumn
|
Inserisce una colonna vuota in una tabella. |
deleteTableRow
|
Elimina una riga da una tabella. |
deleteTableColumn
|
Elimina una colonna da una tabella. |
insertPageBreak
|
Inserisce un'interruzione di pagina nella posizione specificata. |
deletePositionedObject
|
Elimina un oggetto posizionato dal documento. |
updateTableColumnProperties
|
Aggiorna le proprietà delle colonne in una tabella. |
updateTableCellStyle
|
Aggiorna lo stile delle celle della tabella. |
updateTableRowStyle
|
Aggiorna lo stile della riga in una tabella. |
replaceImage
|
Sostituisce un'immagine nel documento. |
updateDocumentStyle
|
Aggiorna lo stile del documento. |
mergeTableCells
|
Unisce le celle in una tabella. |
unmergeTableCells
|
Divide le celle in una tabella. |
createHeader
|
Crea un'intestazione. |
createFooter
|
Crea un piè di pagina. |
createFootnote
|
Crea una nota a piè di pagina. |
replaceNamedRangeContent
|
Sostituisce i contenuti in un intervallo denominato. |
updateSectionStyle
|
Aggiorna lo stile della sezione dell'intervallo specificato. |
insertSectionBreak
|
Inserisce un'interruzione di sezione nella posizione specificata. |
deleteHeader
|
Elimina un'intestazione dal documento. |
deleteFooter
|
Elimina un piè di pagina dal documento. |
pinTableHeaderRows
|
Consente di aggiornare il numero di righe di intestazione bloccate in una tabella. |
ReplaceAllTextRequest
Sostituisce tutte le istanze di testo che corrispondono a un criterio con
replace text
.
Rappresentazione JSON |
---|
{ "replaceText": string, "tabsCriteria": { object ( |
Campi | |
---|---|
replaceText
|
Il testo che sostituirà il testo corrispondente. |
tabsCriteria
|
(Facoltativo) I criteri utilizzati per specificare in quali schede avviene la sostituzione. Se omesso, la sostituzione viene applicata a tutte le schede. In un documento contenente una sola scheda:
In un documento contenente più schede:
|
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 nel documento corrispondente a questa sottostringa. |
SubstringMatchCriteria
Un criterio che corrisponde a una stringa specifica di testo nel documento.
Rappresentazione JSON |
---|
{ "text": string, "matchCase": boolean } |
Campi | |
---|---|
text
|
Il testo da cercare nel documento. |
matchCase
|
Indica se la ricerca deve rispettare le maiuscole/minuscole:
|
TabsCriteria
Un criterio che specifica in quali schede viene eseguita una richiesta.
Rappresentazione JSON |
---|
{ "tabIds": [ string ] } |
Campi | |
---|---|
tabIds[]
|
L'elenco di ID scheda in cui viene eseguita la richiesta. |
InsertTextRequest
Inserisce il testo nella posizione specificata.
Rappresentazione JSON |
---|
{ "text": string, // Union field |
Campi | |
---|---|
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, lo stile del testo inserito corrisponde a quello immediatamente prima dell'indice di inserimento. 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. |
Campo unione
insertion_location . La posizione in cui verrà inserito il testo.
insertion_location
può essere solo uno dei seguenti:
|
|
location
|
Inserisce il testo in un indice specifico nel documento.
Il testo deve essere inserito entro i limiti di un file di testo esistente
|
endOfSegmentLocation
|
Inserisce il testo alla fine di un'intestazione, un piè di pagina, una nota a piè di pagina o il corpo del documento. |
Località
Una particolare posizione nel documento.
Rappresentazione JSON |
---|
{ "segmentId": string, "index": integer, "tabId": string } |
Campi | |
---|---|
segmentId
|
L'ID dell'intestazione, del piè di pagina o della nota a piè di pagina in cui si trova la posizione. Un ID segmento vuoto indica il corpo del documento. |
index
|
L'indice su base zero, in unità di codice UTF-16.
L'indice è relativo all'inizio del segmento specificato
|
tabId
|
La scheda in cui si trova la sede. Se omesso, la richiesta viene applicata alla prima scheda. In un documento contenente una sola scheda:
In un documento contenente più schede:
|
EndOfSegmentLocation
Posizione alla fine di un corpo, un'intestazione, un piè di pagina o una nota a piè di pagina. La posizione è immediatamente prima dell'ultima nuova riga nel segmento del documento.
Rappresentazione JSON |
---|
{ "segmentId": string, "tabId": string } |
Campi | |
---|---|
segmentId
|
L'ID dell'intestazione, del piè di pagina o della nota a piè di pagina in cui si trova la posizione. Un ID segmento vuoto indica il corpo del documento. |
tabId
|
La scheda in cui si trova la sede. Se omesso, la richiesta viene applicata alla prima scheda. In un documento contenente una sola scheda:
In un documento contenente più schede:
|
UpdateTextStyleRequest
Aggiorna lo stile del testo.
Rappresentazione JSON |
---|
{ "textStyle": { object ( |
Campi | |
---|---|
textStyle
|
Gli stili da impostare sul 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 al fine di rispecchiare il comportamento dell'editor di documenti. Visualizza la documentazione di
|
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 ripristinare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato. |
Campo unione
insertion_location . Il tipo di intervallo utilizzato per l'aggiornamento dello stile del testo.
insertion_location
può essere solo uno dei seguenti:
|
|
range
|
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. Gli intervalli non possono essere inseriti all'interno di una UpdateTextStyleRequest relativa. |
CreateParagraphBulletsRequest
Crea elenchi puntati per tutti i paragrafi che si sovrappongono all'intervallo 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 |
---|
{ "range": { object ( |
Campi | |
---|---|
range
|
L'intervallo a cui applicare il preset dei punti. |
bulletPreset
|
I tipi di glifi punti elenco da utilizzare. |
BulletGlyphPreset
Pattern preimpostati di glifi punti elenco per gli elenchi.
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". -
DECIMAL
: un numero, ad esempio "1", "2" o "3". -
ZERODECIMAL
: 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_GLYPH_PRESET_UNSPECIFIED
|
Il preset del glifo dei punti non è specificato. |
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_DECIMAL_ALPHA_ROMAN
|
Un elenco numerato con
DECIMAL ,
ALPHA
e
ROMAN
i glifi numerici per i primi tre livelli di nidificazione, seguiti da punti.
|
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS
|
Un elenco numerato con
DECIMAL ,
ALPHA
e
ROMAN
i glifi numerici per i primi 3 livelli di nidificazione, seguiti da parentesi.
|
NUMBERED_DECIMAL_NESTED
|
Un elenco numerato con
DECIMAL
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_DECIMAL
|
Un elenco numerato con
UPPERROMAN ,
UPPERALPHA
e
DECIMAL
i glifi numerici per i primi tre livelli di nidificazione, seguiti da punti.
|
NUMBERED_ZERODECIMAL_ALPHA_ROMAN
|
Un elenco numerato con
ZERODECIMAL ,
ALPHA
e
ROMAN
i glifi numerici per i primi tre livelli di nidificazione, seguiti da punti.
|
DeleteParagraphBulletsRequest
Elimina i punti elenco da tutti i paragrafi che si sovrappongono all'intervallo specificato.
Il livello di annidamento di ogni paragrafo verrà mantenuto visivamente aggiungendo un rientro all'inizio del paragrafo corrispondente.
Rappresentazione JSON |
---|
{
"range": {
object (
|
Campi | |
---|---|
range
|
L'intervallo da cui eliminare i punti elenco. |
CreateNamedRangeRequest
Crea un
NamedRange
che fa riferimento all'intervallo specificato.
Rappresentazione JSON |
---|
{
"name": string,
"range": {
object (
|
Campi | |
---|---|
name
|
Il nome di NamedRange. Non è necessario che i nomi siano univoci. I nomi devono contenere da 1 a 256 caratteri, misurati in unità di codice UTF-16. |
range
|
L'intervallo a cui applicare il nome. |
DeleteNamedRangeRequest
Elimina un
NamedRange
.
Rappresentazione JSON |
---|
{ "tabsCriteria": { object ( |
Campi | |
---|---|
tabsCriteria
|
(Facoltativo) I criteri utilizzati per specificare in quali schede deve avvenire l'eliminazione dell'intervallo. Se omesso, l'eliminazione dell'intervallo viene applicata a tutte le schede. In un documento contenente una sola scheda:
In un documento contenente più schede:
|
Campo unione
named_range_reference . Il valore che determina l'intervallo o gli intervalli da eliminare. Deve essere impostato in modo esatto.
named_range_reference
può essere solo uno dei seguenti:
|
|
namedRangeId
|
L'ID dell'intervallo denominato da eliminare. |
name
|
Il nome dell'intervallo o degli intervalli da eliminare. Tutti gli intervalli denominati con il nome specificato verranno eliminati. |
UpdateParagraphStyleRequest
Aggiorna lo stile di tutti i paragrafi che si sovrappongono all'intervallo specificato.
Rappresentazione JSON |
---|
{ "paragraphStyle": { object ( |
Campi | |
---|---|
paragraphStyle
|
Gli stili da impostare nei paragrafi.
Alcune modifiche allo stile del paragrafo potrebbero causare altre modifiche al fine di rispecchiare il comportamento dell'editor di documenti. Visualizza la documentazione di
|
fields
|
I campi che devono essere aggiornati.
È necessario specificare almeno un campo. La radice
Ad esempio, per aggiornare la proprietà di allineamento dello stile di paragrafo, imposta
Per reimpostare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato. |
Campo unione
insertion_location . Il tipo di intervallo utilizzato per aggiornare lo stile del paragrafo.
insertion_location
può essere solo uno dei seguenti:
|
|
range
|
L'intervallo che si sovrappone ai paragrafi di cui applicare uno stile. |
DeleteContentRangeRequest
Elimina i contenuti dal documento.
Rappresentazione JSON |
---|
{
"range": {
object (
|
Campi | |
---|---|
range
|
L'intervallo di contenuti da eliminare. L'eliminazione di un testo che supera il limite di un paragrafo può comportare modifiche agli stili del paragrafo, agli elenchi, agli oggetti posizionati e ai segnalibri man mano che i due paragrafi vengono uniti. Il tentativo di eliminare determinati intervalli può causare una struttura del documento non valida. In tal caso, viene restituito un errore di richiesta 400 non valido. Ecco alcuni esempi di richieste di eliminazione non valide:
|
InsertInlineImageRequest
Inserisce un
InlineObject
contenente un'immagine nella posizione specificata.
Rappresentazione JSON |
---|
{ "uri": string, "objectSize": { object ( |
Campi | |
---|---|
uri
|
L'URI dell'immagine. L'immagine viene recuperata una volta al momento dell'inserimento e viene archiviata una copia per la visualizzazione all'interno del documento. 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'URI fornito deve essere accessibile pubblicamente e avere una lunghezza massima di 2 kB. L'URI viene salvato con l'immagine ed esposto tramite
|
objectSize
|
Le dimensioni in cui l'immagine dovrebbe apparire nel documento. Questa proprietà è facoltativa e le dimensioni finali dell'immagine nel documento sono determinate dalle seguenti regole: * Se non vengono specificate né la larghezza né l'altezza, viene calcolata una dimensione predefinita dell'immagine in base alla sua risoluzione. * Se viene specificata una dimensione, l'altra viene calcolata in modo da mantenere le proporzioni dell'immagine. * Se vengono specificate sia la larghezza che l'altezza, l'immagine viene ridimensionata per adattarsi alle dimensioni fornite mantenendo le proporzioni. |
Campo unione
insertion_location . La posizione in cui verrà inserita l'immagine.
insertion_location
può essere solo uno dei seguenti:
|
|
location
|
Inserisce l'immagine in un indice specifico nel documento.
L'immagine deve essere inserita all'interno dei limiti di un modello esistente
Le immagini in linea non possono essere inserite all'interno di una nota a piè di pagina o di un'equazione. |
endOfSegmentLocation
|
Inserisce il testo alla fine di un'intestazione, un piè di pagina o il corpo del documento. Le immagini in linea non possono essere inserite all'interno di una nota a piè di pagina. |
InsertTableRequest
Inserisce una tabella nella posizione specificata.
Verrà inserito un carattere di nuova riga prima della tabella inserita.
Rappresentazione JSON |
---|
{ "rows": integer, "columns": integer, // Union field |
Campi | |
---|---|
rows
|
Il numero di righe nella tabella. |
columns
|
Il numero di colonne nella tabella. |
Campo unione
insertion_location . La posizione in cui verrà inserita la tabella.
insertion_location
può essere solo uno dei seguenti:
|
|
location
|
Inserisce la tabella in corrispondenza dell'indice di un modello specifico. Verrà inserito un carattere di nuova riga prima della tabella inserita, pertanto l'indice iniziale della tabella si troverà nell'indice della località specificato + 1.
La tabella deve essere inserita all'interno dei limiti di una tabella
Le tabelle non possono essere inserite all'interno di una nota a piè di pagina o di un'equazione. |
endOfSegmentLocation
|
Inserisce la tabella alla fine dell'intestazione, del piè di pagina o del corpo del documento specificati. Verrà inserito un carattere di nuova riga prima della tabella inserita. Impossibile inserire le tabelle all'interno di una nota a piè di pagina. |
InsertTableRowRequest
Inserisce una riga vuota in una tabella.
Rappresentazione JSON |
---|
{
"tableCellLocation": {
object (
|
Campi | |
---|---|
tableCellLocation
|
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 una nuova riga sotto la posizione della cella di riferimento.
|
TableCellLocation
Posizione di una singola cella all'interno di una tabella.
Rappresentazione JSON |
---|
{
"tableStartLocation": {
object (
|
Campi | |
---|---|
tableStartLocation
|
La posizione in cui inizia la tabella nel documento. |
rowIndex
|
L'indice di riga in base zero. Ad esempio, la seconda riga della tabella ha un indice di riga pari a 1. |
columnIndex
|
L'indice della colonna in base zero. Ad esempio, la seconda colonna della tabella ha un indice di colonna pari a 1. |
InsertTableColumnRequest
Inserisce una colonna vuota in una tabella.
Rappresentazione JSON |
---|
{
"tableCellLocation": {
object (
|
Campi | |
---|---|
tableCellLocation
|
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 una nuova colonna a destra della posizione della cella di riferimento.
|
DeleteTableRowRequest
Elimina una riga da una tabella.
Rappresentazione JSON |
---|
{
"tableCellLocation": {
object (
|
Campi | |
---|---|
tableCellLocation
|
La posizione della cella della tabella di riferimento da cui verrà eliminata la riga. La riga coperta da questa cella verrà eliminata. Se si tratta di una cella unita che comprende più righe, verranno eliminate tutte le righe coperte dalla cella. Se non rimangono righe nella tabella dopo questa eliminazione, viene eliminata l'intera tabella. |
DeleteTableColumnRequest
Elimina una colonna da una tabella.
Rappresentazione JSON |
---|
{
"tableCellLocation": {
object (
|
Campi | |
---|---|
tableCellLocation
|
La posizione della cella della tabella di riferimento da cui verrà eliminata la colonna. La colonna coperta da questa cella verrà eliminata. Se si tratta di una cella unita che si estende su più colonne, verranno eliminate tutte le colonne coperte dalla cella. Se dopo questa eliminazione non rimane nessuna colonna nella tabella, viene eliminata l'intera tabella. |
InsertPageBreakRequest
Inserisce un'interruzione di pagina seguita da una nuova riga nella posizione specificata.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
insertion_location . La posizione in cui verrà inserita l'interruzione di pagina.
insertion_location
può essere solo uno dei seguenti:
|
|
location
|
Inserisce l'interruzione di pagina in corrispondenza di un indice specifico nel documento.
L'interruzione di pagina deve essere inserita all'interno dei limiti di una
Le interruzioni di pagina non possono essere inserite all'interno di una tabella, un'equazione, una nota a piè di pagina, un'intestazione o un piè di pagina. Poiché le interruzioni di pagina possono essere inserite solo all'interno del corpo,
|
endOfSegmentLocation
|
Inserisce l'interruzione di pagina alla fine del corpo del documento.
Le interruzioni di pagina non possono essere inserite all'interno di una nota a piè di pagina, un'intestazione o un piè di pagina. Poiché le interruzioni di pagina possono essere inserite solo all'interno del corpo,
|
DeletePositionedObjectRequest
Elimina un
PositionedObject
dal documento.
Rappresentazione JSON |
---|
{ "objectId": string, "tabId": string } |
Campi | |
---|---|
objectId
|
L'ID dell'oggetto posizionato da eliminare. |
tabId
|
La scheda in cui si trova l'oggetto posizionato da eliminare. Se omesso, la richiesta viene applicata alla prima scheda. In un documento contenente una sola scheda:
In un documento contenente più schede:
|
UpdateTableColumnPropertiesRequest
Aggiorna il
TableColumnProperties
di colonne in una tabella.
Rappresentazione JSON |
---|
{ "tableStartLocation": { object ( |
Campi | |
---|---|
tableStartLocation
|
La posizione in cui inizia la tabella nel documento. |
columnIndices[]
|
L'elenco di indici delle colonne su base zero la cui proprietà deve essere aggiornata. Se non vengono specificati indici, tutte le colonne 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
|
UpdateTableCellStyleRequest
Aggiorna lo stile di un intervallo di celle della tabella.
Rappresentazione JSON |
---|
{ "tableCellStyle": { object ( |
Campi | |
---|---|
tableCellStyle
|
Lo stile da impostare nelle celle della tabella. Quando si aggiornano i bordi, se una cella condivide un bordo con una cella adiacente, viene aggiornata anche la proprietà del bordo corrispondente della cella adiacente. I bordi uniti e invisibili non vengono aggiornati. Poiché l'aggiornamento di un bordo condiviso da celle adiacenti nella stessa richiesta può causare aggiornamenti in conflitto dei bordi, gli aggiornamenti dei bordi vengono applicati nel seguente ordine:
|
fields
|
I campi che devono essere aggiornati.
È necessario specificare almeno un campo. La radice
Ad esempio, per aggiornare il colore di 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. |
Campo unione
cells . Le celle che verranno aggiornate.
cells
può essere solo uno dei seguenti:
|
|
tableRange
|
L'intervallo di tabelle che rappresenta il sottoinsieme della tabella a cui vengono applicati gli aggiornamenti. |
tableStartLocation
|
La posizione in cui inizia la tabella nel documento. Se specificato, gli aggiornamenti vengono applicati a tutte le celle della tabella. |
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 della cella della tabella = (tableStartLocation, riga = 0, colonna = 0), intervallo di righe = 3 e intervallo di colonne = 2 specifica le seguenti celle:
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
Rappresentazione JSON |
---|
{
"tableCellLocation": {
object (
|
Campi | |
---|---|
tableCellLocation
|
La posizione della cella in cui inizia l'intervallo di tabella. |
rowSpan
|
L'intervallo di righe dell'intervallo della tabella. |
columnSpan
|
L'estensione delle colonne dell'intervallo della tabella. |
UpdateTableRowStyleRequest
Aggiorna il
TableRowStyle
di righe in una tabella.
Rappresentazione JSON |
---|
{ "tableStartLocation": { object ( |
Campi | |
---|---|
tableStartLocation
|
La posizione in cui inizia la tabella nel documento. |
rowIndices[]
|
L'elenco di indici di riga con base zero il cui stile dovrebbe essere aggiornato. Se non vengono specificati indici, verranno aggiornate tutte le righe. |
tableRowStyle
|
Gli stili da impostare nelle righe. |
fields
|
I campi che devono essere aggiornati.
È necessario specificare almeno un campo. La radice
Ad esempio, per aggiornare l'altezza minima della riga, imposta
|
ReplaceImageRequest
Sostituisce un'immagine esistente con una nuova.
La sostituzione di un'immagine ne comporta la rimozione
image effects
dall'immagine esistente per rispecchiare il comportamento dell'editor di documenti.
Rappresentazione JSON |
---|
{
"imageObjectId": string,
"uri": string,
"imageReplaceMethod": enum (
|
Campi | |
---|---|
imageObjectId
|
L'ID dell'immagine esistente che verrà sostituita. L'ID può essere recuperato dalla risposta di una richiesta get. |
uri
|
L'URI della nuova immagine. L'immagine viene recuperata una volta al momento dell'inserimento e viene archiviata una copia per la visualizzazione all'interno del documento. Le immagini devono avere dimensioni inferiori a 50 MB, non più di 25 megapixel e devono essere in formato PNG, JPEG o GIF.
L'URI fornito non può superare i 2 kB. L'URI viene salvato con l'immagine ed esposto tramite
|
imageReplaceMethod
|
Il metodo di sostituzione. |
tabId
|
La scheda in cui si trova l'immagine da sostituire. Se omesso, la richiesta viene applicata alla prima scheda. In un documento contenente una sola scheda:
In un documento contenente più schede:
|
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_CROP
|
Ridimensiona e centra l'immagine per riempire i limiti dell'immagine originale. L'immagine potrebbe essere ritagliata per riempire i limiti dell'immagine originale. Le dimensioni dell'immagine sottoposta a rendering saranno le stesse dell'immagine originale. |
UpdateDocumentStyleRequest
Aggiorna il
DocumentStyle
.
Rappresentazione JSON |
---|
{
"documentStyle": {
object (
|
Campi | |
---|---|
documentStyle
|
Gli stili da impostare nel documento.
Alcune modifiche allo stile del documento potrebbero causare altre modifiche al fine di rispecchiare il comportamento dell'editor di documenti. Visualizza la documentazione di
|
fields
|
I campi che devono essere aggiornati.
È necessario specificare almeno un campo. La radice
Ad esempio, per aggiornare lo sfondo, imposta
|
tabId
|
La scheda che contiene lo stile da aggiornare. Se omesso, la richiesta si applica alla prima scheda. In un documento contenente una sola scheda:
In un documento contenente più schede:
|
MergeTableCellsRequest
Unisce le celle in un
Table
.
Rappresentazione JSON |
---|
{
"tableRange": {
object (
|
Campi | |
---|---|
tableRange
|
L'intervallo di tabella che specifica quali celle della tabella unire. Il testo nelle celle che vengono unite verrà concatenato e archiviato nella sezione "head" cella dell'intervallo. Questa è la cella in alto a sinistra dell'intervallo quando la direzione dei contenuti è da sinistra a destra, altrimenti la cella in alto a destra dell'intervallo. Se l'intervallo non è rettangolare (il che può verificarsi in alcuni casi in cui l'intervallo copre celle già unite o dove la tabella non è rettangolare), viene restituito un errore di richiesta non valida 400. |
UnmergeTableCellsRequest
Divide le celle in un
Table
.
Rappresentazione JSON |
---|
{
"tableRange": {
object (
|
Campi | |
---|---|
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, il testo rimarrà nella sezione "head" cella del blocco di celle non unite risultante. La "testa" è la cella in alto a sinistra quando la direzione dei contenuti va da sinistra a destra e l'angolo in alto a destra negli altri casi. |
CreateHeaderRequest
Crea un
Header
. La nuova intestazione viene applicata
SectionStyle
nella posizione
SectionBreak
se specificato, altrimenti viene applicato
DocumentStyle
.
Se esiste già un'intestazione del tipo specificato, viene restituito un errore di richiesta errata 400.
Rappresentazione JSON |
---|
{ "type": enum ( |
Campi | |
---|---|
type
|
Il tipo di intestazione da creare. |
sectionBreakLocation
|
La posizione
|
CreateFootnoteRequest
Crea un
Footnote
e inserisce un nuovo
FootnoteReference
nella posizione specificata.
Il nuovo
Footnote
conterrà uno spazio seguito da un carattere di nuova riga.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
footnote_reference_location . La posizione in cui inserire il riferimento della nota a piè di pagina.
footnote_reference_location
può essere solo uno dei seguenti:
|
|
location
|
Inserisce il riferimento a nota a piè di pagina in un indice specifico del documento.
Il riferimento a nota a piè di pagina deve essere inserito all'interno dei limiti di una nota esistente
I riferimenti a nota a piè di pagina non possono essere inseriti all'interno di un'equazione, un'intestazione, un piè di pagina o una nota a piè di pagina. Poiché i riferimenti a nota a piè di pagina possono essere inseriti solo nel corpo,
|
endOfSegmentLocation
|
Inserisce il riferimento alla nota a piè di pagina alla fine del corpo del documento.
I riferimenti a nota a piè di pagina non possono essere inseriti all'interno di un'intestazione, un piè di pagina o una nota a piè di pagina. Poiché i riferimenti a nota a piè di pagina possono essere inseriti solo nel corpo,
|
ReplaceNamedRangeContentRequest
Sostituisce i contenuti del valore
NamedRange
o
NamedRanges
con i contenuti sostitutivi forniti.
Tieni presente che una persona
NamedRange
può essere costituito da più parti
ranges
. In questo caso, verranno sostituiti solo i contenuti nel primo intervallo. Gli altri intervalli e i relativi contenuti verranno eliminati.
Nei casi in cui la sostituzione o l'eliminazione di intervalli comporti una struttura del documento non valida, viene restituito un errore di richiesta errata 400.
Rappresentazione JSON |
---|
{ "tabsCriteria": { object ( |
Campi | |
---|---|
tabsCriteria
|
(Facoltativo) I criteri utilizzati per specificare in quali schede avviene la sostituzione. Se omesso, la sostituzione viene applicata a tutte le schede. In un documento contenente una sola scheda:
In un documento contenente più schede:
|
Campo unione
replacement_content . I contenuti con cui sostituire quelli esistenti nell'intervallo denominato.
replacement_content
può essere solo uno dei seguenti:
|
|
text
|
Sostituisce il contenuto dell'intervallo o degli intervalli denominati specificati con il testo specificato. |
Campo unione
named_range_reference . Un riferimento agli intervalli denominati i cui contenuti verranno sostituiti.
named_range_reference
può essere solo uno dei seguenti:
|
|
namedRangeId
|
L'ID dell'intervallo denominato il cui contenuto verrà sostituito. Se non è presente un intervallo denominato con l'ID specificato, viene restituito un errore di richiesta errata 400. |
namedRangeName
|
Il nome del
Se ci sono più parametri
|
UpdateSectionStyleRequest
Aggiorna il
SectionStyle
.
Rappresentazione JSON |
---|
{ "range": { object ( |
Campi | |
---|---|
range
|
L'intervallo che si sovrappone alle sezioni da applicare.
Poiché le interruzioni di sezione possono essere inserite solo all'interno del corpo,
|
sectionStyle
|
Gli stili da impostare nella sezione.
Alcune modifiche allo stile della sezione potrebbero causare altre modifiche al fine di rispecchiare il comportamento dell'editor di documenti. Visualizza la documentazione di
|
fields
|
I campi che devono essere aggiornati.
È necessario specificare almeno un campo. La radice
Ad esempio, per aggiornare il margine sinistro, imposta
|
InsertSectionBreakRequest
Inserisce un'interruzione di sezione nella posizione specificata.
Verrà inserito un carattere di nuova riga prima dell'interruzione di sezione.
Rappresentazione JSON |
---|
{ "sectionType": enum ( |
Campi | |
---|---|
sectionType
|
Il tipo di sezione da inserire. |
Campo unione
insertion_location . La posizione in cui verrà inserita l'interruzione.
insertion_location
può essere solo uno dei seguenti:
|
|
location
|
Inserisce una nuova riga e un'interruzione di sezione in corrispondenza di un indice specifico nel documento.
L'interruzione di sezione deve essere inserita all'interno dei limiti di un modello esistente
Le interruzioni di sezione non possono essere inserite all'interno di una tabella, un'equazione, una nota a piè di pagina, un'intestazione o un piè di pagina. Poiché le interruzioni di sezione possono essere inserite solo all'interno del corpo,
|
endOfSegmentLocation
|
Inserisce una nuova riga e un'interruzione di sezione alla fine del corpo del documento.
Le interruzioni di sezione non possono essere inserite all'interno di una nota a piè di pagina, un'intestazione o un piè di pagina. Poiché le interruzioni di sezione possono essere inserite solo all'interno del corpo,
|
DeleteHeaderRequest
Elimina un
Header
dal documento.
Rappresentazione JSON |
---|
{ "headerId": string, "tabId": string } |
Campi | |
---|---|
headerId
|
L'ID dell'intestazione da eliminare. Se questa intestazione è definita
|
tabId
|
La scheda contenente l'intestazione da eliminare. Se omesso, la richiesta viene applicata alla prima scheda. In un documento contenente una sola scheda:
In un documento contenente più schede:
|
PinTableHeaderRowsRequest
Consente di aggiornare il numero di righe di intestazione della tabella fissate in una tabella.
Rappresentazione JSON |
---|
{
"tableStartLocation": {
object (
|
Campi | |
---|---|
tableStartLocation
|
La posizione in cui inizia la tabella nel documento. |
pinnedHeaderRowsCount
|
Il numero di righe della tabella da bloccare, dove 0 indica che tutte le righe sono sbloccate. |