REST Resource: presentations.pages

Risorsa: Pagina

Una pagina di una presentazione.

Rappresentazione JSON 
{
  "objectId": string,
  "pageType": enum (PageType),
  "pageElements": [
    {
      object (PageElement)
    }
  ],
  "revisionId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "commentAnchors": [
    {
      object (CommentAnchor)
    }
  ],
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of mutually exclusive fields.
}
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 verificare che la revisione della presentazione non sia cambiata dall'ultima operazione di lettura. Viene 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 è garantito valido solo per 24 ore dopo la restituzione e non può essere condiviso tra gli utenti. Se l'ID revisione rimane invariato tra le chiamate, la presentazione non è stata modificata. 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ò anche essere dovuto a fattori interni, come modifiche al formato dell'ID.
pageProperties

object (PageProperties)

Le proprietà della pagina.
commentAnchors[]

object (CommentAnchor)

Solo output. Gli ancoraggi dei commenti presenti nella pagina.

comments[]

object (CommentThread)

Solo output. I thread di commenti associati alla pagina. Compilato solo se la pagina è stata recuperata tramite un GetPageRequest con un commentsViewMode compilato. In caso contrario, i commenti vengono restituiti in Presentation tramite GetPresentationRequest.

commentsViewMode

enum (CommentsViewMode)

Solo output. La modalità di visualizzazione dei commenti applicata alla pagina. Compilato solo se la pagina è stata recuperata tramite un GetPageRequest con un commentsViewMode compilato.

Proprietà specifiche per ogni tipo di pagina. I master non richiedono proprietà aggiuntive. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
slideProperties

object (SlideProperties)

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

object (LayoutProperties)

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

object (NotesProperties)

Proprietà specifiche delle note. Impostato solo se pageType = NOTES.
masterProperties

object (MasterProperties)

Proprietà specifiche del master. Impostato solo se pageType = MASTER.
Fine dei campi che si escludono a vicenda.

PageType

Il tipo di pagina.

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

PageElement

Un elemento visivo visualizzato in una pagina.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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 mutually exclusive fields.
}
Campi
objectId

string

L'ID oggetto per 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 di pagina.

L'aspetto visivo dell'elemento di pagina è determinato dalla sua trasformazione assoluta. Per calcolare la trasformazione assoluta, preconcatenare 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 dell'identità.
title

string

Il titolo dell'elemento di 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.
Il tipo di elemento rappresentato da questo PageElement. Ogni messaggio contiene le proprietà specifiche di quel tipo di elemento di pagina. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
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 di pagina immagine.
video

object (Video)

Un elemento di pagina video.
line

object (Line)

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

Un video in diretta.
Fine dei campi che si escludono a vicenda.

Gruppo

Un tipo PageElement che rappresenta una raccolta unita di PageElement.

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

Rappresentazione JSON 
{
  "renderedText": string
}
Campi
renderedText

string

Il testo visualizzato come word art.

SpeakerSpotlight

Un tipo PageElement che rappresenta una presentazione in evidenza.

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

object (SpeakerSpotlightProperties)

Le proprietà della presentazione in evidenza.

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 contorno.
shadow

object (Shadow)

L'ombra di Presentazione in evidenza. Se non è impostato, non ha ombre.

SlideProperties

Le proprietà di Page 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 della slide master 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 di note quando si stampano o si esportano slide con note del relatore. Una pagina di 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 del contenuto 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 oggetto della slide 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 pageType NOTES.

Rappresentazione JSON 
{
  "speakerNotesObjectId": string
}
Campi
speakerNotesObjectId

string

L'ID oggetto della forma in questa pagina di note che contiene le note del relatore per la slide corrispondente. La forma effettiva potrebbe non essere sempre presente nella pagina delle note. L'inserimento di testo utilizzando questo ID oggetto creerà automaticamente la forma. 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 padre. 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 viene impostato per impostazione predefinita sul riempimento 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 un elemento principale, la combinazione di colori utilizza una combinazione di colori predefinita di Presentazioni, che corrisponde 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 delle pagine Master. Per aggiornare il campo, è necessario fornire una combinazione di colori contenente mappature di tutti i primi 12 ThemeColorTypes ai relativi colori concreti. I colori per i restanti ThemeColorTypes verranno ignorati.

PageBackgroundFill

Il riempimento dello sfondo della pagina.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of mutually exclusive fields.
}
Campi
propertyState

enum (PropertyState)

Lo stato della proprietà di riempimento dello sfondo.

