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 na tej stronie. Identyfikatory obiektów używane przez Page i PageElement mają tę samą przestrzeń nazw.
pageType

enum (PageType)

Typ strony.
pageElements[]

object (PageElement)

Elementy strony renderowane na stronie.
revisionId

string

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

Identyfikator wersji to nieciągły ciąg znaków, a nie liczba. Format identyfikatora wersji może się z czasem zmieniać. Zwrócony identyfikator wersji jest gwarantowany tylko przez 24 godziny od momentu jego zwrotu i nie może być udostępniany innym użytkownikom. Jeśli identyfikator wersji nie zmienia się między wywołaniami, oznacza to, że prezentacja się nie zmieniła. Z kolei zmieniony identyfikator (w przypadku tej samej prezentacji i użytkownika) zwykle oznacza, że prezentacja została zaktualizowana. Zmiana identyfikatora może być też spowodowana czynnikami wewnętrznymi, takimi jak zmiany formatu identyfikatora.
pageProperties

object (PageProperties)

Właściwości strony.
Pole unii properties. Właściwości specyficzne dla każdego typu strony. Pliki master nie wymagają żadnych dodatkowych właściwości. properties może być tylko jednym z tych elementów:
slideProperties

object (SlideProperties)

Właściwości konkretnego slajdu. Ustawiana tylko wtedy, gdy pageType = SLIDE.
layoutProperties

object (LayoutProperties)

Właściwości układu. Ustawiana tylko wtedy, gdy pageType = LAYOUT.
notesProperties

object (NotesProperties)

Wskazuje konkretne właściwości. Ustawiaj tylko wtedy, gdy pageType = NOTES.
masterProperties

object (MasterProperties)

Ustawienia dotyczące konkretnych usług. Ustawiana tylko wtedy, gdy pageType = MASTER.

PageType

Typ strony.

Wartości w polu enum
SLIDE Strona slajdów.
MASTER Strona główna slajdu.
LAYOUT Strona układu.
NOTES strona z notatkami.
NOTES_MASTER Strona główna 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.

Wizualny wygląd elementu strony jest określany przez jego bezwzględną transformację. Aby obliczyć transformację bezwzględną, należy złączyć transformację elementu strony z transformacjami wszystkich jego grup nadrzędnych. Jeśli element strony nie znajduje się w grupie, jego transformacja bezwzględna jest taka sama jak wartość w tym polu.

Początkowa transformacja nowo utworzonego elementu Group to zawsze transformacja tożsamości.
title

string

Tytuł elementu strony. W połączeniu z opisem, aby wyświetlić tekst alternatywny.

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

string

Opis elementu strony. W połączeniu z tytułem, aby wyświetlić tekst alternatywny.

To pole nie jest obsługiwane w przypadku elementów typu Group.
Pole unii element_kind. Rodzaj elementu reprezentowanego przez ten obiekt PageElement. Każda wiadomość zawiera wszystkie właściwości specyficzne dla danego typu elementu strony. element_kind może być tylko jednym z tych elementów:
elementGroup

object (Group)

Zbiór elementów strony połączonych w jedną całość.
shape

object (Shape)

Ogólny kształt.
image

object (Image)

Element strony z obrazem.
video

object (Video)

Element strony wideo.
line

object (Line)

Element strony zamówienia.
table

object (Table)

Element strony tabeli.
wordArt

object (WordArt)

Element strony WordArt.
sheetsChart

object (SheetsChart)

Połączony wykres z Arkuszy Google. Niepołączone wykresy są wyświetlane jako obrazy.
speakerSpotlight

object (SpeakerSpotlight)

Okienko prezentujące.

Grupa

Typ PageElement reprezentuje złączoną kolekcję elementów strony.

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

object (PageElement)

Zbiór elementów w grupie. Minimalna liczba elementów w grupie to 2.

WordArt

Typ PageElement reprezentujący obiekt WordArt.

Zapis JSON 
{
  "renderedText": string
}
Pola
renderedText

string

Tekst renderowany jako element graficzny.

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

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

object (Outline)

Kontur okienka prezentującego. Jeśli nie jest ustawiony, nie ma obrysu.
shadow

object (Shadow)

Cień okienka prezentującego. Jeśli nie jest ustawiony, nie ma cienia.

SlideProperties

Właściwości Page, które mają zastosowanie tylko do stron o typie pageType SLIDE.

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

string

Identyfikator obiektu układu, na którym opiera się ta prezentacja. Ta usługa jest tylko do odczytu.
masterObjectId

string

Identyfikator obiektu w masterze, na którym opiera się ta prezentacja. Ta usługa jest tylko do odczytu.
notesPage

object (Page)

Strona z notatkami, z którą jest powiązany ten slajd. Określa wygląd strony z notatkami podczas drukowania lub eksportowania slajdu z notatkami. Strona notatek dziedziczy właściwości z poziomu notes master. Kształt zastępczy z typem BODY na stronie notatek zawiera notatki prezentującego dotyczące tego slajdu. Identyfikator tego kształtu jest określany przez pole speakerNotesObjectId. Strona z notatkami jest tylko do odczytu, z wyjątkiem zawartości tekstowej i stylów kształtu okna z notatkami. Ta usługa jest tylko do odczytu.
isSkipped

