REST Resource: presentations.pages

Risorsa: pagina

Una pagina in una presentazione.

Rappresentazione JSON 
{
  "objectId": string,
  "pageType": enum (PageType),
  "pageElements": [
    {
      object (PageElement)
    }
  ],
  "revisionId": string,
  "pageProperties": {
    object (PageProperties)
  },

  // Union field properties can be only one of the following:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of list of possible types for union field properties.
}
Campi
objectId

string

L'ID oggetto di questa pagina. Gli ID oggetto utilizzati da Page e PageElement condividono lo stesso spazio dei nomi.
pageType

enum (PageType)

Il tipo di pagina.
pageElements[]

object (PageElement)

Gli elementi di pagina visualizzati nella pagina.
revisionId

string

Solo output. L'ID revisione della presentazione. Può essere utilizzato nelle richieste di aggiornamento per affermare che la revisione della presentazione non è cambiata dall'ultima operazione di lettura. Compilato solo se l'utente dispone dell'accesso in modifica alla presentazione.

L'ID revisione non è un numero sequenziale, ma una stringa opaca. Il formato dell'ID revisione potrebbe cambiare nel tempo. Un ID revisione restituito è valido solo per 24 ore dalla restituzione e non può essere condiviso tra gli utenti. Se l'ID revisione rimane invariato tra le chiamate, la presentazione non è cambiata. Al contrario, un ID modificato (per la stessa presentazione e lo stesso utente) di solito indica che la presentazione è stata aggiornata. Tuttavia, la modifica di un ID può essere dovuta anche a fattori interni, come le modifiche al formato dell'ID.
pageProperties

object (PageProperties)

Le proprietà della pagina.
Campo di unione properties. Proprietà specifiche per ciascun tipo di pagina. I master non richiedono proprietà aggiuntive. properties può essere solo uno dei seguenti:
slideProperties

object (SlideProperties)

Proprietà specifiche della slide. Impostato solo se pageType = SLIDE.
layoutProperties

object (LayoutProperties)

Proprietà specifiche del layout. Impostato solo se pageType = LAYOUT.
notesProperties

object (NotesProperties)

Consente di prendere nota di proprietà specifiche. Impostato solo se pageType = NOTES.
masterProperties

object (MasterProperties)

Proprietà specifiche. Impostato solo se pageType = MASTER.

PageType

Il tipo di pagina.

Enum
SLIDE Una pagina slide.
MASTER Una pagina della slide principale.
LAYOUT Una pagina di layout.
NOTES Una pagina delle note.
NOTES_MASTER Una pagina principale delle note.

PageElement

Un elemento visivo visualizzato in una pagina.

Rappresentazione JSON 
{
  "objectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  },
  "title": string,
  "description": string,

  // Union field element_kind can be only one of the following:
  "elementGroup": {
    object (Group)
  },
  "shape": {
    object (Shape)
  },
  "image": {
    object (Image)
  },
  "video": {
    object (Video)
  },
  "line": {
    object (Line)
  },
  "table": {
    object (Table)
  },
  "wordArt": {
    object (WordArt)
  },
  "sheetsChart": {
    object (SheetsChart)
  },
  "speakerSpotlight": {
    object (SpeakerSpotlight)
  }
  // End of list of possible types for union field element_kind.
}
Campi
objectId

string

L'ID oggetto di questo elemento di pagina. Gli ID oggetto utilizzati da google.apps.slides.v1.Page e google.apps.slides.v1.PageElement condividono lo stesso spazio dei nomi.
size

object (Size)

Le dimensioni dell'elemento di pagina.
transform

object (AffineTransform)

La trasformazione dell'elemento della pagina.

L'aspetto visivo dell'elemento della pagina è determinato dalla sua trasformazione assoluta. Per calcolare la trasformazione assoluta, preconcatena la trasformazione di un elemento di pagina con le trasformazioni di tutti i suoi gruppi principali. Se l'elemento di pagina non è in un gruppo, la sua trasformazione assoluta corrisponde al valore in questo campo.

La trasformazione iniziale per l'oggetto Group appena creato è sempre la trasformazione dell'identità.
title

string

Il titolo dell'elemento di pagina. Combinata con la descrizione, consente di visualizzare il testo alternativo.

