Requests

Risorse richieste:

Un unico tipo di aggiornamento da applicare a una presentazione.

Rappresentazione JSON 
{

  // 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.
}
Campi
Campo Union kind. Il tipo di aggiornamento. È necessario specificare esattamente un campo. kind può essere solo uno dei seguenti:
createSlide

object (CreateSlideRequest)

Crea una nuova diapositiva.

createShape

object (CreateShapeRequest)

Crea una nuova forma.

createTable

object (CreateTableRequest)

Crea una nuova tabella.

insertText

object (InsertTextRequest)

Inserisce il testo in una cella di forma o tabella.

insertTableRows

object (InsertTableRowsRequest)

Inserisce righe in una tabella.

insertTableColumns

object (InsertTableColumnsRequest)

Inserisce colonne in una tabella.

deleteTableRow

object (DeleteTableRowRequest)

Elimina una riga da una tabella.

deleteTableColumn

object (DeleteTableColumnRequest)

Elimina una colonna da una tabella.

replaceAllText

object (ReplaceAllTextRequest)

Sostituisce tutte le istanze del testo specificato.

deleteObject

object (DeleteObjectRequest)

Elimina una pagina o un elemento di pagina dalla presentazione.

updatePageElementTransform

object (UpdatePageElementTransformRequest)

Aggiorna la trasformazione di un elemento della pagina.

updateSlidesPosition

object (UpdateSlidesPositionRequest)

Aggiorna la posizione di una serie di diapositive nella presentazione.

deleteText

object (DeleteTextRequest)

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

createImage

object (CreateImageRequest)

Crea un'immagine.

createVideo

object (CreateVideoRequest)

Crea un video.

createSheetsChart

object (CreateSheetsChartRequest)

Crea un grafico di Fogli Google incorporato.

createLine

object (CreateLineRequest)

Crea una linea.

refreshSheetsChart

object (RefreshSheetsChartRequest)

Aggiorna un grafico di Fogli Google.

updateShapeProperties

object (UpdateShapePropertiesRequest)

Aggiorna le proprietà di un elemento Shape.

updateImageProperties

object (UpdateImagePropertiesRequest)

Aggiorna le proprietà di un elemento Image.

updateVideoProperties

object (UpdateVideoPropertiesRequest)

Aggiorna le proprietà di un elemento Video.

updatePageProperties

object (UpdatePagePropertiesRequest)

Aggiorna le proprietà di un elemento Page.

updateTableCellProperties

object (UpdateTableCellPropertiesRequest)

Aggiorna le proprietà di un elemento TableCell.

updateLineProperties

object (UpdateLinePropertiesRequest)

Aggiorna le proprietà di un elemento Line.

createParagraphBullets

object (CreateParagraphBulletsRequest)

Crea elenchi puntati per i paragrafi.

replaceAllShapesWithImage

object (ReplaceAllShapesWithImageRequest)

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

duplicateObject

object (DuplicateObjectRequest)

Duplicare una diapositiva o un elemento della pagina.

updateTextStyle

object (UpdateTextStyleRequest)

Aggiorna lo stile del testo in un elemento Shape o Table.

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

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

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Elimina i punti elenco dei paragrafi.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

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

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

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

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Aggiorna le proprietà di una colonna Table.

updateTableRowProperties

object (UpdateTableRowPropertiesRequest)

Aggiorna le proprietà di una riga Table.

mergeTableCells

object (MergeTableCellsRequest)

Unisce le celle in una Table.

unmergeTableCells

object (UnmergeTableCellsRequest)

Divide le celle in una Table.

groupObjects

object (GroupObjectsRequest)

Raggruppa gli oggetti, ad esempio gli elementi di pagina.

ungroupObjects

object (UngroupObjectsRequest)

Separa gli oggetti, ad esempio groups.

updatePageElementAltText

object (UpdatePageElementAltTextRequest)

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

replaceImage

object (ReplaceImageRequest)

Sostituisce un'immagine esistente con una nuova.

updateSlideProperties

object (UpdateSlidePropertiesRequest)

Aggiorna le proprietà di una diapositiva

updatePageElementsZOrder

object (UpdatePageElementsZOrderRequest)

Aggiorna l'ordine Z di page elements.

updateLineCategory

object (UpdateLineCategoryRequest)

Aggiorna la categoria di line.

rerouteLine

object (RerouteLineRequest)

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

Crea richiesta di diapositiva

Crea una diapositiva.

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

string

Un ID oggetto fornito dall'utente.

