Requests

{

  // Union field kind can be only one of the following:
  "createSlide": {
    object (CreateSlideRequest)
  },
  "createShape": {
    object (CreateShapeRequest)
  },
  "createTable": {
    object (CreateTableRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "insertTableRows": {
    object (InsertTableRowsRequest)
  },
  "insertTableColumns": {
    object (InsertTableColumnsRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "deleteObject": {
    object (DeleteObjectRequest)
  },
  "updatePageElementTransform": {
    object (UpdatePageElementTransformRequest)
  },
  "updateSlidesPosition": {
    object (UpdateSlidesPositionRequest)
  },
  "deleteText": {
    object (DeleteTextRequest)
  },
  "createImage": {
    object (CreateImageRequest)
  },
  "createVideo": {
    object (CreateVideoRequest)
  },
  "createSheetsChart": {
    object (CreateSheetsChartRequest)
  },
  "createLine": {
    object (CreateLineRequest)
  },
  "refreshSheetsChart": {
    object (RefreshSheetsChartRequest)
  },
  "updateShapeProperties": {
    object (UpdateShapePropertiesRequest)
  },
  "updateImageProperties": {
    object (UpdateImagePropertiesRequest)
  },
  "updateVideoProperties": {
    object (UpdateVideoPropertiesRequest)
  },
  "updatePageProperties": {
    object (UpdatePagePropertiesRequest)
  },
  "updateTableCellProperties": {
    object (UpdateTableCellPropertiesRequest)
  },
  "updateLineProperties": {
    object (UpdateLinePropertiesRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "replaceAllShapesWithImage": {
    object (ReplaceAllShapesWithImageRequest)
  },
  "duplicateObject": {
    object (DuplicateObjectRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "replaceAllShapesWithSheetsChart": {
    object (ReplaceAllShapesWithSheetsChartRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "updateTableBorderProperties": {
    object (UpdateTableBorderPropertiesRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableRowProperties": {
    object (UpdateTableRowPropertiesRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "groupObjects": {
    object (GroupObjectsRequest)
  },
  "ungroupObjects": {
    object (UngroupObjectsRequest)
  },
  "updatePageElementAltText": {
    object (UpdatePageElementAltTextRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateSlideProperties": {
    object (UpdateSlidePropertiesRequest)
  },
  "updatePageElementsZOrder": {
    object (UpdatePageElementsZOrderRequest)
  },
  "updateLineCategory": {
    object (UpdateLineCategoryRequest)
  },
  "rerouteLine": {
    object (RerouteLineRequest)
  }
  // End of list of possible types for union field kind.
}

object (CreateSlideRequest)

Crea una nuova slide.

object (CreateShapeRequest)

Crea una nuova forma.

object (CreateTableRequest)

Crea una nuova tabella.

object (InsertTextRequest)

Inserisce il testo in una forma o in una cella di tabella.

object (InsertTableRowsRequest)

Inserisce righe in una tabella.

object (InsertTableColumnsRequest)

Inserisce colonne in una tabella.

object (DeleteTableRowRequest)

Elimina una riga da una tabella.

object (DeleteTableColumnRequest)

Elimina una colonna da una tabella.

object (ReplaceAllTextRequest)

Sostituisce tutte le istanze del testo specificato.

object (DeleteObjectRequest)

Elimina una pagina o un elemento di pagina dalla presentazione.

object (UpdatePageElementTransformRequest)

Aggiorna la trasformazione di un elemento di pagina.

object (UpdateSlidesPositionRequest)

Consente di aggiornare la posizione di un insieme di slide nella presentazione.

object (DeleteTextRequest)

Elimina il testo da una forma o da una cella di tabella.

object (CreateImageRequest)

Crea un'immagine.

object (CreateVideoRequest)

Crea un video.

object (CreateSheetsChartRequest)

Crea un grafico di Fogli Google incorporato.

object (CreateLineRequest)

Crea una linea.

object (RefreshSheetsChartRequest)

Aggiorna un grafico di Fogli Google.

object (UpdateShapePropertiesRequest)

Aggiorna le proprietà di un Shape.

object (UpdateImagePropertiesRequest)

Aggiorna le proprietà di un Image.

object (UpdateVideoPropertiesRequest)

Aggiorna le proprietà di un Video.

object (UpdatePagePropertiesRequest)

Aggiorna le proprietà di un Page.

object (UpdateTableCellPropertiesRequest)

Aggiorna le proprietà di un TableCell.

object (UpdateLinePropertiesRequest)

Aggiorna le proprietà di un Line.

object (CreateParagraphBulletsRequest)

Crea elenchi puntati per i paragrafi.

object (ReplaceAllShapesWithImageRequest)

Sostituisce tutte le forme che corrispondono ad alcuni criteri con un'immagine.

object (DuplicateObjectRequest)

Duplica una slide o un elemento della pagina.

object (UpdateTextStyleRequest)

Aggiorna lo stile del testo all'interno di un Shape o Table.

object (ReplaceAllShapesWithSheetsChartRequest)

Sostituisce tutte le forme che corrispondono ad alcuni criteri con un grafico di Fogli Google.

object (DeleteParagraphBulletsRequest)

Elimina i punti elenco dai paragrafi.

object (UpdateParagraphStyleRequest)

Aggiorna lo stile dei paragrafi all'interno di una Shape o Table.

object (UpdateTableBorderPropertiesRequest)

Aggiorna le proprietà dei bordi della tabella in un Table.

object (UpdateTableColumnPropertiesRequest)

Aggiorna le proprietà di un Table colonna.

object (UpdateTableRowPropertiesRequest)

Aggiorna le proprietà di un Table riga di comando.

object (MergeTableCellsRequest)

Unisce le celle in un Table.

object (UnmergeTableCellsRequest)

Divide le celle in un Table.

object (GroupObjectsRequest)

Raggruppa gli oggetti, come gli elementi della pagina.

object (UngroupObjectsRequest)

Separa gli oggetti, ad esempio groups.

object (UpdatePageElementAltTextRequest)

Aggiorna il titolo del testo alternativo e/o la descrizione di un page element.

object (ReplaceImageRequest)

Sostituisce un'immagine esistente con una nuova.

object (UpdateSlidePropertiesRequest)

Aggiorna le proprietà di una slide

object (UpdatePageElementsZOrderRequest)

Aggiorna l'ordine Z di page elements.

object (UpdateLineCategoryRequest)

Aggiorna la categoria di un line.

object (RerouteLineRequest)

Reindirizza un line in modo che sia collegato ai due siti di connessione più vicini negli elementi della pagina collegati.

{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}

string

Un ID oggetto fornito dall'utente.

Se specifichi un ID, questo deve essere univoco tra tutte le pagine e gli elementi di pagina nella presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde all'espressione regolare [a-zA-Z0-9_]); i caratteri rimanenti possono includerli, nonché un trattino o due punti (corrisponde alla regex [a-zA-Z0-9_-:]). La lunghezza dell'ID deve essere compresa tra 5 e 50 caratteri inclusi.

Se non specifichi un ID, ne viene generato uno univoco.

integer

L'indice facoltativo in base zero che indica dove inserire le slide.

Se non specifichi un indice, la slide viene creata alla fine.

object (LayoutReference)

Riferimento al layout della slide da inserire, in base al master attuale, che è uno dei seguenti:

• Lo schema dell'indice della slide precedente.
• Lo schema della prima slide, se InserIndex è pari a zero.
• Il primo schema della presentazione, se non ci sono slide.

Se LayoutReference non viene trovato nell'istanza master corrente, viene restituito un errore di richiesta errata 400.

Se non specifichi un riferimento al layout, la slide utilizza i valori predefiniti BLANK layout.

object (LayoutPlaceholderIdMapping)

Un elenco facoltativo di mappature di ID oggetto placeholder (s) sul layout ai segnaposto creati nella slide a partire dal layout specificato. Può essere utilizzato solo quando slideLayoutReference è specificato.

{

  // Union field kind can be only one of the following:
  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
  // End of list of possible types for union field kind.
}

enum (PredefinedLayout)

Layout predefinito.

string

ID layout: l'ID oggetto di uno dei layout della presentazione.

{
  "objectId": string,

  // Union field kind can be only one of the following:
  "layoutPlaceholder": {
    object (Placeholder)
  },
  "layoutPlaceholderObjectId": string
  // End of list of possible types for union field kind.
}

string

Un ID oggetto fornito dall'utente per il segnaposto identificato in precedenza che deve essere creato su una slide.

Se specifichi un ID, questo deve essere univoco tra tutte le pagine e gli elementi di pagina nella presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde all'espressione regolare [a-zA-Z0-9_]); i caratteri rimanenti possono includerli, nonché un trattino o due punti (corrisponde alla regex [a-zA-Z0-9_-:]). La lunghezza dell'ID non deve essere inferiore a 5 o superiore a 50.

Se non specifichi un ID, ne viene generato uno univoco.

object (Placeholder)

Il segnaposto su un layout che verrà applicato a una slide. Solo type e index sono necessarie. Ad esempio, un valore predefinito TITLE_AND_BODY di solito può avere un segnaposto TITLE con indice 0 e un segnaposto BODY con indice 0.

string

L'ID oggetto del segnaposto su un layout che verrà applicato a una slide.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}

string

Un ID oggetto fornito dall'utente.

Se specifichi un ID, questo deve essere univoco tra tutte le pagine e gli elementi di pagina nella presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde all'espressione regolare [a-zA-Z0-9_]); i caratteri rimanenti possono includerli, nonché un trattino o due punti (corrisponde alla regex [a-zA-Z0-9_-:]). La lunghezza dell'ID non deve essere inferiore a 5 o superiore a 50. Se vuoto, verrà generato un identificatore univoco.

object (PageElementProperties)

Le proprietà dell'elemento per la forma.

enum (Type)

Il tipo di forma.

{
  "pageObjectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  }
}

string

L'ID oggetto della pagina in cui si trova l'elemento.

object (Size)

Le dimensioni dell'elemento.

object (AffineTransform)

La trasformazione dell'elemento.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}

string

Un ID oggetto fornito dall'utente.

Se specifichi un ID, questo deve essere univoco tra tutte le pagine e gli elementi di pagina nella presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde all'espressione regolare [a-zA-Z0-9_]); i caratteri rimanenti possono includerli, nonché un trattino o due punti (corrisponde alla regex [a-zA-Z0-9_-:]). La lunghezza dell'ID non deve essere inferiore a 5 o superiore a 50.

Se non specifichi un ID, ne viene generato uno univoco.

object (PageElementProperties)

Le proprietà degli elementi della tabella.

La tabella verrà creata alle dimensioni fornite, rispettando le dimensioni minime. Se non viene fornita alcuna dimensione, la tabella verrà ridimensionata automaticamente.

Le trasformazioni di tabella devono avere una scala di 1 e nessun componente di taglio. Se non viene fornita alcuna trasformazione, la tabella sarà centrata sulla pagina.

integer

Numero di righe nella tabella.

integer

Numero di colonne nella tabella.

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": integer
}

string

L'ID oggetto della forma o della tabella in cui verrà inserito il testo.

object (TableCellLocation)

La posizione facoltativa della cella della tabella se il testo deve essere inserito in una cella. Se presente, l'oggetto objectId deve fare riferimento a una tabella.

string

Il testo da inserire.

L'inserimento di un carattere di nuova riga creerà implicitamente un nuovo ParagraphMarker a quell'indice. Lo stile del paragrafo del nuovo paragrafo verrà copiato dal paragrafo nell'indice di inserimento corrente, inclusi elenchi e punti elenco.

Gli stili del testo per il testo inserito vengono determinati automaticamente, mantenendo in genere lo stile del testo vicino. Nella maggior parte dei casi, il testo verrà aggiunto TextRun esistente nell'indice di inserimento.

Alcuni caratteri di controllo (U+0000-U+0008, U+000C-U+001F) e caratteri dell'area a uso privato del piano multilingue di base di Unicode (U+E000-U+F8FF) verranno rimossi dal testo inserito.

integer

L'indice in cui verrà inserito il testo, in unità di codice Unicode, basato su TextElement indici di appartenenza.

L'indice è in base zero e viene calcolato dall'inizio della stringa. L'indice può essere modificato per impedire inserimenti all'interno dei cluster di grafema Unicode. In questi casi, il testo verrà inserito immediatamente dopo il cluster di grafeme.

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}

string

La tabella in cui inserire le righe.

object (TableCellLocation)

La posizione della cella della tabella di riferimento da cui verranno inserite le righe.

Una nuova riga verrà inserita sopra (o sotto) la riga in cui si trova la cella di riferimento. Se la cella di riferimento è unita, verrà inserita una nuova riga sopra (o sotto) la cella unita.

boolean

Indica se inserire nuove righe sotto la posizione della cella di riferimento.

• True : inserisci sotto la cella.
• False : inserisci sopra la cella.

integer

Il numero di righe da inserire. Massimo 20 per richiesta.

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean,
  "number": integer
}

string

La tabella in cui inserire le colonne.

object (TableCellLocation)

La posizione della cella della tabella di riferimento da cui verranno inserite le colonne.

Una nuova colonna verrà inserita a sinistra (o a destra) della colonna in cui si trova la cella di riferimento. Se la cella di riferimento è una cella unita, verrà inserita una nuova colonna a sinistra (o a destra) della cella unita.

boolean

Indica se inserire nuove colonne a destra della posizione della cella di riferimento.

• True : inserisci a destra.
• False : inserisci a sinistra.

integer

Il numero di colonne da inserire. Massimo 20 per richiesta.

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}

string

La tabella da cui eliminare le righe.

object (TableCellLocation)

La posizione della cella della tabella di riferimento da cui verrà eliminata una riga.

La riga coperta da questa cella verrà eliminata. Se questa è una cella unita, verranno eliminate più righe. Se non rimangono righe nella tabella dopo questa eliminazione, viene eliminata l'intera tabella.

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}

string

La tabella da cui eliminare le colonne.

object (TableCellLocation)

La posizione della cella della tabella di riferimento da cui verrà eliminata una colonna.

La colonna coperta da questa cella verrà eliminata. Se questa è una cella unita, verranno eliminate più colonne. Se dopo questa eliminazione non rimane nessuna colonna nella tabella, viene eliminata l'intera tabella.

{
  "replaceText": string,
  "pageObjectIds": [
    string
  ],

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.
}

string

Il testo che sostituirà il testo corrispondente.

string

Se il campo non è vuoto, limita le corrispondenze agli elementi della pagina solo nelle pagine specificate.

Restituisce un errore 400 di richiesta non valida se fornito l'ID oggetto della pagina di un notes master o se nella presentazione non esiste una pagina con questo ID oggetto.

object (SubstringMatchCriteria)

Trova il testo in una forma corrispondente a questa sottostringa.

{
  "text": string,
  "matchCase": boolean
}

string

Il testo da cercare nella forma o nella tabella.

boolean

Indica se la ricerca deve rispettare le maiuscole/minuscole:

• True : la ricerca è sensibile alle maiuscole.
• False : la ricerca non fa distinzione tra maiuscole e minuscole.

{
  "objectId": string
}

string

L'ID oggetto della pagina o dell'elemento di pagina da eliminare.

Se, dopo un'operazione di eliminazione, group contiene solo uno o nessun elemento di pagina, anche il gruppo viene eliminato.

Se in un layout viene eliminato un segnaposto, vengono eliminati anche tutti i segnaposto ereditari vuoti.

{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}

string

L'ID oggetto dell'elemento della pagina da aggiornare.

object (AffineTransform)

La matrice di trasformazione dell'input utilizzata per aggiornare l'elemento della pagina.

enum (ApplyMode)

La modalità di applicazione dell'aggiornamento della trasformazione.

{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}

string

Gli ID delle slide della presentazione da spostare. Le slide in questo elenco devono essere nell'ordine della presentazione esistente, senza duplicati.

integer

L'indice in cui inserire le slide, in base alla disposizione delle slide prima che avvenga lo spostamento. Deve essere compreso tra zero e il numero di slide della presentazione (incluso).

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}

string

L'ID oggetto della forma o della tabella da cui verrà eliminato il testo.

object (TableCellLocation)

La posizione facoltativa della cella della tabella se il testo deve essere eliminato dalla cella. Se presente, l'oggetto objectId deve fare riferimento a una tabella.

object (Range)

L'intervallo di testo da eliminare, in base a TextElement indici di appartenenza.

È sempre presente un carattere di nuova riga implicito alla fine del testo di una forma o di una cella di tabella che non può essere eliminato. Range.Type.ALL utilizzerà i limiti corretti, ma occorre prestare attenzione quando si specificano limiti espliciti per i tipi di intervallo FROM_START_INDEX e FIXED_RANGE. Ad esempio, se il testo è "ABC", seguito da una nuova riga implicita, il valore massimo è 2 per textRange.start_index e 3 per textRange.end_index.

L'eliminazione di un testo che supera il limite di un paragrafo può comportare modifiche agli stili e agli elenchi dei paragrafi quando i due paragrafi vengono uniti.

Gli intervalli che includono solo un'unità di codice di una coppia di surrogati vengono espansi per includere entrambe le unità di codice.

{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}

integer

L'indice facoltativo in base zero dell'inizio della raccolta. Obbligatorio per FIXED_RANGE e FROM_START_INDEX intervalli di tempo.

integer

L'indice facoltativo in base zero della fine della raccolta. Obbligatorio per FIXED_RANGE intervalli di tempo.

enum (Type)

Il tipo di intervallo.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}

string

Un ID oggetto fornito dall'utente.

Se specifichi un ID, questo deve essere univoco tra tutte le pagine e gli elementi di pagina nella presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde all'espressione regolare [a-zA-Z0-9_]); i caratteri rimanenti possono includerli, nonché un trattino o due punti (corrisponde alla regex [a-zA-Z0-9_-:]). La lunghezza dell'ID non deve essere inferiore a 5 o superiore a 50.

Se non specifichi un ID, ne viene generato uno univoco.

object (PageElementProperties)

Le proprietà dell'elemento dell'immagine.

Se le proporzioni delle dimensioni fornite non corrispondono a quelle dell'immagine, l'immagine viene ridimensionata e centrata rispetto alle dimensioni in modo da mantenere le proporzioni. La trasformazione fornita viene applicata dopo questa operazione.

La PageElementProperties.size è facoltativa. Se non specifichi le dimensioni, viene utilizzata la dimensione predefinita dell'immagine.

La PageElementProperties.transform è facoltativa. Se non specifichi una trasformazione, l'immagine verrà posizionata nell'angolo in alto a sinistra della pagina.

string

L'URL dell'immagine.

L'immagine viene recuperata una volta al momento dell'inserimento e viene archiviata una copia da visualizzare all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.

L'URL fornito deve essere accessibile pubblicamente e avere una lunghezza massima di 2 kB. L'URL viene salvato con l'immagine ed esposto tramite Image.source_url .

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}

string

Un ID oggetto fornito dall'utente.

Se specifichi un ID, questo deve essere univoco tra tutte le pagine e gli elementi di pagina nella presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde all'espressione regolare [a-zA-Z0-9_]); i caratteri rimanenti possono includerli, nonché un trattino o due punti (corrisponde alla regex [a-zA-Z0-9_-:]). La lunghezza dell'ID non deve essere inferiore a 5 o superiore a 50.

Se non specifichi un ID, ne viene generato uno univoco.

object (PageElementProperties)

Le proprietà degli elementi per il video.

La PageElementProperties.size è facoltativa. Se non specifichi una dimensione, il server ne sceglie una predefinita.

La PageElementProperties.transform è facoltativa. La trasformazione non deve avere componenti di taglio. Se non specifichi una trasformazione, il video verrà posizionato nell'angolo in alto a sinistra della pagina.

enum (Source)

L'origine del video.

string

L'identificatore univoco della sorgente video per questo video.

ad es. Per video di YouTube https://www.youtube.com/watch?v=7U3axjORYZ0, l'ID è 7U3axjORYZ0. Per un video di Google Drive https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q l'ID è 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q.

Per accedere a un file video di Google Drive, potrebbe essere necessario aggiungere una chiave risorsa all'intestazione HTTP per un sottoinsieme di file precedenti. Per ulteriori informazioni, vedi Accedi ai file condivisi tramite link utilizzando le chiavi delle risorse.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}

string

Un ID oggetto fornito dall'utente.

Se specificato, l'ID deve essere univoco tra tutte le pagine e gli elementi di pagina nella presentazione. L'ID deve iniziare con un carattere [a-zA-Z0-9_] seguito da un numero qualsiasi dei seguenti caratteri [a-zA-Z0-9_-:]. La lunghezza dell'ID non deve essere inferiore a 5 o superiore a 50. Se vuoto, verrà generato un identificatore univoco.

object (PageElementProperties)

Le proprietà degli elementi per il grafico.

Quando le proporzioni delle dimensioni fornite non corrispondono a quelle del grafico, quest'ultimo viene ridimensionato e centrato rispetto alle dimensioni per mantenere le proporzioni. La trasformazione fornita viene applicata dopo questa operazione.

string

L'ID del foglio di lavoro di Fogli Google che contiene il grafico.

Potresti dover aggiungere una chiave risorsa all'intestazione HTTP per un sottoinsieme di file precedenti. Per ulteriori informazioni, vedi Accedi ai file condivisi tramite link utilizzando le chiavi delle risorse.

integer

L'ID del grafico specifico nel foglio di lavoro di Fogli Google.

enum (LinkingMode)

La modalità con cui il grafico è collegato al foglio di lavoro di origine. Se non specificato, il grafico sarà un'immagine non collegata.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}

string

Un ID oggetto fornito dall'utente.

Se specifichi un ID, questo deve essere univoco tra tutte le pagine e gli elementi di pagina nella presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde all'espressione regolare [a-zA-Z0-9_]); i caratteri rimanenti possono includerli, nonché un trattino o due punti (corrisponde alla regex [a-zA-Z0-9_-:]). La lunghezza dell'ID non deve essere inferiore a 5 o superiore a 50.

Se non specifichi un ID, ne viene generato uno univoco.

object (PageElementProperties)

Le proprietà dell'elemento della linea.

enum (Category)

La categoria della riga da creare.

Deprecato . : usa category .

L'esatto line type viene determinato in base alla categoria e a come viene indirizzata ad altri elementi della pagina.

Se specifichi sia un valore category e un lineCategory, category ha la precedenza.

enum (LineCategory)

La categoria della riga da creare.

L'esatto line type viene determinato in base alla categoria e a come viene indirizzata ad altri elementi della pagina.

Se specifichi sia un valore category e un lineCategory, category ha la precedenza.

Se non specifichi un valore per category, ma specifica un valore per lineCategory, quindi il valore lineCategory .

Se non specifichi nessuna di queste due modalità, STRAIGHT .

{
  "objectId": string
}

string

L'ID oggetto del grafico da aggiornare.

{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}

string

L'ID oggetto della forma a cui vengono applicati gli aggiornamenti.

object (ShapeProperties)

Le proprietà della forma da aggiornare.

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice shapeProperties è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare il colore di riempimento a tinta unita dello sfondo di forma, imposta fields a "shapeBackgroundFill.solidFill.color".

Per ripristinare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato.

{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}

string

L'ID oggetto dell'immagine a cui vengono applicati gli aggiornamenti.

object (ImageProperties)

Le proprietà dell'immagine da aggiornare.

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice imageProperties è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare il colore dei contorni dell'immagine, imposta fields a "outline.outlineFill.solidFill.color".

Per ripristinare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato.

{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}

string

L'ID oggetto del video a cui vengono applicati gli aggiornamenti.

object (VideoProperties)

Le proprietà video da aggiornare.

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice videoProperties è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare il colore dei contorni del video, imposta fields a "outline.outlineFill.solidFill.color".

Per ripristinare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato.

{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}

string

L'ID oggetto della pagina a cui viene applicato l'aggiornamento.

object (PageProperties)

Le proprietà della pagina da aggiornare.

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice pageProperties è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare il colore di riempimento a tinta unita dello sfondo della pagina, imposta fields a "pageBackgroundFill.solidFill.color".

Per ripristinare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato.

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}

string

L'ID oggetto della tabella.

object (TableRange)

L'intervallo di tabelle che rappresenta il sottoinsieme della tabella a cui vengono applicati gli aggiornamenti. Se non viene specificato un intervallo di tabella, gli aggiornamenti verranno applicati all'intera tabella.

object (TableCellProperties)

Le proprietà della cella della tabella da aggiornare.

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice tableCellProperties è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare il colore di riempimento in tinta unita dallo sfondo delle celle di una tabella, fields a "tableCellBackgroundFill.solidFill.color".

Per ripristinare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato.

{
  "location": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}

object (TableCellLocation)

La posizione iniziale dell'intervallo della tabella.

integer

L'intervallo di righe dell'intervallo della tabella.

integer

L'estensione delle colonne dell'intervallo della tabella.

{
  "objectId": string,
  "lineProperties": {
    object (LineProperties)
  },
  "fields": string
}

string

L'ID oggetto della riga a cui viene applicato l'aggiornamento.

object (LineProperties)

Le proprietà della riga da aggiornare.

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice lineProperties è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare il colore di riempimento a tinta unita, imposta fields a "lineFill.solidFill.color".

Per reimpostare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato.

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}

string

L'ID oggetto della forma o della tabella contenente il testo a cui aggiungere punti elenco.

object (TableCellLocation)

La posizione facoltativa della cella della tabella se il testo da modificare si trova in una cella. Se presente, l'oggetto objectId deve fare riferimento a una tabella.

object (Range)

L'intervallo di testo a cui applicare i punti predefiniti, in base a TextElement indici di appartenenza.

enum (BulletGlyphPreset)

I tipi di glifi punti elenco da utilizzare. Il valore predefinito è BULLET_DISC_CIRCLE_SQUARE predefinito.

{
  "replaceMethod": enum (ReplaceMethod),
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "pageObjectIds": [
    string
  ],

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.

  // Union field image_source can be only one of the following:
  "imageUrl": string
  // End of list of possible types for union field image_source.
}

enum (ReplaceMethod)

Il metodo di sostituzione.

Deprecato . : usa imageReplaceMethod .

Se specifichi sia un valore replaceMethod e un imageReplaceMethod, imageReplaceMethod ha la precedenza.

enum (ImageReplaceMethod)

Il metodo di sostituzione delle immagini.

Se specifichi sia un valore replaceMethod e un imageReplaceMethod, imageReplaceMethod ha la precedenza.

Se non specifichi un valore per imageReplaceMethod, ma specifica un valore per replaceMethod, quindi il valore replaceMethod .

Se non specifichi nessuna delle due, viene utilizzato CENTER_INSIDE.

string

Se il campo non è vuoto, limita le corrispondenze agli elementi della pagina solo nelle pagine specificate.

Restituisce un errore 400 di richiesta non valida se fornito l'ID oggetto della pagina di un notes page o un notes master o se nella presentazione non esiste una pagina con questo ID oggetto.

object (SubstringMatchCriteria)

Se impostato, questa richiesta sostituirà tutte le forme che contengono il testo specificato.

string

L'URL dell'immagine.

L'immagine viene recuperata una volta al momento dell'inserimento e viene archiviata una copia da visualizzare all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.

L'URL fornito può avere una lunghezza massima di 2 kB. L'URL viene salvato con l'immagine ed esposto tramite Image.source_url .

{
  "objectId": string,
  "objectIds": {
    string: string,
    ...
  }
}

string

L'ID dell'oggetto da duplicare.

map (key: string, value: string)

L'oggetto duplicato potrebbe contenere altri oggetti, ad esempio durante la duplicazione di una slide o di un elemento di pagina di gruppo. Questa mappa definisce il modo in cui vengono generati gli ID degli oggetti duplicati: le chiavi sono gli ID degli oggetti originali e i loro valori sono gli ID che vengono assegnati all'oggetto duplicato corrispondente. L'ID del duplicato dell'oggetto di origine può essere specificato anche in questa mappa, utilizzando lo stesso valore del parametro objectId come chiave e il nuovo ID desiderato come valore.

Tutte le chiavi devono corrispondere agli ID esistenti nella presentazione. Tutti i valori devono essere univoci nella presentazione e devono iniziare con un carattere alfanumerico o un trattino basso (corrisponde all'espressione regolare [a-zA-Z0-9_]); i caratteri rimanenti possono includerli, nonché un trattino o due punti (corrisponde alla regex [a-zA-Z0-9_-:]). La lunghezza del nuovo ID non deve essere inferiore a 5 o superiore a 50.

Se alcuni ID degli oggetti di origine vengono omessi dalla mappa, verrà assegnato un nuovo ID casuale. Se la mappa è vuota o se non viene impostata, tutti gli oggetti duplicati riceveranno un nuovo ID casuale.

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}

string

L'ID oggetto della forma o della tabella con il testo a cui applicare lo stile.

object (TableCellLocation)

La posizione della cella nella tabella contenente il testo di cui applicare uno stile. Se objectId si riferisce a una tabella, cellLocation deve avere un valore. In caso contrario, non deve.

object (TextStyle)

Gli stili da impostare per il testo.

Se il valore di un particolare stile corrisponde a quello dell'elemento principale, quello stile verrà impostato in modo da ereditare.

Alcune modifiche allo stile del testo potrebbero causare altre modifiche volte a rispecchiare il comportamento dell'editor di Presentazioni. Visualizza la documentazione di TextStyle per ulteriori informazioni.

object (Range)

L'intervallo di testo a cui applicare uno stile.

L'intervallo può essere esteso per includere nuove righe adiacenti.

Se l'intervallo contiene interamente un paragrafo appartenente a un elenco, il punto elenco del paragrafo viene aggiornato con lo stile di testo corrispondente.

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice style è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare lo stile del testo in grassetto, imposta fields a "bold".

Per reimpostare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato.

{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}

object (SubstringMatchCriteria)

I criteri a cui le forme devono corrispondere per poter essere sostituite. La richiesta sostituirà tutte le forme che contengono il testo specificato.

string

L'ID del foglio di lavoro di Fogli Google che contiene il grafico.

integer

L'ID del grafico specifico nel foglio di lavoro di Fogli Google.

enum (LinkingMode)

La modalità con cui il grafico è collegato al foglio di lavoro di origine. Se non specificato, il grafico sarà un'immagine non collegata.

string

Se il campo non è vuoto, limita le corrispondenze agli elementi della pagina solo nelle pagine specificate.

Restituisce un errore 400 di richiesta non valida se fornito l'ID oggetto della pagina di un notes page o un notes master o se nella presentazione non esiste una pagina con questo ID oggetto.

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}

string

L'ID oggetto della forma o della tabella contenente il testo da cui eliminare i punti elenco.

object (TableCellLocation)

La posizione facoltativa della cella della tabella se il testo da modificare si trova in una cella. Se presente, l'oggetto objectId deve fare riferimento a una tabella.

object (Range)

L'intervallo di testo da cui eliminare un elenco puntato, in base a TextElement indici di appartenenza.

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}

string

L'ID oggetto della forma o della tabella con il testo a cui applicare lo stile.

object (TableCellLocation)

La posizione della cella nella tabella contenente i paragrafi da applicare a uno stile. Se objectId si riferisce a una tabella, cellLocation deve avere un valore. In caso contrario, non deve.

object (ParagraphStyle)

Lo stile del paragrafo.

object (Range)

L'intervallo di testo contenente i paragrafi da applicare allo stile.

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice style è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare l'allineamento del paragrafo, imposta fields a "alignment".

Per reimpostare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato.

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}

string

L'ID oggetto della tabella.

object (TableRange)

L'intervallo di tabelle che rappresenta il sottoinsieme della tabella a cui vengono applicati gli aggiornamenti. Se non viene specificato un intervallo di tabella, gli aggiornamenti verranno applicati all'intera tabella.

enum (BorderPosition)

La posizione del bordo nell'intervallo di tabella a cui devono essere applicati gli aggiornamenti. Se non viene specificata una posizione del bordo, gli aggiornamenti verranno applicati a tutti i bordi nell'intervallo della tabella.

object (TableBorderProperties)

Le proprietà dei bordi della tabella da aggiornare.

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice tableBorderProperties è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare il colore di riempimento in tinta unita del bordo della tabella, fields a "tableBorderFill.solidFill.color".

Per reimpostare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato.

{
  "objectId": string,
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}

string

L'ID oggetto della tabella.

integer

L'elenco di indici a base zero che specifica quali colonne aggiornare. Se non vengono forniti indici, tutte le colonne della tabella verranno aggiornate.

object (TableColumnProperties)

Le proprietà della colonna della tabella da aggiornare.

Se il valore tableColumnProperties#columnWidth nella richiesta è inferiore a 406.400 EMU (32 punti), viene restituito un errore di richiesta errata 400.

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice tableColumnProperties è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare la larghezza delle colonne, imposta fields a "columnWidth".

Se "columnwidth"' è incluso nella maschera del campo ma la proprietà non viene impostata, la larghezza della colonna verrà impostata su 406.400 EMU (32 punti).

{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}

string

L'ID oggetto della tabella.

integer

L'elenco di indici a base zero che specifica quali righe aggiornare. Se non vengono forniti indici, tutte le righe della tabella verranno aggiornate.

object (TableRowProperties)

Le proprietà delle righe della tabella da aggiornare.

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice tableRowProperties è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare l'altezza minima della riga, imposta fields a "minRowHeight".

Se "minRowHeight"' è incluso nella maschera del campo ma la proprietà non è impostata, l'altezza minima della riga viene impostata su 0 per impostazione predefinita.

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}

