REST Resource: documents

{
  "documentId": string,
  "title": string,
  "tabs": [
    {
      object (Tab)
    }
  ],
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}

string

Solo output. L'ID del documento.

string

Il titolo del documento.

object (Tab)

Schede che fanno parte di un documento.

Le schede possono contenere schede secondarie, una scheda nidificata in un'altra scheda. Le schede secondarie sono rappresentate dal campo Tab.childTabs.

string

Solo output. L'ID revisione del documento. Può essere utilizzato nelle richieste di aggiornamento per specificare a quale revisione di un documento applicare gli aggiornamenti e il comportamento della richiesta se il documento è stato modificato dopo quella revisione. Viene compilato solo se l'utente dispone dell'accesso in modifica al documento.

L'ID revisione non è un numero sequenziale, ma una stringa opaca. Il formato dell'ID revisione potrebbe cambiare nel tempo. L'ID revisione restituito è garantito come valido solo per 24 ore dopo la restituzione e non può essere condiviso tra gli utenti. Se l'ID revisione rimane invariato tra una chiamata e l'altra, significa che il documento non è stato modificato. Al contrario, un ID modificato (per lo stesso documento e utente) di solito indica che il documento è stato aggiornato. Tuttavia, un ID modificato può essere dovuto anche a fattori interni, come le modifiche al formato dell'ID.

enum (SuggestionsViewMode)

Solo output. La modalità di visualizzazione dei suggerimenti applicata al documento.

Nota: quando modifichi un documento, le modifiche devono essere basate su un documento con SUGGESTIONS_INLINE.

object (Body)

Solo output. Il corpo principale del documento.

Campo precedente: utilizza invece Document.tabs.documentTab.body, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se è false o non impostato, questo campo contiene informazioni sulla prima scheda del documento.

map (key: string, value: object (Header))

Solo output. Le intestazioni del documento, con chiave in base all'ID intestazione.

Campo precedente: utilizza invece Document.tabs.documentTab.headers, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se è false o non impostato, questo campo contiene informazioni sulla prima scheda del documento.

map (key: string, value: object (Footer))

Solo output. I piè di pagina nel documento, indicizzati in base all'ID piè di pagina.

Campo precedente: utilizza invece Document.tabs.documentTab.footers, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se è false o non impostato, questo campo contiene informazioni sulla prima scheda del documento.

map (key: string, value: object (Footnote))

Solo output. Le note a piè di pagina nel documento, con chiave in base all'ID nota a piè di pagina.

Campo precedente: utilizza invece Document.tabs.documentTab.footnotes, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se è false o non impostato, questo campo contiene informazioni sulla prima scheda del documento.

object (DocumentStyle)

Solo output. Lo stile del documento.

Campo precedente: utilizza invece Document.tabs.documentTab.documentStyle, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se è false o non impostato, questo campo contiene informazioni sulla prima scheda del documento.

map (key: string, value: object (SuggestedDocumentStyle))

Solo output. Le modifiche suggerite allo stile del documento, con chiave in base all'ID suggerimento.

Campo precedente: utilizza invece Document.tabs.documentTab.suggestedDocumentStyleChanges, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se è false o non impostato, questo campo contiene informazioni sulla prima scheda del documento.

object (NamedStyles)

Solo output. Gli stili denominati del documento.

Campo precedente: utilizza invece Document.tabs.documentTab.namedStyles, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se è false o non impostato, questo campo contiene informazioni sulla prima scheda del documento.

map (key: string, value: object (SuggestedNamedStyles))

Solo output. Le modifiche suggerite agli stili denominati del documento, con chiave in base all'ID suggerimento.

Campo precedente: utilizza invece Document.tabs.documentTab.suggestedNamedStylesChanges, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se è false o non impostato, questo campo contiene informazioni sulla prima scheda del documento.

map (key: string, value: object (List))

Solo output. Gli elenchi nel documento, indicizzati in base all'ID elenco.

Campo precedente: utilizza invece Document.tabs.documentTab.lists, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se è false o non impostato, questo campo contiene informazioni sulla prima scheda del documento.

map (key: string, value: object (NamedRanges))

Solo output. Gli intervalli denominati nel documento, indicizzati per nome.

Campo precedente: utilizza invece Document.tabs.documentTab.namedRanges, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se è false o non impostato, questo campo contiene informazioni sulla prima scheda del documento.

map (key: string, value: object (InlineObject))

Solo output. Gli oggetti in linea nel documento, indicizzati in base all'ID oggetto.

Campo precedente: utilizza invece Document.tabs.documentTab.inlineObjects, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se è false o non impostato, questo campo contiene informazioni sulla prima scheda del documento.

map (key: string, value: object (PositionedObject))

Solo output. Gli oggetti posizionati nel documento, indicizzati in base all'ID oggetto.

Campo precedente: utilizza invece Document.tabs.documentTab.positionedObjects, che mostra i contenuti effettivi del documento di tutte le schede quando il parametro includeTabsContent è impostato su true. Se è false o non impostato, questo campo contiene informazioni sulla prima scheda del documento.

{
  "tabProperties": {
    object (TabProperties)
  },
  "childTabs": [
    {
      object (Tab)
    }
  ],

  // Union field content can be only one of the following:
  "documentTab": {
    object (DocumentTab)
  }
  // End of list of possible types for union field content.
}

object (TabProperties)

Le proprietà della scheda, come ID e titolo.

object (Tab)

Le schede secondarie nidificate in questa scheda.

object (DocumentTab)

Una scheda con i contenuti del documento, come testo e immagini.

{
  "tabId": string,
  "title": string,
  "parentTabId": string,
  "index": integer,
  "nestingLevel": integer
}

string

Solo output. L'ID della scheda. Questo campo non può essere modificato.

string

Il nome visibile all'utente della scheda.

string

Facoltativo. L'ID della scheda principale. Vuoto quando la scheda corrente è a livello di radice, il che significa che non ha schede principali.

integer

L'indice in base zero della scheda all'interno dell'elemento principale.

integer

Solo output. La profondità della scheda all'interno del documento. Le schede a livello di radice iniziano da 0.

{
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}

object (Body)

Il corpo principale della scheda del documento.

map (key: string, value: object (Header))

Le intestazioni nella scheda del documento, con chiave ID intestazione.

map (key: string, value: object (Footer))

I piè di pagina nella scheda del documento, indicizzati in base all'ID piè di pagina.

map (key: string, value: object (Footnote))

