Richieste e risposte

Questa guida illustra i metodi di richiesta e risposta principali che compongono l'API Documenti Google e come aggiornare un documento in batch.

Puoi richiamare l'API Google Documenti utilizzando una richiesta HTTP o un metodo in una libreria client specifica per una lingua. Questi valori sono in linea di massima equivalenti.

L'API Google Documenti restituisce una risposta HTTP che generalmente include il risultato della chiamata della richiesta. Quando utilizzi una libreria client per effettuare le richieste, risposte vengono restituite in un modo specifico per la lingua.

Metodi di richiesta

L'API Documenti supporta i seguenti metodi:

  • documents.create: crea un documento di Documenti Google vuoto.
  • documents.get: restituisci un un'istanza completa del documento specificato. Puoi analizzare il file JSON restituito per estrarre i contenuti, la formattazione e altre caratteristiche del documento.
  • documents.batchUpdate: Invia un elenco di richieste di modifica da applicare atomicamente al documento e restituiscono un elenco di risultati.

I metodi documents.get e documents.batchUpdate richiedono un documentId parametro per specificare il documento di destinazione. Il metodo documents.create restituisce un'istanza del documento creato, da cui puoi leggere il documentId. Per ulteriori informazioni su documentId, consulta la sezione Documento ID.

Aggiornamenti batch

La documents.batchUpdate prende un elenco di request oggetti, ciascuno che specifica una singola richiesta da eseguire. Ad esempio, formatta un paragrafo e poi aggiungere un'immagine in linea. Ogni richiesta viene convalidata prima di essere applicata e vengono elaborate in base all'ordine in cui appaiono nella richiesta batch.

Tutte le richieste nell'aggiornamento batch vengono applicate in modo atomico. Vale a dire che se ci sono richieste non è valido, l'intero aggiornamento non andrà a buon fine e nessuno dei problemi (potenzialmente dipendenti) vengono applicate.

Alcuni metodi di documents.batchUpdate forniscono risposte con informazioni su le richieste applicate. Questi metodi restituiscono una risposta del testo, contiene un elenco di response di oggetti strutturati. Non è necessario che le altre richieste restituiscano informazioni e mostrino un campo vuoto rispondere. Gli oggetti nell'elenco delle risposte occupano lo stesso ordine di indice dell'ordine a una richiesta corrispondente.

Un pattern molto utilizzato per effettuare richieste batch è il seguente:

requests = []
requests.append(first request)
requests.append(second request)
...

body = ... & requests & ...

...batchUpdate(body)

Consulta le best practice per le richieste batch per informazioni dettagliate su come raggruppare le chiamate all'API Docs e la documentazione di riferimento documents.batchUpdate per i tipi di richiesta e risposta.

Operazioni di aggiornamento batch

Esistono vari tipi di richieste di aggiornamento collettivo. Ecco un'analisi dettagliata tipi di richiesta, raggruppati in diverse categorie.

Oggetto AGGIUNGI / INSERISCI AGGIORNA / SOSTITUISCI ELIMINA
Testo InsertTextRequest ReplaceAllTextRequest
Stili CreateParagraphBulletsRequest UpdateTextStyleRequest
UpdateParagraphStyleRequest
UpdateTableCellStyleRequest
UpdateTableRowStyleRequest
UpdateDocumentStyleRequest
UpdateSectionStyleRequest
DeleteParagraphBulletsRequest
Intervalli denominati CreateNamedRangeRequest ReplaceNamedRangeContentRequest DeleteNamedRangeRequest
DeleteContentRangeRequest
Immagini InsertInlineImageRequest ReplaceImageRequest
Tabelle InsertTableRequest
InsertTableRowRequest
InsertTableColumnRequest
UpdateTableColumnPropertiesRequest
MergeTableCellsRequest
UnmergeTableCellsRequest
PinTableHeaderRowsRequest
DeleteTableRowRequest
DeleteTableColumnRequest
Oggetti pagina (inclusi intestazioni e piè di pagina) InsertPageBreakRequest
CreateHeaderRequest
CreateFooterRequest
CreateFootnoteRequest
InsertSectionBreakRequest
DeletePositionedObjectRequest
DeleteHeaderRequest
DeleteFooterRequest