Se specifichi un ID, deve essere univoco tra tutte le pagine e gli elementi delle pagine della 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 includere sia un trattino che i due punti (corrisponde all'espressione regolare [a-zA-Z0-9_-:]). La lunghezza dell'ID deve essere compresa tra 5 e 50 caratteri (inclusi).

Se non specifichi un ID, ne verrà generato uno univoco.

insertionIndex

integer

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

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

slideLayoutReference

object (LayoutReference)

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

  • Il master dell'indice della diapositiva precedente.
  • La pagina principale della prima diapositiva, se il valore di IndexIndex è zero.
  • Il primo master nella presentazione, se non ci sono diapositive.

Se il LayoutReference non viene trovato nel master attuale, viene restituito un errore di richiesta 400 non valido.

Se non specifichi un riferimento al layout, la diapositiva utilizza il layout BLANK predefinito.

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

Un elenco facoltativo di mappature degli ID oggetto dagli elementi placeholder del layout ai segnaposto creati nella diapositiva dal layout specificato. Può essere utilizzato solo quando slideLayoutReference è specificato.

Riferimento layout

Riferimento per il layout delle diapositive. Queste informazioni possono fare riferimento a:

  • Un layout predefinito
  • Uno dei layout della presentazione.
Rappresentazione JSON 
{

  // 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.
}
Campi
Campo Union kind. Il tipo di LayoutReference. kind può essere solo uno dei seguenti:
predefinedLayout

enum (PredefinedLayout)

Layout predefinito.

layoutId

string

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

Layout predefinito

Tipi di layout predefiniti. Questi sono i layout più comuni nelle presentazioni. Tuttavia, non esiste alcuna garanzia che questi layout siano presenti nel master attuale perché potrebbero essere stati eliminati o non facevano parte del tema utilizzato. Inoltre, i segnaposto su ciascun layout potrebbero essere stati modificati.

Enum
PREDEFINED_LAYOUT_UNSPECIFIED Layout non specificato.
BLANK Layout vuoto, senza segnaposto.
CAPTION_ONLY Layout con una didascalia in fondo.
TITLE Layout con titolo e sottotitolo.
TITLE_AND_BODY Layout con titolo e corpo.
TITLE_AND_TWO_COLUMNS Layout con un titolo e due colonne.
TITLE_ONLY Layout con solo un titolo.
SECTION_HEADER Layout con un titolo di sezione.
SECTION_TITLE_AND_DESCRIPTION Layout con titolo e sottotitolo da un lato e descrizione dall'altro.
ONE_COLUMN_TEXT Layout con un titolo e un corpo, disposti in una singola colonna.
MAIN_POINT Layout con un punto principale.
BIG_NUMBER Layout con un'intestazione composta da un numero elevato.

LayoutSegnapostoIdMap

La mappatura degli ID specificata dall'utente per un segnaposto che verrà creato in una diapositiva da un layout specificato.

Rappresentazione JSON 
{
  "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.
}
Campi
objectId

string

Un ID oggetto fornito dall'utente per il segnaposto identificato in precedenza da creare su una diapositiva.

Se specifichi un ID, deve essere univoco tra tutte le pagine e gli elementi delle pagine della 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 includere sia un trattino che due punti (corrisponde all'espressione regolare [a-zA-Z0-9_-:]). La lunghezza dell'ID non deve essere minore di 5 o maggiore di 50.

Se non specifichi un ID, ne verrà generato uno univoco.

Campo Union kind. Il tipo per identificare un segnaposto in un layout. kind può essere solo uno dei seguenti:
layoutPlaceholder

object (Placeholder)

Il segnaposto su un layout che verrà applicato a una diapositiva. Sono necessari solo type e index. Ad esempio, un layout TITLE_AND_BODY predefinito può generalmente avere un segnaposto TITLE con indice 0 e un segnaposto BODY con indice 0.

layoutPlaceholderObjectId

string

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

Creazione richiesta di forma

Crea una nuova forma.

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

string

Un ID oggetto fornito dall'utente.

Se specifichi un ID, deve essere univoco tra tutte le pagine e gli elementi delle pagine della 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 includere sia un trattino che due punti (corrisponde all'espressione regolare [a-zA-Z0-9_-:]). La lunghezza dell'ID non deve essere minore di 5 o maggiore di 50. Se vuoto, verrà generato un identificatore univoco.

elementProperties

object (PageElementProperties)

Le proprietà dell'elemento per la forma.

shapeType

enum (Type)

Il tipo di forma.

Proprietà paginaElemento

Proprietà comuni per un elemento di pagina.

Nota: quando inizialmente crei una proprietà PageElement, l'API può modificare i valori di size e transform, ma le dimensioni visive rimarranno invariate.

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

string

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

size

object (Size)

Le dimensioni dell'elemento.

transform

object (AffineTransform)

La trasformazione dell'elemento.

CreateTableRequest

Crea una nuova tabella.

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

string

Un ID oggetto fornito dall'utente.

Se specifichi un ID, deve essere univoco tra tutte le pagine e gli elementi delle pagine della 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 includere sia un trattino che due punti (corrisponde all'espressione regolare [a-zA-Z0-9_-:]). La lunghezza dell'ID non deve essere minore di 5 o maggiore di 50.

Se non specifichi un ID, ne verrà generato uno univoco.

elementProperties

object (PageElementProperties)

Le proprietà dell'elemento della tabella.

La tabella verrà creata nella dimensione specificata, nel rispetto delle dimensioni minime. Se non viene specificata alcuna dimensione, la tabella verrà ridimensionata automaticamente.

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

rows

integer

Numero di righe nella tabella.

columns

integer

Numero di colonne nella tabella.

Inserisci testo richiesta

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

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

string

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

cellLocation

object (TableCellLocation)

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

text

string

Il testo da inserire.

Se inserisci un carattere di nuova riga verrà creato implicitamente un nuovo ParagraphMarker all'indice. Lo stile del nuovo paragrafo verrà copiato dal paragrafo all'indice di inserzione corrente, inclusi elenchi e punti elenco.

Gli stili di testo per il testo inserito verranno determinati automaticamente, mantenendo generalmente lo stile del testo adiacente. Nella maggior parte dei casi, il testo viene aggiunto al TextRun all'indice di inserzione.

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

insertionIndex

integer

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

L'indice è basato su zero e viene calcolato dall'inizio della stringa. L'indice può essere modificato per impedire l'inserimento all'interno di cluster grafite Unicode. In questi casi, il testo viene inserito subito dopo il cluster Grapheme.

InserisciRigaRigaTabella

Inserisce righe in una tabella.

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

string

Tabella in cui inserire le righe.

cellLocation

object (TableCellLocation)

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

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

insertBelow

boolean

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

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

integer

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

Inserisci tabella colonne

Inserisce colonne in una tabella.

Le altre colonne nella tabella verranno ridimensionate per essere adattate alla nuova colonna.

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

string

Tabella in cui inserire le colonne.

cellLocation

object (TableCellLocation)

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

Verrà inserita una nuova colonna 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 destra) della cella unita.

insertRight

boolean

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

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

integer

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

Elimina richiesta TableRow

Elimina una riga da una tabella.

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

string

Tabella da cui eliminare le righe.

cellLocation

object (TableCellLocation)

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

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

Elimina tabella colonna richiesta

Elimina una colonna da una tabella.

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

string

Tabella da cui eliminare le colonne.

cellLocation

object (TableCellLocation)

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

La colonna in cui si estende questa cella verrà eliminata. Se si tratta di una cella unita, verranno eliminate più colonne. Se dopo questa eliminazione non rimangono colonne nella tabella, viene eliminata l'intera tabella.

SostituisciAllTextRequest

Sostituisce tutte le istanze di testo corrispondenti a un criterio con replace text.

Rappresentazione JSON 
{
  "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.
}
Campi
replaceText

string

Il testo che sostituirà il testo corrispondente.

pageObjectIds[]

string

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

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

Campo Union criteria. I criteri utilizzati per trovare corrispondenze con il testo da sostituire. criteria può essere solo uno dei seguenti:
containsText

object (SubstringMatchCriteria)

Trova il testo in una forma corrispondente a questa sottostringa.

SubstringMatchCriteria

Un criterio che corrisponde a una specifica stringa di testo in una forma o in una tabella.

Rappresentazione JSON 
{
  "text": string,
  "matchCase": boolean
}
Campi
text

string

Il testo da cercare nella forma o nella tabella.

matchCase

boolean

Indica se la ricerca deve rispettare il caso:

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

Richiesta eliminazione oggetto

Elimina un oggetto pages o page elements dalla presentazione.

Rappresentazione JSON 
{
  "objectId": string
}
Campi
objectId

string

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

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

Se su un layout viene eliminato un segnaposto, vengono eliminati anche eventuali segnaposto ereditati vuoti.

UpdatePageElementTransformRequest

Aggiorna la trasformazione di un elemento della pagina.

L'aggiornamento della trasformazione di un gruppo cambierà la trasformazione assoluta degli elementi della pagina nel gruppo, il che può modificare il loro aspetto visivo. Per ulteriori dettagli, consulta la documentazione per PageElement.transform.

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

string

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

transform

object (AffineTransform)

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

applyMode

enum (ApplyMode)

La modalità di applicazione dell'aggiornamento della trasformazione.

ApplicaModalità

Le modalità di applicazione dell'aggiornamento della trasformazione.

Enum
APPLY_MODE_UNSPECIFIED Modalità non specificata.
RELATIVE Applica la nuova matrice AffineTransform a quella esistente e sostituisce quella esistente con la concatenazione risultante.
ABSOLUTE Sostituisce la matrice AffineTransform esistente con quella nuova.

Richiesta di aggiornamento della posizione in Presentazioni

Aggiorna la posizione delle diapositive nella presentazione.

Rappresentazione JSON 
{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}
Campi
slideObjectIds[]

string

Gli ID delle diapositive della presentazione che devono essere spostati. Le diapositive in questo elenco devono essere in ordine di presentazione esistente, senza duplicati.

insertionIndex

integer

L'indice in cui devono essere inserite le diapositive, in base alla disposizione delle diapositive prima dello spostamento. Il valore deve essere compreso tra zero e il numero di diapositive della presentazione incluse.

Richiesta di testo eliminata

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

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

string

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

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

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

C'è sempre un carattere di nuova riga implicito alla fine del testo di una forma o della cella di tabella che non può essere eliminato. Range.Type.ALL utilizzerà i limiti corretti, ma è necessario prestare attenzione quando specifichi i 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 testo che supera un limite di un paragrafo può comportare modifiche agli stili e agli elenchi di paragrafi quando i due paragrafi vengono uniti.

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

Intervallo

Specifica un intervallo contiguo di una raccolta indicizzata, ad esempio i caratteri nel testo.

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

integer

L'indice facoltativo a base zero dell'inizio della raccolta. Obbligatorio per gli intervalli FIXED_RANGE e FROM_START_INDEX.

endIndex

integer

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

type

enum (Type)

Il tipo di intervallo.

Tipo

I tipi di intervalli.

Enum
RANGE_TYPE_UNSPECIFIED Tipo di intervallo non specificato. Questo valore non deve essere utilizzato.
FIXED_RANGE Un intervallo fisso. È necessario specificare sia startIndex sia endIndex.
FROM_START_INDEX L'intervallo inizia a startIndex e continua fino alla fine della raccolta. endIndex non deve essere specificato.
ALL Imposta l'intervallo in modo che corrisponda all'intera durata della raccolta. startIndex e endIndex non devono essere specificati.

Crea richiesta di immagine

Crea un'immagine.

Rappresentazione JSON 
{
  "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.
}
Campi
objectId

string

Un ID oggetto fornito dall'utente.

Se specifichi un ID, deve essere univoco tra tutte le pagine e gli elementi delle pagine della 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 includere sia un trattino che due punti (corrisponde all'espressione regolare [a-zA-Z0-9_-:]). La lunghezza dell'ID non deve essere minore di 5 o maggiore di 50.

Se non specifichi un ID, ne verrà generato uno univoco.

elementProperties

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 alla dimensione per mantenere le proporzioni. La trasformazione fornita viene applicata dopo questa operazione.

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

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

Campo Union image_source. Il tipo di origine dell'immagine. image_source può essere solo uno dei seguenti:
url

string

L'URL dell'immagine.

L'immagine viene recuperata una volta al momento dell'inserimento e una copia viene archiviata per essere visualizzata 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 con una lunghezza massima di 2 kB. L'URL viene salvato con l'immagine ed esposto tramite il campo Image.source_url.

Crea richiesta video

Crea un video.

NOTA: per creare un video da Google Drive, l'app richiedente richiede almeno un ambito di Drive, Drive.readonly o drive.file.

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

string

Un ID oggetto fornito dall'utente.

Se specifichi un ID, deve essere univoco tra tutte le pagine e gli elementi delle pagine della 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 includere sia un trattino che due punti (corrisponde all'espressione regolare [a-zA-Z0-9_-:]). La lunghezza dell'ID non deve essere minore di 5 o maggiore di 50.

Se non specifichi un ID, ne verrà generato uno univoco.

elementProperties

object (PageElementProperties)

Le proprietà dell'elemento del video.

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

La proprietà 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.

source

enum (Source)

L'origine del video.

id

string

Identificatore univoco dell'origine video di questo video.

ad es. per il video di YouTube https://www.youtube.com/watch?v=7U3axjORYZ0, l'ID è 7U3axjORYZ0. Per un video 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, potresti dover aggiungere una chiave di risorsa all'intestazione HTTP per un sottoinsieme di file precedenti. Per maggiori informazioni, consulta la pagina Accedere ai file condivisi tramite link utilizzando le chiavi delle risorse.

CreaFoglioGraficoRichiesta

Crea un grafico di Fogli Google incorporato.

NOTA: la creazione dei grafici richiede almeno uno dei fogli di lavoro.readonly, fogli di lavoro, drive.readonly, drive.file, o Drive OAuth.

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

string

Un ID oggetto fornito dall'utente.

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

elementProperties

object (PageElementProperties)

Le proprietà dell'elemento del grafico.

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

spreadsheetId

string

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

Potresti dover aggiungere una chiave di risorsa all'intestazione HTTP per un sottoinsieme di file meno recenti. Per maggiori informazioni, consulta la pagina Accedere ai file condivisi tramite link utilizzando le chiavi delle risorse.

chartId

integer

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

linkingMode

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.

Modalità collegamento

La modalità con cui il grafico è collegato al foglio di lavoro di origine.

Enum
NOT_LINKED_IMAGE Il grafico non è associato al foglio di lavoro di origine e non può essere aggiornato. Un grafico non collegato verrà inserito come immagine.
LINKED Il collegamento del grafico consente di aggiornarlo e gli altri collaboratori vedranno un link al foglio di lavoro.

Crea richiesta di riga

Crea una linea.

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

string

Un ID oggetto fornito dall'utente.

Se specifichi un ID, deve essere univoco tra tutte le pagine e gli elementi delle pagine della 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 includere sia un trattino che due punti (corrisponde all'espressione regolare [a-zA-Z0-9_-:]). La lunghezza dell'ID non deve essere minore di 5 o maggiore di 50.

Se non specifichi un ID, ne verrà generato uno univoco.

elementProperties

object (PageElementProperties)

Le proprietà dell'elemento per la linea.

lineCategory
(deprecated)

enum (Category)

La categoria della linea da creare.

Ritirato : utilizza category.

L'esatto line type creato è determinato in base alla categoria e al modo in cui viene instradato per connettersi ad altri elementi della pagina.

Se specifichi sia category sia lineCategory, category avrà la precedenza.

category

enum (LineCategory)

La categoria della linea da creare.

L'esatto line type creato è determinato in base alla categoria e al modo in cui viene instradato per connettersi ad altri elementi della pagina.

Se specifichi sia category sia lineCategory, category avrà la precedenza.

Se non specifichi un valore per category, ma specifichi un valore per lineCategory, verrà utilizzato il valore specificato per lineCategory.

Se non specifichi nessuna delle due opzioni, viene utilizzato STRAIGHT.

Categoria

Le categorie di linee.

Enum
STRAIGHT Connettori dritti, incluso il connettore dritto 1. La categoria predefinita è quella non specificata.
BENT Connettori piegati, incluso il connettore piegato da 2 a 5.
CURVED Connettori curvi, compreso il connettore curvo 2-5.

AggiornaChartChartRequest

Aggiorna un grafico di Fogli Google incorporato sostituendolo con la versione più recente del grafico di Fogli Google.

NOTA: l'aggiornamento dei grafici richiede almeno uno dei fogli di lavoro, di sola lettura, dei fogli di lavoro, di drive.readonly o di Drive OAuth.

Rappresentazione JSON 
{
  "objectId": string
}
Campi
objectId

string

L'ID oggetto del grafico da aggiornare.

Richiesta di aggiornamento delle proprietà

Aggiorna le proprietà di un elemento Shape.

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

string

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

shapeProperties

object (ShapeProperties)

Le proprietà della forma da aggiornare.

fields

string (FieldMask format)

I campi che devono essere aggiornati.

Devi specificare almeno un campo. La radice shapeProperties è implicita e non deve essere specificata. Puoi utilizzare un singolo "*" per creare un elenco di tutti i campi.

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

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

Richiesta aggiornamento immagine proprietà

Aggiorna le proprietà di un Image.

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

string

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

imageProperties

object (ImageProperties)

Le proprietà dell'immagine da aggiornare.

fields

string (FieldMask format)

I campi che devono essere aggiornati.

Devi specificare almeno un campo. La radice imageProperties è implicita e non deve essere specificata. Puoi utilizzare un singolo "*" per creare un elenco di tutti i campi.

Ad esempio, per aggiornare il colore del contorno dell'immagine, imposta fields su "outline.outlineFill.solidFill.color".

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

Richiesta aggiornamento videoProperties

Aggiorna le proprietà di un elemento Video.

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

string

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

videoProperties

object (VideoProperties)

Le proprietà del video da aggiornare.

fields

string (FieldMask format)

I campi che devono essere aggiornati.

Devi specificare almeno un campo. La radice videoProperties è implicita e non deve essere specificata. Puoi utilizzare un singolo "*" per creare un elenco di tutti i campi.

Ad esempio, per aggiornare il colore della struttura del video, imposta fields su "outline.outlineFill.solidFill.color".

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

Richiesta aggiornamento pagina proprietà

Aggiorna le proprietà di un elemento Page.

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

string

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

pageProperties

object (PageProperties)

Le proprietà della pagina da aggiornare.

fields

string (FieldMask format)

I campi che devono essere aggiornati.

Devi specificare almeno un campo. La radice pageProperties è implicita e non deve essere specificata. Puoi utilizzare un singolo "*" per creare un elenco di tutti i campi.

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

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

Aggiornamento tabella (CellPropertiesRequest)

Aggiorna le proprietà di un elemento TableCell.

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

string

L'ID oggetto della tabella.

tableRange

object (TableRange)

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

tableCellProperties

object (TableCellProperties)

Le proprietà della cella della tabella da aggiornare.

fields

string (FieldMask format)

I campi che devono essere aggiornati.

Devi specificare almeno un campo. La radice tableCellProperties è implicita e non deve essere specificata. Puoi utilizzare un singolo "*" per creare un elenco di tutti i campi.

Ad esempio, per aggiornare il colore di riempimento a tinta unita dello sfondo delle celle della tabella, imposta fields su "tableCellBackgroundFill.solidFill.color".

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

IntervalloTabella

Un intervallo di tabelle rappresenta un riferimento a un sottoinsieme di una tabella.

È importante notare che le celle specificate da un intervallo di tabella non formano necessariamente un rettangolo. Ad esempio, supponiamo di avere una tabella 3 x 3 in cui tutte le celle dell'ultima riga sono unite. La tabella ha il seguente aspetto: 

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

Un intervallo di tabelle con posizione = (0, 0), intervallo di righe = 3 e intervallo di colonne = 2 specifica le seguenti celle: 

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
Rappresentazione JSON 
{
  "location": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
Campi
location

object (TableCellLocation)

La posizione iniziale dell'intervallo della tabella.

rowSpan

integer

L'intervallo di righe dell'intervallo della tabella.

columnSpan

integer

L'intervallo di colonne dell'intervallo della tabella.

Richiesta aggiornamento linea proprietà

Aggiorna le proprietà di un elemento Line.

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

string

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

lineProperties

object (LineProperties)

Le proprietà della linea da aggiornare.

fields

string (FieldMask format)

I campi che devono essere aggiornati.

Devi specificare almeno un campo. La radice lineProperties è implicita e non deve essere specificata. Puoi utilizzare un singolo "*" per creare un elenco di tutti i campi.

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

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

CreazioneRichiesta di elenchi puntati

Crea elenchi puntati per tutti i paragrafi che si sovrappongono all'intervallo di indice di testo specificato.

Il livello di nidificazione di ogni paragrafo sarà determinato conteggiando le linguette iniziali davanti a ogni paragrafo. Per evitare spazi in eccesso tra il punto elenco e il paragrafo corrispondente, queste schede iniziali vengono rimosse da questa richiesta. Ciò potrebbe modificare gli indici di parti del testo.

Se il paragrafo subito prima dell'aggiornamento dei paragrafi si trova in un elenco con un valore preimpostato corrispondente, i paragrafi in fase di aggiornamento vengono aggiunti all'elenco precedente.

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

string

L'ID oggetto della forma o della tabella contenente il testo in cui aggiungere i punti.

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

L'intervallo di testo a cui applicare i valori preimpostati del punto elenco, in base a TextElement indici.

bulletPreset

enum (BulletGlyphPreset)

I tipi di glifi del proiettile da utilizzare. Il valore predefinito è il valore predefinito BULLET_DISC_CIRCLE_SQUARE.

Preset BulletGlyph

Modelli preimpostati di glifi per gli elenchi nel testo.

Questi pattern utilizzano i seguenti tipi di punti elenco:

  • ARROW : una freccia, che corrisponde a un punto di codice Unicode U+2794
  • ARROW3D : una freccia con ombreggiatura 3D, corrispondente a un punto di codice Unicode U+27a2
  • CHECKBOX : un quadrato vuoto, corrispondente a un punto di codice Unicode U+274f
  • CIRCLE : Un cerchio vuoto, corrispondente a un punto di codice Unicode U+25cb
  • DIAMOND : Un diamante massiccio, corrispondente a un punto di codice Unicode U+25c6
  • DIAMONDX : Un rombo con una "x", che corrisponde a un punto di codice Unicode U+2756
  • HOLLOWDIAMOND : Un diamante cavo, corrispondente a un punto di codice Unicode U+25c7
  • DISC : un cerchio pieno, corrispondente a un punto di codice Unicode U+25cf
  • SQUARE : un quadrato pieno, corrispondente a un punto di codice Unicode U+25a0
  • STAR : una stella, corrispondente a un punto di codice Unicode U+2605
  • ALPHA : una lettera minuscola, ad esempio "a", "b" o "c".
  • UPPERALPHA : una lettera maiuscola, come "A", "B" o "C".
  • DIGIT : un numero, ad esempio "1", "2" o "3".
  • ZERODIGIT : un numero in cui i numeri a una cifra sono preceduti da uno zero, come '01', '02' o '03'. I numeri con più di una cifra non devono essere preceduti da zero.
  • ROMAN : un numero romano minuscolo, come "i", "ii" o "iii".
  • UPPERROMAN : un numero romano maiuscolo, come "I", "II" o "III".
  • LEFTTRIANGLE : un triangolo rivolto verso sinistra, corrispondente a un punto di codice Unicode U+25c4
Enum
BULLET_DISC_CIRCLE_SQUARE Un elenco puntato con DISC, CIRCLE e SQUARE glifo con elenco puntato per i primi 3 livelli di annidamento dell'elenco.
BULLET_DIAMONDX_ARROW3D_SQUARE Un elenco puntato con DIAMONDX, ARROW3D e SQUARE glifo con elenco puntato per i primi 3 livelli di annidamento dell'elenco.
BULLET_CHECKBOX Un elenco puntato con CHECKBOX glifi del punto elenco per tutti i livelli di nidificazione.
BULLET_ARROW_DIAMOND_DISC Un elenco puntato con ARROW, DIAMOND e DISC glifo con elenco puntato per i primi 3 livelli di annidamento dell'elenco.
BULLET_STAR_CIRCLE_SQUARE Un elenco puntato con STAR, CIRCLE e SQUARE glifo con elenco puntato per i primi 3 livelli di annidamento dell'elenco.
BULLET_ARROW3D_CIRCLE_SQUARE Un elenco puntato con ARROW3D, CIRCLE e SQUARE glifo con elenco puntato per i primi 3 livelli di annidamento dell'elenco.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Un elenco puntato con LEFTTRIANGLE, DIAMOND e DISC glifo con elenco puntato per i primi 3 livelli di annidamento dell'elenco.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Un elenco puntato con DIAMONDX, HOLLOWDIAMOND e SQUARE glifo con elenco puntato per i primi 3 livelli di annidamento dell'elenco.
BULLET_DIAMOND_CIRCLE_SQUARE Un elenco puntato con DIAMOND, CIRCLE e SQUARE glifo con elenco puntato per i primi 3 livelli di annidamento dell'elenco.
NUMBERED_DIGIT_ALPHA_ROMAN Un elenco numerato con DIGIT, ALPHA e ROMAN glifi numerici per i primi 3 livelli di annidamento dell'elenco, seguiti da punti.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS Un elenco numerato con DIGIT, ALPHA e ROMAN glifi numerici per i primi 3 livelli di annidamento dell'elenco, seguiti da parentesi.
NUMBERED_DIGIT_NESTED Un elenco numerato con DIGIT glifi numerici separati da punti, in cui ogni livello di annidamento utilizza il prefisso del livello di nidificazione precedente. Ad esempio: "1.", "1.1.", "2.", "2.2."
NUMBERED_UPPERALPHA_ALPHA_ROMAN Un elenco numerato con UPPERALPHA, ALPHA e ROMAN glifi numerici per i primi 3 livelli di annidamento dell'elenco, seguiti da punti.
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT Un elenco numerato con UPPERROMAN, UPPERALPHA e DIGIT glifi numerici per i primi 3 livelli di annidamento dell'elenco, seguiti da punti.
NUMBERED_ZERODIGIT_ALPHA_ROMAN Un elenco numerato con ZERODIGIT, ALPHA e ROMAN glifi numerici per i primi 3 livelli di annidamento dell'elenco, seguiti da punti.

Sostituisci tutte le forme con richiesta immagine

Sostituisce tutte le forme che corrispondono ai criteri specificati con l'immagine fornita.

Le immagini che sostituiscono le forme sono rettangolari dopo essere state inserite nella presentazione e non assumono le forme delle forme.

Rappresentazione JSON 
{
  "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.
}
Campi
replaceMethod
(deprecated)

enum (ReplaceMethod)

Il metodo di sostituzione.

Ritirato : utilizza imageReplaceMethod.

Se specifichi sia replaceMethod che imageReplaceMethod, imageReplaceMethod ha la precedenza.

imageReplaceMethod

enum (ImageReplaceMethod)

Il metodo di sostituzione dell'immagine.

Se specifichi sia replaceMethod che imageReplaceMethod, imageReplaceMethod ha la precedenza.

Se non specifichi un valore per imageReplaceMethod, ma specifichi un valore per replaceMethod, verrà utilizzato il valore specificato per replaceMethod.

Se non specifichi nessuna delle due opzioni, viene utilizzato CENTER_INSIDE.

pageObjectIds[]

string

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

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

Campo Union criteria. I criteri con cui le forme devono corrispondere per poter essere sostituiti. criteria può essere solo uno dei seguenti:
containsText

object (SubstringMatchCriteria)

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

Campo Union image_source. Il tipo di origine dell'immagine. image_source può essere solo uno dei seguenti:
imageUrl

string

L'URL dell'immagine.

L'immagine viene recuperata una volta al momento dell'inserimento e una copia viene archiviata per essere visualizzata 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 stesso viene salvato con l'immagine ed esposto tramite il campo Image.source_url.

Metodo di sostituzione

Il metodo di sostituzione.

Enum
CENTER_INSIDE Ridimensiona e centra l'immagine per adattarla ai limiti della forma originale e mantiene le proporzioni dell'immagine. Le dimensioni dell'immagine visualizzata potrebbero essere inferiori a quelle della forma. Questo è il metodo predefinito quando non è specificato.
CENTER_CROP Ridimensiona e centra l'immagine per riempire i bordi della forma originale. L'immagine può essere ritagliata per riempire la forma. Le dimensioni visualizzate dell'immagine saranno uguali a quelle della forma originale.

Metodo di sostituzione immagine

Il metodo di sostituzione dell'immagine.

Enum
IMAGE_REPLACE_METHOD_UNSPECIFIED Metodo di sostituzione dell'immagine non specificato. Questo valore non deve essere utilizzato.
CENTER_INSIDE Ridimensiona e centra l'immagine per adattarla ai limiti della forma originale e mantiene le proporzioni dell'immagine. Le dimensioni dell'immagine visualizzata potrebbero essere inferiori a quelle della forma. Questo è il metodo predefinito quando non è specificato.
CENTER_CROP Ridimensiona e centra l'immagine per riempire i bordi della forma originale. L'immagine può essere ritagliata per riempire la forma. Le dimensioni visualizzate dell'immagine saranno uguali a quelle della forma originale.

RichiestaOggetto duplicato

Duplicare una diapositiva o un elemento della pagina.

Quando duplica una diapositiva, questa viene creata immediatamente dopo quella specificata. Quando duplichi un elemento di pagina, il duplicato verrà posizionato nella stessa pagina nella stessa posizione dell'originale.

Rappresentazione JSON 
{
  "objectId": string,
  "objectIds": {
    string: string,
    ...
  }
}
Campi
objectId

string

L'ID dell'oggetto da duplicare.

objectIds

map (key: string, value: string)

L'oggetto duplicato può contenere altri oggetti, ad esempio quando si duplica una diapositiva o un elemento della pagina del 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 relativi valori sono gli ID che verranno 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 campo objectId come chiave e l'ID appena 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 alla regex [a-zA-Z0-9_]); i caratteri rimanenti possono includere sia un trattino che due punti (corrisponde alla regex [a-zA-Z0-9_-:]). La lunghezza del nuovo ID non deve essere inferiore a 5 o maggiore di 50.

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

Richiesta aggiornamento stile testo

Aggiorna lo stile del testo in un elemento Shape o Table.

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

string

L'ID oggetto della forma o della tabella con il testo da applicare allo stile.

cellLocation

object (TableCellLocation)

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

style

object (TextStyle)

Gli stili da impostare sul testo.

Se il valore di un determinato stile corrisponde a quello dell'elemento principale, questo stile verrà impostato per ereditare.

Alcune modifiche allo stile del testo potrebbero causare altri cambiamenti che riflettono il comportamento dell'editor di Presentazioni. Per saperne di più, consulta la documentazione di TextStyle.

textRange

object (Range)

La gamma di testo da applicare allo stile.

L'intervallo potrebbe essere esteso in modo da includere nuove righe adiacenti.

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

fields

string (FieldMask format)

I campi che devono essere aggiornati.

Devi specificare almeno un campo. La radice style è implicita e non deve essere specificata. Puoi utilizzare un singolo "*" per creare un elenco di tutti i campi.

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

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

Sostituzione di Tutte le forme con Fogli Grafico Richiesta

Sostituisce tutte le forme che corrispondono ai criteri specificati con il grafico di Fogli Google fornito. Il grafico verrà scalato e centrato per adattarsi ai limiti della forma originale.

NOTA: per sostituire le forme con un grafico è necessario almeno uno dei fogli di lavoro, di sola lettura, dei fogli di lavoro, di drive.readonly o di Drive OAuth.

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

object (SubstringMatchCriteria)

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

spreadsheetId

string

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

chartId

integer

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

linkingMode

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.

pageObjectIds[]

string

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

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

Modalità collegamento

La modalità con cui il grafico è collegato al foglio di lavoro di origine.

Enum
NOT_LINKED_IMAGE Il grafico non è associato al foglio di lavoro di origine e non può essere aggiornato. Un grafico non collegato verrà inserito come immagine.
LINKED Il collegamento del grafico consente di aggiornarlo e gli altri collaboratori vedranno un link al foglio di lavoro.

EliminaParagraphBulletsRequest

Elimina i punti elenco di tutti i paragrafi che si sovrappongono all'indice di testo specificato range.

Il livello di nidificazione di ogni paragrafo verrà preservato visivamente aggiungendo un rientro all'inizio del paragrafo corrispondente.

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

string

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

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

L'intervallo di testo da cui eliminare i punti elenco, in base a indici TextElement.

Aggiornamento Paragrafo

Aggiorna lo stile di tutti i paragrafi all'interno di un elemento Shape o Table che si sovrappongono all'intervallo di indice di testo specificato.

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

string

L'ID oggetto della forma o della tabella con il testo da applicare allo stile.

cellLocation

object (TableCellLocation)

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

style

object (ParagraphStyle)

Lo stile del paragrafo.

textRange

object (Range)

L'intervallo di testo contenente i paragrafi di stile.

fields

string (FieldMask format)

I campi che devono essere aggiornati.

Devi specificare almeno un campo. La radice style è implicita e non deve essere specificata. Puoi utilizzare un singolo "*" per creare un elenco di tutti i campi.

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

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

Aggiornamento richiesta di tabella TableBorderProperties

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

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

string

L'ID oggetto della tabella.

tableRange

object (TableRange)

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

borderPosition

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

tableBorderProperties

object (TableBorderProperties)

Le proprietà del bordo della tabella da aggiornare.

fields

string (FieldMask format)

I campi che devono essere aggiornati.

Devi specificare almeno un campo. La radice tableBorderProperties è implicita e non deve essere specificata. Puoi utilizzare un singolo "*" per creare un elenco di tutti i campi.

Ad esempio, per aggiornare il colore di riempimento a tinta unita dei bordi della tabella, imposta fields su "tableBorderFill.solidFill.color".

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

Posizione bordo

La posizione del bordo della tabella.

Enum
ALL Tutti i bordi compresi nell'intervallo.
BOTTOM Bordi in fondo all'intervallo.
INNER Bordi all'interno dell'intervallo.
INNER_HORIZONTAL Bordi orizzontali all'interno dell'intervallo.
INNER_VERTICAL Bordi verticali all'interno dell'intervallo.
LEFT Bordi a sinistra dell'intervallo.
OUTER Bordi lungo l'esterno dell'intervallo.
RIGHT Bordi a destra dell'intervallo.
TOP Bordi nella parte superiore dell'intervallo.

Aggiornamento tabella colonna proprietà

Aggiorna le proprietà di una colonna Table.

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

string

L'ID oggetto della tabella.

columnIndices[]

integer

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

tableColumnProperties

object (TableColumnProperties)

Le proprietà della colonna della tabella da aggiornare.

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

fields

string (FieldMask format)

I campi che devono essere aggiornati.

Devi specificare almeno un campo. La radice tableColumnProperties è implicita e non deve essere specificata. Puoi utilizzare un singolo "*" per creare un elenco di tutti i campi.

Ad esempio, per aggiornare la larghezza della colonna, imposta il valore fields su "columnWidth".

Se "maschera colonna" è inclusa nella maschera di campo, ma la proprietà non viene impostata,la larghezza di colonna verrà impostata su 406.400 EMU (32 punti) per impostazione predefinita.

AggiornamentoProprietàProprietàTabellaRiga

Aggiorna le proprietà di una riga Table.

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

string

L'ID oggetto della tabella.

rowIndices[]

integer

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

tableRowProperties

object (TableRowProperties)

Le proprietà della riga della tabella da aggiornare.

fields

string (FieldMask format)

I campi che devono essere aggiornati.

Devi specificare almeno un campo. La radice tableRowProperties è implicita e non deve essere specificata. Puoi utilizzare un singolo "*" per creare un elenco di tutti i campi.

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

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

Richiesta unione tabellaCells

Unisce le celle in una Table.

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

string

L'ID oggetto della tabella.

tableRange

object (TableRange)

L'intervallo della 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 (può verificarsi in alcuni casi in cui l'intervallo copre celle già unite), viene restituito un errore di richiesta 400 non valido.

Richiesta di unione di tabelle e celle

Divide le celle in una Table.

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

string

L'ID oggetto della tabella.

tableRange

object (TableRange)

L'intervallo della tabella che specifica le celle della tabella da dividere.

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

Richiesta Oggetti Gruppo

Raggruppa gli oggetti per creare un gruppo di oggetti. Ad esempio, i gruppi PageElements possono creare un elemento Group nella stessa pagina di tutti gli elementi secondari.

Rappresentazione JSON 
{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}
Campi
groupObjectId

string

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

Se specifichi un ID, deve essere univoco tra tutte le pagine e gli elementi delle pagine della 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 includere sia un trattino che due punti (corrisponde all'espressione regolare [a-zA-Z0-9_-:]). La lunghezza dell'ID non deve essere minore di 5 o maggiore di 50.

Se non specifichi un ID, ne verrà generato uno univoco.

childrenObjectIds[]

string

Gli ID degli oggetti da raggruppare.

È possibile raggruppare solo gli elementi di pagina. Sulla stessa pagina devono essere presenti almeno due elementi di pagina che non sono già presenti in un altro gruppo. Alcuni elementi della pagina, come videos, tables e placeholders, non possono essere raggruppati.

UngroupObjectsRequest

Separa gli oggetti, ad esempio groups.

Rappresentazione JSON 
{
  "objectIds": [
    string
  ]
}
Campi
objectIds[]

string

Gli ID degli oggetti da separare.

È possibile annullare il raggruppamento solo groups che non si trovano all'interno di altri groups. Tutti i gruppi devono trovarsi sulla stessa pagina. Il gruppo stesso è stato eliminato. Vengono mantenute le dimensioni e le posizioni visive di tutti i bambini.

UpdatePageElementAltTextRequest

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

Rappresentazione JSON 
{
  "objectId": string,
  "title": string,
  "description": string
}
Campi
objectId

string

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

title

string

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

description

string

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

SostituisciRichiesta immagine

Sostituisce un'immagine esistente con una nuova.

La sostituzione di un'immagine rimuove alcuni image effects dall'immagine esistente.

Rappresentazione JSON 
{
  "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.
}
Campi
imageObjectId

string

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

imageReplaceMethod

enum (ImageReplaceMethod)

Il metodo di sostituzione.

Campo Union image_source. Il tipo di origine dell'immagine. image_source può essere solo uno dei seguenti:
url

string

L'URL dell'immagine.

L'immagine viene recuperata una volta al momento dell'inserimento e una copia viene archiviata per essere visualizzata all'interno della presentazione. Le immagini devono essere inferiori a 50 MB, non possono superare i 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 il campo Image.source_url.

Richiesta di aggiornamento delle proprietà delle diapositive

Aggiorna le proprietà di una diapositiva.

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

string

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

slideProperties

object (SlideProperties)

Le proprietà della diapositiva da aggiornare.

fields

string (FieldMask format)

I campi che devono essere aggiornati.

Devi specificare almeno un campo. La radice "slideProperties" è implicita e non deve essere specificata. Puoi utilizzare un singolo "*" per creare un elenco di tutti i campi.

Ad esempio, per aggiornare se una diapositiva viene ignorata, imposta fields su "isSkipped".

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

UpdatePageElementsZOrderRequest

Aggiorna l'ordine Z degli elementi di una pagina. L'ordine Z è un ordine degli elementi della pagina dalla parte anteriore a quella anteriore. L'elemento della pagina sul lato anteriore potrebbe coprire gli elementi dietro di esso.

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

string

Gli ID oggetto degli elementi della pagina da aggiornare.

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

operation

enum (ZOrderOperation)

L'operazione Z-order da applicare agli elementi della pagina.

Quando applichi l'operazione su più elementi di pagina, i relativi ordini di Z all'interno di questi elementi di pagina prima della manutenzione vengono eseguiti.

Operazione ZOrder

L'operazione di aggiornamento dell'ordine Z di un elemento di pagina.

Enum
Z_ORDER_OPERATION_UNSPECIFIED Operazione non specificata.
BRING_TO_FRONT Porta gli elementi della pagina in primo piano.
BRING_FORWARD Porta gli elementi della pagina in avanti nella pagina di un elemento rispetto a quello più avanti degli elementi di pagina specificati.
SEND_BACKWARD Invia gli elementi della pagina all'indietro nella pagina di un elemento rispetto al più lontano dietro uno degli elementi della pagina specificati.
SEND_TO_BACK Invia gli elementi della pagina sul retro della pagina.

Richiesta aggiornamento categoria categoria

Aggiorna la categoria di line.

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

string

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

È possibile aggiornare solo una riga con un category che indica che è un "connettore".

La linea potrebbe essere reindirizzata dopo l'aggiornamento della relativa categoria.

lineCategory

enum (LineCategory)

La categoria di linea a cui aggiornare.

L'esatto line type viene determinato in base alla categoria di destinazione dell'aggiornamento e a come viene indirizzato per la connessione ad altri elementi della pagina.

Richiesta reindirizzamento

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

Rappresentazione JSON 
{
  "objectId": string
}
Campi
objectId

string

L'ID oggetto della linea da reindirizzare.

Solo una linea con un category che indica che è un "connettore" può essere reindirizzata. Le connessioni di inizio e fine della linea devono trovarsi su elementi di pagina diversi.