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 come dovrebbe comportarsi la 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 utenti. Se l'ID revisione rimane invariato tra una chiamata e l'altra, 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 viene configurato, 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 viene configurato, 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 viene configurato, 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, digitate dall'ID della 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 viene configurato, 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 viene configurato, questo campo contiene informazioni sulla prima scheda del documento.

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

Solo output. Le modifiche suggerite allo stile del documento, digitate dall'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 con nome 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 con nome del documento, digitati dall'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 viene configurato, 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 viene configurato, questo campo contiene informazioni sulla prima scheda del documento.

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

Solo output. Gli oggetti incorporati nel documento, codificati 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 viene configurato, 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 directory principale 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 con nome della scheda del documento.

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

Le modifiche suggerite agli stili con nome della scheda del documento, digitate dall'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))

Intervalli denominati nella scheda del documento, digitati per nome.

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

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

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

Gli oggetti posizionati nella scheda del documento, codificati per ID oggetto.

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

object (StructuralElement)

I contenuti del corpo.

Gli indici dei 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 finale in base zero di questo elemento strutturale, esclusivo, nelle 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 parti.

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 che si consiglia di associare a questo paragrafo, digitati dall'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 basato su 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 di paragrafo con interruzione di colonna.

object (FootnoteReference)

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

object (HorizontalRule)

Un elemento di paragrafo con righello orizzontale.

object (Equation)

Un elemento di paragrafo 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 testuali nell'esecuzione vengono sostituiti con il carattere Unicode U+E907.

string

Gli ID di inserimento 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 viene lasciato vuoto, non sono previste eliminazioni suggerite di questi contenuti.

object (TextStyle)

Lo stile del testo di questa esecuzione.

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

Lo stile di testo suggerito viene modificato in questa esecuzione, specificato dall'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 o meno in grassetto.

boolean

Indica se il testo è in corsivo.

boolean

Se il testo è sottolineato o meno.

boolean

Indica se il testo è barrato o meno.

boolean

Indica se il testo è in minuscolo.

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 in primo piano del testo. Se impostato, il colore è RGB o trasparente, a seconda del campo color.

object (Dimension)

La dimensione del carattere del testo.

object (WeightedFontFamily)

La famiglia di caratteri e lo spessore visualizzato del testo.

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

Se il criterio weightedFontFamily#weight non viene configurato, 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 offset di riferimento SUPERSCRIPT o SUBSCRIPT viene visualizzato automaticamente con caratteri di dimensioni inferiori, calcolati in base al campo fontSize. Le modifiche in questo campo non influiscono su fontSize.

object (Link)

La destinazione del link ipertestuale del testo. Se il criterio non viene configurato, non viene visualizzato 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 del testo in primo piano viene aggiornato al colore predefinito del link e il testo viene 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 supera il limite di un paragrafo, ad esempio "ABC\n123", separerà i caratteri della nuova riga in esecuzioni di testo distinte. 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 viene 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, compreso tra 0,0 e 1,0.

number

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

number

Il componente blu del colore, compreso tra 0,0 e 1,0.

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

number

La grandezza.

enum (Unit)

Le unità di grandezza.

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

string

La famiglia di caratteri del testo.

La famiglia di caratteri può essere qualsiasi carattere disponibile nel menu Caratteri in Documenti o in 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 del valore bold risolto di weight e dello stile di testo determina la ponderazione visualizzata, dopo aver tenuto conto dell'ereditarietà:

• Se il testo è in grassetto e lo spessore è inferiore a 400, lo spessore visualizzato è 400.
• Se il testo è in grassetto e la ponderazione è maggiore o uguale a 400 ma è inferiore a 700, la ponderazione visualizzata è 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 un'unica scheda, i link ai preferiti all'interno della scheda singola continuano a restituire Link.bookmarkId se il parametro includeTabsContent è impostato su false o non viene configurato. 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, questo campo viene restituito.

string

L'ID di un segnalibro 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 i 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 segnalibro è considerato come proveniente dall'ID scheda specificato nella richiesta. Se un ID scheda non è specificato nella richiesta, viene considerato come proveniente dalla prima scheda del documento.

string

L'ID di un'intestazione 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 se includeTabsContent è impostato su false nei documenti contenenti una singola scheda e si collega a un'intestazione all'interno della scheda singola. In caso contrario, viene restituito Link.heading.

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

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

