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 dell'oggetto per 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 della pagina visualizzati nella pagina.
revisionId

string

Solo output. L'ID revisione della presentazione. Può essere utilizzato nelle richieste di aggiornamento per verificare che la revisione della presentazione non sia cambiata dall'ultima operazione di lettura. Compilato solo se l'utente ha 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. L'ID revisione restituito è garantito come valido solo per 24 ore dopo la restituzione e non può essere condiviso tra utenti. Se l'ID revisione è rimasto invariato tra una chiamata e l'altra, la presentazione non ha subito modifiche. Al contrario, un ID modificato (per la stessa presentazione e lo stesso utente) di solito indica che la presentazione è stata aggiornata. Tuttavia, un ID modificato può essere dovuto anche a fattori interni come le modifiche al formato dell'ID.
pageProperties

object (PageProperties)

Le proprietà della pagina.
Campo 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. Impostalo solo se pageType = LAYOUT.
notesProperties

object (NotesProperties)

Note proprietà specifiche. Impostato solo se pageType = NOTES.
masterProperties

object (MasterProperties)

Proprietà specifiche principali. Impostato solo se pageType = MASTER.

PageType

Il tipo di pagina.

Enum
SLIDE Una pagina di slide.
MASTER Una pagina di slide master.
LAYOUT Una pagina di layout.
NOTES Una pagina di 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 dell'oggetto per questo elemento della 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 della pagina.
transform

object (AffineTransform)

La trasformazione dell'elemento di pagina.

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

La trasformazione iniziale per il Group appena creato è sempre la trasformazione di identità.
title

string

Il titolo dell'elemento della pagina. Combinato con la descrizione per visualizzare il testo alternativo.

Il campo non è supportato per gli elementi Group.
description

string

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

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

object (Group)

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

object (Shape)

Una forma generica.
image

object (Image)

Un elemento di pagina immagine.
video

object (Video)

Un elemento della pagina di un video.
line

object (Line)

Un elemento di pagina di riga.
table

object (Table)

Un elemento di pagina della tabella.
wordArt

object (WordArt)

Un elemento di pagina WordArt.
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 elementi di pagina.

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

object (PageElement)

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

WordArt

Un tipo PageElement che rappresenta la word art.

Rappresentazione JSON 
{
  "renderedText": string
}
Campi
renderedText

string

Il testo reso come word art.

SpeakerSpotlight

Un tipo PageElement che rappresenta una presentazione in evidenza.

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

object (SpeakerSpotlightProperties)

Le proprietà di Video in diretta.

SpeakerSpotlightProperties

Le proprietà di SpeakerSpotlight.

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

object (Outline)

Il contorno di Video in diretta. Se non è impostato, non ha un contorno.
shadow

object (Shadow)

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

SlideProperties

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

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

string

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

string

L'ID dell'oggetto del master su cui si basa questa diapositiva. Questa proprietà è di sola lettura.
notesPage

object (Page)

La pagina delle note a cui è associata questa diapositiva. Definisce l'aspetto visivo di una pagina delle note quando stampi o esporti le diapositive con le note dell'altoparlante. Una pagina di note eredita le proprietà dal notes master. La forma segnaposto di tipo TESTO 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 di testo 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 pageType LAYOUT.

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

string

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

string

Il nome del layout.
displayName

string

Il nome leggibile del layout.

NotesProperties

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

Rappresentazione JSON 
{
  "speakerNotesObjectId": string
}
Campi
speakerNotesObjectId

string

L'ID oggetto della forma in questa pagina delle note che contiene le note dell'altoparlante per la diapositiva corrispondente. La forma effettiva potrebbe non esistere sempre nella pagina delle note. Se inserisci il testo utilizzando questo ID oggetto, la forma verrà creata automaticamente. In questo caso, la forma effettiva potrebbe avere un 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à di Page.

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

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

object (PageBackgroundFill)

Il riempimento dello sfondo della pagina. Se non è impostato, il riempimento dello sfondo viene ereditato da una pagina principale, se esistente. Se la pagina non ha un elemento principale, il riempimento dello sfondo predefinito è quello corrispondente nell'editor di Presentazioni.
colorScheme

object (ColorScheme)

La combinazione di colori della pagina. Se non è impostato, la combinazione di colori viene ereditata da una pagina principale. Se la pagina non ha una pagina principale, la combinazione di colori utilizza una combinazione di colori predefinita di Presentazioni, che corrisponde a quella predefinita nell'editor di Presentazioni.

Solo i colori concreti dei primi 12 ThemeColorType sono modificabili. Inoltre, è possibile aggiornare solo la combinazione di colori nelle pagine Master. Per aggiornare il campo, deve essere fornita una combinazione di colori contenente le mappature di tutti i primi 12 ThemeColorTypes ai rispettivi colori concreti. I colori per i restanti ThemeColorTypes verranno ignorati.

PageBackgroundFill

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

Se aggiorni il riempimento di una pagina, questo campo verrà aggiornato implicitamente in RENDERED, a meno che non venga specificato un altro valore nella stessa richiesta. Per non avere alcun riempimento in una pagina, imposta questo campo su NOT_RENDERED. In questo caso, tutti gli altri campi di compilazione impostati nella stessa richiesta verranno ignorati.
Campo unione kind. Il tipo di riempimento dello sfondo. kind può essere solo uno dei seguenti:
solidFill

object (SolidFill)

Riempimento a tinta unita.
stretchedPictureFill

object (StretchedPictureFill)

Riempimento immagine allungata.

StretchedPictureFill

Il riempimento dell'immagine allungata. La pagina o l'elemento della pagina viene riempito completamente con l'immagine specificata. L'immagine viene 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 abbia l'URL accede all'immagine come richiedente originale. L'accesso all'immagine potrebbe andare perso se le impostazioni di condivisione della presentazione vengono modificate.

Scrittura di contentUrl:

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 può avere una lunghezza massima di 2 KB.
size

object (Size)

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

ColorScheme

La tavolozza dei colori predefiniti per una pagina.

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

object (ThemeColorPair)

Il tipo di colore del tema e le coppie di colori specifiche corrispondenti.

ThemeColorPair

Una coppia che mappa un tipo di colore tema al colore specifico 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 riportato sopra.

Metodi

get

 Recupera la versione più recente della pagina specificata nella presentazione.

getThumbnail

 Genera una miniatura della versione più recente della pagina specificata nella presentazione e restituisce un URL all'immagine della miniatura.