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
|
Consente di inserire del testo nella posizione specificata. |
updateTextStyle
|
Aggiorna lo stile di 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 di paragrafo nell'intervallo specificato. |
deleteContentRange
|
Consente di eliminare 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
|
Consente di eliminare una colonna da una tabella. |
insertPageBreak
|
Inserisce un'interruzione di pagina nella posizione specificata. |
deletePositionedObject
|
Consente di eliminare 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 di una tabella. |
unmergeTableCells
|
Separa le celle di 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
|
Consente di eliminare un'intestazione dal documento. |
deleteFooter
|
Elimina un piè di pagina dal documento. |
pinTableHeaderRows
|
Aggiorna 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 che contiene 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 nel documento il testo corrispondente a questa sottostringa. |
SubstringMatchCriteria
Un criterio che corrisponde a una stringa di testo specifica nel documento.
Rappresentazione JSON |
---|
{ "text": string, "matchCase": boolean } |
Campi | |
---|---|
text
|
Il testo da cercare nel documento. |
matchCase
|
Indica se la ricerca deve rispettare la maiuscola:
|
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 di testo per il testo inserito verranno determinati automaticamente, generalmente mantenendo gli stili del testo adiacente. 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 i caratteri dell'area di uso privato del piano multilingue di base 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, di un piè di pagina, di una nota a piè di pagina o del corpo del documento. |
Località
Una determinata 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 a partire da zero, in unità di codice UTF-16.
L'indice è relativo all'inizio del segmento specificato
|
tabId
|
La scheda in cui si trova la stazione di ricarica. Se omessa, la richiesta viene applicata alla prima scheda. In un documento contenente una singola 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 stazione di ricarica. Se omesso, la richiesta viene applicata alla prima scheda. In un documento contenente una singola 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, quest'ultimo verrà impostato per ereditare.
Alcune modifiche allo stile del testo potrebbero causare altre modifiche che rispecchino il comportamento dell'editor di documenti. Per ulteriori informazioni, consulta 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 in cui verrà aggiornato lo stile di 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 completamente un paragrafo appartenente a un elenco, anche 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 di ogni paragrafo. Per evitare spazi eccessivi 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 immediatamente precedente a quelli in fase di aggiornamento è 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 di 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 diamante 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 pieno, corrispondente a un punto di codice Unicode U+25cf -
SQUARE
: un quadrato pieno, corrispondente a un punto di 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 cifra sono preceduti da uno zero, ad esempio "01", "02" o "03". I numeri con più di una cifra non hanno un 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 verso 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 con glifos di punti elenco
CHECKBOX
per tutti i livelli di nidificazione dell'elenco.
|
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 un carattere di punteggiatura corrispondente a un punto elenco
STAR ,
CIRCLE
e
SQUARE
per i primi 3 livelli di annidamento dell'elenco.
|
BULLET_ARROW3D_CIRCLE_SQUARE
|
Un elenco puntato con un carattere di punteggiatura corrispondente a un punto elenco
ARROW3D ,
CIRCLE
e
SQUARE
per i primi 3 livelli di annidamento dell'elenco.
|
BULLET_LEFTTRIANGLE_DIAMOND_DISC
|
Un elenco puntato con un carattere di punteggiatura corrispondente a un punto elenco
LEFTTRIANGLE ,
DIAMOND
e
DISC
per i primi 3 livelli di annidamento dell'elenco.
|
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE
|
Un elenco puntato con un carattere di segni di spunta
DIAMONDX ,
HOLLOWDIAMOND
e
SQUARE
per i primi 3 livelli di annidamento 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 gli glifi numerici DECIMAL , ALPHA e ROMAN per i primi 3 livelli di annidamento dell'elenco, 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 gli glifi numerici UPPERALPHA , ALPHA e ROMAN per i primi 3 livelli di nidificazione dell'elenco, seguiti da punti.
|
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL
|
Un elenco numerato con gli glifi numerici UPPERROMAN , UPPERALPHA e DECIMAL per i primi 3 livelli di nidificazione dell'elenco, 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.
|
DeleteParagraphBulletsRequests
Consente di eliminare i numeri 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 numeri. |
CreateNamedRangeRequest
Crea un
NamedRange
che fa riferimento all'intervallo specificato.
Rappresentazione JSON |
---|
{
"name": string,
"range": {
object (
|
Campi | |
---|---|
name
|
Il nome dell'intervallo denominato. I nomi non devono essere univoci. I nomi devono essere composti da almeno 1 e non più di 256 caratteri, misurati in unità di codice UTF-16. |
range
|
L'intervallo a cui applicare il nome. |
DeleteNamedRangeRequest
Consente di eliminare 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 che contiene 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. È necessario impostarne uno solo.
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 in cui verrà aggiornato lo stile di paragrafo.
insertion_location
può essere solo uno dei seguenti:
|
|
range
|
L'intervallo che si sovrappone ai paragrafi da stilare. |
DeleteContentRangeRequest
Elimina i contenuti dal documento.
Rappresentazione JSON |
---|
{
"range": {
object (
|
Campi | |
---|---|
range
|
L'intervallo di contenuti da eliminare. L'eliminazione di testo che attraversa il confine di un paragrafo può comportare modifiche agli stili di paragrafo, agli elenchi, agli oggetti posizionati e ai segnalibri durante l'unione dei due paragrafi. Il tentativo di eliminare determinati intervalli può comportare una struttura del documento non valida, nel qual caso viene restituito un errore di richiesta non valida (400). 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 una copia viene archiviata 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 stesso viene salvato con l'immagine ed esposto tramite il
|
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é larghezza né 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 in modo da 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, di un piè di pagina o del 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 un indice del modello specifico. Prima della tabella inserita verrà inserito un carattere di a capo, pertanto l'indice di inizio della tabella sarà pari all'indice di posizione specificato + 1.
La tabella deve essere inserita nei limiti di un Le tabelle non possono essere inserite in una nota a piè di pagina o in un'equazione. |
endOfSegmentLocation
|
Inserisce la tabella alla fine dell'intestazione, del piè di pagina o del corpo del documento specificato. Prima della tabella inserita verrà inserito un carattere di nuova riga. 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. Viene inserita una nuova riga sopra (o sotto) la riga in cui si trova la cella di riferimento. Se la cella di riferimento è una cella unita, viene 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 a partire da 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 la nuova colonna a destra della posizione della cella di riferimento.
|
DeleteTableRowRequest
Consente di eliminare 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 che occupa questa cella verrà eliminata. Se si tratta di una cella unita che si estende su più colonne, verranno eliminate tutte le colonne interessate. Se dopo questa eliminazione non rimangono colonne nella tabella, l'intera tabella viene eliminata. |
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 un indice specifico del 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, di un'equazione, di una nota a piè di pagina, di un'intestazione o di un piè di pagina. Poiché le interruzioni di pagina possono essere inserite solo all'interno del corpo, il campo
|
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, il campo
|
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 omessa, la richiesta viene applicata alla prima scheda. In un documento contenente una singola scheda:
In un documento contenente più schede:
|
UpdateTableColumnPropertiesRequest
Aggiorna il valore TableColumnProperties
delle colonne di una tabella.
Rappresentazione JSON |
---|
{ "tableStartLocation": { object ( |
Campi | |
---|---|
tableStartLocation
|
La posizione in cui inizia la tabella nel documento. |
columnIndices[]
|
L'elenco degli indici di colonna a partire da zero la cui proprietà deve essere aggiornata. Se non vengono specificati indici, verranno aggiornate tutte le colonne. |
tableColumnProperties
|
Le proprietà delle colonne 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 di una tabella.
Rappresentazione JSON |
---|
{ "tableCellStyle": { object ( |
Campi | |
---|---|
tableCellStyle
|
Lo stile da impostare nelle celle della tabella. Quando aggiorni 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 reimpostare 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 di tabelle 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. 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 della tabella. |
rowSpan
|
L'intervallo di righe dell'intervallo della tabella. |
columnSpan
|
L'intervallo di colonne dell'intervallo della tabella. |
UpdateTableRowStyleRequest
Aggiorna il valore
TableRowStyle
delle righe in una tabella.
Rappresentazione JSON |
---|
{ "tableStartLocation": { object ( |
Campi | |
---|---|
tableStartLocation
|
La posizione in cui inizia la tabella nel documento. |
rowIndices[]
|
L'elenco degli indici di riga a partire da zero di cui deve essere aggiornato lo stile. Se non vengono specificati indici, verranno aggiornate tutte le righe. |
tableRowStyle
|
Gli stili da impostare sulle 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 possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.
L'URI fornito non può superare i 2 KB di lunghezza. 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 singola 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
|
Scala e centra l'immagine in modo che riempia i limiti dell'immagine originale. L'immagine potrebbe essere ritagliata per riempire i limiti dell'immagine originale. Le dimensioni dell'immagine visualizzata saranno le stesse dell'immagine originale. |
UpdateDocumentStyleRequest
Aggiorna DocumentStyle
.
Rappresentazione JSON |
---|
{
"documentStyle": {
object (
|
Campi | |
---|---|
documentStyle
|
Gli stili da impostare nel documento.
Alcune modifiche allo stile del documento potrebbero causare altre modifiche per 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 omessa, la richiesta si applica alla prima scheda. In un documento che contiene 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 tabelle che specifica le celle della tabella da unire. Il testo nelle celle che vengono unite verrà concatenato e archiviato nella sezione "head" cella dell'intervallo. Si tratta della cella in alto a sinistra dell'intervallo se la direzione dei contenuti è da sinistra a destra e della cella in alto a destra dell'intervallo in caso contrario. Se l'intervallo non è rettangolare (il che può verificarsi in alcuni casi in cui l'intervallo copra celle già unite o in cui 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 tabelle che specifica le celle della tabella da annullare l'unione. Tutte le celle unite in questo intervallo verranno separate e le celle già separate non saranno interessate. Se l'intervallo non contiene celle unite, la richiesta non avrà alcun effetto. Se una delle celle unite contiene del testo, questo rimarrà nella cella "testa" del blocco risultante di celle non unite. 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 del
|
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 alla 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 un
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 alle note a piè di pagina possono essere inseriti solo nel corpo, il
campo |
endOfSegmentLocation
|
Inserisce il riferimento alla nota a piè di pagina alla fine del corpo del documento.
I riferimenti alle note a piè di pagina non possono essere inseriti all'interno di un'intestazione, di un piè di pagina o di 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
NamedRange
o
NamedRanges
specificato con i contenuti di sostituzione specificati.
Tieni presente che un singolo
NamedRange
può essere costituito da più
ranges
discontinui. 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 400 non valido.
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 che contiene una sola scheda:
In un documento contenente più schede:
|
Campo unione
replacement_content . I contenuti con cui sostituire i contenuti esistenti dell'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 esiste un intervallo denominato con l'ID specificato, viene restituito un errore di richiesta non valida (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 stilare.
Poiché le interruzioni di sezione possono essere inserite solo all'interno del corpo, il campo
|
sectionStyle
|
Gli stili da impostare nella sezione.
Alcune modifiche allo stile della sezione potrebbero causare altre modifiche per 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.
Prima dell'interruzione di sezione verrà inserito un carattere di a capo.
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 un a capo e un'interruzione di sezione in un indice specifico del 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, di un'equazione, di una nota a piè di pagina, di un'intestazione o di un piè di pagina. Poiché le interruzioni di sezione possono essere inserite solo all'interno del corpo, il
|
endOfSegmentLocation
|
Inserisce una nuova riga e un a capo 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, di un'intestazione o di un piè di pagina. Poiché le interruzioni di sezione possono essere inserite solo all'interno del corpo, il campo
|
DeleteHeaderRequest
Elimina un
Header
dal documento.
Rappresentazione JSON |
---|
{ "headerId": string, "tabId": string } |
Campi | |
---|---|
headerId
|
L'ID dell'intestazione da eliminare. Se questa intestazione è definita su
|
tabId
|
La scheda contenente l'intestazione da eliminare. Se omessa, la richiesta viene applicata alla prima scheda. In un documento contenente una singola scheda:
In un documento contenente più schede:
|
PinTableHeaderRowsRequest
Aggiorna il numero di righe di intestazione della tabella bloccate in una tabella.
Rappresentazione JSON |
---|
{
"tableStartLocation": {
object (
|
Campi | |
---|---|
tableStartLocation
|
La posizione in cui inizia la tabella nel documento. |
pinnedHeaderRowsCount
|
Il numero di righe di tabella da bloccare, dove 0 implica che tutte le righe non sono bloccate. |