Requests

Richiesta

Un singolo tipo di aggiornamento da applicare a un foglio di lavoro.

Rappresentazione JSON 
{

  "updateSpreadsheetProperties": {
    object (UpdateSpreadsheetPropertiesRequest)
  },
  "updateSheetProperties": {
    object (UpdateSheetPropertiesRequest)
  },
  "updateDimensionProperties": {
    object (UpdateDimensionPropertiesRequest)
  },
  "updateNamedRange": {
    object (UpdateNamedRangeRequest)
  },
  "repeatCell": {
    object (RepeatCellRequest)
  },
  "addNamedRange": {
    object (AddNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "addSheet": {
    object (AddSheetRequest)
  },
  "deleteSheet": {
    object (DeleteSheetRequest)
  },
  "autoFill": {
    object (AutoFillRequest)
  },
  "cutPaste": {
    object (CutPasteRequest)
  },
  "copyPaste": {
    object (CopyPasteRequest)
  },
  "mergeCells": {
    object (MergeCellsRequest)
  },
  "unmergeCells": {
    object (UnmergeCellsRequest)
  },
  "updateBorders": {
    object (UpdateBordersRequest)
  },
  "updateCells": {
    object (UpdateCellsRequest)
  },
  "addFilterView": {
    object (AddFilterViewRequest)
  },
  "appendCells": {
    object (AppendCellsRequest)
  },
  "clearBasicFilter": {
    object (ClearBasicFilterRequest)
  },
  "deleteDimension": {
    object (DeleteDimensionRequest)
  },
  "deleteEmbeddedObject": {
    object (DeleteEmbeddedObjectRequest)
  },
  "deleteFilterView": {
    object (DeleteFilterViewRequest)
  },
  "duplicateFilterView": {
    object (DuplicateFilterViewRequest)
  },
  "duplicateSheet": {
    object (DuplicateSheetRequest)
  },
  "findReplace": {
    object (FindReplaceRequest)
  },
  "insertDimension": {
    object (InsertDimensionRequest)
  },
  "insertRange": {
    object (InsertRangeRequest)
  },
  "moveDimension": {
    object (MoveDimensionRequest)
  },
  "updateEmbeddedObjectPosition": {
    object (UpdateEmbeddedObjectPositionRequest)
  },
  "pasteData": {
    object (PasteDataRequest)
  },
  "textToColumns": {
    object (TextToColumnsRequest)
  },
  "updateFilterView": {
    object (UpdateFilterViewRequest)
  },
  "deleteRange": {
    object (DeleteRangeRequest)
  },
  "appendDimension": {
    object (AppendDimensionRequest)
  },
  "addConditionalFormatRule": {
    object (AddConditionalFormatRuleRequest)
  },
  "updateConditionalFormatRule": {
    object (UpdateConditionalFormatRuleRequest)
  },
  "deleteConditionalFormatRule": {
    object (DeleteConditionalFormatRuleRequest)
  },
  "sortRange": {
    object (SortRangeRequest)
  },
  "setDataValidation": {
    object (SetDataValidationRequest)
  },
  "setBasicFilter": {
    object (SetBasicFilterRequest)
  },
  "addProtectedRange": {
    object (AddProtectedRangeRequest)
  },
  "updateProtectedRange": {
    object (UpdateProtectedRangeRequest)
  },
  "deleteProtectedRange": {
    object (DeleteProtectedRangeRequest)
  },
  "autoResizeDimensions": {
    object (AutoResizeDimensionsRequest)
  },
  "addChart": {
    object (AddChartRequest)
  },
  "updateChartSpec": {
    object (UpdateChartSpecRequest)
  },
  "updateBanding": {
    object (UpdateBandingRequest)
  },
  "addBanding": {
    object (AddBandingRequest)
  },
  "deleteBanding": {
    object (DeleteBandingRequest)
  },
  "createDeveloperMetadata": {
    object (CreateDeveloperMetadataRequest)
  },
  "updateDeveloperMetadata": {
    object (UpdateDeveloperMetadataRequest)
  },
  "deleteDeveloperMetadata": {
    object (DeleteDeveloperMetadataRequest)
  },
  "randomizeRange": {
    object (RandomizeRangeRequest)
  },
  "addDimensionGroup": {
    object (AddDimensionGroupRequest)
  },
  "deleteDimensionGroup": {
    object (DeleteDimensionGroupRequest)
  },
  "updateDimensionGroup": {
    object (UpdateDimensionGroupRequest)
  },
  "trimWhitespace": {
    object (TrimWhitespaceRequest)
  },
  "deleteDuplicates": {
    object (DeleteDuplicatesRequest)
  },
  "updateEmbeddedObjectBorder": {
    object (UpdateEmbeddedObjectBorderRequest)
  },
  "addSlicer": {
    object (AddSlicerRequest)
  },
  "updateSlicerSpec": {
    object (UpdateSlicerSpecRequest)
  },
  "addDataSource": {
    object (AddDataSourceRequest)
  },
  "updateDataSource": {
    object (UpdateDataSourceRequest)
  },
  "deleteDataSource": {
    object (DeleteDataSourceRequest)
  },
  "refreshDataSource": {
    object (RefreshDataSourceRequest)
  },
  "cancelDataSourceRefresh": {
    object (CancelDataSourceRefreshRequest)
  },
  "addTable": {
    object (AddTableRequest)
  },
  "updateTable": {
    object (UpdateTableRequest)
  },
  "deleteTable": {
    object (DeleteTableRequest)
  },
  "insertComment": {
    object (InsertCommentRequest)
  },
  "addCommentReply": {
    object (AddCommentReplyRequest)
  },
  "updateCommentPost": {
    object (UpdateCommentPostRequest)
  },
  "deleteComment": {
    object (DeleteCommentRequest)
  },
  "deleteCommentReply": {
    object (DeleteCommentReplyRequest)
  }
}
Campi
Il tipo di aggiornamento. È necessario un solo campo. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
updateSpreadsheetProperties

object (UpdateSpreadsheetPropertiesRequest)

Aggiorna le proprietà del foglio di lavoro.

updateSheetProperties

object (UpdateSheetPropertiesRequest)

Aggiorna le proprietà di un foglio.

updateDimensionProperties

object (UpdateDimensionPropertiesRequest)

Aggiorna le proprietà delle dimensioni.

updateNamedRange

object (UpdateNamedRangeRequest)

Aggiorna un intervallo denominato.

repeatCell

object (RepeatCellRequest)

Ripete una singola cella in un intervallo.

addNamedRange

object (AddNamedRangeRequest)

Aggiunge un intervallo denominato.

deleteNamedRange

object (DeleteNamedRangeRequest)

Elimina un intervallo denominato.

addSheet

object (AddSheetRequest)

Aggiunge un foglio.

deleteSheet

object (DeleteSheetRequest)

Elimina un foglio.

autoFill

object (AutoFillRequest)

Compila automaticamente più dati in base a quelli esistenti.

cutPaste

object (CutPasteRequest)

Taglia i dati da un'area e li incolla in un'altra.

copyPaste

object (CopyPasteRequest)

Copia i dati da un'area e li incolla in un'altra.

mergeCells

object (MergeCellsRequest)

Unisce le celle.

unmergeCells

object (UnmergeCellsRequest)

Annulla l'unione delle celle unite.

updateBorders

object (UpdateBordersRequest)

Aggiorna i bordi in un intervallo di celle.

updateCells

object (UpdateCellsRequest)

Aggiorna molte celle contemporaneamente.

addFilterView

object (AddFilterViewRequest)

Aggiunge una visualizzazione filtrata.

appendCells

object (AppendCellsRequest)

Aggiunge celle dopo l'ultima riga con dati in un foglio.

clearBasicFilter

object (ClearBasicFilterRequest)

Cancella il filtro di base su un foglio.

deleteDimension

object (DeleteDimensionRequest)

Elimina righe o colonne in un foglio.

deleteEmbeddedObject

object (DeleteEmbeddedObjectRequest)

Elimina un oggetto incorporato (ad esempio, grafico, immagine) in un foglio.

deleteFilterView

object (DeleteFilterViewRequest)

Elimina una visualizzazione filtrata da un foglio.

duplicateFilterView

object (DuplicateFilterViewRequest)

Duplica una visualizzazione filtrata.

duplicateSheet

object (DuplicateSheetRequest)

Duplica un foglio.

findReplace

object (FindReplaceRequest)

Trova e sostituisce le occorrenze di un testo con un altro.

insertDimension

object (InsertDimensionRequest)

Inserisce nuove righe o colonne in un foglio.

insertRange

object (InsertRangeRequest)

Inserisce nuove celle in un foglio, spostando quelle esistenti.

moveDimension

object (MoveDimensionRequest)

Sposta righe o colonne in un'altra posizione di un foglio.

updateEmbeddedObjectPosition

object (UpdateEmbeddedObjectPositionRequest)

Aggiorna la posizione di un oggetto incorporato (ad es. grafico, immagine).

pasteData

object (PasteDataRequest)

Incolla i dati (HTML o delimitati) in un foglio.

textToColumns

object (TextToColumnsRequest)

Converte una colonna di testo in più colonne di testo.

updateFilterView

object (UpdateFilterViewRequest)

Aggiorna le proprietà di una visualizzazione filtrata.

deleteRange

object (DeleteRangeRequest)

Elimina un intervallo di celle da un foglio, spostando le celle rimanenti.

appendDimension

object (AppendDimensionRequest)

Aggiunge le dimensioni alla fine di un foglio.

addConditionalFormatRule

object (AddConditionalFormatRuleRequest)

Aggiunge una nuova regola di formattazione condizionale.

updateConditionalFormatRule

object (UpdateConditionalFormatRuleRequest)

Aggiorna una regola di formattazione condizionale esistente.

deleteConditionalFormatRule

object (DeleteConditionalFormatRuleRequest)

Elimina una regola di formattazione condizionale esistente.

sortRange

object (SortRangeRequest)

Ordina i dati in un intervallo.

setDataValidation

object (SetDataValidationRequest)

Imposta la convalida dei dati per una o più celle.

setBasicFilter

object (SetBasicFilterRequest)

Imposta il filtro di base su un foglio.

addProtectedRange

object (AddProtectedRangeRequest)

Aggiunge un intervallo protetto.

updateProtectedRange

object (UpdateProtectedRangeRequest)

Aggiorna un intervallo protetto.

deleteProtectedRange

object (DeleteProtectedRangeRequest)

Elimina un intervallo protetto.

autoResizeDimensions

object (AutoResizeDimensionsRequest)

Ridimensiona automaticamente una o più dimensioni in base ai contenuti delle celle della dimensione.

addChart

object (AddChartRequest)

Aggiunge un grafico.

updateChartSpec

object (UpdateChartSpecRequest)

Aggiorna le specifiche di un grafico.

updateBanding

object (UpdateBandingRequest)

Aggiorna un intervallo a bande

addBanding

object (AddBandingRequest)

Aggiunge un nuovo intervallo a bande

deleteBanding

object (DeleteBandingRequest)

Rimuove un intervallo a bande

createDeveloperMetadata

object (CreateDeveloperMetadataRequest)

Crea nuovi metadati dello sviluppatore

updateDeveloperMetadata

object (UpdateDeveloperMetadataRequest)

Aggiorna una voce dei metadati dello sviluppatore esistente

deleteDeveloperMetadata

object (DeleteDeveloperMetadataRequest)

Elimina i metadati dello sviluppatore

randomizeRange

object (RandomizeRangeRequest)

Randomizza l'ordine delle righe in un intervallo.

addDimensionGroup

object (AddDimensionGroupRequest)

Crea un gruppo nell'intervallo specificato.

deleteDimensionGroup

object (DeleteDimensionGroupRequest)

Elimina un gruppo nell'intervallo specificato.

updateDimensionGroup

object (UpdateDimensionGroupRequest)

Aggiorna lo stato del gruppo specificato.

trimWhitespace

object (TrimWhitespaceRequest)

Taglia gli spazi vuoti (come spazi, tabulazioni o nuove righe) nelle celle.

deleteDuplicates

object (DeleteDuplicatesRequest)

Rimuove le righe contenenti valori duplicati nelle colonne specificate di un intervallo di celle.

updateEmbeddedObjectBorder

object (UpdateEmbeddedObjectBorderRequest)

Aggiorna il bordo di un oggetto incorporato.

addSlicer

object (AddSlicerRequest)

Aggiunge un controllo filtro.

updateSlicerSpec

object (UpdateSlicerSpecRequest)

Aggiorna le specifiche di uno slicer.

addDataSource

object (AddDataSourceRequest)

Aggiunge un'origine dati.

updateDataSource

object (UpdateDataSourceRequest)

Aggiorna un'origine dati.

deleteDataSource

object (DeleteDataSourceRequest)

Elimina un'origine dati.

refreshDataSource

object (RefreshDataSourceRequest)

Aggiorna una o più origini dati e gli oggetti db associati.

cancelDataSourceRefresh

object (CancelDataSourceRefreshRequest)

Annulla gli aggiornamenti di una o più origini dati e degli oggetti db associati.

addTable

object (AddTableRequest)

Aggiunge una tabella.

updateTable

object (UpdateTableRequest)

Aggiorna una tabella.

deleteTable

object (DeleteTableRequest)

Una richiesta di eliminazione di una tabella.

insertComment

object (InsertCommentRequest)

Inserisce un CommentThread nel foglio di lavoro.

addCommentReply

object (AddCommentReplyRequest)

Aggiunge una risposta a un CommentThread.

updateCommentPost

object (UpdateCommentPostRequest)

Aggiorna un post esistente (post principale o risposta) di un CommentThread.

deleteComment

object (DeleteCommentRequest)

Elimina un CommentThread.

deleteCommentReply

object (DeleteCommentReplyRequest)

Elimina una risposta Post da un CommentThread

Fine dei campi che si escludono a vicenda.

UpdateSpreadsheetPropertiesRequest

Aggiorna le proprietà di un foglio di lavoro.

Rappresentazione JSON 
{
  "properties": {
    object (SpreadsheetProperties)
  },
  "fields": string
}
Campi
properties

object (SpreadsheetProperties)

Le proprietà da aggiornare.

fields

string (FieldMask format)

I campi da aggiornare. È necessario specificare almeno un campo. La radice "properties" è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come abbreviazione per elencare tutti i campi.

UpdateSheetPropertiesRequest

Aggiorna le proprietà del foglio con il sheetId specificato.

Rappresentazione JSON 
{
  "properties": {
    object (SheetProperties)
  },
  "fields": string
}
Campi
properties

object (SheetProperties)

Le proprietà da aggiornare.

fields

string (FieldMask format)

I campi da aggiornare. È necessario specificare almeno un campo. La radice properties è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come abbreviazione per elencare tutti i campi.

UpdateDimensionPropertiesRequest

Aggiorna le proprietà delle dimensioni all'interno dell'intervallo specificato.

Rappresentazione JSON 
{
  "properties": {
    object (DimensionProperties)
  },
  "fields": string,

  "range": {
    object (DimensionRange)
  },
  "dataSourceSheetRange": {
    object (DataSourceSheetDimensionRange)
  }
}
Campi
properties

object (DimensionProperties)

Proprietà da aggiornare.

fields

string (FieldMask format)

I campi da aggiornare. È necessario specificare almeno un campo. La radice properties è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come abbreviazione per elencare tutti i campi.

L'intervallo di dimensioni. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
range

object (DimensionRange)

Le righe o le colonne da aggiornare.

dataSourceSheetRange

object (DataSourceSheetDimensionRange)

Le colonne di un foglio dell'origine dati da aggiornare.

Fine dei campi che si escludono a vicenda.

DataSourceSheetDimensionRange

Un intervallo lungo una singola dimensione in un DATA_SOURCE foglio.

Rappresentazione JSON 
{
  "sheetId": integer,
  "columnReferences": [
    {
      object (DataSourceColumnReference)
    }
  ]
}
Campi
sheetId

integer

L'ID del foglio dell'origine dati in cui si trova l'intervallo.

columnReferences[]

object (DataSourceColumnReference)

Le colonne del foglio dell'origine dati.

UpdateNamedRangeRequest

Aggiorna le proprietà dell'intervallo denominato con il namedRangeId specificato.

Rappresentazione JSON 
{
  "namedRange": {
    object (NamedRange)
  },
  "fields": string
}
Campi
namedRange

object (NamedRange)

L'intervallo denominato da aggiornare con le nuove proprietà.

fields

string (FieldMask format)

I campi da aggiornare. È necessario specificare almeno un campo. La radice namedRange è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come abbreviazione per elencare tutti i campi.

RepeatCellRequest

Aggiorna tutte le celle nell'intervallo con i valori dell'oggetto Cella specificato. Vengono aggiornati solo i campi elencati nel campo fields; gli altri rimangono invariati.

Se scrivi una cella con una formula, gli intervalli della formula aumenteranno automaticamente per ogni campo dell'intervallo. Ad esempio, se scrivi una cella con la formula =A1 nell'intervallo B2:C4, B2 sarà =A1, B3 sarà =A2, B4 sarà =A3, C2 sarà =B1, C3 sarà =B2, C4 sarà =B3.

Per mantenere statici gli intervalli della formula, utilizza l'indicatore $. Ad esempio, utilizza la formula =$A$1 per impedire l'incremento sia della riga che della colonna.

Rappresentazione JSON 
{
  "range": {
    object (GridRange)
  },
  "cell": {
    object (CellData)
  },
  "fields": string
}
Campi
range

object (GridRange)

L'intervallo in cui ripetere la cella.

cell

object (CellData)

I dati da scrivere.

fields

string (FieldMask format)

I campi da aggiornare. È necessario specificare almeno un campo. La radice cell è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come abbreviazione per elencare tutti i campi.

AddNamedRangeRequest

Aggiunge un intervallo denominato al foglio di lavoro.

Rappresentazione JSON 
{
  "namedRange": {
    object (NamedRange)
  }
}
Campi
namedRange

object (NamedRange)

L'intervallo denominato da aggiungere. Il campo namedRangeId è facoltativo; se non viene impostato, viene generato un ID in modo casuale. È un errore specificare l'ID di un intervallo già esistente.

DeleteNamedRangeRequest

Rimuove l'intervallo denominato con l'ID specificato dal foglio di lavoro.

Rappresentazione JSON 
{
  "namedRangeId": string
}
Campi
namedRangeId

string

L'ID dell'intervallo denominato da eliminare.

AddSheetRequest

Aggiunge un nuovo foglio. Quando viene aggiunto un foglio a un determinato indice, gli indici di tutti i fogli successivi vengono incrementati. Per aggiungere un foglio degli oggetti, utilizza AddChartRequest e specifica EmbeddedObjectPosition.sheetId o EmbeddedObjectPosition.newSheet.

Rappresentazione JSON 
{
  "properties": {
    object (SheetProperties)
  }
}
Campi
properties

object (SheetProperties)

Le proprietà che deve avere il nuovo foglio. Tutte le proprietà sono facoltative. Il campo sheetId è facoltativo; se non viene impostato, viene generato un ID in modo casuale. È un errore specificare l'ID di un foglio esistente.

DeleteSheetRequest

Elimina il foglio richiesto.

Rappresentazione JSON 
{
  "sheetId": integer
}
Campi
sheetId

integer

L'ID del foglio da eliminare.

Se il foglio è di tipo DATA_SOURCE, viene eliminato anche il DataSource associato.

AutoFillRequest

Compila più dati in base a quelli esistenti.

Rappresentazione JSON 
{
  "useAlternateSeries": boolean,

  "range": {
    object (GridRange)
  },
  "sourceAndDestination": {
    object (SourceAndDestination)
  }
}
Campi
useAlternateSeries

boolean

True se dobbiamo generare dati con la serie "alternativa". Questo valore varia in base al tipo e alla quantità di dati di origine.

L'area da compilare automaticamente. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
range

object (GridRange)

L'intervallo da compilare automaticamente. Verrà esaminato l'intervallo, verrà rilevata la posizione contenente dati e questi verranno inseriti automaticamente nel resto dell'intervallo.

sourceAndDestination

object (SourceAndDestination)

Le aree di origine e di destinazione da compilare automaticamente. Elenca esplicitamente l'origine della compilazione automatica e dove estendere questi dati.

Fine dei campi che si escludono a vicenda.

SourceAndDestination

Una combinazione di un intervallo di origine e di come estenderlo.

Rappresentazione JSON 
{
  "source": {
    object (GridRange)
  },
  "dimension": enum (Dimension),
  "fillLength": integer
}
Campi
source

object (GridRange)

La posizione dei dati da utilizzare come origine della compilazione automatica.

dimension

enum (Dimension)

La dimensione in cui devono essere inseriti i dati.

fillLength

integer

Il numero di righe o colonne in cui devono essere inseriti i dati. I numeri positivi si espandono oltre l'ultima riga o l'ultima colonna dell'origine. I numeri negativi si espandono prima della prima riga o della prima colonna dell'origine.

CutPasteRequest

Sposta i dati dall'origine alla destinazione.

Rappresentazione JSON 
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridCoordinate)
  },
  "pasteType": enum (PasteType)
}
Campi
source

