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. È necessario un solo campo. kind può essere solo uno dei seguenti tipi:
createSlide

object (CreateSlideRequest)

Crea una nuova slide.

createShape

object (CreateShapeRequest)

Crea una nuova forma.

createTable

object (CreateTableRequest)

Crea una nuova tabella.

insertText

object (InsertTextRequest)

Inserisce il testo in una forma o in una cella di una 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 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 slide 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 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 che corrispondono a determinati criteri con un'immagine.

duplicateObject

object (DuplicateObjectRequest)

Duplica 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 che corrispondono a determinati criteri con un grafico di Fogli Google.

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Elimina i punti elenco dai 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 riga Table.

mergeTableCells

object (MergeTableCellsRequest)

Unisce le celle in un Table.

unmergeTableCells

object (UnmergeTableCellsRequest)

Annulla l'unione delle celle in un Table.

groupObjects

object (GroupObjectsRequest)

Raggruppa gli oggetti, ad esempio gli elementi della 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)

Riorganizza un line in modo che sia collegato ai due siti di connessione più vicini sugli elementi della pagina collegata.

CreateSlideRequest

Crea una slide.

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 tutti gli elementi 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 anche un trattino o 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 viene generato uno univoco.

insertionIndex

integer

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

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

slideLayoutReference

object (LayoutReference)

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

  • Il master dell'indice della slide precedente.
  • La slide master della prima slide, se insertionIndex è zero.
  • Il primo schema nella presentazione, se non ci sono slide.

Se LayoutReference non viene trovato nel master corrente, viene restituito un errore 400 Bad Request.

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

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

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

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 tipi:
predefinedLayout

enum (PredefinedLayout)

Layout predefinito.

layoutId

string

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

PredefinedLayout

Tipi di layout predefiniti. Questi sono layout comunemente utilizzati nelle presentazioni. Tuttavia, non è garantito che questi layout siano presenti nel master corrente, in quanto potrebbero essere stati eliminati o non far parte del tema utilizzato. Inoltre, i segnaposto di 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 solo un titolo.
SECTION_HEADER Layout con un titolo di sezione.
SECTION_TITLE_AND_DESCRIPTION Layout con titolo e sottotitolo su un lato e 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 titolo numerico di grandi dimensioni.

LayoutPlaceholderIdMapping

La mappatura dell'ID specificata dall'utente per un segnaposto che verrà creato in una slide 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 slide.

