Requests

Richiesta

Un singolo 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 unione kind. Il tipo di aggiornamento. È richiesto 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 del testo in una forma o in una cella di tabella.

insertTableRows

object (InsertTableRowsRequest)

Inserisce righe in una tabella.

insertTableColumns

object (InsertTableColumnsRequest)

Inserisce colonne in una tabella.

deleteTableRow

object (DeleteTableRowRequest)

Consente di eliminare una riga da una tabella.

deleteTableColumn

object (DeleteTableColumnRequest)

Consente di eliminare una colonna da una tabella.

replaceAllText

object (ReplaceAllTextRequest)

Sostituisce tutte le istanze del testo specificato.

deleteObject

object (DeleteObjectRequest)

Consente di eliminare una pagina o un elemento della pagina dalla presentazione.

updatePageElementTransform

object (UpdatePageElementTransformRequest)

Aggiorna la trasformazione di un elemento della pagina.

updateSlidesPosition

object (UpdateSlidesPositionRequest)

Aggiorna la posizione di un insieme di diapositive nella presentazione.

deleteText

object (DeleteTextRequest)

Consente di eliminare il testo da una forma o da una cella di 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 riga.

refreshSheetsChart

object (RefreshSheetsChartRequest)

Aggiorna un grafico di Fogli Google.

updateShapeProperties

object (UpdateShapePropertiesRequest)

Aggiorna le proprietà di un Shape.

updateImageProperties

object (UpdateImagePropertiesRequest)

Aggiorna le proprietà di un Image.

updateVideoProperties

object (UpdateVideoPropertiesRequest)

Aggiorna le proprietà di un Video.

updatePageProperties

object (UpdatePagePropertiesRequest)

Aggiorna le proprietà di un Page.

updateTableCellProperties

object (UpdateTableCellPropertiesRequest)

Aggiorna le proprietà di un TableCell.

updateLineProperties

object (UpdateLinePropertiesRequest)

Aggiorna le proprietà di un Line.

createParagraphBullets

object (CreateParagraphBulletsRequest)

Crea elenchi puntati per i paragrafi.

replaceAllShapesWithImage

object (ReplaceAllShapesWithImageRequest)

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

duplicateObject

object (DuplicateObjectRequest)

Consente di duplicare un elemento di una slide o di una pagina.

updateTextStyle

object (UpdateTextStyleRequest)

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

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

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

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Consente di eliminare i numeri dall'elenco puntato nei paragrafi.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

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

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

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

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Aggiorna le proprietà di una colonna Table

updateTableRowProperties

object (UpdateTableRowPropertiesRequest)

Aggiorna le proprietà di una Table riga.

mergeTableCells

object (MergeTableCellsRequest)

Unisce le celle di un Table.

unmergeTableCells

object (UnmergeTableCellsRequest)

Divide le celle in un Table.

groupObjects

object (GroupObjectsRequest)

Raggruppa oggetti, ad esempio elementi di pagina.

ungroupObjects

object (UngroupObjectsRequest)

Separa gli oggetti, ad esempio groups.

updatePageElementAltText

object (UpdatePageElementAltTextRequest)

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

replaceImage

object (ReplaceImageRequest)

Sostituisce un'immagine esistente con una nuova.

updateSlideProperties

object (UpdateSlidePropertiesRequest)

Aggiorna le proprietà di una slide

updatePageElementsZOrder

object (UpdatePageElementsZOrderRequest)

Aggiorna l'ordine Z di page elements.

updateLineCategory

object (UpdateLineCategoryRequest)

Aggiorna la categoria di un line.

rerouteLine

object (RerouteLineRequest)

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

CreateSlideRequest

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, questo deve essere univoco tra tutte le pagine e gli elementi della pagina della presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde alla regex [a-zA-Z0-9_]); i caratteri rimanenti possono includere questi, 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.

insertionIndex

integer

L'indice facoltativo a partire da zero che indica dove inserire le slide.

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

slideLayoutReference

object (LayoutReference)

Riferimento del layout della diapositiva da inserire, in base al modello principale attuale, che può essere uno dei seguenti:

  • Lo schema dell'indice della diapositiva precedente.
  • Il master della prima diapositiva, se l'indice di inserzione è zero.
  • Il primo schema nella presentazione, se non sono presenti diapositive.

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

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

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

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

LayoutReference

Riferimento al layout delle slide. Può 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 unione 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.

PredefinedLayout

Tipi di layout predefiniti. Si tratta di layout comuni nelle presentazioni. Tuttavia, non vi è alcuna garanzia che questi layout siano presenti nel master corrente, in quanto potrebbero essere stati eliminati o non far parte del tema utilizzato. Inoltre, i segnaposto in ogni layout potrebbero essere stati modificati.

Enum
PREDEFINED_LAYOUT_UNSPECIFIED Layout non specificato.
BLANK Layout vuoto, senza segnaposto.
CAPTION_ONLY Layout con una didascalia in basso.
TITLE Layout con un titolo e un sottotitolo.
TITLE_AND_BODY Layout con un titolo e un corpo.
TITLE_AND_TWO_COLUMNS Layout con un titolo e due colonne.
TITLE_ONLY Layout con un solo titolo.
SECTION_HEADER Layout con un titolo di sezione.
SECTION_TITLE_AND_DESCRIPTION Layout con un titolo e un sottotitolo su un lato e una descrizione sull'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 con numeri grandi.

LayoutPlaceholderIdMapping

La mappatura dell'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 sopra da creare in una diapositiva.

Se specifichi un ID, questo deve essere univoco tra tutte le pagine e gli elementi della pagina della presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde alla regex [a-zA-Z0-9_]); i caratteri rimanenti possono includere questi, 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.

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

object (Placeholder)

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

layoutPlaceholderObjectId

string

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

CreateShapeRequest

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, questo deve essere univoco tra tutte le pagine e gli elementi della pagina della presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde alla regex [a-zA-Z0-9_]); i caratteri rimanenti possono includere questi, 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 il campo è vuoto, verrà generato un identificatore univoco.

elementProperties

object (PageElementProperties)

Le proprietà dell'elemento per la forma.

shapeType

enum (Type)

Il tipo di forma.

PageElementProperties

Proprietà comuni per un elemento della pagina.

Nota: quando crei inizialmente un PageElement, l'API potrebbe modificare i valori sia di size sia di 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)

La dimensione 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, questo deve essere univoco tra tutte le pagine e gli elementi della pagina della presentazione. L'ID deve iniziare con un carattere alfanumerico o un trattino basso (corrisponde alla regex [a-zA-Z0-9_]); i caratteri rimanenti possono includere questi, 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.

elementProperties

object (PageElementProperties)

Le proprietà dell'elemento per la tabella.

La tabella verrà creata con le dimensioni specificate, rispettando una dimensione minima. Se non viene specificata alcuna dimensione, le dimensioni della tabella verranno impostate automaticamente.

Le trasformazioni delle tabelle devono avere una scala di 1 e nessun componente di taglio. Se non viene specificato alcun valore di trasformazione, la tabella verrà centrata nella pagina.

rows

integer

Numero di righe nella tabella.

columns

integer

Numero di colonne nella tabella.

InsertTextRequest

Inserisce del 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 (