object (GridRange)

I dati di origine da tagliare.

destination

object (GridCoordinate)

La coordinata in alto a sinistra in cui devono essere incollati i dati.

pasteType

enum (PasteType)

Il tipo di dati da incollare. Tutti i dati di origine verranno tagliati, indipendentemente da ciò che viene incollato.

PasteType

Quali tipi di dati devono essere incollati.

Enum
PASTE_NORMAL Incolla valori, formule, formati e unioni.
PASTE_VALUES Incolla SOLO i valori senza formattazione, formule o unioni.
PASTE_FORMAT Incolla solo il formato, escludendo la convalida dei dati.
PASTE_NO_BORDERS Come PASTE_NORMAL ma senza bordi.
PASTE_FORMULA Incolla solo le formule.
PASTE_DATA_VALIDATION Incolla solo la convalida dei dati.
PASTE_CONDITIONAL_FORMATTING Incolla solo le regole di formattazione condizionale.

CopyPasteRequest

Copia i dati dall'origine alla destinazione.

Rappresentazione JSON 
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridRange)
  },
  "pasteType": enum (PasteType),
  "pasteOrientation": enum (PasteOrientation)
}
Campi
source

object (GridRange)

L'intervallo di origine da copiare.

destination

object (GridRange)

La posizione in cui incollare. Se l'intervallo copre un intervallo multiplo dell'altezza o della larghezza dell'origine, i dati verranno ripetuti per riempire l'intervallo di destinazione. Se l'intervallo è più piccolo dell'intervallo di origine, verranno comunque copiati tutti i dati di origine (oltre la fine dell'intervallo di destinazione).

pasteType

enum (PasteType)

Il tipo di dati da incollare.

pasteOrientation

enum (PasteOrientation)

Come devono essere orientati i dati durante l'incollatura.

PasteOrientation

Come deve essere eseguita un'operazione di incolla.

Enum
NORMAL Incolla normalmente.
TRANSPOSE Incolla trasposto, in cui tutte le righe diventano colonne e viceversa.

MergeCellsRequest

Unisce tutte le celle dell'intervallo.

Rappresentazione JSON 
{
  "range": {
    object (GridRange)
  },
  "mergeType": enum (MergeType)
}
Campi
range

object (GridRange)

L'intervallo di celle da unire.

mergeType

enum (MergeType)

Come devono essere unite le celle.

MergeType

Il tipo di unione da creare.

Enum
MERGE_ALL Crea una singola unione dall'intervallo
MERGE_COLUMNS Crea un'unione per ogni colonna dell'intervallo
MERGE_ROWS Crea un'unione per ogni riga dell'intervallo

UnmergeCellsRequest

Annulla l'unione delle celle nell'intervallo specificato.

Rappresentazione JSON 
{
  "range": {
    object (GridRange)
  }
}
Campi
range

object (GridRange)

L'intervallo in cui tutte le celle devono essere divise. Se l'intervallo si estende su più unioni, tutte verranno annullate. L'intervallo non deve coprire parzialmente un'unione.

UpdateBordersRequest

Aggiorna i bordi di un intervallo. Se un campo non è impostato nella richiesta, significa che il bordo rimane invariato. Ad esempio, con due UpdateBordersRequest successive:

  1. intervallo: A1:A5 { top: RED, bottom: WHITE }
  2. intervallo: A1:A5 { left: BLUE }

In questo modo, l'intervallo A1:A5 avrà bordi di { top: RED, bottom: WHITE, left: BLUE }. Se vuoi cancellare un bordo, imposta esplicitamente lo stile su NONE.

Rappresentazione JSON 
{
  "range": {
    object (GridRange)
  },
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  },
  "innerHorizontal": {
    object (Border)
  },
  "innerVertical": {
    object (Border)
  }
}
Campi
range

