REST Resource: presentations.pages

Zasób: strona

Strona w prezentacji.

Zapis 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.
}
Pola
objectId

string

Identyfikator obiektu tej strony. Identyfikatory obiektów używane przez Page i PageElement mają tę samą przestrzeń nazw.
pageType

enum (PageType)

Typ strony.
pageElements[]

object (PageElement)

Elementy wyrenderowane na stronie.
revisionId

string

Tylko dane wyjściowe. Identyfikator wersji prezentacji. Może być używany w żądaniach aktualizacji, aby potwierdzić, że wersja prezentacji nie zmieniła się od ostatniej operacji odczytu. To pole jest wypełniane tylko wtedy, gdy użytkownik ma uprawnienia do edycji prezentacji.

Identyfikator wersji nie jest liczbą sekwencyjną, ale nieprzezroczystym ciągiem. Format identyfikatora wersji może się z czasem zmienić. Gwarantujemy, że zwrócony identyfikator wersji będzie ważny tylko przez 24 godziny po zwróceniu i nie będzie można go udostępniać użytkownikom. Jeśli identyfikator wersji nie zmienia się między wywołaniami, prezentacja nie uległa zmianie. Jeśli natomiast zmienisz identyfikator (dla tej samej prezentacji i tego samego użytkownika), oznacza to, że prezentacja została zaktualizowana. Jednak zmiana identyfikatora może wynikać z czynników wewnętrznych, takich jak zmiana formatu identyfikatora.
pageProperties

object (PageProperties)

Właściwości strony.
Pole sumy properties. Właściwości, które są specyficzne dla każdego typu strony. Elementy nadrzędne nie wymagają żadnych dodatkowych właściwości. properties może mieć tylko jedną z tych wartości:
slideProperties

object (SlideProperties)

Właściwości dotyczące slajdów. Ustaw tylko wtedy, gdy pageType ma wartość SLIDE.
layoutProperties

object (LayoutProperties)

Właściwości związane z układem. Ustawiany tylko wtedy, gdy pageType ma wartość LAYOUT.
notesProperties

object (NotesProperties)

Właściwości charakterystyczne dla notatek. Ustaw tylko wtedy, gdy pageType ma wartość NOTES.
masterProperties

object (MasterProperties)

Opanuj konkretne właściwości. Ustawiany tylko wtedy, gdy pageType ma wartość MASTER.

PageType

Typ strony.

Wartości w polu enum
SLIDE Strona slajdu.
MASTER Główna strona slajdu.
LAYOUT Układ strony.
NOTES Strona z notatkami.
NOTES_MASTER Strona wzorcowa notatek.

PageElement

Element wizualny wyrenderowany na stronie.

Zapis 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.
}
Pola
objectId

string

Identyfikator obiektu tego elementu strony. Identyfikatory obiektów używane przez google.apps.slides.v1.Page i google.apps.slides.v1.PageElement mają tę samą przestrzeń nazw.
size

object (Size)

Rozmiar elementu strony.
transform

object (AffineTransform)

Przekształcenie elementu strony.

Wygląd elementu strony zależy od jego przekształcenia bezwzględnego. Aby obliczyć przekształcenie bezwzględne, połącz wstępnie przekształcenie elementu strony z przekształceniami wszystkich jego grup nadrzędnych. Jeśli element strony nie należy do grupy, jego przekształcenie bezwzględne jest takie samo jak wartość w tym polu.

Początkowe przekształcenie nowo utworzonego elementu Group to zawsze przekształcenie tożsamości.
title

string

Tytuł elementu strony. Łączenie z opisem w celu wyświetlenia tekstu alternatywnego.

Pole nie jest obsługiwane w przypadku elementów Group.
description

string

Opis elementu strony. W połączeniu z tytułem w celu wyświetlenia tekstu alternatywnego.

Pole nie jest obsługiwane w przypadku elementów Group.
Pole sumy element_kind. Rodzaj elementu reprezentowanego przez dany element strony. Każda wiadomość zawiera właściwości charakterystyczne dla danego typu elementu strony. element_kind może mieć tylko jedną z tych wartości:
elementGroup

object (Group)

Zbiór elementów strony połączonych w jedną jednostkę.
shape