string

L'ID di un segnalibro in questo documento.

string

L'ID della scheda contenente il preferito.

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

string

L'ID di un titolo in questo documento.

string

L'ID della scheda contenente questa intestazione.

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

object (TextStyle)

Un elemento TextStyle che include solo le modifiche apportate in questo suggerimento. Questa opzione può essere utilizzata 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 inserimento 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, questo non è un inserimento suggerito.

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 interruzione di pagina.

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 viene modificato in questa interruzione di pagina, contrassegnata dall'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, questo non è un inserimento suggerito.

string

Gli ID eliminazione suggeriti. Se viene lasciato vuoto, non sono previste eliminazioni suggerite di questi contenuti.

object (TextStyle)

Lo stile del testo di questa interruzione 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 della risorsa footnote che include i contenuti di questo riferimento a nota a piè di pagina.

string

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

string

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

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 del testo suggerito viene modificato in questo Piè di pagina, specificato dall'ID suggerimento.

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

string

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

string

Gli ID eliminazione suggeriti. Se viene lasciato vuoto, non sono previste eliminazioni suggerite di questi contenuti.

object (TextStyle)

Lo stile del testo di questa regola orizzontale.

In modo simile ai contenuti testuali, come esecuzioni di testo e riferimenti a note a piè di pagina, lo stile del testo di una regola 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 viene modificato in questa regola orizzontale, digitata dall'ID suggerimento.

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

string

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

string

Gli ID di 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 in 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 viene lasciato vuoto, non sono previste eliminazioni suggerite di questi contenuti.

object (TextStyle)

Lo stile di testo di questo elemento InlineObject.

In modo simile ai contenuti testuali, come esecuzioni di testo e riferimenti a note a piè di pagina, lo stile del testo di un elemento di oggetto incorporato 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 collegamento.

string

ID per i suggerimenti che inseriscono il link di 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 apportato 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 viene modificato in questo Person, specificato dall'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 è visualizzato nel testo del link anziché l'indirizzo email della persona.

string

Solo output. L'indirizzo email collegato a 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 collegamento.

string