Il campo non è supportato per gli elementi Group.
description

string

La descrizione dell'elemento di pagina. Combinato con il titolo per visualizzare il testo alternativo.

Il campo non è supportato per gli elementi Group.
Campo di unione element_kind. Il tipo di elemento rappresentato da questo PageElement. Ciascun messaggio contiene le proprietà specifiche di quel tipo di elemento di pagina. element_kind può essere solo uno dei seguenti:
elementGroup

object (Group)

Una raccolta di elementi di pagina uniti in un'unica unità.
shape

object (Shape)

Una forma generica.
image

object (Image)

Un elemento della pagina immagine.
video

object (Video)

Un elemento di pagina video.
line

object (Line)

Un elemento di pagina a linee.
table

object (Table)

Un elemento della pagina della tabella.
wordArt

object (WordArt)

Un elemento di pagina Word art.
sheetsChart

object (SheetsChart)

Un grafico collegato incorporato da Fogli Google. I grafici scollegati sono rappresentati come immagini.
speakerSpotlight

object (SpeakerSpotlight)

Una presentazione in evidenza.

Gruppo

Un tipo PageElement che rappresenta una raccolta unita di PageElement.

Rappresentazione JSON 
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
Campi
children[]

object (PageElement)

La raccolta di elementi del gruppo. La dimensione minima di un gruppo è 2.

WordArt

Un tipo PageElement che rappresenta il word art.

Rappresentazione JSON 
{
  "renderedText": string
}
Campi
renderedText

string

Il testo reso come Word art.

SpeakerSpotlight

Un tipo PageElement che rappresenta uno speaker in evidenza.

Rappresentazione JSON 
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
Campi
speakerSpotlightProperties

object (SpeakerSpotlightProperties)

Le proprietà di Video in diretta.

SpeakerSpotlightProperties

Le proprietà dell'elemento SpeakerSpotlight.

Rappresentazione JSON 
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
Campi
outline

object (Outline)

Il contorno di Video in diretta. Se il criterio non è impostato, non ha contorni.
shadow

object (Shadow)

L'ombra di Video in diretta. Se non viene configurato, non ha ombra.

SlideProperties

Le proprietà di Page che sono pertinenti solo per le pagine con pageType SLIDE.

Rappresentazione JSON 
{
  "layoutObjectId": string,
  "masterObjectId": string,
  "notesPage": {
    object (Page)
  },
  "isSkipped": boolean
}
Campi
layoutObjectId

string

L'ID oggetto del layout su cui si basa questa slide. Questa proprietà è di sola lettura.
masterObjectId

string

L'ID oggetto dello schema su cui si basa questa slide. Questa proprietà è di sola lettura.
notesPage

object (Page)

La pagina delle note a cui è associata questa slide. Definisce l'aspetto visivo di una pagina delle note durante la stampa o l'esportazione delle slide con le note del relatore. Una pagina delle note eredita le proprietà da notes master. La forma segnaposto di tipo BODY nella pagina delle note contiene le note del relatore per questa slide. L'ID di questa forma è identificato dal campo speakerNotesObjectId. La pagina delle note è di sola lettura, ad eccezione dei contenuti testuali e degli stili della forma delle note del relatore. Questa proprietà è di sola lettura.
isSkipped

boolean

Indica se la slide viene saltata in modalità di presentazione. Il valore predefinito è false.

LayoutProperties

Le proprietà di Page sono pertinenti solo per le pagine con LAYOUT pageType.

Rappresentazione JSON 
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
Campi
masterObjectId

string

L'ID oggetto del master su cui si basa questo layout.
name

string

Il nome del layout.
displayName

string

Il nome leggibile del layout.

NotesProperties

Le proprietà di Page che sono pertinenti solo per le pagine con pageType NOTES.

Rappresentazione JSON 
{
  "speakerNotesObjectId": string
}
Campi
speakerNotesObjectId

string

L'ID oggetto della forma su questa pagina delle note che contiene le note del relatore per la slide corrispondente. La forma effettiva potrebbe non esistere sempre nella pagina delle note. Se inserisci testo utilizzando questo ID oggetto, la forma verrà creata automaticamente. In questo caso, la forma effettiva potrebbe avere ID oggetto diverso. L'azione presentations.get o pages.get restituirà sempre l'ID oggetto più recente.