object (GridRange)

L'intervallo i cui bordi devono essere aggiornati.

top

object (Border)

Il bordo da posizionare nella parte superiore dell'intervallo.

bottom

object (Border)

Il bordo da posizionare nella parte inferiore dell'intervallo.

left

object (Border)

Il bordo da posizionare a sinistra dell'intervallo.

right

object (Border)

Il bordo da inserire a destra dell'intervallo.

innerHorizontal

object (Border)

Il bordo orizzontale da inserire nell'intervallo.

innerVertical

object (Border)

Il bordo verticale da inserire nell'intervallo.

UpdateCellsRequest

Aggiorna tutte le celle di un intervallo con i nuovi dati.

Rappresentazione JSON 
{
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string,

  "start": {
    object (GridCoordinate)
  },
  "range": {
    object (GridRange)
  }
}
Campi
rows[]

object (RowData)

I dati da scrivere.

fields

string (FieldMask format)

I campi di CellData che devono essere aggiornati. È necessario specificare almeno un campo. La radice è CellData; "row.values." non deve essere specificato. Un singolo "*" può essere utilizzato come abbreviazione per elencare tutti i campi.

I dati sulla posizione devono essere scritti. È necessario impostare esattamente un valore. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
start

object (GridCoordinate)

La coordinata da cui iniziare a scrivere i dati. È possibile scrivere un numero qualsiasi di righe e colonne (incluso un numero diverso di colonne per riga).