boolean

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

LayoutProperties

Właściwości Page mają zastosowanie tylko do stron z typem strony LAYOUT.

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

string

Identyfikator obiektu głównego, na którym bazuje ten układ.
name

string

Nazwa układu.
displayName

string

Czytelna nazwa układu.

NotesProperties

Właściwości Page, które mają zastosowanie tylko do stron z typem pageType NOTES.

Zapis JSON 
{
  "speakerNotesObjectId": string
}
Pola
speakerNotesObjectId

string

Identyfikator obiektu kształtu na tej stronie notatek, który zawiera notatki prelegenta dla odpowiedniej slajdu. Rzeczywisty kształt może nie zawsze występować na stronie notatek. Wstawienie tekstu z użyciem tego identyfikatora obiektu spowoduje automatyczne utworzenie kształtu. W takim przypadku rzeczywisty kształt może mieć inny identyfikator obiektu. Czynność presentations.get lub pages.get zawsze zwraca najnowszy identyfikator obiektu.

MasterProperties

Właściwości Page, które mają zastosowanie tylko do stron z typem strony MASTER.

Zapis JSON 
{
  "displayName": string
}
Pola
displayName

string

Czytelna nazwa pliku master.

PageProperties

Właściwości Page.

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

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

object (PageBackgroundFill)

Wypełnienie tła strony. Jeśli nie jest ustawiony, wypełnienie tła jest dziedziczone z poziomu strony nadrzędnej (jeśli istnieje). Jeśli strona nie ma strony nadrzędnej, wypełnienie tła jest domyślnie ustawiane na odpowiadające wypełnienie w edytorze slajdów.
colorScheme

object (ColorScheme)

Schemat kolorów strony. Jeśli nie jest ustawiony, schemat kolorów jest dziedziczony z poziomu strony nadrzędnej. Jeśli strona nie ma strony nadrzędnej, schemat kolorów używa domyślnego schematu kolorów Prezentacje, który jest zgodny z domyślnymi ustawieniami w edytorze Prezentacje.

Można edytować tylko konkretne kolory pierwszych 12 elementów.ThemeColorType Dodatkowo można zaktualizować tylko schemat kolorów na stronach Master. Aby zaktualizować to pole, musisz podać schemat kolorów zawierający mapowania wszystkich pierwszych 12 wartości ThemeColorTypes na ich konkretne kolory. Kolory pozostałych typów kolorów motywu zostaną zignorowane.

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łniania tła.

Zmiana wypełnienia na stronie spowoduje domyślne zaktualizowanie tego pola na RENDERED, chyba że w tej samej prośbie zostanie podana inna wartość. Aby na stronie nie było żadnego wypełnienia, ustaw to pole na NOT_RENDERED. W takim przypadku wszystkie inne pola wypełnienia ustawione w tym samym żądaniu zostaną zignorowane.
Pole unii kind. Rodzaj wypełnienia tła. kind może być tylko jednym z tych elementów:
solidFill

object (SolidFill)

Wypełnienie jednolitym kolorem.
stretchedPictureFill

object (StretchedPictureFill)

Rozciągnięty obraz wypełniający.

StretchedPictureFill

Rozciągnięty obraz wypełniający. Strona lub element strony jest całkowicie wypełniony określonym obrazem. Obraz jest rozciągany, aby pasował do kontenera.

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

string

Czytanie treściAdres URL:

Adres URL obrazu z domyślnym czasem trwania 30 minut. Ten adres URL jest oznaczony tagiem konta osoby, która wysłała prośbę. Każdy, kto ma adres URL, ma dostęp do zdjęcia jako pierwotny żądający. Jeśli ustawienia udostępniania prezentacji ulegną zmianie, możesz utracić dostęp do zdjęcia.

Tworzenie adresu URL treści:

Obraz jest pobierany raz w momencie wstawienia i kopia jest przechowywana na potrzeby wyświetlania w prezentacji. Zdjęcia muszą mieć rozmiar mniejszy niż 50 MB, nie mogą mieć więcej niż 25 megapikseli i muszą być w formacie PNG, JPEG lub GIF.

Podany adres URL może mieć maksymalnie 2 KB.
size

object (Size)

Pierwotny rozmiar wypełnienia obrazu. To pole jest tylko do odczytu.

ColorScheme

Paleta wstępnie zdefiniowanych kolorów na stronie.

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

object (ThemeColorPair)

Typ motywu kolorów i odpowiadające mu konkretne pary kolorów.

ThemeColorPair

Para mapująca typ koloru motywu na konkretny kolor.

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

enum (ThemeColorType)

Typ koloru motywu.
color

object (RgbColor)

Kolor odpowiadający podanemu powyżej kolorowi 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.