L'aggiornamento del riempimento di una pagina aggiornerà implicitamente questo campo a RENDERED, a meno che non venga specificato un altro valore nella stessa richiesta. Per non avere riempimento in una pagina, imposta questo campo su NOT_RENDERED. In questo caso, tutti gli altri campi di riempimento impostati nella stessa richiesta verranno ignorati.
Il tipo di riempimento dello sfondo. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
solidFill

object (SolidFill)

Riempimento a tinta unita.
stretchedPictureFill

object (StretchedPictureFill)

Riempimento dell'immagine estesa.
Fine dei campi che si escludono a vicenda.

StretchedPictureFill

Il riempimento dell'immagine estesa. La pagina o l'elemento di pagina è interamente riempito 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 è taggato con l'account del richiedente. Chiunque disponga dell'URL accede all'immagine come il richiedente originale. L'accesso all'immagine potrebbe essere perso se le impostazioni di condivisione della presentazione cambiano.

Scrittura di contentUrl:

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

ThemeColorType e le coppie di colori concreti corrispondenti.

ThemeColorPair

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

CommentAnchor

Contiene un elenco di tutte le posizioni in un Page ancorate a un CommentThread tramite lo stesso anchorId. Più ancore separate possono fare riferimento alla stessa posizione, all'interno di un Page o in pagine diverse.

Rappresentazione JSON 
{
  "anchorId": string,
  "objectAnchors": [
    {
      object (ObjectAnchor)
    }
  ]
}
Campi
anchorId

string

Solo output. L'ID univoco dell'ancora del commento.
objectAnchors[]

object (ObjectAnchor)

Solo output. Tutte le posizioni basate sull'ID oggetto all'interno di una pagina che fanno riferimento all'ID ancora.

ObjectAnchor

Rappresenta i dati di ancoraggio dei commenti associati a un oggetto Presentazioni, ad esempio un Page o un PageElement.

Rappresentazione JSON 
{
  "objectId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "shapeTextAnchors": {
    object (ShapeTextAnchors)
  },
  "tableCellAnchors": {
    object (TableCellAnchors)
  }
  // End of mutually exclusive fields.
}
Campi
objectId

string

Solo output. La pagina o l'elemento della pagina a cui è ancorato il thread di commenti.
Solo output. Gli intervalli di testo all'interno dell'elemento di pagina a cui è ancorato il thread di commenti. Sarà vuoto se l'ancoraggio del commento riguarda l'intera pagina o l'elemento della pagina anziché un intervallo di testo all'interno dell'elemento. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
shapeTextAnchors

object (ShapeTextAnchors)

Compilato per Shapes che hanno commenti ancorati a intervalli di testo in [text][google.apps.slides.v1.Shape.TextContent] della forma.
tableCellAnchors

object (TableCellAnchors)

Compilato per Tables che hanno commenti ancorati a intervalli di testo in una o più celle della tabella.
Fine dei campi che si escludono a vicenda.

ShapeTextAnchors

Rappresenta gli intervalli di testo all'interno di una forma coperti da un ancoraggio del commento.

Rappresentazione JSON 
{
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
Campi
ranges[]

object (TextRange)

Un elenco di intervalli di testo coperti dall'ancoraggio del commento.

TextRange

Specifica un intervallo contiguo di testo all'interno di una forma o della cella di una tabella text.

Rappresentazione JSON 
{
  "startIndex": integer,
  "endIndex": integer
}
Campi
startIndex

integer

L'indice in base zero dell'intervallo iniziale. Questo campo è un Int32Value per adattarsi a futuri casi d'uso con intervalli aperti.
endIndex

integer

L'indice in base zero della fine dell'intervallo. Questo campo è un Int32Value per adattarsi a futuri casi d'uso con intervalli aperti.

TableCellAnchors

Rappresenta gli intervalli di celle di una tabella coperti da un ancoraggio del commento.

Rappresentazione JSON 
{
  "cellRanges": [
    {
      object (TableCellTextRanges)
    }
  ]
}
Campi
cellRanges[]

object (TableCellTextRanges)

Un elenco di tutte le celle di una tabella che contengono testo coperto dall'ancora nella tabella.

TableCellTextRanges

Rappresenta gli intervalli di testo all'interno di una cella della tabella coperti da un ancoraggio del commento.

Rappresentazione JSON 
{
  "cellLocation": {
    object (TableCellLocation)
  },
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
Campi
cellLocation

object (TableCellLocation)

La posizione della cella della tabella.
ranges[]

object (TextRange)

Un elenco di tutti gli intervalli di testo coperti dall'ancora in questa cella.

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.