range

object (GridRange)

L'intervallo in cui scrivere i dati.

Se i dati nelle righe non coprono l'intero intervallo richiesto, i campi corrispondenti a quelli impostati in fields verranno cancellati.

Fine dei campi che si escludono a vicenda.

AddFilterViewRequest

Aggiunge una visualizzazione filtrata.

Rappresentazione JSON 
{
  "filter": {
    object (FilterView)
  }
}
Campi
filter

object (FilterView)

Il filtro da aggiungere. Il campo filterViewId è facoltativo. Se non ne viene impostato uno, verrà generato un ID in modo casuale. È un errore specificare l'ID di un filtro già esistente.

AppendCellsRequest

Aggiunge nuove celle dopo l'ultima riga con dati in un foglio, inserendo nuove righe nel foglio, se necessario.

Rappresentazione JSON 
{
  "sheetId": integer,
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string,

  "tableId": string
}
Campi
sheetId

integer

L'ID del foglio a cui aggiungere i dati.

rows[]

object (RowData)

I dati da aggiungere.

fields

string (FieldMask format)

I campi di CellData che devono essere aggiornati. È necessario specificare almeno un campo. La radice è CellData; "row.values." non deve essere specificato. Un singolo "*" può essere utilizzato come abbreviazione per elencare tutti i campi.

I dati sulla posizione devono essere scritti. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
tableId

string

L'ID della tabella a cui aggiungere i dati. I dati verranno aggiunti solo al corpo della tabella.

Questo campo ha la precedenza anche sul campo sheetId.

Fine dei campi che si escludono a vicenda.

ClearBasicFilterRequest

Cancella il filtro di base, se presente nel foglio.

Rappresentazione JSON 
{
  "sheetId": integer
}
Campi
sheetId

integer

L'ID del foglio in cui deve essere cancellato il filtro di base.

DeleteDimensionRequest

Elimina le dimensioni dal foglio.

Rappresentazione JSON 
{
  "range": {
    object (DimensionRange)
  }
}
Campi
range

object (DimensionRange)

Le dimensioni da eliminare dal foglio.

DeleteEmbeddedObjectRequest

Elimina l'oggetto incorporato con l'ID specificato.

Rappresentazione JSON 
{
  "objectId": integer
}
Campi
objectId

integer

L'ID dell'oggetto incorporato da eliminare.

DeleteFilterViewRequest

Elimina una visualizzazione filtrata specifica.

Rappresentazione JSON 
{
  "filterId": integer
}
Campi
filterId

integer

L'ID del filtro da eliminare.

DuplicateFilterViewRequest

Duplica una visualizzazione filtrata specifica.

Rappresentazione JSON 
{
  "filterId": integer
}
Campi
filterId

integer

L'ID del filtro duplicato.

DuplicateSheetRequest

Duplica i contenuti di un foglio.

Rappresentazione JSON 
{
  "sourceSheetId": integer,
  "insertSheetIndex": integer,
  "newSheetId": integer,
  "newSheetName": string
}
Campi
sourceSheetId

integer

Il foglio da duplicare.

Se il foglio di origine è di tipo DATA_SOURCE, anche il DataSource viene duplicato e associato alla nuova copia del foglio. Non viene attivata l'esecuzione dei dati, vengono copiati anche i dati della griglia di questo foglio, ma sono disponibili solo dopo il completamento della richiesta batch.

insertSheetIndex

integer

L'indice in base zero in cui deve essere inserito il nuovo foglio. L'indice di tutti i fogli successivi viene incrementato.

newSheetId

integer

Se impostato, l'ID del nuovo foglio. Se non viene impostato, viene scelto un ID. Se impostato, l'ID non deve essere in conflitto con alcun ID foglio esistente. Se impostato, deve essere non negativo.

newSheetName

string

Il nome del nuovo foglio. Se il campo è vuoto, verrà scelto un nuovo nome.

FindReplaceRequest

Trova e sostituisce i dati nelle celle in un intervallo, un foglio o tutti i fogli.

Rappresentazione JSON 
{
  "find": string,
  "replacement": string,
  "matchCase": boolean,
  "matchEntireCell": boolean,
  "searchByRegex": boolean,
  "includeFormulas": boolean,

  "range": {
    object (GridRange)
  },
  "sheetId": integer,
  "allSheets": boolean
}
Campi
find

string

Il valore da cercare.