Le note a piè di pagina nella scheda del documento, con chiave in base all'ID nota.

object (DocumentStyle)

Lo stile della scheda del documento.

map (key: string, value: object (SuggestedDocumentStyle))

Le modifiche suggerite allo stile della scheda del documento, con chiave in base all'ID suggerimento.

object (NamedStyles)

Gli stili denominati della scheda del documento.

map (key: string, value: object (SuggestedNamedStyles))

Le modifiche suggerite agli stili denominati della scheda del documento, con chiave in base all'ID suggerimento.

map (key: string, value: object (List))

Gli elenchi nella scheda del documento, indicizzati in base all'ID elenco.

map (key: string, value: object (NamedRanges))

Gli intervalli denominati nella scheda del documento, indicizzati per nome.

map (key: string, value: object (InlineObject))

Gli oggetti in linea nella scheda del documento, con chiave in base all'ID oggetto.

map (key: string, value: object (PositionedObject))

Gli oggetti posizionati nella scheda del documento, indicizzati in base all'ID oggetto.

{
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

object (StructuralElement)

I contenuti del corpo.

Gli indici per i contenuti del corpo iniziano da zero.

{
  "startIndex": integer,
  "endIndex": integer,

  // Union field content can be only one of the following:
  "paragraph": {
    object (Paragraph)
  },
  "sectionBreak": {
    object (SectionBreak)
  },
  "table": {
    object (Table)
  },
  "tableOfContents": {
    object (TableOfContents)
  }
  // End of list of possible types for union field content.
}

integer

L'indice di inizio basato su zero di questo elemento strutturale, in unità di codice UTF-16.

integer

L'indice di fine di questo elemento strutturale basato su zero, esclusivo, in unità di codice UTF-16.

object (Paragraph)

Un tipo di paragrafo di elemento strutturale.

object (SectionBreak)

Un tipo di interruzione di sezione dell'elemento strutturale.

object (Table)

Un tipo di tabella di elemento strutturale.

object (TableOfContents)

Un tipo di elemento strutturale del sommario.

{
  "elements": [
    {
      object (ParagraphElement)
    }
  ],
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "suggestedParagraphStyleChanges": {
    string: {
      object (SuggestedParagraphStyle)
    },
    ...
  },
  "bullet": {
    object (Bullet)
  },
  "suggestedBulletChanges": {
    string: {
      object (SuggestedBullet)
    },
    ...
  },
  "positionedObjectIds": [
    string
  ],
  "suggestedPositionedObjectIds": {
    string: {
      object (ObjectReferences)
    },
    ...
  }
}

object (ParagraphElement)

I contenuti del paragrafo, suddivisi nelle relative componenti.

object (ParagraphStyle)

Lo stile di questo paragrafo.

map (key: string, value: object (SuggestedParagraphStyle))

Lo stile di paragrafo suggerito viene modificato in questo paragrafo, con chiave in base all'ID suggerimento.

object (Bullet)

Il punto elenco per questo paragrafo. Se non è presente, il paragrafo non appartiene a un elenco.

map (key: string, value: object (SuggestedBullet))

Le modifiche suggerite al punto elenco di questo paragrafo.

string

Gli ID degli oggetti posizionati collegati a questo paragrafo.

map (key: string, value: object (ObjectReferences))

Gli ID degli oggetti posizionati suggeriti da allegare a questo paragrafo, indicizzati in base all'ID suggerimento.

{
  "startIndex": integer,
  "endIndex": integer,

  // Union field content can be only one of the following:
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  },
  "pageBreak": {
    object (PageBreak)
  },
  "columnBreak": {
    object (ColumnBreak)
  },
  "footnoteReference": {
    object (FootnoteReference)
  },
  "horizontalRule": {
    object (HorizontalRule)
  },
  "equation": {
    object (Equation)
  },
  "inlineObjectElement": {
    object (InlineObjectElement)
  },
  "person": {
    object (Person)
  },
  "richLink": {
    object (RichLink)
  }
  // End of list of possible types for union field content.
}

integer

L'indice iniziale a zero di questo elemento paragrafo, in unità di codice UTF-16.

integer

L'indice di fine di questo elemento paragrafo con base zero, esclusivo, in unità di codice UTF-16.

object (TextRun)

Un elemento paragrafo di paragrafo di testo.

object (AutoText)

Un elemento di paragrafo di testo automatico.

object (PageBreak)

Un elemento di paragrafo di interruzione di pagina.

object (ColumnBreak)

Un elemento paragrafo di interruzione di colonna.

object (FootnoteReference)

Un elemento paragrafo di riferimento a nota a piè di pagina.

object (HorizontalRule)

Un elemento di paragrafo con righello orizzontale.

object (Equation)

Un elemento di paragrafo dell'equazione.

object (InlineObjectElement)

Un elemento paragrafo di oggetto in linea.

object (Person)

Un elemento paragrafo che rimanda a una persona o a un indirizzo email.

object (RichLink)

Un elemento paragrafo che rimanda a una risorsa Google (ad esempio un file su Google Drive, un video di YouTube o un evento di Calendar).

