Requests

Richiesta

Un singolo aggiornamento da applicare a un documento.

Rappresentazione JSON
{

  // Union field request can be only one of the following:
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "createNamedRange": {
    object (CreateNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "deleteContentRange": {
    object (DeleteContentRangeRequest)
  },
  "insertInlineImage": {
    object (InsertInlineImageRequest)
  },
  "insertTable": {
    object (InsertTableRequest)
  },
  "insertTableRow": {
    object (InsertTableRowRequest)
  },
  "insertTableColumn": {
    object (InsertTableColumnRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "insertPageBreak": {
    object (InsertPageBreakRequest)
  },
  "deletePositionedObject": {
    object (DeletePositionedObjectRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableCellStyle": {
    object (UpdateTableCellStyleRequest)
  },
  "updateTableRowStyle": {
    object (UpdateTableRowStyleRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateDocumentStyle": {
    object (UpdateDocumentStyleRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "createHeader": {
    object (CreateHeaderRequest)
  },
  "createFooter": {
    object (CreateFooterRequest)
  },
  "createFootnote": {
    object (CreateFootnoteRequest)
  },
  "replaceNamedRangeContent": {
    object (ReplaceNamedRangeContentRequest)
  },
  "updateSectionStyle": {
    object (UpdateSectionStyleRequest)
  },
  "insertSectionBreak": {
    object (InsertSectionBreakRequest)
  },
  "deleteHeader": {
    object (DeleteHeaderRequest)
  },
  "deleteFooter": {
    object (DeleteFooterRequest)
  },
  "pinTableHeaderRows": {
    object (PinTableHeaderRowsRequest)
  }
  // End of list of possible types for union field request.
}
Campi
Campo unione request. La richiesta specifica da applicare. È richiesto esattamente un campo. request può essere solo uno dei seguenti:
replaceAllText

object (ReplaceAllTextRequest)

Sostituisce tutte le istanze del testo specificato.

insertText

object (InsertTextRequest)

Inserisce il testo nella posizione specificata.

updateTextStyle

object (UpdateTextStyleRequest)

Consente di aggiornare lo stile del testo nell'intervallo specificato.

createParagraphBullets

object (CreateParagraphBulletsRequest)

Crea elenchi puntati per i paragrafi.

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Elimina i punti elenco dai paragrafi.

createNamedRange

object (CreateNamedRangeRequest)

Crea un intervallo denominato.

deleteNamedRange

object (DeleteNamedRangeRequest)

Elimina un intervallo denominato.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

Aggiorna lo stile del paragrafo nell'intervallo specificato.

deleteContentRange

object (DeleteContentRangeRequest)

Elimina i contenuti dal documento.

insertInlineImage

object (InsertInlineImageRequest)

Inserisce un'immagine in linea nella posizione specificata.

insertTable

object (InsertTableRequest)

Inserisce una tabella nella posizione specificata.

insertTableRow

object (InsertTableRowRequest)

Inserisce una riga vuota in una tabella.

insertTableColumn

object (InsertTableColumnRequest)

Inserisce una colonna vuota in una tabella.

deleteTableRow

object (DeleteTableRowRequest)

Elimina una riga da una tabella.

deleteTableColumn

object (DeleteTableColumnRequest)

Elimina una colonna da una tabella.

insertPageBreak

object (InsertPageBreakRequest)

Inserisce un'interruzione di pagina nella posizione specificata.

deletePositionedObject

object (DeletePositionedObjectRequest)

Elimina un oggetto posizionato dal documento.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Aggiorna le proprietà delle colonne in una tabella.

updateTableCellStyle

object (UpdateTableCellStyleRequest)

Aggiorna lo stile delle celle della tabella.

updateTableRowStyle

object (UpdateTableRowStyleRequest)

Aggiorna lo stile della riga in una tabella.

replaceImage

object (ReplaceImageRequest)

Sostituisce un'immagine nel documento.

updateDocumentStyle

object (UpdateDocumentStyleRequest)

Aggiorna lo stile del documento.

mergeTableCells

object (MergeTableCellsRequest)

Unisce le celle in una tabella.

unmergeTableCells

object (UnmergeTableCellsRequest)

Divide le celle in una tabella.

createHeader

object (CreateHeaderRequest)

Crea un'intestazione.

createFootnote

object (CreateFootnoteRequest)

Crea una nota a piè di pagina.

replaceNamedRangeContent

object (ReplaceNamedRangeContentRequest)

Sostituisce i contenuti in un intervallo denominato.

updateSectionStyle

object (UpdateSectionStyleRequest)

Aggiorna lo stile della sezione dell'intervallo specificato.

insertSectionBreak

object (InsertSectionBreakRequest)

Inserisce un'interruzione di sezione nella posizione specificata.

deleteHeader

object (DeleteHeaderRequest)

Elimina un'intestazione dal documento.

pinTableHeaderRows

object (PinTableHeaderRowsRequest)

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 (TabsCriteria)
  },

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.
}
Campi
replaceText

string

Il testo che sostituirà il testo corrispondente.

tabsCriteria

object (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:

  • Se fornito, deve corrispondere all'ID della tabulazione singolare.

  • Se omesso, la sostituzione viene applicata alla tabulazione singolare.

In un documento contenente più schede:

  • Se fornito, la sostituzione si applica alle schede specificate.

  • Se omesso, la sostituzione viene applicata a tutte le schede.

Campo unione criteria. I criteri utilizzati per trovare una corrispondenza con il testo da sostituire. criteria può essere solo uno dei seguenti:
containsText

object (SubstringMatchCriteria)

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

string

Il testo da cercare nel documento.

matchCase

boolean

Indica se la ricerca deve rispettare le maiuscole/minuscole:

  • True : la ricerca è sensibile alle maiuscole.
  • False : la ricerca non fa distinzione tra maiuscole e minuscole.

TabsCriteria

Un criterio che specifica in quali schede viene eseguita una richiesta.

Rappresentazione JSON
{
  "tabIds": [
    string
  ]
}
Campi
tabIds[]

string

L'elenco di ID scheda in cui viene eseguita la richiesta.

InsertTextRequest

Inserisce il testo nella posizione specificata.

Rappresentazione JSON
{
  "text": string,

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
Campi
text

string

Il testo da inserire.

L'inserimento di un carattere di nuova riga creerà implicitamente un nuovo Paragraph a quell'indice. Lo stile del paragrafo del nuovo paragrafo verrà copiato dal paragrafo nell'indice di inserimento corrente, inclusi elenchi e punti elenco.

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

object (Location)

Inserisce il testo in un indice specifico nel documento.

Il testo deve essere inserito entro i limiti di un file di testo esistente Paragraph. Ad esempio, il testo non può essere inserito all'indice iniziale di una tabella (ovvero tra la tabella e il paragrafo precedente). Il testo deve essere inserito nel paragrafo precedente.

endOfSegmentLocation

object (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

string

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

integer

L'indice su base zero, in unità di codice UTF-16.

L'indice è relativo all'inizio del segmento specificato segmentId.

tabId

string

La scheda in cui si trova la sede. Se omesso, la richiesta viene applicata alla prima scheda.

In un documento contenente una sola scheda:

  • Se fornito, deve corrispondere all'ID della tabulazione singolare.

  • Se omesso, la richiesta si applica alla scheda singola.

In un documento contenente più schede:

  • Se fornita, la richiesta si applica alla scheda specificata.

  • Se omesso, la richiesta si applica alla prima scheda del documento.

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

string

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

string

La scheda in cui si trova la sede. Se omesso, la richiesta viene applicata alla prima scheda.

In un documento contenente una sola scheda:

  • Se fornito, deve corrispondere all'ID della tabulazione singolare.

  • Se omesso, la richiesta si applica alla scheda singola.

In un documento contenente più schede:

  • Se fornita, la richiesta si applica alla scheda specificata.

  • Se omesso, la richiesta si applica alla prima scheda del documento.

UpdateTextStyleRequest

Aggiorna lo stile del testo.

Rappresentazione JSON
{
  "textStyle": {
    object (TextStyle)
  },
  "fields": string,

  // Union field insertion_location can be only one of the following:
  "range": {
    object (Range)
  }
  // End of list of possible types for union field insertion_location.
}
Campi
textStyle

object (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 TextStyle per ulteriori informazioni.

fields

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice textStyle è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare lo stile del testo in grassetto, imposta fields a "bold".

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

object (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 (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
Campi
range

object (Range)

L'intervallo a cui applicare il preset dei punti.

bulletPreset

enum (BulletGlyphPreset)

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 (Range)
  }
}
Campi
range

object (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 (Range)
  }
}
Campi
name

string

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

object (Range)

L'intervallo a cui applicare il nome.

DeleteNamedRangeRequest

Elimina un NamedRange.

Rappresentazione JSON
{
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "name": string
  // End of list of possible types for union field named_range_reference.
}
Campi
tabsCriteria

object (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:

  • Se fornito, deve corrispondere all'ID della tabulazione singolare.

  • Se omesso, l'eliminazione dell'intervallo si applica alla tabulazione singolare.

In un documento contenente più schede:

  • Se fornito, l'eliminazione dell'intervallo si applica alle schede specificate.

  • Se non viene specificato, l'eliminazione dell'intervallo viene applicata a tutte le 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

string

L'ID dell'intervallo denominato da eliminare.

name

string

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 (ParagraphStyle)
  },
  "fields": string,

  // Union field insertion_location can be only one of the following:
  "range": {
    object (Range)
  }
  // End of list of possible types for union field insertion_location.
}
Campi
paragraphStyle

object (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 ParagraphStyle per ulteriori informazioni.

fields

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice paragraphStyle è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare la proprietà di allineamento dello stile di paragrafo, imposta fields a "alignment".

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

object (Range)

L'intervallo che si sovrappone ai paragrafi di cui applicare uno stile.

DeleteContentRangeRequest

Elimina i contenuti dal documento.

Rappresentazione JSON
{
  "range": {
    object (Range)
  }
}
Campi
range

object (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:

  • Eliminazione di un'unità di codice di una coppia di surrogati.
  • L'eliminazione dell'ultimo carattere di nuova riga di un Body, Header, Footer, Footnote, TableCell o TableOfContents,
  • L'eliminazione dell'inizio o della fine di un Table, TableOfContents o Equation senza eliminare l'intero elemento.
  • Eliminando il carattere di nuova riga prima di un Table, TableOfContents o SectionBreak senza eliminare l'elemento.
  • Eliminazione di singole righe o celle di una tabella. È consentito eliminare il contenuto all'interno di una cella di tabella.

InsertInlineImageRequest

Inserisce un InlineObject contenente un'immagine nella posizione specificata.

Rappresentazione JSON
{
  "uri": string,
  "objectSize": {
    object (Size)
  },

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
Campi
uri

string

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 ImageProperties.content_uri .

objectSize

object (Size)

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

object (Location)

Inserisce l'immagine in un indice specifico nel documento.

L'immagine deve essere inserita all'interno dei limiti di un modello esistente Paragraph. Ad esempio, non può essere inserito all'indice iniziale di una tabella (ovvero tra la tabella e il paragrafo precedente).

Le immagini in linea non possono essere inserite all'interno di una nota a piè di pagina o di un'equazione.

endOfSegmentLocation

object (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 insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
Campi
rows

integer

Il numero di righe nella tabella.

columns

integer

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

object (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 Paragraph. Ad esempio, non può essere inserito all'indice iniziale di una tabella (ovvero tra una tabella esistente e il paragrafo precedente).

Le tabelle non possono essere inserite all'interno di una nota a piè di pagina o di un'equazione.

endOfSegmentLocation

object (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 (TableCellLocation)
  },
  "insertBelow": boolean
}
Campi
tableCellLocation

object (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

boolean

Indica se inserire una nuova riga sotto la posizione della cella di riferimento.

  • True : inserisci sotto la cella.
  • False : inserisci sopra la cella.

TableCellLocation

Posizione di una singola cella all'interno di una tabella.

Rappresentazione JSON
{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndex": integer,
  "columnIndex": integer
}
Campi
tableStartLocation

object (Location)

La posizione in cui inizia la tabella nel documento.

rowIndex

integer

L'indice di riga in base zero. Ad esempio, la seconda riga della tabella ha un indice di riga pari a 1.

columnIndex

integer

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 (TableCellLocation)
  },
  "insertRight": boolean
}
Campi
tableCellLocation

object (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

boolean

Indica se inserire una nuova colonna a destra della posizione della cella di riferimento.

  • True : inserisci a destra.
  • False : inserisci a sinistra.

DeleteTableRowRequest

Elimina una riga da una tabella.

Rappresentazione JSON
{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}
Campi
tableCellLocation

object (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 (TableCellLocation)
  }
}
Campi
tableCellLocation

object (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 insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
Campi
Campo unione insertion_location. La posizione in cui verrà inserita l'interruzione di pagina. insertion_location può essere solo uno dei seguenti:
location

object (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 Paragraph. Ad esempio, non può essere inserito all'indice iniziale di una tabella (ovvero tra la tabella e il paragrafo precedente).

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, segment ID deve essere vuoto.

endOfSegmentLocation

object (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, segment ID deve essere vuoto.

DeletePositionedObjectRequest

Elimina un PositionedObject dal documento.

Rappresentazione JSON
{
  "objectId": string,
  "tabId": string
}
Campi
objectId

string

L'ID dell'oggetto posizionato da eliminare.

tabId

string

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:

  • Se fornito, deve corrispondere all'ID della tabulazione singolare.

  • Se omesso, la richiesta si applica alla scheda singola.

In un documento contenente più schede:

  • Se fornita, la richiesta si applica alla scheda specificata.

  • Se omesso, la richiesta si applica alla prima scheda del documento.

UpdateTableColumnPropertiesRequest

Aggiorna il TableColumnProperties di colonne in una tabella.

Rappresentazione JSON
{
  "tableStartLocation": {
    object (Location)
  },
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
Campi
tableStartLocation

object (Location)

La posizione in cui inizia la tabella nel documento.

columnIndices[]

integer

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

object (TableColumnProperties)

Le proprietà della colonna della tabella da aggiornare.

Se il valore tableColumnProperties#width è inferiore a 5 punti (5/72 di pollice), viene restituito un errore di richiesta errata 400.

fields

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice tableColumnProperties è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare la larghezza delle colonne, imposta fields a "width".

UpdateTableCellStyleRequest

Aggiorna lo stile di un intervallo di celle della tabella.

Rappresentazione JSON
{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "fields": string,

  // Union field cells can be only one of the following:
  "tableRange": {
    object (TableRange)
  },
  "tableStartLocation": {
    object (Location)
  }
  // End of list of possible types for union field cells.
}
Campi
tableCellStyle

object (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:

  • borderRight
  • borderLeft
  • borderBottom
  • borderTop
fields

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice tableCellStyle è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare il colore di sfondo delle celle di una tabella, fields a "backgroundColor".

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

object (TableRange)

L'intervallo di tabelle che rappresenta il sottoinsieme della tabella a cui vengono applicati gli aggiornamenti.

tableStartLocation

object (Location)

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 (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
Campi
tableCellLocation

object (TableCellLocation)

La posizione della cella in cui inizia l'intervallo di tabella.

rowSpan

integer

L'intervallo di righe dell'intervallo della tabella.

columnSpan

integer

L'estensione delle colonne dell'intervallo della tabella.

UpdateTableRowStyleRequest

Aggiorna il TableRowStyle di righe in una tabella.

Rappresentazione JSON
{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndices": [
    integer
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "fields": string
}
Campi
tableStartLocation

object (Location)

La posizione in cui inizia la tabella nel documento.

rowIndices[]

integer

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

object (TableRowStyle)

Gli stili da impostare nelle righe.

fields

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice tableRowStyle è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare l'altezza minima della riga, imposta fields a "minRowHeight".

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 (ImageReplaceMethod),
  "tabId": string
}
Campi
imageObjectId

string

L'ID dell'immagine esistente che verrà sostituita. L'ID può essere recuperato dalla risposta di una richiesta get.

uri

string

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 ImageProperties.source_uri .

imageReplaceMethod

enum (ImageReplaceMethod)

Il metodo di sostituzione.

tabId

string

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:

  • Se fornito, deve corrispondere all'ID della tabulazione singolare.

  • Se omesso, la richiesta si applica alla scheda singola.

In un documento contenente più schede:

  • Se fornita, la richiesta si applica alla scheda specificata.

  • Se omesso, la richiesta si applica alla prima scheda del documento.

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 (DocumentStyle)
  },
  "fields": string,
  "tabId": string
}
Campi
documentStyle

object (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 DocumentStyle per ulteriori informazioni.

fields

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice documentStyle è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare lo sfondo, imposta fields a "background".

tabId

string

La scheda che contiene lo stile da aggiornare. Se omesso, la richiesta si applica alla prima scheda.

In un documento contenente una sola scheda:

  • Se fornito, deve corrispondere all'ID della tabulazione singolare.

  • Se omesso, la richiesta si applica alla scheda singola.

In un documento contenente più schede:

  • Se fornita, la richiesta si applica alla scheda specificata.

  • Se non viene specificato, la richiesta si applica alla prima scheda del documento.

MergeTableCellsRequest

Unisce le celle in un Table.

Rappresentazione JSON
{
  "tableRange": {
    object (TableRange)
  }
}
Campi
tableRange

object (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 (TableRange)
  }
}
Campi
tableRange

object (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 (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}
Campi
type

enum (HeaderFooterType)

Il tipo di intestazione da creare.

sectionBreakLocation

object (Location)

La posizione SectionBreak che inizia la sezione a cui deve appartenere questa intestazione. Se "sectionBreakLocation" non è impostato o se fa riferimento alla prima interruzione di sezione nel corpo del documento, l'intestazione si applica alla DocumentStyle

HeaderFooterType

I tipi di intestazioni e piè di pagina che è possibile creare.

Enum
DEFAULT Un'intestazione/un piè di pagina predefinito.

CreateFooterRequest

Crea un Footer. Il nuovo piè di pagina viene applicato SectionStyle nella posizione SectionBreak se specificato, altrimenti viene applicato DocumentStyle.

Se esiste già un piè di pagina del tipo specificato, viene restituito un errore 400 di richiesta errata.

Rappresentazione JSON
{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}
Campi
type

enum (HeaderFooterType)

Il tipo di piè di pagina da creare.

sectionBreakLocation

object (Location)

La posizione SectionBreak immediatamente prima della sezione SectionStyle a cui deve appartenere questo piè di pagina. Se non viene configurato o se si riferisce alla prima interruzione di sezione nel documento, il piè di pagina si applica allo stile del documento.

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 footnote_reference_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field footnote_reference_location.
}
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

object (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 Paragraph. Ad esempio, non può essere inserito all'indice iniziale di una tabella (ovvero tra la tabella e il paragrafo precedente).

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, segment ID deve essere vuoto.

endOfSegmentLocation

object (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, segment ID deve essere vuoto.

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 (TabsCriteria)
  },

  // Union field replacement_content can be only one of the following:
  "text": string
  // End of list of possible types for union field replacement_content.

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "namedRangeName": string
  // End of list of possible types for union field named_range_reference.
}
Campi
tabsCriteria

object (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:

  • Se fornito, deve corrispondere all'ID della tabulazione singolare.

  • Se omesso, la sostituzione viene applicata alla tabulazione singolare.

In un documento contenente più schede:

  • Se fornito, la sostituzione si applica alle schede specificate.

  • Se omesso, la sostituzione viene applicata a tutte le schede.

Campo unione replacement_content. I contenuti con cui sostituire quelli esistenti nell'intervallo denominato. replacement_content può essere solo uno dei seguenti:
text

string

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

string

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

string

Il nome del NamedRanges i cui contenuti verranno sostituiti.

Se ci sono più parametri named ranges con il nome specificato, i contenuti di ogni elemento verranno sostituiti. Se non esistono intervalli denominati con il nome specificato, la richiesta sarà autonoma.

UpdateSectionStyleRequest

Aggiorna il SectionStyle.

Rappresentazione JSON
{
  "range": {
    object (Range)
  },
  "sectionStyle": {
    object (SectionStyle)
  },
  "fields": string
}
Campi
range

object (Range)

L'intervallo che si sovrappone alle sezioni da applicare.

Poiché le interruzioni di sezione possono essere inserite solo all'interno del corpo, segment ID deve essere vuoto.

sectionStyle

object (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 SectionStyle per ulteriori informazioni.

fields

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice sectionStyle è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare il margine sinistro, imposta fields a "marginLeft".

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 (SectionType),

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
Campi
sectionType

enum (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

object (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 Paragraph. Ad esempio, non può essere inserito all'indice iniziale di una tabella (ovvero tra la tabella e il paragrafo precedente).

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, segment ID deve essere vuoto.

endOfSegmentLocation

object (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, segment ID deve essere vuoto.

DeleteHeaderRequest

Elimina un Header dal documento.

Rappresentazione JSON
{
  "headerId": string,
  "tabId": string
}
Campi
headerId

string

L'ID dell'intestazione da eliminare. Se questa intestazione è definita DocumentStyle, il riferimento a questa intestazione viene rimosso, generando di conseguenza l'assenza di intestazione di quel tipo per la prima sezione del documento. Se questa intestazione viene definita su un SectionStyle, il riferimento a questa intestazione è stato rimosso e l'intestazione di quel tipo è continuata dalla sezione precedente.

tabId

string

La scheda contenente l'intestazione da eliminare. Se omesso, la richiesta viene applicata alla prima scheda.

In un documento contenente una sola scheda:

  • Se fornito, deve corrispondere all'ID della tabulazione singolare.

  • Se omesso, la richiesta si applica alla scheda singola.

In un documento contenente più schede:

  • Se fornita, la richiesta si applica alla scheda specificata.

  • Se omesso, la richiesta si applica alla prima scheda del documento.

DeleteFooterRequest

Elimina un Footer dal documento.

Rappresentazione JSON
{
  "footerId": string,
  "tabId": string
}
Campi
footerId

string

L'ID del piè di pagina da eliminare. Se questo piè di pagina è definito DocumentStyle, il riferimento a questo piè di pagina viene rimosso, generando di conseguenza l'assenza di piè di pagina di quel tipo per la prima sezione del documento. Se questo piè di pagina è definito in SectionStyle, il riferimento a questo piè di pagina viene rimosso e il piè di pagina di quel tipo è ora riportato nella sezione precedente.

tabId

string

La scheda che contiene il piè di pagina da eliminare. Se omesso, la richiesta viene applicata alla prima scheda.

In un documento contenente una sola scheda:

  • Se fornito, deve corrispondere all'ID della tabulazione singolare.

  • Se omesso, la richiesta si applica alla scheda singola.

In un documento contenente più schede:

  • Se fornita, la richiesta si applica alla scheda specificata.

  • Se omesso, la richiesta si applica alla prima scheda del documento.

PinTableHeaderRowsRequest

Consente di aggiornare il numero di righe di intestazione della tabella fissate in una tabella.

Rappresentazione JSON
{
  "tableStartLocation": {
    object (Location)
  },
  "pinnedHeaderRowsCount": integer
}
Campi
tableStartLocation

object (Location)

La posizione in cui inizia la tabella nel documento.

pinnedHeaderRowsCount

integer

Il numero di righe della tabella da bloccare, dove 0 indica che tutte le righe sono sbloccate.