MasterProperties

Le proprietà di Page pertinenti solo per le pagine con pageType MASTER.

Rappresentazione JSON 
{
  "displayName": string
}
Campi
displayName

string

Il nome leggibile del master.

PageProperties

Le proprietà dell'elemento Page.

La pagina erediterà le proprietà dalla pagina principale. A seconda del tipo di pagina, la gerarchia viene definita in SlideProperties o LayoutProperties.

Rappresentazione JSON 
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
Campi
pageBackgroundFill

object (PageBackgroundFill)

Riempimento dello sfondo della pagina. Se il criterio non viene configurato, il riempimento dello sfondo viene ereditato da una pagina principale, se esistente. Se la pagina non ha un elemento principale, il riempimento dello sfondo viene impostato in modo predefinito sul riempimento corrispondente nell'editor di Presentazioni.
colorScheme

object (ColorScheme)

La combinazione di colori della pagina. Se il criterio non viene configurato, la combinazione di colori viene ereditata da una pagina principale. Se la pagina non ha elementi principali, la combinazione di colori utilizza una combinazione di colori predefinita per Presentazioni, corrispondente ai valori predefiniti nell'editor di Presentazioni.

Sono modificabili solo i colori concreti dei primi 12 ThemeColorType. Inoltre, è possibile aggiornare solo la combinazione di colori su Master pagine. Per aggiornare il campo, è necessario fornire una combinazione di colori contenente le mappature di tutti i primi 12 ThemeColorTypes ai colori concreti. I colori dei restanti ThemeColorTypes verranno ignorati.

PageBackgroundFill

Riempimento dello sfondo della pagina.

Rappresentazione JSON 
{
  "propertyState": enum (PropertyState),

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of list of possible types for union field kind.
}
Campi
propertyState

enum (PropertyState)

Lo stato della proprietà di riempimento dello sfondo.

L'aggiornamento del riempimento in una pagina comporterà l'aggiornamento implicito di questo campo a RENDERED, a meno che non venga specificato un altro valore nella stessa richiesta. Per impedire la compilazione di una pagina, imposta questo campo su NOT_RENDERED. In questo caso, qualsiasi altro campo di riempimento impostato nella stessa richiesta verrà ignorato.
Campo di unione kind. Il tipo di riempimento dello sfondo. kind può essere solo uno dei seguenti:
solidFill

object (SolidFill)

Riempimento a colori a tinta unita.
stretchedPictureFill

object (StretchedPictureFill)

Riempimento immagine esteso.

StretchedPictureFill

L'immagine si riempie. La pagina o l'elemento della pagina viene riempito interamente con l'immagine specificata. L'immagine è allungata per adattarsi al contenitore.

Rappresentazione JSON 
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
Campi
contentUrl

string

Lettura di contentUrl:

Un URL che rimanda a un'immagine con una durata predefinita di 30 minuti. Questo URL è codificato con l'account del richiedente. Chiunque sia in possesso dell'URL accede alla foto in qualità di richiedente originale. Se le impostazioni di condivisione della presentazione vengono modificate, l'accesso all'immagine potrebbe andare perso.

Scrittura di contentUrl:

L'immagine viene recuperata una volta al momento dell'inserimento e una copia viene memorizzata 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ò avere una lunghezza massima di 2 kB.
size

object (Size)

Le dimensioni originali dell'immagine di riempimento. Questo campo è di sola lettura.

ColorScheme

La tavolozza dei colori predefiniti di una pagina.

Rappresentazione JSON 
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Campi
colors[]

object (ThemeColorPair)

Il valore ThemeColorType e le corrispondenti coppie di colori concreti.

ThemeColorPair

Una coppia che mappa un tipo di colore di un tema sul colore concreto che rappresenta.

Rappresentazione JSON 
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
Campi
type

enum (ThemeColorType)

Il tipo di colore del tema.
color

object (RgbColor)

Il colore concreto corrispondente al tipo di colore del tema indicato sopra.

Metodi

get

 Recupera l'ultima versione della pagina specificata nella presentazione.

getThumbnail

 Genera una miniatura dell'ultima versione della pagina specificata nella presentazione e restituisce un URL all'immagine in miniatura.