{
  "content": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

Il testo di questa esecuzione.

Tutti gli elementi non di testo nell'esecuzione vengono sostituiti con il carattere Unicode U+E907.

string

Gli ID di inserzione suggeriti. Un TextRun può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

string

Gli ID eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

object (TextStyle)

Lo stile di testo di questa esecuzione.

map (key: string, value: object (SuggestedTextStyle))

Lo stile di testo suggerito viene modificato in base a questa esecuzione, con chiave in base all'ID suggerimento.

{
  "bold": boolean,
  "italic": boolean,
  "underline": boolean,
  "strikethrough": boolean,
  "smallCaps": boolean,
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "fontSize": {
    object (Dimension)
  },
  "weightedFontFamily": {
    object (WeightedFontFamily)
  },
  "baselineOffset": enum (BaselineOffset),
  "link": {
    object (Link)
  }
}

boolean

Indica se il testo viene visualizzato in grassetto o meno.

boolean

Indica se il testo è in corsivo o meno.

boolean

Se il testo è sottolineato o meno.

boolean

Indica se il testo è barrato o meno.

boolean

Indica se il testo è scritto in lettere maiuscole piccole.

object (OptionalColor)

Il colore di sfondo del testo. Se impostato, il colore è un colore RGB o trasparente, a seconda del campo color.

object (OptionalColor)

Il colore di primo piano del testo. Se impostato, il colore è un colore RGB o trasparente, a seconda del campo color.

object (Dimension)

Le dimensioni del carattere del testo.

object (WeightedFontFamily)

La famiglia di caratteri e lo spessore visualizzato del testo.

Se una richiesta di aggiornamento specifica valori sia per weightedFontFamily che per bold, viene applicato prima weightedFontFamily e poi bold.

Se weightedFontFamily#weight non è impostato, il valore predefinito è 400.

Se weightedFontFamily è impostato, è necessario impostare anche weightedFontFamily#fontFamily con un valore non vuoto. In caso contrario, viene restituito un errore di richiesta non valida 400.

enum (BaselineOffset)

Lo scostamento verticale del testo rispetto alla posizione normale.

Il testo con gli offset di base SUPERSCRIPT o SUBSCRIPT viene visualizzato automaticamente in un carattere più piccolo, calcolato in base al campo fontSize. Le modifiche in questo campo non influiscono su fontSize.

object (Link)

La destinazione del link ipertestuale del testo. Se non è impostato, non è presente alcun link. I link non vengono ereditati dal testo principale.

La modifica del link in una richiesta di aggiornamento comporta alcune altre modifiche allo stile di testo dell'intervallo:

• Quando imposti un link, il colore di primo piano del testo verrà aggiornato con il colore del link predefinito e il testo verrà sottolineato. Se questi campi vengono modificati nella stessa richiesta, verranno utilizzati questi valori anziché i valori predefiniti del link.
• Se imposti un link su un intervallo di testo che si sovrappone a un link esistente, il link esistente verrà aggiornato in modo da puntare al nuovo URL.
• I link non sono impostabili sui caratteri di nuova riga. Di conseguenza, l'impostazione di un link in un intervallo di testo che attraversa il confine di un paragrafo, ad esempio "ABC\n123", separerà i caratteri di a capo in singole righe di testo. Il link verrà applicato separatamente alle esecuzioni prima e dopo il nuovo riga.
• La rimozione di un link aggiorna lo stile di testo dell'intervallo in modo che corrisponda allo stile del testo precedente (o agli stili di testo predefiniti se il testo precedente è un altro link), a meno che non vengano impostati stili diversi nella stessa richiesta.

{
  "color": {
    object (Color)
  }
}

object (Color)

Se impostato, verrà utilizzato come colore opaco. Se non è impostato, rappresenta un colore trasparente.

{
  "rgbColor": {
    object (RgbColor)
  }
}

object (RgbColor)

Il valore del colore RGB.

{
  "red": number,
  "green": number,
  "blue": number
}

number

Il componente rosso del colore, da 0,0 a 1,0.

number

Il componente verde del colore, da 0,0 a 1,0.

number

Il componente blu del colore, da 0,0 a 1,0.

{
  "magnitude": number,
  "unit": enum (Unit)
}

number

La magnitudine.

enum (Unit)

Le unità di misura dell'intensità.

{
  "fontFamily": string,
  "weight": integer
}

string

La famiglia di caratteri del testo.

La famiglia di caratteri può essere qualsiasi carattere del menu Carattere in Documenti o di Google Fonts. Se il nome del carattere non è riconosciuto, il testo viene visualizzato in Arial.

integer

Lo spessore del carattere. Questo campo può avere qualsiasi valore che sia un multiplo di 100 compreso tra 100 e 900. Questo intervallo corrisponde ai valori numerici descritti nella sezione 15.6 della specifica CSS 2.1, con i valori non numerici non consentiti.

Il valore predefinito è 400 ("normale").

Lo spessore del carattere costituisce solo un componente dello spessore del carattere visualizzato. Una combinazione di weight e del valore bold risolto dello stile di testo determina lo spessore visualizzato, dopo aver tenuto conto dell'eredità:

• Se il testo è in grassetto e lo spessore è inferiore a 400, lo spessore visualizzato è 400.
• Se il testo è in grassetto e lo spessore è maggiore o uguale a 400, ma minore di 700, lo spessore visualizzato è 700.
• Se il peso è maggiore o uguale a 700, il peso visualizzato è uguale al peso.
• Se il testo non è in grassetto, lo spessore visualizzato è uguale a quello impostato.

{

  // Union field destination can be only one of the following:
  "url": string,
  "tabId": string,
  "bookmark": {
    object (BookmarkLink)
  },
  "heading": {
    object (HeadingLink)
  },
  "bookmarkId": string,
  "headingId": string
  // End of list of possible types for union field destination.
}

string

Un URL esterno.

string

L'ID di una scheda in questo documento.

object (BookmarkLink)

Un segnalibro in questo documento.

Nei documenti contenenti una singola scheda, i link ai segnalibri all'interno della scheda singola continuano a restituire Link.bookmarkId quando il parametro includeTabsContent è impostato su false o non è impostato. In caso contrario, viene restituito questo campo.

object (HeadingLink)

Un'intestazione in questo documento.

Nei documenti contenenti una singola scheda, i link alle intestazioni all'interno della scheda singola continuano a restituire Link.headingId quando il parametro includeTabsContent è impostato su false o non è impostato. In caso contrario, viene restituito questo campo.

string

L'ID di un preferito in questo documento.

Campo precedente: imposta includeTabsContent su true e utilizza Link.bookmark per le operazioni di lettura e scrittura. Questo campo viene restituito solo quando includeTabsContent è impostato su false nei documenti contenenti una singola scheda e link a un preferito all'interno della scheda singola. In caso contrario, viene restituito Link.bookmark.

Se questo campo viene utilizzato in una richiesta di scrittura, il preferito è considerato proveniente dall'ID scheda specificato nella richiesta. Se nella richiesta non viene specificato un ID scheda, si presume che provenga dalla prima scheda del documento.

string

L'ID di un titolo in questo documento.

Campo precedente: imposta includeTabsContent su true e utilizza Link.heading per le operazioni di lettura e scrittura. Questo campo viene restituito solo quando includeTabsContent è impostato su false nei documenti contenenti una singola scheda e i link a una voce all'interno della scheda singola. In caso contrario, viene restituito Link.heading.

Se questo campo viene utilizzato in una richiesta di scrittura, l'intestazione è considerata proveniente dall'ID scheda specificato nella richiesta. Se nella richiesta non viene specificato un ID scheda, si presume che provenga dalla prima scheda del documento.

{
  "id": string,
  "tabId": string
}

string

L'ID di un preferito in questo documento.

string

L'ID della scheda contenente questo preferito.

{
  "id": string,
  "tabId": string
}

string

L'ID di un'intestazione in questo documento.

string

L'ID della scheda contenente questa intestazione.

{
  "textStyle": {
    object (TextStyle)
  },
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}

object (TextStyle)

Un TextStyle che include solo le modifiche apportate in questo suggerimento. Questo comando può essere utilizzato insieme a textStyleSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

object (TextStyleSuggestionState)

Una maschera che indica quali campi della base TextStyle sono stati modificati in questo suggerimento.

{
  "boldSuggested": boolean,
  "italicSuggested": boolean,
  "underlineSuggested": boolean,
  "strikethroughSuggested": boolean,
  "smallCapsSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "foregroundColorSuggested": boolean,
  "fontSizeSuggested": boolean,
  "weightedFontFamilySuggested": boolean,
  "baselineOffsetSuggested": boolean,
  "linkSuggested": boolean
}

boolean

Indica se è stata suggerita una modifica a bold.

boolean

Indica se è stata suggerita una modifica a italic.

boolean

Indica se è stata suggerita una modifica a underline.

boolean

Indica se è stata suggerita una modifica a strikethrough.

boolean

Indica se è stata suggerita una modifica a smallCaps.

boolean

Indica se è stata suggerita una modifica a backgroundColor.

boolean

Indica se è stata suggerita una modifica a foregroundColor.

boolean

Indica se è stata suggerita una modifica a fontSize.

boolean

Indica se è stata suggerita una modifica a weightedFontFamily.

boolean

Indica se è stata suggerita una modifica a baselineOffset.

boolean

Indica se è stata suggerita una modifica a link.

{
  "type": enum (Type),
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

enum (Type)

Il tipo di questo testo automatico.

string

Gli ID di inserzione suggeriti. Un AutoText può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

string

Gli ID eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

object (TextStyle)

Lo stile di testo di questo testo automatico.

map (key: string, value: object (SuggestedTextStyle))

Lo stile di testo suggerito diventa questo testo automatico, con chiave in base all'ID suggerimento.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

Gli ID di inserzione suggeriti. Un PageBreak può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

string

Gli ID eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

object (TextStyle)

Lo stile di testo di questo a capo.

Analogamente ai contenuti di testo, come le righe di testo e i riferimenti alle note a piè di pagina, lo stile di testo di un a capo può influire sul layout dei contenuti e sullo stile del testo inserito accanto.

map (key: string, value: object (SuggestedTextStyle))

Lo stile di testo suggerito diventa questo a capo, con chiave in base all'ID suggerimento.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

Gli ID di inserzione suggeriti. Un ColumnBreak può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

string

Gli ID eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

object (TextStyle)

Lo stile di testo di questo a capo di colonna.

Analogamente ai contenuti di testo, come le righe di testo e i riferimenti alle note a piè di pagina, lo stile di testo di un a capo può influire sul layout dei contenuti e sullo stile del testo inserito accanto.

map (key: string, value: object (SuggestedTextStyle))

Lo stile di testo suggerito diventa questo a capo di colonna, con chiave ID suggerimento.

{
  "footnoteId": string,
  "footnoteNumber": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

L'ID del footnote che contiene i contenuti di questo riferimento a nota a piè di pagina.

string

Il numero visualizzato di questa nota a piè di pagina.

string

Gli ID di inserzione suggeriti. Un FootnoteReference può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

string

Gli ID eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

object (TextStyle)

Lo stile di testo di questa FootnoteReference.

map (key: string, value: object (SuggestedTextStyle))

Lo stile di testo suggerito diventa questo FootnoteReference, con chiave ID suggerimento.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

Gli ID di inserzione suggeriti. Un HorizontalRule può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

string

Gli ID eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

object (TextStyle)

Lo stile del testo di questa HorizontalRule.

Analogamente ai contenuti di testo, come le righe di testo e i riferimenti alle note a piè di pagina, lo stile di testo di una linea orizzontale può influire sul layout dei contenuti e sullo stile del testo inserito accanto.

map (key: string, value: object (SuggestedTextStyle))

Lo stile di testo suggerito diventa questa regola orizzontale, con chiave in base all'ID suggerimento.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}

string

Gli ID di inserzione suggeriti. Un Equation può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

string

Gli ID eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

{
  "inlineObjectId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

L'ID del InlineObject contenuto da questo elemento.

string

Gli ID di inserzione suggeriti. Un InlineObjectElement può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

string

Gli ID eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

object (TextStyle)

Lo stile di testo di questo elemento InlineObject.

Analogamente ai contenuti di testo, come le righe di testo e i riferimenti alle note a piè di pagina, lo stile di testo di un elemento oggetto in linea può influire sul layout dei contenuti e sullo stile del testo inserito accanto.

map (key: string, value: object (SuggestedTextStyle))

Lo stile di testo suggerito diventa questo InlineObject, con chiave in base all'ID suggerimento.

{
  "personId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "personProperties": {
    object (PersonProperties)
  }
}

string

Solo output. L'ID univoco di questo link.

string

ID per i suggerimenti che inseriscono il link a questa persona nel documento. Un Person potrebbe avere più ID inserimento se si tratta di una modifica suggerita nidificata (ad esempio un suggerimento all'interno di un suggerimento fatto da un altro utente). Se è vuoto, il link a questa persona non è un inserimento suggerito.

string

ID dei suggerimenti che rimuovono il link a questa persona dal documento. Un Person potrebbe avere più ID eliminazione se, ad esempio, più utenti ne suggeriscono l'eliminazione. Se è vuoto, il link a questa persona non viene suggerito per l'eliminazione.

object (TextStyle)

Lo stile del testo di questo Person.

map (key: string, value: object (SuggestedTextStyle))

Lo stile di testo suggerito diventa Person, con chiave in base all'ID suggerimento.

object (PersonProperties)

Solo output. Le proprietà di questo Person. Questo campo è sempre presente.

{
  "name": string,
  "email": string
}

string

Solo output. Il nome della persona se viene visualizzato nel testo del link anziché nell'indirizzo email.

string

Solo output. L'indirizzo email collegato a questo Person. Questo campo è sempre presente.

{
  "richLinkId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
}

string

Solo output. L'ID di questo link.

string

ID dei suggerimenti che inseriscono questo link nel documento. Un RichLink potrebbe avere più ID inserzione se si tratta di una modifica suggerita nidificata (ad esempio un suggerimento all'interno di un suggerimento fatto da un altro utente). Se è vuoto, il link a questa persona non è un inserimento suggerito.

string

ID dei suggerimenti che rimuovono questo link dal documento. Un RichLink potrebbe avere più ID eliminazione se, ad esempio, più utenti ne suggeriscono l'eliminazione. Se è vuoto, il link a questa persona non viene suggerito per l'eliminazione.

object (TextStyle)

Lo stile del testo di questo RichLink.

map (key: string, value: object (SuggestedTextStyle))

Lo stile di testo suggerito diventa RichLink, con chiave in base all'ID suggerimento.

object (RichLinkProperties)

Solo output. Le proprietà di questo RichLink. Questo campo è sempre presente.

{
  "title": string,
  "uri": string,
  "mimeType": string
}

string

Solo output. Il titolo del RichLink visualizzato nel link. Questo titolo corrisponde al titolo della risorsa collegata al momento dell'inserimento o dell'ultimo aggiornamento del link. Questo campo è sempre presente.

string

Solo output. L'URI del RichLink. Questo valore è sempre presente.

string

Solo output. Il tipo MIME del RichLink, se presente (ad esempio, se si tratta di un file su Drive).

{
  "headingId": string,
  "namedStyleType": enum (NamedStyleType),
  "alignment": enum (Alignment),
  "lineSpacing": number,
  "direction": enum (ContentDirection),
  "spacingMode": enum (SpacingMode),
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "borderBetween": {
    object (ParagraphBorder)
  },
  "borderTop": {
    object (ParagraphBorder)
  },
  "borderBottom": {
    object (ParagraphBorder)
  },
  "borderLeft": {
    object (ParagraphBorder)
  },
  "borderRight": {
    object (ParagraphBorder)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "tabStops": [
    {
      object (TabStop)
    }
  ],
  "keepLinesTogether": boolean,
  "keepWithNext": boolean,
  "avoidWidowAndOrphan": boolean,
  "shading": {
    object (Shading)
  },
  "pageBreakBefore": boolean
}

string

L'ID dell'intestazione del paragrafo. Se è vuoto, questo paragrafo non è un'intestazione.

Questa proprietà è di sola lettura.

enum (NamedStyleType)

Il tipo di stile denominato del paragrafo.

Poiché l'aggiornamento del tipo di stile denominato influisce su altre proprietà all'interno di ParagraphStyle, il tipo di stile denominato viene applicato prima dell'aggiornamento delle altre proprietà.

enum (Alignment)

L'allineamento del testo per questo paragrafo.

number

La quantità di spazio tra le linee, in percentuale rispetto al normale, dove il normale è rappresentato da 100,0. Se non è impostato, il valore viene ereditato dall'elemento principale.

enum (ContentDirection)

La direzione del testo di questo paragrafo. Se non è impostato, il valore predefinito è LEFT_TO_RIGHT poiché l'orientamento del paragrafo non viene ereditato.

enum (SpacingMode)

La modalità di spaziatura per il paragrafo.

object (Dimension)

La quantità di spazio aggiuntivo sopra il paragrafo. Se non è impostato, il valore viene ereditato dall'elemento principale.

object (Dimension)

La quantità di spazio aggiuntivo sotto il paragrafo. Se non è impostato, il valore viene ereditato dall'elemento principale.

object (ParagraphBorder)

Il bordo tra questo paragrafo e i paragrafi precedenti e successivi. Se non è impostato, il valore viene ereditato dall'elemento principale.

Il bordo tra viene visualizzato quando il paragrafo adiacente ha le stesse proprietà di bordo e rientro.

I bordi dei paragrafi non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato nella sua interezza.

object (ParagraphBorder)

Il bordo nella parte superiore di questo paragrafo. Se non è impostato, il valore viene ereditato dall'elemento principale.

Il bordo superiore viene visualizzato quando il paragrafo precedente ha proprietà di bordo e rientro diverse.

I bordi dei paragrafi non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato nella sua interezza.

object (ParagraphBorder)

Il bordo in fondo a questo paragrafo. Se non è impostato, il valore viene ereditato dall'elemento principale.

Il bordo inferiore viene visualizzato quando il paragrafo sottostante ha proprietà di bordo e rientro diverse.

I bordi dei paragrafi non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato nella sua interezza.

object (ParagraphBorder)

Il bordo a sinistra di questo paragrafo. Se non è impostato, il valore viene ereditato dall'elemento principale.

I bordi dei paragrafi non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato nella sua interezza.

object (ParagraphBorder)

Il bordo a destra di questo paragrafo. Se non è impostato, il valore viene ereditato dall'elemento principale.

I bordi dei paragrafi non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, il nuovo bordo deve essere specificato nella sua interezza.

object (Dimension)

L'entità del rientro per la prima riga del paragrafo. Se non è impostato, il valore viene ereditato dall'elemento principale.

object (Dimension)

La quantità di rientro del paragrafo sul lato che corrisponde all'inizio del testo, in base all'attuale direzione del paragrafo. Se non è impostato, il valore viene ereditato dall'elemento principale.

object (Dimension)

La quantità di rientro del paragrafo sul lato che corrisponde alla fine del testo, in base all'attuale direzione del paragrafo. Se non è impostato, il valore viene ereditato dall'elemento principale.

object (TabStop)

Un elenco delle tabulazioni per questo paragrafo. L'elenco delle tabulazioni non viene ereditato.

Questa proprietà è di sola lettura.

boolean

Indica se, se possibile, tutte le righe del paragrafo devono essere disposte nella stessa pagina o colonna. Se non è impostato, il valore viene ereditato dall'elemento principale.

boolean

Indica se, se possibile, almeno una parte di questo paragrafo deve essere disposta nella stessa pagina o colonna del paragrafo successivo. Se non è impostato, il valore viene ereditato dall'elemento principale.

boolean

Se evitare vedovanza e orfanezza per il paragrafo. Se non è impostato, il valore viene ereditato dall'elemento principale.

object (Shading)

L'ombreggiatura del paragrafo. Se non è impostato, il valore viene ereditato dall'elemento principale.

boolean

Indica se il paragrafo corrente deve sempre iniziare all'inizio di una pagina. Se non è impostato, il valore viene ereditato dall'elemento principale.

Il tentativo di aggiornare pageBreakBefore per i paragrafi in regioni non supportate, tra cui Table, Header, Footer e Footnote, può comportare uno stato del documento non valido che restituisce un errore di richiesta non valida (400).

{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "padding": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}

object (OptionalColor)

Il colore del bordo.

object (Dimension)

La larghezza del bordo.

object (Dimension)

La spaziatura interna del bordo.

enum (DashStyle)

Lo stile del tratto del bordo.

{
  "offset": {
    object (Dimension)
  },
  "alignment": enum (TabStopAlignment)
}

object (Dimension)

Lo spazio tra questo rientro e il margine iniziale.

enum (TabStopAlignment)

L'allineamento di questo a capo. Se non viene impostato, il valore predefinito è START.

{
  "backgroundColor": {
    object (OptionalColor)
  }
}

object (OptionalColor)

Il colore di sfondo dell'ombreggiatura del paragrafo.

{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}

object (ParagraphStyle)

Un ParagraphStyle che include solo le modifiche apportate in questo suggerimento. Questo comando può essere utilizzato insieme a paragraphStyleSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

object (ParagraphStyleSuggestionState)

Una maschera che indica quali campi della base ParagraphStyle sono stati modificati in questo suggerimento.

{
  "headingIdSuggested": boolean,
  "namedStyleTypeSuggested": boolean,
  "alignmentSuggested": boolean,
  "lineSpacingSuggested": boolean,
  "directionSuggested": boolean,
  "spacingModeSuggested": boolean,
  "spaceAboveSuggested": boolean,
  "spaceBelowSuggested": boolean,
  "borderBetweenSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "indentEndSuggested": boolean,
  "keepLinesTogetherSuggested": boolean,
  "keepWithNextSuggested": boolean,
  "avoidWidowAndOrphanSuggested": boolean,
  "shadingSuggestionState": {
    object (ShadingSuggestionState)
  },
  "pageBreakBeforeSuggested": boolean
}

boolean

Indica se è stata suggerita una modifica a headingId.

boolean

Indica se è stata suggerita una modifica a namedStyleType.

boolean

Indica se è stata suggerita una modifica a alignment.

boolean

Indica se è stata suggerita una modifica a lineSpacing.

boolean

Indica se è stata suggerita una modifica a direction.

boolean

Indica se è stata suggerita una modifica a spacingMode.

boolean

Indica se è stata suggerita una modifica a spaceAbove.

boolean

Indica se è stata suggerita una modifica a spaceBelow.

boolean

Indica se è stata suggerita una modifica a borderBetween.

boolean

Indica se è stata suggerita una modifica a borderTop.

boolean

Indica se è stata suggerita una modifica a borderBottom.

boolean

Indica se è stata suggerita una modifica a borderLeft.

boolean

Indica se è stata suggerita una modifica a borderRight.

boolean

Indica se è stata suggerita una modifica a indentFirstLine.

boolean

Indica se è stata suggerita una modifica a indentStart.

boolean

Indica se è stata suggerita una modifica a indentEnd.

boolean

Indica se è stata suggerita una modifica a keepLinesTogether.

boolean

Indica se è stata suggerita una modifica a keepWithNext.

boolean

Indica se è stata suggerita una modifica a avoidWidowAndOrphan.

object (ShadingSuggestionState)

Una maschera che indica quali campi in shading sono stati modificati in questo suggerimento.

boolean

Indica se è stata suggerita una modifica a pageBreakBefore.

{
  "backgroundColorSuggested": boolean
}

boolean

Indica se è stata suggerita una modifica al Shading.

{
  "listId": string,
  "nestingLevel": integer,
  "textStyle": {
    object (TextStyle)
  }
}

string

L'ID dell'elenco a cui appartiene questo paragrafo.

integer

Il livello di nidificazione di questo paragrafo nell'elenco.

object (TextStyle)

Lo stile di testo specifico del paragrafo applicato a questo punto elenco.

{
  "bullet": {
    object (Bullet)
  },
  "bulletSuggestionState": {
    object (BulletSuggestionState)
  }
}

object (Bullet)

Un Bullet che include solo le modifiche apportate in questo suggerimento. Questo comando può essere utilizzato insieme a bulletSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

object (BulletSuggestionState)

Una maschera che indica quali campi della base Bullet sono stati modificati in questo suggerimento.

{
  "listIdSuggested": boolean,
  "nestingLevelSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}

boolean

Indica se è stata suggerita una modifica al listId.

boolean

Indica se è stata suggerita una modifica al nestingLevel.

object (TextStyleSuggestionState)

Una maschera che indica quali campi in text style sono stati modificati in questo suggerimento.

{
  "objectIds": [
    string
  ]
}

string

Gli ID oggetto.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "sectionStyle": {
    object (SectionStyle)
  }
}

string

Gli ID di inserzione suggeriti. Un SectionBreak può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

string

Gli ID eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

object (SectionStyle)

Lo stile della sezione dopo questo a capo.

{
  "columnProperties": [
    {
      object (SectionColumnProperties)
    }
  ],
  "columnSeparatorStyle": enum (ColumnSeparatorStyle),
  "contentDirection": enum (ContentDirection),
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "sectionType": enum (SectionType),
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "flipPageOrientation": boolean
}

object (SectionColumnProperties)

Le proprietà delle colonne della sezione.

Se è vuota, la sezione contiene una colonna con le proprietà predefinite nell'editor di Documenti. Una sezione può essere aggiornata in modo da avere al massimo tre colonne.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, verrà generato un errore di richiesta non valida (400).

enum (ColumnSeparatorStyle)

Lo stile dei separatori di colonna.

Questo stile può essere impostato anche quando la sezione contiene una sola colonna.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, viene generato un errore di richiesta non valida (400).

enum (ContentDirection)

L'orientamento dei contenuti di questa sezione. Se non viene impostato, il valore predefinito è LEFT_TO_RIGHT.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, viene generato un errore di richiesta non valida (400).

object (Dimension)

Il margine superiore della pagina della sezione. Se non viene impostato, il valore predefinito è marginTop di DocumentStyle.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, viene generato un errore di richiesta non valida (400).

object (Dimension)

Il margine inferiore della pagina della sezione. Se non viene impostato, il valore predefinito è marginBottom di DocumentStyle.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, viene generato un errore di richiesta non valida (400).

object (Dimension)

Il margine destro della pagina della sezione. Se non viene impostato, il valore predefinito è marginRight di DocumentStyle. L'aggiornamento del margine destro comporta il ridimensionamento delle colonne in questa sezione. Poiché il margine influisce sulla larghezza della colonna, viene applicato prima delle proprietà della colonna.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, viene generato un errore di richiesta non valida (400).

object (Dimension)

Il margine sinistro della pagina della sezione. Se non viene impostato, il valore predefinito è marginLeft di DocumentStyle. L'aggiornamento del margine sinistro comporta il ridimensionamento delle colonne in questa sezione. Poiché il margine influisce sulla larghezza della colonna, viene applicato prima delle proprietà della colonna.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, viene generato un errore di richiesta non valida (400).

object (Dimension)

Il margine dell'intestazione della sezione. Se non viene impostato, il valore predefinito è marginHeader di DocumentStyle. Se aggiornato, useCustomHeaderFooterMargins è impostato su true in DocumentStyle. Il valore di useCustomHeaderFooterMargins in DocumentStyle indica se per questa sezione viene rispettato un margine di intestazione.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, viene generato un errore di richiesta non valida (400).

object (Dimension)

Il margine del piè di pagina della sezione. Se non viene impostato, il valore predefinito è marginFooter di DocumentStyle. Se aggiornato, useCustomHeaderFooterMargins è impostato su true in DocumentStyle. Il valore di useCustomHeaderFooterMargins in DocumentStyle indica se viene rispettato un margine di piè di pagina per questa sezione

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, viene generato un errore di richiesta non valida (400).

enum (SectionType)

Solo output. Il tipo di sezione.

string

L'ID dell'intestazione predefinita. Se non viene impostato, il valore viene ereditato dal valore SectionBreak's SectionStyle precedente. Se il valore non è impostato nella prima interruzione di sezione, viene ereditato da defaultHeaderId di DocumentStyle.

Questa proprietà è di sola lettura.

string

L'ID del piè di pagina predefinito. Se non viene impostato, il valore viene ereditato dal valore SectionBreak's SectionStyle precedente. Se il valore non è impostato nella prima interruzione di sezione, viene ereditato da defaultFooterId di DocumentStyle.

Questa proprietà è di sola lettura.

string

L'ID dell'intestazione utilizzato solo per la prima pagina della sezione. Se useFirstPageHeaderFooter è true, questo valore viene utilizzato per l'intestazione della prima pagina della sezione. Se è falso, l'intestazione della prima pagina della sezione utilizza defaultHeaderId. Se non viene impostato, il valore viene ereditato dal valore SectionBreak's SectionStyle precedente. Se il valore non è impostato nella prima interruzione di sezione, viene ereditato da firstPageHeaderId di DocumentStyle.

Questa proprietà è di sola lettura.

string

L'ID del piè di pagina utilizzato solo per la prima pagina della sezione. Se useFirstPageHeaderFooter è true, questo valore viene utilizzato per il piè di pagina della prima pagina della sezione. Se è falso, il piè di pagina nella prima pagina della sezione utilizza defaultFooterId. Se non viene impostato, il valore viene ereditato dal valore SectionBreak's SectionStyle precedente. Se il valore non è impostato nella prima interruzione di sezione, viene ereditato da firstPageFooterId di DocumentStyle.

Questa proprietà è di sola lettura.

string

L'ID dell'intestazione utilizzata solo per le pagine pari. Se il valore di useEvenPageHeaderFooter di DocumentStyle è True, questo valore viene utilizzato per le intestazioni delle pagine pari della sezione. Se è false, le intestazioni nelle pagine pari utilizzano defaultHeaderId. Se non viene impostato, il valore viene ereditato dal valore SectionBreak's SectionStyle precedente. Se il valore non è impostato nella prima interruzione di sezione, viene ereditato da evenPageHeaderId di DocumentStyle.

Questa proprietà è di sola lettura.

string

L'ID del piè di pagina utilizzato solo per le pagine pari. Se il valore di useEvenPageHeaderFooter di DocumentStyle è True, questo valore viene utilizzato per i piè di pagina nelle pagine pari della sezione. Se è false, i piè di pagina delle pagine pari utilizzano defaultFooterId. Se non viene impostato, il valore viene ereditato dal valore SectionBreak's SectionStyle precedente. Se il valore non è impostato nella prima interruzione di sezione, viene ereditato da evenPageFooterId di DocumentStyle.

Questa proprietà è di sola lettura.

boolean

Indica se utilizzare gli ID intestazione / piè di pagina della prima pagina per la prima pagina della sezione. Se non è impostato, eredita il valore useFirstPageHeaderFooter di DocumentStyle per la prima sezione. Se il valore non è impostato per i settori successivi, deve essere interpretato come falso.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, viene generato un errore di richiesta non valida (400).

integer

Il numero di pagina da cui iniziare a conteggiare il numero di pagine per questa sezione. Se non è impostato, la numerazione delle pagine continua dalla sezione precedente. Se il valore non è impostato nel primo SectionBreak, fai riferimento a pageNumberStart di DocumentStyle.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, viene generato un errore di richiesta non valida (400).

boolean

Facoltativo. Indica se capovolgere le dimensioni di pageSize di DocumentStyle per questa sezione, il che consente di cambiare l'orientamento della pagina tra verticale e orizzontale. Se non è impostato, il valore eredita da flipPageOrientation di DocumentStyle.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se questa proprietà non viene impostata, viene generato un errore di richiesta non valida (400).

{
  "width": {
    object (Dimension)
  },
  "paddingEnd": {
    object (Dimension)
  }
}

object (Dimension)

Solo output. La larghezza della colonna.

object (Dimension)

La spaziatura interna alla fine della colonna.

{
  "rows": integer,
  "columns": integer,
  "tableRows": [
    {
      object (TableRow)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableStyle": {
    object (TableStyle)
  }
}

integer

Numero di righe nella tabella.

integer

Numero di colonne nella tabella.

È possibile che una tabella non sia rettangolare, quindi alcune righe potrebbero avere un numero diverso di celle.

object (TableRow)

I contenuti e lo stile di ogni riga.

string

Gli ID di inserzione suggeriti. Un Table può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

string

Gli ID eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

object (TableStyle)

Lo stile della tabella.

{
  "startIndex": integer,
  "endIndex": integer,
  "tableCells": [
    {
      object (TableCell)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "suggestedTableRowStyleChanges": {
    string: {
      object (SuggestedTableRowStyle)
    },
    ...
  }
}

integer

L'indice di inizio di questa riga basato su zero, in unità di codice UTF-16.

integer

L'indice di fine di questa riga, esclusivo, basato su zero in unità di codice UTF-16.

object (TableCell)

I contenuti e lo stile di ogni cella di questa riga.

È possibile che una tabella non sia rettangolare, pertanto alcune righe potrebbero avere un numero di celle diverso rispetto ad altre righe della stessa tabella.

string

Gli ID di inserzione suggeriti. Un TableRow può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

string

Gli ID eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

object (TableRowStyle)

Lo stile della riga della tabella.

map (key: string, value: object (SuggestedTableRowStyle))

Lo stile suggerito viene modificato in questa riga, in base all'ID suggerimento.

{
  "startIndex": integer,
  "endIndex": integer,
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "suggestedTableCellStyleChanges": {
    string: {
      object (SuggestedTableCellStyle)
    },
    ...
  }
}

integer

L'indice di inizio di questa cella basato su zero, in unità di codice UTF-16.

integer

L'indice di fine di questa cella, esclusivo, basato su zero in unità di codice UTF-16.

object (StructuralElement)

I contenuti della cella.

object (TableCellStyle)

Lo stile della cella.

string

Gli ID di inserzione suggeriti. Un TableCell può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

string

Gli ID eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

map (key: string, value: object (SuggestedTableCellStyle))

Le modifiche suggerite allo stile della cella della tabella, con chiave in base all'ID suggerimento.

{
  "rowSpan": integer,
  "columnSpan": integer,
  "backgroundColor": {
    object (OptionalColor)
  },
  "borderLeft": {
    object (TableCellBorder)
  },
  "borderRight": {
    object (TableCellBorder)
  },
  "borderTop": {
    object (TableCellBorder)
  },
  "borderBottom": {
    object (TableCellBorder)
  },
  "paddingLeft": {
    object (Dimension)
  },
  "paddingRight": {
    object (Dimension)
  },
  "paddingTop": {
    object (Dimension)
  },
  "paddingBottom": {
    object (Dimension)
  },
  "contentAlignment": enum (ContentAlignment)
}

integer

L'intervallo di righe della cella.

Questa proprietà è di sola lettura.

integer

L'intervallo di colonne della cella.

Questa proprietà è di sola lettura.

object (OptionalColor)

Il colore di sfondo della cella.

object (TableCellBorder)

Il bordo sinistro della cella.

object (TableCellBorder)

Il bordo destro della cella.

object (TableCellBorder)

Il bordo superiore della cella.

object (TableCellBorder)

Il bordo inferiore della cella.

object (Dimension)

La spaziatura interna a sinistra della cella.

object (Dimension)

Il rivestimento destro della cella.

object (Dimension)

Il riempimento superiore della cella.

object (Dimension)

La spaziatura interna inferiore della cella.

enum (ContentAlignment)

L'allineamento dei contenuti nella cella della tabella. L'allineamento predefinito corrisponde a quello delle celle di tabelle appena create nell'editor di Documenti.

{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}

object (OptionalColor)

Il colore del bordo.

Questo colore non può essere trasparente.

object (Dimension)

La larghezza del bordo.

enum (DashStyle)

Lo stile del tratto del bordo.

{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}

object (TableCellStyle)

Un TableCellStyle che include solo le modifiche apportate in questo suggerimento. Questo comando può essere utilizzato insieme a tableCellStyleSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

object (TableCellStyleSuggestionState)

Una maschera che indica quali campi della base TableCellStyle sono stati modificati in questo suggerimento.

{
  "rowSpanSuggested": boolean,
  "columnSpanSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "paddingLeftSuggested": boolean,
  "paddingRightSuggested": boolean,
  "paddingTopSuggested": boolean,
  "paddingBottomSuggested": boolean,
  "contentAlignmentSuggested": boolean
}

boolean

Indica se è stata suggerita una modifica a rowSpan.

boolean

Indica se è stata suggerita una modifica a columnSpan.

boolean

Indica se è stata suggerita una modifica a backgroundColor.

boolean

Indica se è stata suggerita una modifica a borderLeft.

boolean

Indica se è stata suggerita una modifica a borderRight.

boolean

Indica se è stata suggerita una modifica a borderTop.

boolean

Indica se è stata suggerita una modifica a borderBottom.

boolean

Indica se è stata suggerita una modifica a paddingLeft.

boolean

Indica se è stata suggerita una modifica a paddingRight.

boolean

Indica se è stata suggerita una modifica a paddingTop.

boolean

Indica se è stata suggerita una modifica a paddingBottom.

boolean

Indica se è stata suggerita una modifica a contentAlignment.

{
  "minRowHeight": {
    object (Dimension)
  },
  "tableHeader": boolean,
  "preventOverflow": boolean
}

object (Dimension)

L'altezza minima della riga. La riga verrà visualizzata nell'editor di Documenti con un'altezza uguale o superiore a questo valore per mostrare tutti i contenuti delle celle della riga.

boolean

Indica se la riga è un'intestazione di tabella.

boolean

Indica se la riga non può superare i limiti di pagina o colonna.

{
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "tableRowStyleSuggestionState": {
    object (TableRowStyleSuggestionState)
  }
}

object (TableRowStyle)

Un TableRowStyle che include solo le modifiche apportate in questo suggerimento. Questo comando può essere utilizzato insieme a tableRowStyleSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

object (TableRowStyleSuggestionState)

Una maschera che indica quali campi della base TableRowStyle sono stati modificati in questo suggerimento.

{
  "minRowHeightSuggested": boolean
}

boolean

Indica se è stata suggerita una modifica a minRowHeight.

{
  "tableColumnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}

object (TableColumnProperties)

Le proprietà di ogni colonna.

Tieni presente che in Documenti le tabelle contengono righe e le righe contengono celle, in modo simile all'HTML. Pertanto, le proprietà di una riga sono disponibili in tableRowStyle della riga.

{
  "widthType": enum (WidthType),
  "width": {
    object (Dimension)
  }
}

enum (WidthType)

Il tipo di larghezza della colonna.

object (Dimension)

La larghezza della colonna. Imposta quando widthType della colonna è FIXED_WIDTH.

{
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}

object (StructuralElement)

I contenuti del sommario.

string

Gli ID di inserzione suggeriti. Un TableOfContents può avere più ID inserzione se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

string

Gli ID eliminazione suggeriti. Se è vuoto, significa che non sono state suggerite eliminazioni di questi contenuti.

{
  "headerId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

L'ID dell'intestazione.

object (StructuralElement)

I contenuti dell'intestazione.

Gli indici per i contenuti di un'intestazione iniziano da zero.

{
  "footerId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

L'ID del piè di pagina.

object (StructuralElement)