Method: documents.create

Crea un documento vuoto utilizzando il titolo indicato 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 all'interno di un'altra scheda. Le schede secondarie sono rappresentate dal campo Tab.child_tabs.

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 come dovrebbe comportarsi la richiesta se il documento è stato modificato dopo quella revisione. Compilato solo se l'utente ha 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. Un ID revisione restituito è garantito di essere valido solo per 24 ore dalla restituzione e non può essere condiviso tra gli utenti. Se l'ID revisione è rimasto invariato tra una chiamata e l'altra, il documento non è cambiato. Al contrario, un ID modificato (per lo stesso documento e utente) di solito significa 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.document_tab.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.

headers

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

Solo output. Le intestazioni nel documento, digitate dall'ID intestazione.

Campo precedente: utilizza invece Document.tabs.document_tab.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.

footers

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

Solo output. I piè di pagina nel documento, digitati dall'ID piè di pagina.

Campo precedente: utilizza invece Document.tabs.document_tab.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.

footnotes

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

documentStyle

object (DocumentStyle)

Solo output. Lo stile del documento.

Campo precedente: utilizza invece Document.tabs.document_tab.document_style, 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.

suggestedDocumentStyleChanges

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.document_tab.suggested_document_style_changes, 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.

namedStyles

object (NamedStyles)

Solo output. Gli stili con nome del documento.

Campo precedente: utilizza invece Document.tabs.document_tab.named_styles, 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.

suggestedNamedStylesChanges

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.document_tab.suggested_named_styles_changes, 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.

lists

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

Solo output. Elenchi nel documento, digitati per ID elenco.

Campo precedente: utilizza invece Document.tabs.document_tab.lists, 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.

namedRanges

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

Solo output. Intervalli denominati nel documento, digitati per nome.

Campo precedente: utilizza invece Document.tabs.document_tab.named_ranges, 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.

inlineObjects

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.document_tab.inline_objects, 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.

positionedObjects

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

Solo output. Gli oggetti posizionati nel documento, codificati per ID oggetto.

Campo precedente: utilizza invece Document.tabs.document_tab.positioned_objects, 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.

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.