replacement

string

Il valore da utilizzare come sostituzione.

matchCase

boolean

True se la ricerca è sensibile alle maiuscole.

matchEntireCell

boolean

True se il valore di ricerca deve corrispondere all'intera cella.

searchByRegex

boolean

True se il valore di ricerca è un'espressione regolare. L'espressione regolare e la sostituzione devono seguire le regole delle espressioni regolari Java all'indirizzo https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html. La stringa di sostituzione può fare riferimento ai gruppi di acquisizione. Ad esempio, se una cella contiene "Google Sheets" e un'altra contiene "Google Docs", la ricerca di "o.* (.*)" con una sostituzione di "$1 Rocks" modifica i contenuti delle celle in "GSheets Rocks" e "GDocs Rocks" rispettivamente.

includeFormulas

boolean

"True" se la ricerca deve includere le celle con formule. False per ignorare le celle con formule.

L'ambito in cui trovare/sostituire: deve essere impostato uno e uno solo. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
range

object (GridRange)

L'intervallo in cui trovare/sostituire.

sheetId

integer

Il foglio in cui trovare/sostituire.

allSheets

boolean

"True" per trovare/sostituire in tutti i fogli.

Fine dei campi che si escludono a vicenda.

InsertDimensionRequest

Inserisce righe o colonne in un foglio in un indice specifico.

Rappresentazione JSON 
{
  "range": {
    object (DimensionRange)
  },
  "inheritFromBefore": boolean
}
Campi
range

object (DimensionRange)

Le dimensioni da inserire. Gli indici di inizio e di fine devono essere delimitati.

inheritFromBefore

boolean

Se le proprietà delle dimensioni devono essere estese dalle dimensioni prima o dopo le dimensioni appena inserite. True per ereditare dalle dimensioni precedenti (nel qual caso l'indice iniziale deve essere maggiore di 0) e false per ereditare dalle dimensioni successive.

Ad esempio, se l'indice di riga 0 ha uno sfondo rosso e l'indice di riga 1 ha uno sfondo verde, l'inserimento di due righe all'indice 1 può ereditare lo sfondo verde o rosso. Se inheritFromBefore è true, le due nuove righe saranno rosse (perché la riga prima del punto di inserimento era rossa), mentre se inheritFromBefore è false, le due nuove righe saranno verdi (perché la riga dopo il punto di inserimento era verde).

InsertRangeRequest

Inserisce celle in un intervallo, spostando le celle esistenti a destra o in basso.

Rappresentazione JSON 
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
Campi
range

object (GridRange)

L'intervallo in cui inserire le nuove celle. L'intervallo è vincolato ai limiti del foglio corrente.

shiftDimension

enum (Dimension)

La dimensione che verrà spostata quando vengono inserite le celle. Se ROWS, le celle esistenti verranno spostate verso il basso. Se COLUMNS, le celle esistenti verranno spostate a destra.

MoveDimensionRequest

Sposta una o più righe o colonne.

Rappresentazione JSON 
{
  "source": {
    object (DimensionRange)
  },
  "destinationIndex": integer
}
Campi
source

object (DimensionRange)

Le dimensioni di origine da spostare.

destinationIndex

integer

L'indice iniziale basato su zero in cui spostare i dati di origine, in base alle coordinate prima che i dati di origine vengano rimossi dalla griglia. I dati esistenti verranno spostati verso il basso o verso destra (a seconda della dimensione) per fare spazio alle dimensioni spostate. Le dimensioni di origine vengono rimosse dalla griglia, quindi i dati potrebbero finire in un indice diverso da quello specificato.

Ad esempio, dato A1..A5 di 0, 1, 2, 3, 4 e volendo spostare "1" e "2" tra "3" e "4", l'origine sarebbe ROWS [1..3) e l'indice di destinazione sarebbe "4" (l'indice in base zero della riga 5). Il risultato finale sarebbe A1..A5 di 0, 3, 1, 2, 4.

UpdateEmbeddedObjectPositionRequest

Aggiorna la posizione di un oggetto incorporato (ad esempio spostando o ridimensionando un grafico o un'immagine).

Rappresentazione JSON 
{
  "objectId": integer,
  "newPosition": {
    object (EmbeddedObjectPosition)
  },
  "fields": string
}
Campi
objectId

integer

L'ID dell'oggetto da spostare.

newPosition

object (EmbeddedObjectPosition)

Una posizione esplicita in cui spostare l'oggetto incorporato. Se newPosition.sheetId è impostato, verrà creato un nuovo foglio con questo ID. Se newPosition.newSheet è impostato su true, verrà creato un nuovo foglio con un ID scelto per te.

fields

string (FieldMask format)

I campi di OverlayPosition che devono essere aggiornati quando viene impostata una nuova posizione. Utilizzato solo se newPosition.overlayPosition è impostato, nel qual caso è necessario specificare almeno un campo. La radice newPosition.overlayPosition è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come abbreviazione per elencare tutti i campi.

PasteDataRequest

Inserisce i dati nel foglio di lavoro a partire dalla coordinata specificata.

Rappresentazione JSON 
{
  "coordinate": {
    object (GridCoordinate)
  },
  "data": string,
  "type": enum (PasteType),

  "delimiter": string,
  "html": boolean
}
Campi
coordinate

object (GridCoordinate)

La coordinata in cui devono iniziare a essere inseriti i dati.

data

string

I dati da inserire.

type

enum (PasteType)

Come devono essere incollati i dati.

Come interpretare i dati, deve essere impostato esattamente un valore. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
delimiter

string

Il delimitatore nei dati.

html

boolean

Vero se i dati sono in formato HTML.

Fine dei campi che si escludono a vicenda.

TextToColumnsRequest

Suddivide una colonna di testo in più colonne in base a un delimitatore in ogni cella.

Rappresentazione JSON 
{
  "source": {
    object (GridRange)
  },
  "delimiter": string,
  "delimiterType": enum (DelimiterType)
}
Campi
source

object (GridRange)

L'intervallo di dati di origine. Deve estendersi esattamente su una colonna.

delimiter

string

Il delimitatore da utilizzare. Utilizzato solo se delimiterType è CUSTOM.

delimiterType

enum (DelimiterType)

Il tipo di delimitatore da utilizzare.

DelimiterType

Il delimitatore in base a cui dividere.

Enum
DELIMITER_TYPE_UNSPECIFIED Valore predefinito. Questo valore non deve essere utilizzato.
COMMA ","
SEMICOLON ";"
PERIOD "."
SPACE " "
CUSTOM Un valore personalizzato come definito nel delimitatore.
AUTODETECT Rileva automaticamente le colonne.

UpdateFilterViewRequest

Aggiorna le proprietà della visualizzazione filtrata.

Rappresentazione JSON 
{
  "filter": {
    object (FilterView)
  },
  "fields": string
}
Campi
filter

object (FilterView)

Le nuove proprietà della visualizzazione filtrata.

fields

string (FieldMask format)

I campi da aggiornare. È necessario specificare almeno un campo. La radice filter è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come abbreviazione per elencare tutti i campi.

DeleteRangeRequest

Elimina un intervallo di celle, spostando le altre celle nell'area eliminata.

Rappresentazione JSON 
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
Campi
range

object (GridRange)

L'intervallo di celle da eliminare.

shiftDimension

enum (Dimension)

La dimensione da cui verranno sostituite le celle eliminate. Se ROWS, le celle esistenti verranno spostate verso l'alto per sostituire quelle eliminate. Se COLUMNS, le celle esistenti verranno spostate a sinistra per sostituire le celle eliminate.

AppendDimensionRequest

Aggiunge righe o colonne alla fine di un foglio.

Rappresentazione JSON 
{
  "sheetId": integer,
  "dimension": enum (Dimension),
  "length": integer
}
Campi
sheetId

integer

Il foglio a cui aggiungere righe o colonne.

dimension

enum (Dimension)

Indica se devono essere aggiunte righe o colonne.

length

integer

Il numero di righe o colonne da aggiungere.

AddConditionalFormatRuleRequest

Aggiunge una nuova regola di formattazione condizionale all'indice specificato. Gli indici di tutte le regole successive vengono incrementati.

Rappresentazione JSON 
{
  "rule": {
    object (ConditionalFormatRule)
  },
  "index": integer
}
Campi
rule

object (ConditionalFormatRule)

La regola da aggiungere.

index

integer

L'indice in base zero in cui deve essere inserita la regola.

UpdateConditionalFormatRuleRequest

Aggiorna una regola di formattazione condizionale all'indice specificato o la sposta in un altro indice.

Rappresentazione JSON 
{
  "index": integer,
  "sheetId": integer,

  "rule": {
    object (ConditionalFormatRule)
  },
  "newIndex": integer
}
Campi
index

integer

L'indice in base zero della regola da sostituire o spostare.

sheetId

integer

Il foglio della regola da spostare. Obbligatorio se newIndex è impostato, altrimenti non utilizzato.

Il tipo di aggiornamento che deve essere eseguito. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
rule

object (ConditionalFormatRule)

La regola che deve sostituire la regola all'indice specificato.

newIndex

integer

Il nuovo indice in base zero in cui deve trovarsi la regola.

Fine dei campi che si escludono a vicenda.

DeleteConditionalFormatRuleRequest

Elimina una regola di formattazione condizionale all'indice specificato. Gli indici di tutte le regole successive vengono decrementati.

Rappresentazione JSON 
{
  "index": integer,
  "sheetId": integer
}
Campi
index

integer

L'indice a base zero della regola da eliminare.

sheetId

integer

Il foglio da cui viene eliminata la regola.

SortRangeRequest

Ordina i dati nelle righe in base a un ordine di ordinamento per colonna.

Rappresentazione JSON 
{
  "range": {
    object (GridRange)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ]
}
Campi
range

object (GridRange)

L'intervallo da ordinare.

sortSpecs[]

object (SortSpec)

L'ordine di ordinamento per colonna. Le specifiche successive vengono utilizzate quando i valori sono uguali nelle specifiche precedenti.

SetDataValidationRequest

Imposta una regola di convalida dei dati per ogni cella dell'intervallo. Per cancellare la convalida in un intervallo, chiama questo metodo senza specificare alcuna regola.

Rappresentazione JSON 
{
  "range": {
    object (GridRange)
  },
  "rule": {
    object (DataValidationRule)
  },
  "filteredRowsIncluded": boolean
}
Campi
range

object (GridRange)

L'intervallo a cui deve essere applicata la regola di convalida dei dati.

rule

object (DataValidationRule)

La regola di convalida dei dati da impostare su ogni cella dell'intervallo o vuota per cancellare la convalida dei dati nell'intervallo.

filteredRowsIncluded

boolean

Facoltativo. Se è true, la regola di convalida dei dati verrà applicata anche alle righe filtrate.

SetBasicFilterRequest

Imposta il filtro di base associato a un foglio.

Rappresentazione JSON 
{
  "filter": {
    object (BasicFilter)
  }
}
Campi
filter

object (BasicFilter)

Il filtro da impostare.

AddProtectedRangeRequest

Aggiunge un nuovo intervallo protetto.

Rappresentazione JSON 
{
  "protectedRange": {
    object (ProtectedRange)
  }
}
Campi
protectedRange

object (ProtectedRange)

L'intervallo protetto da aggiungere. Il campo protectedRangeId è facoltativo; se non viene impostato, viene generato un ID in modo casuale. È un errore specificare l'ID di un intervallo già esistente.

UpdateProtectedRangeRequest

Aggiorna un intervallo protetto esistente con il protectedRangeId specificato.

Rappresentazione JSON 
{
  "protectedRange": {
    object (ProtectedRange)
  },
  "fields": string
}
Campi
protectedRange

object (ProtectedRange)

L'intervallo protetto da aggiornare con le nuove proprietà.

fields

string (FieldMask format)

I campi da aggiornare. È necessario specificare almeno un campo. La radice protectedRange è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come abbreviazione per elencare tutti i campi.

DeleteProtectedRangeRequest

Elimina l'intervallo protetto con l'ID specificato.

Rappresentazione JSON 
{
  "protectedRangeId": integer
}
Campi
protectedRangeId

integer

L'ID dell'intervallo protetto da eliminare.

AutoResizeDimensionsRequest

Ridimensiona automaticamente una o più dimensioni in base ai contenuti delle celle della dimensione.

Rappresentazione JSON 
{

  "dimensions": {
    object (DimensionRange)
  },
  "dataSourceSheetDimensions": {
    object (DataSourceSheetDimensionRange)
  }
}
Campi
L'intervallo di dimensioni. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
dimensions

object (DimensionRange)

Le dimensioni da ridimensionare automaticamente.

dataSourceSheetDimensions

object (DataSourceSheetDimensionRange)

Le dimensioni di un foglio dell'origine dati da ridimensionare automaticamente.

Fine dei campi che si escludono a vicenda.

AddChartRequest

Aggiunge un grafico a un foglio del foglio di lavoro.

Rappresentazione JSON 
{
  "chart": {
    object (EmbeddedChart)
  }
}
Campi
chart

object (EmbeddedChart)

Il grafico da aggiungere al foglio di lavoro, inclusa la posizione in cui deve essere inserito. Il campo chartId è facoltativo; se non viene impostato, viene generato un ID in modo casuale. È un errore specificare l'ID di un oggetto incorporato già esistente.

UpdateChartSpecRequest

Aggiorna le specifiche di un grafico. Questa operazione non sposta o ridimensiona un grafico. Per spostare o ridimensionare un grafico, utilizza UpdateEmbeddedObjectPositionRequest.)

Rappresentazione JSON 
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  }
}
Campi
chartId