string

L'ID oggetto della tabella.

object (TableRange)

L'intervallo di tabella che specifica quali celle della tabella unire.

Il testo nelle celle che vengono unite verrà concatenato e archiviato nella cella in alto a sinistra ("head") dell'intervallo. Se l'intervallo non è rettangolare (cosa che può verificarsi in alcuni casi in cui l'intervallo copre celle già unite), viene restituito un errore di richiesta non valida 400.

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}

string

L'ID oggetto della tabella.

object (TableRange)

L'intervallo di tabella che specifica quali celle della tabella dividere.

Tutte le celle unite in questo intervallo verranno divise e le celle già separate non saranno interessate. Se l'intervallo non ha celle unite, la richiesta non produce alcun effetto. Se è presente del testo in una delle celle unite, questo rimarrà nella cella in alto a sinistra ("head") del blocco risultante di celle non unite.

{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}

string

Un ID oggetto fornito dall'utente per il gruppo da creare.

Se specifichi un ID, questo deve essere univoco tra tutte le pagine e gli elementi di pagina nella presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde all'espressione regolare [a-zA-Z0-9_]); i caratteri rimanenti possono includerli, nonché un trattino o due punti (corrisponde alla regex [a-zA-Z0-9_-:]). La lunghezza dell'ID non deve essere inferiore a 5 o superiore a 50.

