Method: documents.create

Crea un documento vuoto utilizzando il titolo specificato nella richiesta. Gli altri campi della richiesta, inclusi eventuali contenuti forniti, vengono ignorati.

Restituisce il documento creato.

Richiesta HTTP

POST https://docs.googleapis.com/v1/documents

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "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)
    },
    ...
  }
}
Campi
documentId

string

Solo output. L'ID del documento.

title

string

Il titolo del documento.

tabs[]

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.

revisionId

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

suggestionsViewMode

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.

body

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.

headers

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.

footers

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.

footnotes

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.

documentStyle

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.

suggestedDocumentStyleChanges

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.

namedStyles

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.

suggestedNamedStylesChanges

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.

lists

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.

namedRanges

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.

inlineObjects

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.

positionedObjects

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.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Document appena creata.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/documents
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

Per ulteriori informazioni, consulta la Guida all'autorizzazione.