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 (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 quell'indice. Lo stile del paragrafo del nuovo paragrafo verrà copiato dal paragrafo nell'indice di inserimento corrente, inclusi elenchi e elenchi puntati.

Gli stili di testo per il testo inserito verranno determinati automaticamente, generalmente mantenendo gli stili del testo adiacente. Nella maggior parte dei casi, il testo verrà aggiunto al TextRun esistente nell'indice di inserimento.

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

L'indice è basato su zero e viene calcolato dall'inizio della stringa. L'indice può essere modificato per impedire le inserzioni all'interno di 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.

Viene 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, viene 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.

InsertTableColumnsRequest

Inserisce colonne in una tabella.

Le altre colonne della tabella verranno ridimensionate in base 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.

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

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.

DeleteTableRowRequest

Consente di eliminare 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 interessata 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, l'intera tabella viene eliminata.

DeleteTableColumnRequest

Consente di eliminare 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 che occupa questa cella verrà eliminata. Se si tratta di una cella unita, verranno eliminate più colonne. Se dopo questa 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 di richiesta non valida (400) se viene specificato l'ID oggetto pagina di un notes master o se nella presentazione non esiste una pagina con quell'ID oggetto.

Campo unione criteria. I criteri utilizzati per trovare una corrispondenza 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 stringa di testo specifica in una forma o 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 maiuscola:

  • True : la ricerca è sensibile alle maiuscole.
  • False : la ricerca non è sensibile alle maiuscole.
searchByRegex

boolean

Facoltativo. True se il valore di ricerca deve essere trattato come un'espressione regolare. Le eventuali barre rovesciate nel pattern devono essere interpretate letteralmente.

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

DeleteObjectRequest

Consente di eliminare 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 1 o nessun elemento di pagina, viene eliminato anche il gruppo.

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

UpdatePageElementTransformRequest

Aggiorna la trasformazione di un elemento della pagina.

L'aggiornamento della trasformazione di un gruppo modifica la trasformazione assoluta degli elementi della pagina nel gruppo, il che può cambiare il loro aspetto visivo. Per ulteriori dettagli, consulta la documentazione di 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 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 la nuova.

UpdateSlidesPositionRequest

Aggiorna la posizione delle diapositive nella presentazione.

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

string

Gli ID delle diapositive 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 all'organizzazione delle slide prima del trasferimento. Deve essere compreso tra 0 e il numero di slide della presentazione, inclusi.

DeleteTextRequest

Consente di eliminare il testo da una forma o da una cella di 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 a capo 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 a capo 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 e agli elenchi di paragrafi durante l'unione dei due paragrafi.

Gli intervalli che includono una sola unità di codice di una coppia di sostituti vengono espansi per includere entrambe le unità di codice.

Intervallo

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

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

integer

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

endIndex

integer

L'indice facoltativo a partire da 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 Inizia l'intervallo da startIndex e continua fino alla fine della raccolta. Il valore endIndex non deve essere specificato.
ALL Imposta l'intervallo come l'intera durata della raccolta. Non devono essere specificati sia startIndex sia 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 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 l'immagine.

Quando le proporzioni delle dimensioni fornite non corrispondono a quelle dell'immagine, l'immagine viene ridimensionata e centrata in base 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 quelle 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:
url

string

L'URL dell'immagine.

L'immagine viene recuperata una volta al momento dell'inserimento e una copia viene archiviata 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 uno dei formati PNG, JPEG o GIF.

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

CreateVideoRequest

Crea un video.

NOTA: per creare un video da Google Drive è necessario che l'app richiedente disponga 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 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 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)

La sorgente 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 ulteriori informazioni, consulta Accedere ai file condivisi tramite link utilizzando le chiavi di risorsa.

CreateSheetsChartRequest

Crea un grafico di Fogli Google incorporato.

NOTA: la creazione di grafici richiede 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 pagina della presentazione. L'ID deve iniziare con un carattere di parola [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 a quelle del grafico, il grafico viene ridimensionato e centrato in base alle dimensioni per mantenere le proporzioni. La trasformazione fornita viene applicata dopo questa operazione.

spreadsheetId

string

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

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

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.

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 ne consente l'aggiornamento e gli altri collaboratori vedranno un link al foglio di lavoro.

CreateLineRequest

Crea una riga.

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

lineCategory
(deprecated)

enum (Category)

La categoria della riga da creare.

Disponibile solo per i clienti Google Workspace. : utilizza category instead.

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

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

category

enum (LineCategory)

La categoria della riga da creare.

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

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

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

Se non specifichi nessuno dei due, viene utilizzato STRAIGHT.

Categoria

Le categorie di linee.

Enum
STRAIGHT Connettori diretti, incluso il connettore diritto 1. Si tratta della categoria predefinita se 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 la versione più recente 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 che devono essere aggiornati.

È necessario specificare almeno un campo. La radice shapeProperties è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come scorciatoia 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 di 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 dell'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.

È necessario specificare almeno un campo. La radice imageProperties è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come scorciatoia 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 di 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 dell'oggetto del video a cui vengono applicati gli aggiornamenti.

videoProperties

object (VideoProperties)

Le proprietà video da aggiornare.

fields

string (FieldMask format)

I campi che devono essere aggiornati.

È necessario specificare almeno un campo. La radice videoProperties è implicita e non deve essere specificata. Un singolo "*" può essere utilizzato come scorciatoia 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 di campo, ma lascia il campo stesso non impostato.

UpdatePagePropertiesRequest

Aggiorna le proprietà di un