integer

L'ID del grafico da aggiornare.

spec

object (ChartSpec)

La specifica da applicare al grafico.

UpdateBandingRequest

Aggiorna le proprietà dell'intervallo a bande fornito.

Rappresentazione JSON 
{
  "bandedRange": {
    object (BandedRange)
  },
  "fields": string
}
Campi
bandedRange

object (BandedRange)

L'intervallo a bande da aggiornare con le nuove proprietà.

fields

string (FieldMask format)

I campi da aggiornare. È necessario specificare almeno un campo. La radice bandedRange è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come abbreviazione per elencare tutti i campi.

AddBandingRequest

Aggiunge un nuovo intervallo a bande al foglio di lavoro.

Rappresentazione JSON 
{
  "bandedRange": {
    object (BandedRange)
  }
}
Campi
bandedRange

object (BandedRange)

L'intervallo a bande da aggiungere. Il campo bandedRangeId è facoltativo; se non viene impostato, viene generato un ID in modo casuale. È un errore specificare l'ID di un intervallo già esistente.

DeleteBandingRequest

Rimuove l'intervallo a bande con l'ID specificato dal foglio di lavoro.

Rappresentazione JSON 
{
  "bandedRangeId": integer
}
Campi
bandedRangeId

integer

L'ID dell'intervallo a bande da eliminare.

CreateDeveloperMetadataRequest

Una richiesta per creare metadati dello sviluppatore.

Rappresentazione JSON 
{
  "developerMetadata": {
    object (DeveloperMetadata)
  }
}
Campi
developerMetadata

object (DeveloperMetadata)

I metadati dello sviluppatore da creare.

UpdateDeveloperMetadataRequest