Se non specifichi un ID, ne viene generato uno univoco.

string

Gli ID degli oggetti da raggruppare.

Solo gli elementi della pagina possono essere raggruppati. La stessa pagina deve contenere almeno due elementi che non si trovano già in un altro gruppo. Alcuni elementi della pagina, ad esempio videos, tables e placeholders non possono essere raggruppati.

{
  "objectIds": [
    string
  ]
}

string

Gli ID degli oggetti da separare.

Solo groups che non sono all'interno di altre groups possono essere separati. Tutti i gruppi devono trovarsi sulla stessa pagina. Il gruppo viene eliminato. Le dimensioni e le posizioni visive di tutti gli elementi secondari vengono mantenute.

{
  "objectId": string,
  "title": string,
  "description": string
}

string

L'ID oggetto dell'elemento della pagina a cui vengono applicati gli aggiornamenti.

string

Il titolo del testo alternativo aggiornato dell'elemento della pagina. Se il criterio non viene configurato, il valore esistente verrà mantenuto. Il titolo è esposto agli screen reader e ad altre interfacce di accessibilità. Utilizza solo valori leggibili relativi ai contenuti dell'elemento della pagina.

string

La descrizione del testo alternativo aggiornata dell'elemento della pagina. Se il criterio non viene configurato, il valore esistente verrà mantenuto. La descrizione è esposta a screen reader e ad altre interfacce di accessibilità. Utilizza solo valori leggibili relativi ai contenuti dell'elemento della pagina.