Se specifichi un ID, questo deve essere univoco tra tutte le pagine e tutti gli elementi 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 questi, nonché un trattino o due punti (corrisponde all'espressione regolare [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 tipi:
layoutPlaceholder

object (Placeholder)

Il segnaposto in un layout che verrà applicato a una slide. Sono necessari solo type e index. Ad esempio, un layout TITLE_AND_BODY predefinito potrebbe 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 slide.

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 tutti gli elementi 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 questi, nonché un trattino o due punti (corrisponde all'espressione regolare [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 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)

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 tutti gli elementi 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 questi, nonché un trattino o due punti (corrisponde all'espressione regolare [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 fornite, soggette a una dimensione minima. Se non viene fornita alcuna dimensione, la tabella verrà dimensionata 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 nella pagina.

rows

integer

Numero di righe nella tabella.

columns

integer

Numero di colonne nella tabella.

InsertTextRequest

Inserisce il testo in una forma o in una cella di una 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.

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

Gli stili di testo per il testo inserito verranno determinati automaticamente, in genere mantenendo lo stile del testo adiacente. Nella maggior parte dei casi, il testo verrà aggiunto all'TextRun che si trova all'indice di inserimento.

Alcuni caratteri di controllo (U+0000-U+0008, U+000C-U+001F) e caratteri dell'area di utilizzo 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, in base agli indici TextElement.

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

InsertTableRowsRequest

Inserisce righe in una tabella.

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

string

La 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

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.

InsertTableColumnsRequest

Inserisce colonne in una tabella.

Le altre colonne della tabella verranno ridimensionate per adattarsi alla nuova colonna.

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

string

La 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 a destra) della cella unita.

insertRight

boolean

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.

DeleteTableRowRequest

Elimina una riga da una tabella.

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

string

La 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 a cui appartiene questa cella verrà eliminata. Se si tratta di una cella unita, verranno eliminate più righe. Se dopo l'eliminazione non rimangono righe nella tabella, l'intera tabella viene eliminata.

DeleteTableColumnRequest

Elimina una colonna da una tabella.

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

string

La 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 a cui appartiene questa cella verrà eliminata. Se si tratta di una cella unita, verranno eliminate più colonne. Se dopo l'eliminazione non rimangono colonne nella tabella, l'intera tabella viene eliminata.

ReplaceAllTextRequest

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 400 Bad Request se viene fornito l'ID oggetto pagina di un notes master o se una pagina con quell'ID oggetto non esiste nella presentazione.

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

object (SubstringMatchCriteria)

Trova testo in una forma corrispondente a questa sottostringa.

SubstringMatchCriteria

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

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

string

Il testo da cercare nella forma o nella tabella.

matchCase

boolean

Indica se la ricerca deve rispettare la distinzione tra maiuscole e minuscole:

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

boolean

Facoltativo. True se il valore di ricerca deve essere trattato come un'espressione regolare. Tutte le barre rovesciate nel pattern devono essere precedute dal carattere di escape.

  • True : il testo di ricerca viene trattato come espressione regolare.
  • False : il testo di ricerca viene trattato come una sottostringa per la corrispondenza.

DeleteObjectRequest

Elimina un oggetto, pages o page elements, dalla presentazione.

Rappresentazione JSON 
{
  "objectId": string
}
Campi
objectId

string

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

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

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

UpdatePageElementTransformRequest

Aggiorna la trasformazione di un elemento della pagina.

L'aggiornamento della trasformazione di un gruppo modificherà la trasformazione assoluta degli elementi della pagina in quel gruppo, il che può modificarne l'aspetto visivo. Per ulteriori dettagli, consulta la documentazione relativa a 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 dell'input utilizzata per aggiornare l'elemento della pagina.

applyMode

enum (ApplyMode)

La modalità di applicazione dell'aggiornamento della trasformazione.

ApplyMode

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 la sostituisce con la concatenazione risultante.
ABSOLUTE Sostituisce la matrice AffineTransform esistente con quella nuova.

UpdateSlidesPositionRequest

Aggiorna la posizione delle slide nella presentazione.

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

string

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

insertionIndex

integer

L'indice in cui devono essere inserite le slide, in base alla disposizione delle slide prima dello spostamento. Deve essere compreso tra zero e il numero di slide della presentazione, inclusi.

DeleteTextRequest

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.

Alla fine del testo di una forma o di una cella di tabella è sempre presente un carattere di nuova riga implicito che non può essere eliminato. Range.Type.ALL utilizzerà i limiti corretti, ma è necessario 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 un carattere di nuova riga implicito, il valore massimo è 2 per textRange.start_index e 3 per textRange.end_index.

L'eliminazione di testo che attraversa il confine di un paragrafo può comportare modifiche agli stili di paragrafo e agli elenchi, in quanto i due paragrafi vengono uniti.

Gli intervalli che includono una sola unità di codice di una coppia surrogata vengono espansi in modo da 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 in base zero dell'inizio della raccolta. Obbligatorio per gli intervalli FIXED_RANGE e FROM_START_INDEX.

endIndex

integer

L'indice facoltativo basato su zero della fine della raccolta. Obbligatorio per FIXED_RANGE intervalli.

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. Devono essere specificati sia startIndex sia endIndex.
FROM_START_INDEX Inizia l'intervallo alle startIndex e continua fino alla fine della raccolta. endIndex non deve essere specificato.
ALL Imposta l'intervallo in modo che corrisponda all'intera lunghezza della raccolta. Non devono essere specificati né startIndex né endIndex.

CreateImageRequest

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, questo deve essere univoco tra tutte le pagine e tutti gli elementi 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 questi, nonché un trattino o due punti (corrisponde all'espressione regolare [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 l'immagine.

Quando le proporzioni delle dimensioni fornite non corrispondono a quelle dell'immagine, l'immagine viene scalata e centrata rispetto alle dimensioni per mantenere le proporzioni. La trasformazione fornita viene applicata dopo questa operazione.

La proprietà PageElementProperties.size è facoltativa. Se non specifichi le dimensioni, vengono utilizzate le dimensioni predefinite 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 unione image_source. Il tipo di origine dell'immagine. image_source può essere solo uno dei seguenti tipi:
url

string

L'URL dell'immagine.

L'immagine viene recuperata una sola volta al momento dell'inserimento e ne viene memorizzata una copia per la visualizzazione all'interno della presentazione. Le immagini non devono superare i 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 non deve superare i 2 KB. L'URL viene salvato con l'immagine e visualizzato nel campo Image.source_url.

CreateVideoRequest

Crea un video.

NOTA: per creare un video da Google Drive, l'app richiedente deve disporre di almeno uno degli ambiti OAuth 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, questo deve essere univoco tra tutte le pagine e tutti gli elementi 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 questi, nonché un trattino o due punti (corrisponde all'espressione regolare [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 il video.

La proprietà PageElementProperties.size è facoltativa. Se non specifichi una dimensione, il server ne sceglie una 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

L'identificatore univoco della sorgente video per questo video.

Ad esempio, per il 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, potresti dover aggiungere una chiave di accesso alla risorsa all'intestazione HTTP per un sottoinsieme di file precedenti. Per saperne di più, consulta Accedere ai file condivisi tramite link utilizzando le chiavi delle risorse.

CreateSheetsChartRequest

Crea un grafico di Fogli Google incorporato.

NOTA: per creare un grafico è necessario almeno uno degli ambiti OAuth spreadsheets.readonly, spreadsheets, drive.readonly, drive.file o drive.

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 della presentazione. L'ID deve iniziare con un carattere alfanumerico [a-zA-Z0-9_] e poi essere 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 il campo è vuoto, verrà generato un identificatore univoco.

elementProperties

object (PageElementProperties)

Le proprietà degli elementi del grafico.

Quando le proporzioni delle dimensioni fornite non corrispondono alle proporzioni del grafico, il grafico viene scalato 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 Google Sheets che contiene il grafico.

Potresti dover aggiungere una chiave di accesso alla risorsa all'intestazione HTTP per un sottoinsieme di file precedenti. Per saperne di più, consulta Accedere ai file condivisi tramite link utilizzando le chiavi delle risorse.

chartId

integer

L'ID del grafico specifico nel foglio di lavoro 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.

LinkingMode

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 visualizzeranno un link al foglio di lavoro.

CreateLineRequest

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, questo deve essere univoco tra tutte le pagine e tutti gli elementi 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 questi, nonché un trattino o due punti (corrisponde all'espressione regolare [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 linea.

lineCategory
(deprecated)

enum (Category)

La categoria della linea da creare.

Deprecata : utilizza category in alternativa.

Il line type esatto creato viene determinato in base alla categoria e al modo in cui viene indirizzato per connettersi ad altri elementi della pagina.

Se specifichi sia un category sia un lineCategory, l'elemento category ha la precedenza.

category

enum (LineCategory)

La categoria della linea da creare.

Il line type esatto creato viene determinato in base alla categoria e al modo in cui viene indirizzato per connettersi ad altri elementi della pagina.

Se specifichi sia un category sia un lineCategory, l'elemento category ha la precedenza.

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

Se non specifichi nessuno dei due, viene utilizzato STRAIGHT.

Categoria

Le categorie di righe.

Enum
STRAIGHT Connettori dritti, incluso il connettore dritto 1. Questa è la categoria predefinita quando non ne viene specificata una.
BENT Connettori piegati, inclusi i connettori piegati da 2 a 5.
CURVED Connettori curvi, inclusi i connettori curvi da 2 a 5.

RefreshSheetsChartRequest

Aggiorna un grafico di Fogli Google incorporato sostituendolo con l'ultima versione del grafico di Fogli Google.

NOTA: l'aggiornamento dei grafici richiede almeno uno degli ambiti OAuth spreadsheets.readonly, spreadsheets, drive.readonly o drive.

Rappresentazione JSON 
{
  "objectId": string
}
Campi
objectId

string

L'ID oggetto del grafico da aggiornare.

UpdateShapePropertiesRequest

Aggiorna le proprietà di un 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 da aggiornare.

È necessario specificare almeno un campo. La radice shapeProperties è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come abbreviazione per elencare 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 reimpostare una proprietà sul valore predefinito, includi il nome del campo nella maschera del campo, ma lascia il campo stesso non impostato.

UpdateImagePropertiesRequest

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 da aggiornare.

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

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

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

UpdateVideoPropertiesRequest

Aggiorna le proprietà di un Video.

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

string

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

videoProperties

object (VideoProperties)

Le proprietà video da aggiornare.

fields

string (FieldMask format)

I campi da aggiornare.

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

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

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

UpdatePagePropertiesRequest

Aggiorna le proprietà di un 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 da aggiornare.

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

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

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

UpdateTableCellPropertiesRequest

Aggiorna le proprietà di un 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 di tabelle, gli aggiornamenti verranno applicati all'intera tabella.

tableCellProperties

object (TableCellProperties)

Le proprietà della cella della tabella da aggiornare.

fields

string (FieldMask format)

I campi da aggiornare.

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

Ad esempio, per aggiornare il colore di riempimento solido dello sfondo della cella della tabella, imposta fields su "tableCellBackgroundFill.solidFill.color".

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

TableRange

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

È importante notare che le celle specificate da un intervallo di una 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 questo aspetto: 

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

Un intervallo di tabella con posizione = (0, 0), estensione riga = 3 ed estensione colonna = 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.

UpdateLinePropertiesRequest

Aggiorna le proprietà di un 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 da aggiornare.

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

Ad esempio, per aggiornare il colore di riempimento solido della linea, imposta fields su "lineFill.solidFill.color".

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

CreateParagraphBulletsRequest

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

Il livello di nidificazione di ogni paragrafo viene determinato contando i caratteri di tabulazione iniziali di ogni paragrafo. Per evitare spazio in eccesso tra il punto elenco e il paragrafo corrispondente, queste tabulazioni iniziali vengono rimosse da questa richiesta. Ciò potrebbe modificare gli indici di alcune parti del testo.

Se il paragrafo immediatamente precedente a quelli in fase di aggiornamento si trova in un elenco con un preset 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 a cui aggiungere i punti elenco.

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 preset dei punti elenco, in base agli indici TextElement.

bulletPreset

enum (BulletGlyphPreset)

I tipi di glifi elenco puntato da utilizzare. Il valore predefinito è il preset BULLET_DISC_CIRCLE_SQUARE.

BulletGlyphPreset

Pattern preimpostati di glifi puntati per gli elenchi nel testo.

Questi pattern utilizzano i seguenti tipi di elenchi puntati:

  • ARROW : una freccia, corrispondente 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 rombo pieno, corrispondente a un punto di codice Unicode U+25c6
  • DIAMONDX : Un diamante con una "x", corrispondente a un punto di codice Unicode U+2756
  • HOLLOWDIAMOND : Un rombo vuoto, 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, ad esempio "A", "B" o "C".
  • DIGIT : un numero, ad esempio "1", "2" o "3".
  • ZERODIGIT : un numero in cui i numeri a una sola cifra sono preceduti da uno zero, ad esempio "01", "02" o "03". I numeri con più di una cifra non hanno un prefisso zero.
  • ROMAN : un numero romano minuscolo, ad esempio "i", "ii" o "iii".
  • UPPERROMAN : un numero romano maiuscolo, ad esempio "I", "II" o "III".
  • LEFTTRIANGLE : Un triangolo che punta a sinistra, corrispondente a un punto di codice Unicode U+25c4
Enum
BULLET_DISC_CIRCLE_SQUARE Un elenco puntato con un DISC, CIRCLE e SQUARE glifo puntato per i primi tre livelli di annidamento dell'elenco.
BULLET_DIAMONDX_ARROW3D_SQUARE Un elenco puntato con un DIAMONDX, ARROW3D e SQUARE glifo puntato per i primi tre livelli di annidamento dell'elenco.
BULLET_CHECKBOX Un elenco puntato con CHECKBOX glifi dei punti elenco per tutti i livelli di annidamento dell'elenco.
BULLET_ARROW_DIAMOND_DISC Un elenco puntato con un ARROW, DIAMOND e DISC glifo puntato per i primi tre livelli di annidamento dell'elenco.
BULLET_STAR_CIRCLE_SQUARE Un elenco puntato con un STAR, CIRCLE e SQUARE glifo puntato per i primi tre livelli di annidamento dell'elenco.
BULLET_ARROW3D_CIRCLE_SQUARE Un elenco puntato con un ARROW3D, CIRCLE e SQUARE glifo puntato per i primi tre livelli di annidamento dell'elenco.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Un elenco puntato con un LEFTTRIANGLE, DIAMOND e DISC glifo puntato per i primi tre livelli di annidamento dell'elenco.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Un elenco puntato con un DIAMONDX, HOLLOWDIAMOND e SQUARE glifo puntato per i primi tre livelli di annidamento dell'elenco.
BULLET_DIAMOND_CIRCLE_SQUARE Un elenco puntato con un DIAMOND, CIRCLE e SQUARE glifo puntato per i primi tre livelli di annidamento dell'elenco.
NUMBERED_DIGIT_ALPHA_ROMAN Un elenco numerato con DIGIT, ALPHA e ROMAN glifi numerici per i primi tre 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 tre 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 nidificazione utilizza il glifo del livello di nidificazione precedente come prefisso. 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 tre 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 tre 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 tre livelli di annidamento dell'elenco, seguiti da punti.

ReplaceAllShapesWithImageRequest

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 figure.

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.

Deprecata : utilizza imageReplaceMethod in alternativa.

Se specifichi sia un replaceMethod sia un imageReplaceMethod, l'elemento imageReplaceMethod ha la precedenza.

imageReplaceMethod

enum (ImageReplaceMethod)

Il metodo di sostituzione dell'immagine.

Se specifichi sia un replaceMethod sia un imageReplaceMethod, l'elemento imageReplaceMethod ha la precedenza.

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

Se non specifichi nessuno dei due, viene utilizzato CENTER_INSIDE.

pageObjectIds[]

string

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

Restituisce un errore 400 Bad Request se viene fornito l'ID oggetto pagina di un notes page o di un notes master oppure se una pagina con quell'ID oggetto non esiste nella presentazione.

Campo unione criteria. I criteri che le forme devono soddisfare per essere sostituite. criteria può essere solo uno dei seguenti tipi:
containsText

object (SubstringMatchCriteria)

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

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

string

L'URL dell'immagine.

L'immagine viene recuperata una sola volta al momento dell'inserimento e ne viene memorizzata una copia per la visualizzazione 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ò contenere al massimo 2 kB. L'URL stesso viene salvato con l'immagine e visualizzato tramite il campo Image.source_url.

ReplaceMethod

Il metodo di sostituzione.

Enum
CENTER_INSIDE Scala e centra l'immagine in modo che si adatti ai limiti della forma originale e mantiene le proporzioni dell'immagine. Le dimensioni di rendering dell'immagine potrebbero essere inferiori a quelle della forma. Questo è il metodo predefinito quando non ne viene specificato uno.
CENTER_CROP Scala e centra l'immagine in modo che riempia i limiti della forma originale. L'immagine potrebbe essere ritagliata per riempire la forma. Le dimensioni di rendering dell'immagine saranno le stesse della forma originale.

ImageReplaceMethod

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 Scala e centra l'immagine in modo che si adatti ai limiti della forma originale e mantiene le proporzioni dell'immagine. Le dimensioni di rendering dell'immagine potrebbero essere inferiori a quelle della forma. Questo è il metodo predefinito quando non ne viene specificato uno.
CENTER_CROP Scala e centra l'immagine in modo che riempia i limiti della forma originale. L'immagine potrebbe essere ritagliata per riempire la forma. Le dimensioni di rendering dell'immagine saranno le stesse della forma originale.

DuplicateObjectRequest

Duplica una slide o un elemento della pagina.

Quando duplichi una slide, la slide duplicata viene creata immediatamente dopo la slide specificata. Quando duplichi un elemento della pagina, il duplicato viene posizionato nella stessa pagina e 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 slide o un elemento della pagina di gruppo. Questa mappa definisce come vengono generati gli ID degli oggetti duplicati: le chiavi sono gli ID degli oggetti originali e i valori sono gli ID che verranno assegnati all'oggetto duplicato corrispondente. In questa mappa può essere specificato anche l'ID del duplicato dell'oggetto di origine, 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 all'espressione regolare [a-zA-Z0-9_]); i caratteri rimanenti possono includere anche un trattino o due punti (corrisponde all'espressione regolare [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 non impostata, tutti gli oggetti duplicati riceveranno un nuovo ID casuale.

UpdateTextStyleRequest

Aggiorna lo stile del testo in un 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 formattare.

cellLocation

object (TableCellLocation)

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

style

object (TextStyle)

Lo stile o gli stili da impostare sul testo.

Se il valore di un determinato stile corrisponde a quello del genitore, lo stile verrà impostato su ereditato.

Alcune modifiche allo stile del testo potrebbero causare altre modifiche destinate a rispecchiare il comportamento dell'editor di Presentazioni. Per saperne di più, consulta la documentazione di TextStyle.

textRange

object (Range)

L'intervallo di testo a cui applicare lo stile.

L'intervallo può essere esteso per 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 di testo corrispondente.

fields

string (FieldMask format)

I campi da aggiornare.

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

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

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

ReplaceAllShapesWithSheetsChartRequest

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

NOTA: la sostituzione delle forme con un grafico richiede almeno uno degli ambiti OAuth spreadsheets.readonly, spreadsheets, drive.readonly o drive.

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

object (SubstringMatchCriteria)

I criteri che le forme devono soddisfare per essere sostituite. La richiesta sostituirà tutte le forme che contengono il testo specificato.

spreadsheetId

string

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

chartId

integer

L'ID del grafico specifico nel foglio di lavoro 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 400 Bad Request se viene fornito l'ID oggetto pagina di un notes page o di un notes master oppure se una pagina con quell'ID oggetto non esiste nella presentazione.

LinkingMode

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 visualizzeranno un link al foglio di lavoro.

DeleteParagraphBulletsRequest

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

Il livello di nidificazione di ogni paragrafo verrà mantenuto 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 elenco.

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 agli TextElement indici.

UpdateParagraphStyleRequest

Aggiorna lo stile di tutti i paragrafi all'interno di un Shape o Table che si sovrappongono all'intervallo di indici 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 formattare.

cellLocation

object (TableCellLocation)

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

style

object (ParagraphStyle)

Lo stile del paragrafo.

textRange

object (Range)

L'intervallo di testo contenente i paragrafi da formattare.

fields

string (FieldMask format)

I campi da aggiornare.

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

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

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

UpdateTableBorderPropertiesRequest

Aggiorna le proprietà dei bordi della tabella in un 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 di tabelle, gli aggiornamenti verranno applicati all'intera tabella.

borderPosition

enum (BorderPosition)

La posizione del bordo nell'intervallo della 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.

tableBorderProperties

object (TableBorderProperties)

Le proprietà del bordo della tabella da aggiornare.

fields

string (FieldMask format)

I campi da aggiornare.

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

Ad esempio, per aggiornare il colore di riempimento solido del bordo della tabella, imposta fields su "tableBorderFill.solidFill.color".

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

BorderPosition

La posizione del bordo della tabella.

Enum
ALL Tutti i bordi nell'intervallo.
BOTTOM Bordi nella parte inferiore dell'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.

UpdateTableColumnPropertiesRequest

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 di indici basati su zero che specificano le colonne da aggiornare. Se non vengono forniti indici, verranno aggiornate tutte le colonne della tabella.

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 400 Bad Request.

fields

string (FieldMask format)

I campi da aggiornare.

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

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

Se "columnWidth" è incluso nella maschera del campo, ma la proprietà non è impostata,la larghezza della colonna sarà impostata per impostazione predefinita su 406.400 EMU (32 punti).

UpdateTableRowPropertiesRequest

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 basati su zero che specificano le righe da aggiornare. Se non vengono forniti indici, verranno aggiornate tutte le righe della tabella.

tableRowProperties

object (TableRowProperties)

Le proprietà della riga della tabella da aggiornare.

fields

string (FieldMask format)

I campi da aggiornare.

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

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

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

MergeTableCellsRequest

Unisce le celle in un Table.

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

string

L'ID oggetto della tabella.

tableRange

object (TableRange)

L'intervallo di tabella che specifica le celle della tabella da unire.

Qualsiasi testo nelle celle unite verrà concatenato e memorizzato nella cella in alto a sinistra ("intestazione") dell'intervallo. Se l'intervallo non è rettangolare (il che può verificarsi in alcuni casi in cui l'intervallo copre celle già unite), viene restituito un errore 400 Bad Request.

UnmergeTableCellsRequest

Annulla l'unione delle celle in un 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 separare.

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

GroupObjectsRequest

Raggruppa gli oggetti per creare un gruppo di oggetti. Ad esempio, i gruppi PageElements per creare un 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, questo deve essere univoco tra tutte le pagine e tutti gli elementi 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 questi, nonché un trattino o due punti (corrisponde all'espressione regolare [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.

childrenObjectIds[]

string

Gli ID oggetto degli oggetti da raggruppare.

È possibile raggruppare solo gli elementi della pagina. Devono essere presenti almeno due elementi della pagina sulla stessa pagina che non fanno già parte di un altro gruppo. Alcuni elementi della pagina, ad esempio videos, tables e placeholders non possono essere raggruppati.

UngroupObjectsRequest

Separa gli oggetti, ad esempio groups.

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

string

Gli ID oggetto degli oggetti da separare.

Solo groups che non si trovano all'interno di altri groups possono essere separati. Tutti i gruppi devono trovarsi nella stessa pagina. Il gruppo viene eliminato. Le dimensioni e le posizioni visive di tutti i figli vengono mantenute.

UpdatePageElementAltTextRequest

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

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

string

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

title

string

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

description

string

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

ReplaceImageRequest

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 unione image_source. Il tipo di origine dell'immagine. image_source può essere solo uno dei seguenti tipi:
url

string

L'URL dell'immagine.

L'immagine viene recuperata una sola volta al momento dell'inserimento e ne viene memorizzata una copia per la visualizzazione all'interno della presentazione. Le immagini non devono superare i 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 di lunghezza. L'URL viene salvato con l'immagine e visualizzato nel campo Image.source_url.

UpdateSlidePropertiesRequest

Aggiorna le proprietà di una slide.

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

string

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

slideProperties

object (SlideProperties)

Le proprietà della slide da aggiornare.

fields

string (FieldMask format)

I campi da aggiornare.

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

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

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

UpdatePageElementsZOrderRequest

Aggiorna l'ordine Z degli elementi della pagina. L'ordine Z è un ordinamento degli elementi della pagina da dietro in avanti. L'elemento della pagina in primo piano potrebbe coprire gli elementi che si trovano dietro.

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 trovarsi sulla stessa pagina e non devono essere raggruppati.

operation

enum (ZOrderOperation)

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

Quando applichi l'operazione a più elementi della pagina, l'ordine Z relativo all'interno di questi elementi della pagina prima dell'operazione viene mantenuto.

ZOrderOperation

L'operazione per aggiornare l'ordine Z di un elemento della pagina.

Enum
Z_ORDER_OPERATION_UNSPECIFIED Operazione non specificata.
BRING_TO_FRONT Porta gli elementi della pagina in primo piano.
BRING_FORWARD Porta avanti di un elemento gli elementi della pagina rispetto a quello più avanzato degli elementi della pagina specificati.
SEND_BACKWARD Porta indietro di un elemento gli elementi della pagina rispetto a quello più indietro tra gli elementi della pagina specificati.
SEND_TO_BACK Porta gli elementi della pagina in secondo piano.

UpdateLineCategoryRequest

Aggiorna la categoria di un 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 linea con un category che indica che si tratta di un "connettore".

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

lineCategory

enum (LineCategory)

La categoria di riga da aggiornare.

Il line type esatto viene determinato in base alla categoria da aggiornare e al modo in cui viene indirizzato per connettersi ad altri elementi della pagina.

RerouteLineRequest

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

Rappresentazione JSON 
{
  "objectId": string
}
Campi
objectId

string

L'ID oggetto della linea da reindirizzare.

Può essere reindirizzata solo una linea con un category che indica che si tratta di un "connettore". I punti di inizio e di fine della linea devono trovarsi in elementi della pagina diversi.