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 nie jest liczbą sekwencyjną, ale nieprzezroczystym ciągiem. Format identyfikatora wersji może się z czasem zmienić. 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, prezentacja nie uległa zmianie. Z kolei zmieniony identyfikator (w przypadku tej samej prezentacji i użytkownika) zwykle oznacza, ż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 unii properties. Właściwości specyficzne dla każdego typu strony. Plik master nie wymaga ż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)

Właściwości charakterystyczne dla notatek. Ustawiana 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 Układ strony.
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)

Transformacja elementu strony.

Wizualny wygląd elementu strony jest określany przez jego bezwzględną transformację. 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ą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.

Pole nie jest obsługiwane w przypadku elementów Group.
Pole sumy 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. Niepowiązane 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 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 nie jest ustawiony, nie ma cienia.

SlideProperties

Właściwości Page, które mają zastosowanie tylko do stron o typie 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 właściwość 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 elementu Page istotne tylko w przypadku stron z wartością pageType NOTES.

Zapis JSON 
{
  "speakerNotesObjectId": string
}
Pola
speakerNotesObjectId

string

Identyfikator obiektu kształtu na stronie notatek, który zawiera notatki prelegenta dla danej slajdu. Rzeczywisty kształt nie zawsze musi istnieć 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. Działanie 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 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 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 ThemeColorType. Ponadto można zaktualizować tylko schemat kolorów na stronach Master. Aby zaktualizować to pole, należy podać schemat kolorów zawierający mapowania z wszystkich 12 pierwszych elementów ThemeColorType 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 nie wypełniać żadnej strony, ustaw w tym polu wartość NOT_RENDERED. W takim przypadku wszystkie inne pola wypełniania 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. Zdjęcie zostanie rozciągnięte, aby wypełniło kontener.

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żda osoba, która zna URL, uzyskuje dostęp do zdjęcia jako osoba, która przesłała prośbę. 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 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.
size

object (Size)

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

ThemeColorType i odpowiadające im 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.