{
  "imageObjectId": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}

string

L'ID dell'immagine esistente che verrà sostituita. L'ID può essere recuperato dalla risposta di una richiesta get.

enum (ImageReplaceMethod)

Il metodo di sostituzione.

string

L'URL dell'immagine.

L'immagine viene recuperata una volta al momento dell'inserimento e viene archiviata una copia da visualizzare all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non più di 25 megapixel e devono essere in formato PNG, JPEG o GIF.

L'URL fornito non può superare i 2 kB. L'URL viene salvato con l'immagine ed esposto tramite Image.source_url .

{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}

string

L'ID oggetto della slide a cui viene applicato l'aggiornamento.

object (SlideProperties)

Le proprietà della slide da aggiornare.

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La directory principale "slideProperties" è implicito e non deve essere specificato. Un singolo "*" può essere utilizzato come forma breve per elencare ogni campo.

Ad esempio, per aggiornare se una slide viene saltata, imposta fields a "isSkipped".

Per reimpostare il valore predefinito di una proprietà, includi il nome del campo nella maschera del campo, ma non il campo impostato.

{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}

string

Gli ID oggetto degli elementi della pagina da aggiornare.

Tutti gli elementi della pagina devono trovarsi sulla stessa pagina e non devono essere raggruppati.

enum (ZOrderOperation)

L'operazione di ordinamento Z da applicare agli elementi della pagina.

Quando l'operazione viene applicata su più elementi della pagina, l'ordine Z relativo all'interno di questi elementi della pagina viene mantenuto.

{
  "objectId": string,
  "lineCategory": enum (LineCategory)
}

string

L'ID oggetto della riga a cui viene applicato l'aggiornamento.

Solo una riga con un category che indica che si tratta di un "connettore" possono essere aggiornati.

La linea può essere reindirizzata dopo l'aggiornamento della categoria.

enum (LineCategory)

La categoria della linea da utilizzare per l'aggiornamento.

L'esatto line type è determinato in base alla categoria a cui eseguire l'aggiornamento e al modo in cui viene indirizzato ad altri elementi della pagina.

{
  "objectId": string
}

string

L'ID oggetto della linea da reindirizzare.

Solo una riga con un category che indica che si tratta di un "connettore" può essere reindirizzato. Le connessioni iniziale e finale della linea devono trovarsi su elementi della pagina diversi.