Una richiesta di aggiornamento delle proprietà dei metadati dello sviluppatore. Aggiorna le proprietà dei metadati dello sviluppatore selezionati dai filtri con i valori forniti nella risorsa DeveloperMetadata. I chiamanti devono specificare le proprietà che vogliono aggiornare nel parametro fields, nonché specificare almeno un DataFilter corrispondente ai metadati che vogliono aggiornare.

Rappresentazione JSON 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "developerMetadata": {
    object (DeveloperMetadata)
  },
  "fields": string
}
Campi
dataFilters[]

object (DataFilter)

I filtri che corrispondono alle voci dei metadati dello sviluppatore da aggiornare.

developerMetadata

object (DeveloperMetadata)

Il valore a cui verranno aggiornati tutti i metadati corrispondenti ai filtri dei dati.

fields

string (FieldMask format)

I campi da aggiornare. È necessario specificare almeno un campo. La radice developerMetadata è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come abbreviazione per elencare tutti i campi.

DeleteDeveloperMetadataRequest

Una richiesta di eliminazione dei metadati dello sviluppatore.

Rappresentazione JSON 
{
  "dataFilter": {
    object (DataFilter)
  }
}
Campi
dataFilter

object (DataFilter)

Il filtro dei dati che descrive i criteri utilizzati per selezionare la voce di metadati dello sviluppatore da eliminare.

RandomizeRangeRequest

Randomizza l'ordine delle righe in un intervallo.

Rappresentazione JSON 
{
  "range": {
    object (GridRange)
  }
}
Campi
range

object (GridRange)

L'intervallo da randomizzare.

AddDimensionGroupRequest

Crea un gruppo nell'intervallo specificato.

Se l'intervallo richiesto è un superset dell'intervallo di un gruppo esistente G, la profondità di G viene incrementata e questo nuovo gruppo G' ha la profondità di quel gruppo. Ad esempio, un gruppo [C:D, profondità 1] + [B:E] genera i gruppi [B:E, profondità 1] e [C:D, profondità 2]. Se l'intervallo richiesto è un sottoinsieme dell'intervallo di un gruppo esistente G, la profondità del nuovo gruppo G' diventa maggiore di uno rispetto alla profondità di G. Ad esempio, un gruppo [B:E, profondità 1] + [C:D] genera i gruppi [B:E, profondità 1] e [C:D, profondità 2]. Se l'intervallo richiesto inizia prima e termina all'interno dell'intervallo di un gruppo esistente G oppure inizia all'interno e termina dopo l'intervallo di un gruppo esistente G, l'intervallo del gruppo esistente G diventa l'unione degli intervalli e il nuovo gruppo G' ha una profondità maggiore di uno rispetto a G e un intervallo pari all'intersezione degli intervalli. Ad esempio, un gruppo [B:D, profondità 1] + [C:E] genera i gruppi [B:E, profondità 1] e [C:D, profondità 2].

Rappresentazione JSON 
{
  "range": {
    object (DimensionRange)
  }
}
Campi
range

object (DimensionRange)

L'intervallo su cui creare un gruppo.

DeleteDimensionGroupRequest

Elimina un gruppo nell'intervallo specificato decrementando la profondità delle dimensioni nell'intervallo.

Ad esempio, supponiamo che il foglio abbia un gruppo di livello 1 su B:E e un gruppo di livello 2 su C:D. L'eliminazione di un gruppo su D:E lascia il foglio con un gruppo di livello 1 su B:D e un gruppo di livello 2 su C:C.

Rappresentazione JSON 
{
  "range": {
    object (DimensionRange)
  }
}
Campi
range

object (DimensionRange)

L'intervallo del gruppo da eliminare.

UpdateDimensionGroupRequest

Aggiorna lo stato del gruppo specificato.

Rappresentazione JSON 
{
  "dimensionGroup": {
    object (DimensionGroup)
  },
  "fields": string
}
Campi
dimensionGroup

object (DimensionGroup)

Il gruppo il cui stato deve essere aggiornato. L'intervallo e la profondità del gruppo devono specificare un gruppo valido nel foglio e tutti gli altri campi devono essere aggiornati.

fields

string (FieldMask format)

I campi da aggiornare. È necessario specificare almeno un campo. La radice dimensionGroup è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come abbreviazione per elencare tutti i campi.

TrimWhitespaceRequest

Elimina gli spazi vuoti (come spazi, tabulazioni o nuove righe) in ogni cella dell'intervallo specificato. Questa richiesta rimuove tutti gli spazi vuoti all'inizio e alla fine del testo di ogni cella e riduce qualsiasi sequenza di spazi vuoti rimanenti a un singolo spazio. Se il testo troncato risultante inizia con un carattere "+" o "=", il testo rimane un valore stringa e non viene interpretato come formula.

Rappresentazione JSON 
{
  "range": {
    object (GridRange)
  }
}
Campi
range

object (GridRange)

L'intervallo le cui celle devono essere tagliate.

DeleteDuplicatesRequest

Rimuove le righe all'interno di questo intervallo che contengono valori nelle colonne specificate che sono duplicati dei valori in qualsiasi riga precedente. Le righe con valori identici ma con differenze di lettere maiuscole e minuscole, formattazione o formule vengono considerate duplicate.

Questa richiesta rimuove anche le righe duplicate nascoste dalla visualizzazione (ad esempio a causa di un filtro). Quando vengono rimossi i duplicati, la prima istanza di ogni riga duplicata scansionata dall'alto verso il basso viene mantenuta nell'intervallo risultante. I contenuti al di fuori dell'intervallo specificato non vengono rimossi e le righe considerate duplicate non devono essere adiacenti nell'intervallo.

Rappresentazione JSON 
{
  "range": {
    object (GridRange)
  },
  "comparisonColumns": [
    {
      object (DimensionRange)
    }
  ]
}
Campi
range

object (GridRange)

L'intervallo da cui rimuovere le righe duplicate.

comparisonColumns[]

object (DimensionRange)

Le colonne dell'intervallo da analizzare per i valori duplicati. Se non è selezionata alcuna colonna, vengono analizzate tutte le colonne per rilevare i duplicati.

UpdateEmbeddedObjectBorderRequest

Aggiorna la proprietà del bordo di un oggetto incorporato.

Rappresentazione JSON 
{
  "objectId": integer,
  "border": {
    object (EmbeddedObjectBorder)
  },
  "fields": string
}
Campi
objectId

integer

L'ID dell'oggetto incorporato da aggiornare.

border

object (EmbeddedObjectBorder)

Il bordo che si applica all'oggetto incorporato.

fields

string (FieldMask format)

I campi da aggiornare. È necessario specificare almeno un campo. La radice border è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come abbreviazione per elencare tutti i campi.

AddSlicerRequest

Aggiunge un controllo filtro a un foglio del foglio di lavoro.

Rappresentazione JSON 
{
  "slicer": {
    object (Slicer)
  }
}
Campi
slicer

object (Slicer)

Il controllo filtro da aggiungere al foglio di lavoro, inclusa la posizione in cui deve essere inserito. Il campo slicerId è facoltativo; se non viene impostato, viene generato un ID in modo casuale. È un errore specificare l'ID di un controllo filtro che esiste già.

UpdateSlicerSpecRequest

Aggiorna le specifiche di uno slicer. Questa operazione non sposta o ridimensiona un selettore. Per spostare o ridimensionare un selettore, utilizza UpdateEmbeddedObjectPositionRequest.

Rappresentazione JSON 
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "fields": string
}
Campi
slicerId

integer

L'ID del controllo filtro da aggiornare.

spec

object (SlicerSpec)

La specifica da applicare al controllo filtro.

fields

string (FieldMask format)

I campi da aggiornare. È necessario specificare almeno un campo. La radice SlicerSpec è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come abbreviazione per elencare tutti i campi.

AddDataSourceRequest