ID per i suggerimenti che inseriscono questo link nel documento. Un RichLink potrebbe avere più ID inserimento se si tratta di una modifica suggerita nidificata (ad esempio, un suggerimento all'interno di un suggerimento apportato da un altro utente). Se vuoto, il link di 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 suggeriscono di eliminarlo. Se è vuoto, il link a questa persona non viene suggerito per l'eliminazione.

object (TextStyle)

Lo stile del testo di questo elemento: 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 di RichLink come visualizzato nel link. Questo titolo corrisponde a quello della risorsa collegata al momento dell'inserimento o dell'ultimo aggiornamento del link. Questo campo è sempre presente.

string

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

string

Solo output. Il tipo MIME di RichLink, se presente (ad esempio, quando è 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 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 sulle altre proprietà di ParagraphStyle, il tipo di stile denominato viene applicato prima dell'aggiornamento delle altre proprietà.

enum (Alignment)

L'allineamento del testo di 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 viene configurato, il valore predefinito è LEFT_TO_RIGHT, poiché la direzione del paragrafo non viene ereditata.

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 viene configurato, il valore viene ereditato dall'unità organizzativa principale.

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

Impossibile aggiornare parzialmente i bordi del paragrafo. Quando modifichi il bordo di un paragrafo, è necessario specificare il nuovo bordo.

object (ParagraphBorder)

Il bordo nella parte superiore di questo paragrafo. Se non viene configurato, il valore viene ereditato dall'unità organizzativa 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 viene configurato, il valore viene ereditato dall'unità organizzativa 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 viene configurato, il valore viene ereditato dall'unità organizzativa 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 viene configurato, il valore viene ereditato dall'unità organizzativa principale.

I bordi dei paragrafi non possono essere aggiornati parzialmente. Quando modifichi il bordo di un paragrafo, è necessario specificare il nuovo bordo.

object (Dimension)

La quantità di rientro per la prima riga del paragrafo. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

object (Dimension)

La quantità di rientro del paragrafo sul lato corrispondente all'inizio del testo, in base alla direzione del paragrafo corrente. 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 viene configurato, il valore viene ereditato dall'unità organizzativa 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 tutte le righe del paragrafo devono essere disposte sulla stessa pagina o colonna, se possibile. Se non è impostato, il valore viene ereditato dall'elemento principale.

boolean

Indica se almeno una parte di questo paragrafo deve essere posizionata nella stessa pagina o colonna del paragrafo successivo, se possibile. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

boolean

Se evitare le vedove e gli orfani per il paragrafo. Se non viene configurato, il valore viene ereditato dall'unità organizzativa principale.

object (Shading)

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

boolean

Indica se il paragrafo corrente deve iniziare sempre 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)

L'offset tra questa tabulazione 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 elemento ParagraphStyle che include solo le modifiche apportate in questo suggerimento. Questa opzione può essere utilizzata insieme a paragraphStyleSuggestionState per vedere quali campi sono stati modificati e i relativi nuovi valori.

object (ParagraphStyleSuggestionState)

Una maschera che indica quali campi nella 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 a 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 a 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 inserimento se si tratta di una modifica suggerita nidificata. Se è vuoto, non si tratta di un'inserzione suggerita.

string

Gli ID eliminazione suggeriti. Se viene lasciato vuoto, non sono previste eliminazioni suggerite 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 se 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 annulli questa proprietà, viene generato un errore di richiesta non valido 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 annulli questa proprietà, viene generato un errore di richiesta non valido 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 annulli questa proprietà, viene generato un errore di richiesta non valido 400.

object (Dimension)

Il margine sinistro della sezione. Se non viene configurato, il valore predefinito è marginLeft in DocumentStyle. L'aggiornamento del margine sinistro comporta il ridimensionamento delle colonne di 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 configurato, il valore predefinito è marginHeader in DocumentStyle. Se viene aggiornata, il valore 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 configurato, il valore predefinito è marginFooter in DocumentStyle. Se viene aggiornata, il valore 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 annulli questa proprietà, viene generato un errore di richiesta non valido 400.

enum (SectionType)

Solo output. Il tipo di sezione.

string

L'ID dell'intestazione predefinita. Se non viene configurato, il valore eredita dal precedente elemento SectionStyle SectionBreak's. Se il valore non viene impostato nella prima Interruzione di sezione, viene ereditato dall'elemento 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 nella 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 utilizzato solo per le pagine pari. Se il valore di useEvenPageHeaderFooter di DocumentStyle è true, questo valore viene utilizzato per le intestazioni nelle 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 è falso, 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 viene impostato nella prima interruzione di sezione, viene ereditato dall'elemento 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 viene impostato per i settori successivi, dovrebbe essere interpretato come falso.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli questa proprietà, viene generato un errore di richiesta non valido 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 annulli questa proprietà, viene generato un errore di richiesta non valido 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 viene configurato, il valore eredita dall'elemento flipPageOrientation di DocumentStyle.

Quando aggiorni questa proprietà, è necessario impostare un valore concreto. Se annulli questa proprietà, viene generato un errore di richiesta non valido 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.

Poiché una tabella non è rettangolare, alcune righe possono avere un numero diverso di celle.

object (TableRow)

I contenuti e lo stile di ogni riga.

string

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

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 iniziale in base zero di questa riga, 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)

Contenuti e stile di ogni cella di questa riga.

Una tabella può non essere rettangolare, quindi alcune righe potrebbero avere un numero di celle diverso rispetto alle altre righe della stessa tabella.

string

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

string

Gli ID di 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 iniziale in base zero di questa cella, in unità di codice UTF-16.

integer

L'indice finale in base zero di questa cella, escluso, nelle 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 inserimento se si tratta di una modifica suggerita nidificata. Se vuoto, questo non è un inserimento suggerito.

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)

Bordo superiore della cella.

object (TableCellBorder)

Bordo inferiore della cella.

object (Dimension)

La spaziatura interna a sinistra della cella.

object (Dimension)

La spaziatura interna destra della cella.

object (Dimension)

Spaziatura interna 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 trattino del bordo.

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

object (TableCellStyle)

Un elemento 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 a un'altezza uguale o superiore a questo valore per mostrare tutti i contenuti delle celle della riga.

boolean

Indica se la riga è l'intestazione di una tabella.

boolean

Indica se la riga non può superare i limiti della pagina o delle colonne.