object (Shape)

Ogólny kształt.
image

object (Image)

Element strony z obrazem.
video

object (Video)

Element strony filmu.
line

object (Line)

Element strony.
table

object (Table)

Element strony tabeli.
wordArt

object (WordArt)

Element strony WordArt.
sheetsChart

object (SheetsChart)

Umieszczony link z wykresu z Arkuszy Google Odłączone wykresy są reprezentowane jako obrazy.
speakerSpotlight

object (SpeakerSpotlight)

Speaker spotlight.

Grupa

Rodzaj PageElement reprezentujący złączoną kolekcję elementów PageElements.

Zapis JSON 
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
Pola
children[]

object (PageElement)

Zbiór elementów w grupie. Minimalny rozmiar grupy to 2.

WordArt

Rodzaj PageElement reprezentujący obiekt WordArt.

Zapis JSON 
{
  "renderedText": string
}
Pola
renderedText

string

Tekst wyrenderowany jako tekst WordArt.

SpeakerSpotlight

Rodzaj PageElement reprezentujący okienko prezentującego.

Zapis JSON 
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
Pola
speakerSpotlightProperties

object (SpeakerSpotlightProperties)

Właściwości okienka prezentującego.

SpeakerSpotlightProperties

Właściwości obiektu SpeakerSpotlight.

Zapis JSON 
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
Pola
outline

object (Outline)

Kontur okienka prezentującego. Jeśli nie jest skonfigurowana, nie ma konspektu.
shadow

object (Shadow)

Cień okienka prezentującego. Jeśli zasada nie jest skonfigurowana, cień jest niewidoczny.

SlideProperties

Właściwości elementu Page istotne tylko w przypadku stron z obiektem pageType SLIDE.

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

string

Identyfikator obiektu układu, na którym jest oparty ten slajd. Ta właściwość jest tylko do odczytu.
masterObjectId

string

Identyfikator obiektu głównego, na podstawie którego jest oparty ten slajd. Ta właściwość jest tylko do odczytu.
notesPage

object (Page)

Strona notatek, z którą jest powiązany ten slajd. Definiuje wygląd strony z notatkami podczas drukowania lub eksportowania slajdów z notatkami. Strona z notatkami dziedziczy właściwości z elementu notes master. Kształt zastępczy z tekstem TREŚĆ na stronie notatek zawiera notatki do tego slajdu. Identyfikator tego kształtu jest określany w polu speakerNotesObjectId. Strona notatek jest tylko do odczytu, z wyjątkiem zawartości tekstowej i stylów kształtu notatek. Ta właściwość jest tylko do odczytu.
isSkipped

boolean

Określa, czy slajd ma być pomijany w trybie prezentacji. Wartość domyślna to fałsz.

LayoutProperties

Właściwości elementu Page mają znaczenie tylko w przypadku stron z typem pageType LAYOUT.

Zapis JSON 
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
Pola
masterObjectId

string

Identyfikator obiektu mastera, na którym oparty jest ten układ.
name

string

Nazwa układu.
displayName

string

Zrozumiała dla człowieka nazwa układu.

NotesProperties

Właściwości elementu Page istotne tylko w przypadku stron z wartością pageType NOTES.

Zapis JSON 
{
  "speakerNotesObjectId": string
}
Pola
speakerNotesObjectId

string

Identyfikator obiektu kształtu na tej stronie notatek, który zawiera notatki dotyczące odpowiedniego slajdu. Rzeczywisty kształt nie zawsze musi istnieć na stronie notatek. Wstawienie tekstu przy użyciu tego identyfikatora obiektu spowoduje automatyczne utworzenie kształtu. W tym przypadku rzeczywisty kształt może mieć inny identyfikator obiektu. Działanie presentations.get lub pages.get zawsze zwraca najnowszy identyfikator obiektu.

MasterProperties

Właściwości elementu Page istotne tylko w przypadku stron z typem pageType MASTER.

Zapis JSON 
{
  "displayName": string
}
Pola
displayName

string

Zrozumiała dla człowieka nazwa mastera.

PageProperties

Właściwości obiektu Page.