Aggiunge un'origine dati. Una volta aggiunta l'origine dati, viene creato un foglio DATA_SOURCE associato e viene attivata un'esecuzione per aggiornare il foglio e leggere i dati dall'origine dati.

La richiesta richiede un ambito OAuth bigquery.readonly aggiuntivo se stai aggiungendo un'origine dati BigQuery.

Rappresentazione JSON 
{
  "dataSource": {
    object (DataSource)
  }
}
Campi
dataSource

object (DataSource)

L'origine dati da aggiungere.

UpdateDataSourceRequest

Aggiorna un'origine dati. Una volta aggiornata correttamente l'origine dati, viene attivata un'esecuzione per aggiornare il foglio DATA_SOURCE associato per leggere i dati dall'origine dati aggiornata.

La richiesta richiede un ambito OAuth bigquery.readonly aggiuntivo se stai aggiornando un'origine dati BigQuery.

Rappresentazione JSON 
{
  "dataSource": {
    object (DataSource)
  },
  "fields": string
}
Campi
dataSource

object (DataSource)

L'origine dati da aggiornare.

fields

string (FieldMask format)

I campi da aggiornare. È necessario specificare almeno un campo. La radice dataSource è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come abbreviazione per elencare tutti i campi.

DeleteDataSourceRequest

Elimina un'origine dati. La richiesta elimina anche il foglio dell'origine dati associata e scollega tutti gli oggetti dell'origine dati associati.

Rappresentazione JSON 
{
  "dataSourceId": string
}
Campi
dataSourceId

string

L'ID dell'origine dati da eliminare.

RefreshDataSourceRequest

Aggiorna uno o più oggetti dell'origine dati nel foglio di lavoro in base ai riferimenti specificati.

La richiesta richiede un ambito OAuth bigquery.readonly aggiuntivo se stai aggiornando un'origine dati BigQuery.

Se in un batch sono presenti più richieste di aggiornamento che fanno riferimento agli stessi oggetti dell'origine dati, viene elaborata solo l'ultima richiesta di aggiornamento e tutte le richieste avranno la stessa risposta.

Rappresentazione JSON 
{
  "force": boolean,

  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
}
Campi
force

boolean

Aggiorna gli oggetti dell'origine dati indipendentemente dallo stato attuale. Se non è impostato e un oggetto dell'origine dati a cui viene fatto riferimento è in stato di errore, l'aggiornamento non riuscirà immediatamente.

Specifica cosa aggiornare. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
references

object (DataSourceObjectReferences)

Riferimenti agli oggetti dell'origine dati da aggiornare.

dataSourceId

string

Riferimento a un DataSource. Se specificato, aggiorna tutti gli oggetti dell'origine dati associati all'origine dati.

isAll

boolean

Aggiorna tutti gli oggetti delle origini dati esistenti nel foglio di lavoro.

Fine dei campi che si escludono a vicenda.

DataSourceObjectReferences

Un elenco di riferimenti agli oggetti dell'origine dati.

Rappresentazione JSON 
{
  "references": [
    {
      object (DataSourceObjectReference)
    }
  ]
}
Campi
references[]

object (DataSourceObjectReference)

I riferimenti.

CancelDataSourceRefreshRequest

Annulla uno o più aggiornamenti degli oggetti dell'origine dati nel foglio di lavoro in base ai riferimenti specificati.

La richiesta richiede un ambito OAuth bigquery.readonly aggiuntivo se annulli un aggiornamento di un'origine dati BigQuery.

Rappresentazione JSON 
{

  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
}
Campi
Specifica cosa annullare. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
references

object (DataSourceObjectReferences)

Riferimenti agli oggetti dell'origine dati i cui aggiornamenti devono essere annullati.

dataSourceId

string

Riferimento a un DataSource. Se specificato, annulla tutti gli aggiornamenti degli oggetti dell'origine dati associati per questa origine dati.

isAll

boolean

Annulla tutti gli aggiornamenti degli oggetti delle origini dati esistenti per tutte le origini dati nel foglio di lavoro.

Fine dei campi che si escludono a vicenda.

AddTableRequest

Aggiunge una nuova tabella al foglio di lavoro.

Rappresentazione JSON 
{
  "table": {
    object (Table)
  }
}
Campi
table

object (Table)

Obbligatorio. La tabella da aggiungere.

UpdateTableRequest

Aggiorna una tabella nel foglio di lavoro.

Rappresentazione JSON 
{
  "table": {
    object (Table)
  },
  "fields": string
}
Campi
table

object (Table)

Obbligatorio. La tabella da aggiornare.

fields

string (FieldMask format)

Obbligatorio. I campi da aggiornare. È necessario specificare almeno un campo. La radice table è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come abbreviazione per elencare tutti i campi.

DeleteTableRequest

Rimuove dal foglio di lavoro la tabella con l'ID specificato.

Rappresentazione JSON 
{
  "tableId": string
}
Campi
tableId

string

L'ID della tabella da eliminare.

InsertCommentRequest

Inserisce un CommentThread nel foglio di lavoro.

Rappresentazione JSON 
{
  "content": string,
  "assigneeEmailAddress": string,

  "coordinate": {
    object (GridCoordinate)
  }
}
Campi
content

string

Il testo del commento, come testo normale.

Questo contenuto di testo verrà gestito in modo simile ai commenti creati nell'editor Fogli. Avrà comportamenti simili per la formattazione, le notifiche e così via.

Questo campo non può essere vuoto e non deve superare le 2048 unità di codice UTF-8.

assigneeEmailAddress

string

Facoltativo. L'indirizzo email dell'assegnatario del commento.

Lascia il campo vuoto per un commento non assegnato.

Non può superare le 2048 unità di codice UTF-8.

La posizione nel foglio collegata a questo commento. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
coordinate

object (GridCoordinate)

Il GridCoordinate nel foglio collegato a questo commento.

Fine dei campi che si escludono a vicenda.

AddCommentReplyRequest

Inserisce una risposta Post in un CommentThread.

Rappresentazione JSON 
{
  "commentId": string,
  "post": {
    object (Post)
  }
}
Campi
commentId

string

L'ID del CommentThread a cui aggiungere la risposta.

post

object (Post)

Il Post che rappresenta la risposta.

UpdateCommentPostRequest

Aggiorna un Post in un CommentThread.

Restituisce un errore 400 Bad Request se:

  • L'utente che ha inviato la richiesta non è l'autore del post.
Rappresentazione JSON 
{
  "commentId": string,
  "postId": string,
  "content": string
}
Campi
commentId

string

L'ID del CommentThread a cui appartiene il post.

postId

string

L'ID del post in fase di aggiornamento.

content

string

Il nuovo testo del commento, come testo normale.

Questo contenuto di testo verrà gestito in modo simile ai commenti creati nell'editor Fogli. Avrà comportamenti simili per la formattazione, le notifiche e così via.

Questo campo non può essere vuoto e non deve superare le 2048 unità di codice UTF-8.

DeleteCommentRequest

Elimina un CommentThread.

Restituisce un errore 400 Bad Request se l'utente che ha inviato la richiesta non è l'autore di headPost.

Rappresentazione JSON 
{
  "commentId": string
}
Campi
commentId

string

L'ID di CommentThread che verrà eliminato.

DeleteCommentReplyRequest

Elimina una risposta Post da un CommentThread.

Restituisce un errore 400 Bad Request se:

  • L'utente che ha inviato la richiesta non è l'autore del post.

  • Il post di risposta contiene un comment action.

  • Il post di risposta contiene un assignee.

Rappresentazione JSON 
{
  "commentId": string,
  "postId": string
}
Campi
commentId

string

L'ID del CommentThread a cui appartiene il post.

postId

string

L'ID della risposta Post in fase di eliminazione.