{
  "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 viene lasciato vuoto, non sono previste eliminazioni suggerite 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)

Contenuti del piè di pagina.

Gli indici dei contenuti di un piè di pagina iniziano da zero.

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

string

L'ID della nota a piè di pagina.

object (StructuralElement)

I contenuti della nota a piè di pagina.

Gli indici dei contenuti di una nota a piè di pagina iniziano da zero.

{
  "background": {
    object (Background)
  },
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "useEvenPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "pageSize": {
    object (Size)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "useCustomHeaderFooterMargins": boolean,
  "flipPageOrientation": boolean
}

object (Background)

Lo sfondo del documento. I documenti non possono avere un colore di sfondo trasparente.

string

L'ID dell'intestazione predefinita. Se non viene impostato, non è presente un'intestazione predefinita.

Questa proprietà è di sola lettura.

string

L'ID del piè di pagina predefinito. Se non viene configurato, non è presente un piè di pagina predefinito.

Questa proprietà è di sola lettura.

string

L'ID dell'intestazione utilizzata solo per le pagine pari. Il valore useEvenPageHeaderFooter determina se utilizzare defaultHeaderId o questo valore per l'intestazione nelle pagine pari. Se non è impostato, non è presente l'intestazione della pagina pari.

Questa proprietà è di sola lettura.

string

L'ID del piè di pagina utilizzato solo per le pagine pari. Il valore di useEvenPageHeaderFooter determina se utilizzare defaultFooterId o questo valore per il piè di pagina nelle pagine pari. Se non è impostato, non è presente il piè di pagina per le pagine pari.

Questa proprietà è di sola lettura.

string

L'ID dell'intestazione utilizzato solo per la prima pagina. Se il criterio non viene configurato, non esiste un'intestazione univoca per la prima pagina. Il valore di useFirstPageHeaderFooter determina se utilizzare defaultHeaderId o questo valore per l'intestazione della prima pagina. Se non viene configurato, non viene visualizzata l'intestazione della prima pagina.

Questa proprietà è di sola lettura.

string

L'ID del piè di pagina utilizzato solo per la prima pagina. Se non è impostato, non esiste un piè di pagina univoco per la prima pagina. Il valore useFirstPageHeaderFooter determina se utilizzare defaultFooterId o questo valore per il piè di pagina sulla prima pagina. Se non è impostato, non è presente il piè di pagina della prima pagina.

Questa proprietà è di sola lettura.

boolean

Indica se utilizzare gli ID intestazione/piè di pagina della prima pagina per la prima pagina.

boolean

Indica se utilizzare gli ID intestazione / piè di pagina delle pagine pari per le pagine pari.

integer

Il numero di pagina da cui iniziare a conteggiare il numero di pagine.

object (Dimension)

Il margine superiore della pagina.

L'aggiornamento del margine superiore pagina nello stile del documento consente di cancellare il margine superiore della pagina in tutti gli stili di sezione.

object (Dimension)

Margine inferiore della pagina.

L'aggiornamento del margine inferiore della pagina nello stile del documento comporta la cancellazione di quello in tutti gli stili di sezione.

object (Dimension)

Il margine della pagina destro.

L'aggiornamento del margine destro della pagina nello stile del documento ne cancella il valore in tutti gli stili di sezione. Inoltre, le colonne potrebbero essere ridimensionate in tutte le sezioni.

object (Dimension)

Il margine sinistro della pagina.

L'aggiornamento del margine sinistro della pagina nello stile del documento ne cancella il valore in tutti gli stili di sezione. Inoltre, potrebbe causare il ridimensionamento delle colonne in tutte le sezioni.

object (Size)

Le dimensioni di una pagina nel documento.

object (Dimension)

La quantità di spazio tra la parte superiore della pagina e i contenuti dell'intestazione.

object (Dimension)

La quantità di spazio tra la parte inferiore della pagina e i contenuti del piè di pagina.

boolean

Indica se DocumentStyle marginHeader, SectionStyle marginHeader e DocumentStyle marginFooter, SectionStyle marginFooter sono rispettati. Se il valore è false, vengono utilizzati i valori predefiniti nell'editor di Documenti per i margini di intestazione e piè di pagina.

Questa proprietà è di sola lettura.

boolean

(Facoltativo) Indica se invertire le dimensioni dell'elemento pageSize per modificare l'orientamento della pagina tra verticale e orizzontale.

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

object (OptionalColor)

Il colore di sfondo.