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 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 affermare che la revisione della presentazione non è 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. Un ID revisione restituito è garantito di essere valido solo per 24 ore dalla restituzione e non può essere condiviso tra gli 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 significa 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 ogni tipo di pagina. I master non richiedono proprietà aggiuntive. properties può essere solo uno dei seguenti:
slideProperties

object (SlideProperties)

Proprietà specifiche della slide. Impostalo solo se pageType = SLIDE.

layoutProperties

object (LayoutProperties)

Proprietà specifiche del layout. Impostalo solo se pageType = LAYOUT.

notesProperties

object (NotesProperties)

Note proprietà specifiche. Impostalo solo se pageType = NOTES.

masterProperties

object (MasterProperties)

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

PageType

Il tipo di pagina.

Enum
SLIDE Pagina di una slide.
MASTER La pagina di una slide schema.
LAYOUT Una pagina di layout.
NOTES Una pagina delle note.
NOTES_MASTER Una pagina master delle note.

PageElement

Un elemento visivo visualizzato su 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 di pagina con le trasformazioni di tutti i suoi 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 l'elemento Group appena creato è sempre la trasformazione dell'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 di 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 tutte le proprietà specifiche di quel tipo di elemento della pagina. element_kind può essere solo uno dei seguenti:
elementGroup

object (Group)

Una raccolta di elementi di pagina uniti in una singola unità.

shape

object (Shape)

Una forma generica.

image

object (Image)

Un elemento pagina immagine.

video

object (Video)

Un elemento della pagina video.

line

object (Line)

Un elemento di pagina 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)

Video in diretta

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 di PageElement che rappresenta il word art.

Rappresentazione JSON
{
  "renderedText": string
}
Campi
renderedText

string

Il testo reso come WordArt.

SpeakerSpotlight

Un tipo di 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)

La struttura di Video in diretta. Se non viene configurato, non viene visualizzato alcun contorno.

shadow

object (Shadow)

L'ombra di Video in diretta. Se il criterio non è impostato, 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 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 del segnaposto con il tipo BODY sulla pagina delle note contiene le note del relatore di 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 di pageType.

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

string

L'ID oggetto dell'istanza 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 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 del relatore della slide corrispondente. La forma effettiva potrebbe non esistere sempre nella pagina delle note. Se inserisci del 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 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 automaticamente sul riempimento corrispondente nell'editor di Presentazioni.

colorScheme

object (ColorScheme)

La combinazione di colori della pagina. Se non viene configurato, la combinazione di colori viene ereditata da una pagina principale. Se la pagina non ha un file principale, la combinazione di colori utilizza una combinazione di colori predefinita per Presentazioni, corrispondente a quelle predefinite nell'editor di Presentazioni.

È possibile modificare solo i colori concreti dei primi 12 ThemeColorType. 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 dei 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.

L'aggiornamento del riempimento in una pagina comporterà l'aggiornamento implicito di questo campo in RENDERED, a meno che nella stessa richiesta non venga specificato un altro valore. Per non avere riempimento in una pagina, imposta questo campo su NOT_RENDERED. In questo caso, qualsiasi altro campo di compilazione impostato nella stessa richiesta verrà ignorato.

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 dell'immagine allungato.

StretchedPictureFill

L'immagine allungata. La pagina o l'elemento della pagina viene riempito completamente con l'immagine specificata. L'immagine viene ingrandita 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 effettivamente all'immagine come richiedente originale. Se le impostazioni di condivisione della presentazione cambiano, l'accesso all'immagine potrebbe andare perso.

Scrittura di contentUrl:

L'immagine viene recuperata una volta al momento dell'inserimento e viene archiviata 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ò 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 di una pagina.

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

object (ThemeColorPair)

Il valore ThemeColorType e le corrispondenti coppie di colori in cemento.

ThemeColorPair

Una coppia che mappa un tipo di colore di un tema al colore di cemento 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 cemento corrispondente al tipo di colore del tema sopra indicato.

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.