Strona odziedziczy właściwości ze strony nadrzędnej. W zależności od typu strony hierarchia jest zdefiniowana tutaj: SlideProperties lub LayoutProperties.

Zapis JSON 
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
Pola
pageBackgroundFill

object (PageBackgroundFill)

Wypełnienie tła strony. Jeśli nie jest ustawione, wypełnienie w tle jest dziedziczone ze strony nadrzędnej (jeśli takie występuje). Jeśli strona nie ma elementu nadrzędnego, wypełnienie tła jest domyślnie ustawione na odpowiednie wypełnienie w edytorze Prezentacji.
colorScheme

object (ColorScheme)

Schemat kolorów strony. Jeśli nie jest skonfigurowana, schemat kolorów jest dziedziczony ze strony nadrzędnej. Jeśli strona nie ma elementu nadrzędnego, schemat kolorów używa domyślnego schematu kolorów Prezentacji pasującego do wartości domyślnych w edytorze Prezentacji.

Można edytować tylko konkretne kolory z pierwszych 12 elementów ThemeColorType. Dodatkowo można aktualizować tylko schemat kolorów na stronach Master. Aby zaktualizować pole, należy podać schemat kolorów zawierający mapowania z wszystkich pierwszych 12 elementów ThemeColorType na ich konkretne kolory. Kolory pozostałych elementów ThemeColorTypes będą ignorowane.

PageBackgroundFill

Wypełnienie tła strony.

Zapis 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.
}
Pola
propertyState

enum (PropertyState)

Stan właściwości wypełnienia tła.

Zaktualizowanie wypełnienia na stronie spowoduje niejawnie zaktualizowanie tego pola do wartości RENDERED, chyba że w tym samym żądaniu określono inną wartość. Aby nie wypełniać żadnej strony, ustaw w tym polu wartość NOT_RENDERED. W takim przypadku wszystkie inne wypełnione pola ustawione w tym samym żądaniu zostaną zignorowane.
Pole sumy kind. Rodzaj wypełnienia tła. kind może mieć tylko jedną z tych wartości:
solidFill

object (SolidFill)

Wypełnienie jednolitym kolorem.
stretchedPictureFill

object (StretchedPictureFill)

Rozciągnięte wypełnienie obrazem.

StretchedPictureFill

Wypełnienie rozciągniętego obrazu. Strona lub element strony jest w całości wypełniony określonym obrazem. Zdjęcie zostanie rozciągnięte, aby wypełniło kontener.

Zapis JSON 
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
Pola
contentUrl

string

Odczytywanie parametru contentUrl:

Adres URL zdjęcia o domyślnym czasie trwania wynoszącym 30 minut. Ten adres URL jest otagowany kontem użytkownika zgłaszającego prośbę. Każda osoba znająca adres URL uzyskuje dostęp do zdjęcia jako osoba, która przesłała prośbę. Jeśli zmienią się ustawienia udostępniania prezentacji, możesz utracić dostęp do zdjęcia.

Zapisywanie parametru contentUrl:

Obraz jest pobierany jednokrotnie przy wstawieniu, a jego kopia jest zapisywana w celu wyświetlenia w prezentacji. Zdjęcia nie mogą być większe niż 50 MB, a ich rozdzielczość nie może przekraczać 25 megapikseli i musi być w formacie PNG, JPEG lub GIF.

Podany adres URL może mieć maksymalnie 2 kB długości.
size

object (Size)

Oryginalny rozmiar wypełnienia obrazem. To pole jest tylko do odczytu.

ColorScheme

Paleta wstępnie zdefiniowanych kolorów strony.

Zapis JSON 
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Pola
colors[]

object (ThemeColorPair)

ThemeColorType i odpowiadające im konkretne pary kolorów.

ThemeColorPair

Para przypisująca kolor motywu do koloru betonu, który reprezentuje.

Zapis JSON 
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
Pola
type

enum (ThemeColorType)

Typ koloru motywu.
color

object (RgbColor)

Kolor betonu odpowiadający powyższemu typowi koloru motywu.

Metody

get

 Pobiera najnowszą wersję określonej strony w prezentacji.

getThumbnail

 Generuje miniaturę najnowszej wersji określonej strony w prezentacji i zwraca adres URL obrazu miniatury.