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 strony wyrenderowane na stronie.
revisionId

string

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

Identyfikator wersji nie jest sekwencyjną liczbą, ale nieprzejrzystym ciągiem znaków. Format identyfikatora wersji może się z czasem zmienić. Zwrócony identyfikator wersji jest ważny tylko przez 24 godziny od zwrócenia i nie można go udostępniać innym użytkownikom. Jeśli identyfikator wersji nie uległ zmianie między wywołaniami, prezentacja się nie zmieniła. Natomiast zmiana identyfikatora (dla tej samej prezentacji i użytkownika) zwykle oznacza, że prezentacja została zaktualizowana. Zmiana identyfikatora może jednak być spowodowana czynnikami wewnętrznymi, takimi jak zmiana formatu identyfikatora.
pageProperties

object (PageProperties)

Właściwości strony.
Pole sumy properties. Właściwości specyficzne dla poszczególnych typów strony. Elementy nadrzędne nie wymagają żadnych dodatkowych właściwości. properties może być tylko jedną z tych wartości:
slideProperties

object (SlideProperties)

Właściwości określonego slajdu. Ustaw ją tylko wtedy, gdy pageType = SLIDE.
layoutProperties

object (LayoutProperties)

Właściwości specyficzne dla układu. Wartość należy ustawić tylko wtedy, gdy parametr pageType ma wartość LAYOUT.
notesProperties

object (NotesProperties)

Uwagi o określonych właściwościach. Ustaw ją tylko wtedy, gdy parametr pageType ma wartość NOTES.
masterProperties

object (MasterProperties)

Opanuj konkretne właściwości. Ustaw ją tylko wtedy, gdy parametr pageType ma wartość MASTER.

PageType

Typ strony.

Wartości w polu enum
SLIDE Strona slajdu.
MASTER Główna strona slajdu.
LAYOUT Strona z układem.
NOTES Strona z notatkami.
NOTES_MASTER Główna strona notatek.

PageElement

Element wizualny renderowany 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 bezwzględnego przekształcenia. 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 znajduje się w grupie, jego przekształcenie bezwzględne jest takie samo jak wartość w tym polu.

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

string

Tytuł elementu strony. Połączono z opisem, aby wyświetlić tekst alternatywny.

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

string

Opis elementu strony. Połączono z tytułem, aby wyświetlić tekst alternatywny.

Pole nie jest obsługiwane w przypadku elementów Group.
Pole sumy element_kind. Rodzaj elementu, który reprezentuje ten element PageElement. Każda wiadomość zawiera właściwości charakterystyczne dla danego rodzaju elementu strony. element_kind może być tylko jedną z tych wartości:
elementGroup

object (Group)

Zbiór elementów strony złą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)

Link do wykresu umieszczonego 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)

Kolekcja elementów w grupie. Minimalny rozmiar grupy to 2.

WordArt

Rodzaj elementu PageElement reprezentujący WordArt.

Zapis JSON 
{
  "renderedText": string
}
Pola
renderedText

string

Tekst renderowany jako WordArt.

SpeakerSpotlight

Rodzaj PageElement reprezentujący Speaker spotlight.

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

object (SpeakerSpotlightProperties)

Właściwości Speaker spotlight.

SpeakerSpotlightProperties

Właściwości obiektu SpeakerSpotlight.

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

object (Outline)

Kontur Speaker spotlight. Jeśli zasada jest nieskonfigurowana, nie ma konspektu.
shadow

object (Shadow)

Cień Speaker spotlight. Jeśli zasada jest nieskonfigurowana, nie ma cienia.

SlideProperties

Właściwości elementu Page, które mają zastosowanie tylko w przypadku stron ze stroną SLAJD typu pageType.

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

string

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

string

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

object (Page)

Strona notatek, z którą powiązany jest ten slajd. Definiuje wygląd strony notatek podczas drukowania lub eksportowania slajdów z notatkami. Strona z notatkami dziedziczy właściwości z elementu notes master. Symbol zastępczy typu TREŚĆ na stronie notatek zawiera notatki dotyczące tego slajdu. Identyfikator tego kształtu jest identyfikowany przez pole speakerNotesObjectId. Strona notatek jest dostępna tylko do odczytu, z wyjątkiem treści i stylów kształtu notatek. Ta właściwość 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 elementu Page dotyczą tylko stron z układem pageType LAYOUT.

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

string

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

string

Nazwa układu.
displayName

string

Czytelna dla człowieka nazwa układu.

NotesProperties

Właściwości elementu Page, które mają zastosowanie tylko w przypadku stron z NOTES typu pageType.

Zapis JSON 
{
  "speakerNotesObjectId": string
}
Pola
speakerNotesObjectId

string

Identyfikator obiektu kształtu na stronie z notatkami, który zawiera notatki na odpowiednim slajdzie. Rzeczywisty kształt nie zawsze występuje na stronie notatek. Wstawienie tekstu z użyciem 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 ostatni identyfikator obiektu.

MasterProperties

Właściwości elementu Page, które mają znaczenie tylko w przypadku stron o typie pageType MASTER.

Zapis JSON 
{
  "displayName": string
}
Pola
displayName

string

Czytelna 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 hierarchię definiuje się 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 skonfigurowana, wypełnienie tła jest dziedziczone ze strony nadrzędnej (o ile istnieje). Jeśli strona nie ma elementu nadrzędnego, wypełnienie tła domyślnie przyjmuje odpowiednie wypełnienie w edytorze Prezentacji.
colorScheme

object (ColorScheme)

Schemat kolorów strony. Jeśli schemat kolorów nie jest skonfigurowany, jest dziedziczony ze strony nadrzędnej. Jeśli strona nie ma elementu nadrzędnego, schemat kolorów korzysta z domyślnego schematu kolorów Prezentacji, zgodnego z wartościami domyślnymi w edytorze Prezentacji.

Edytować można tylko konkretne kolory z pierwszych 12 elementów 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 ze wszystkich pierwszych 12 elementów ThemeColorType na ich konkretne kolory. Kolory pozostałych elementów ThemeColorType 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 domyślnie zaktualizowanie tego pola do wartości RENDERED, chyba że w tym samym żądaniu określono inną wartość. Aby strona nie miała żadnego wypełnienia, ustaw to pole na NOT_RENDERED. W takim przypadku wszystkie pozostałe pola wypełnione w tym samym żądaniu będą ignorowane.
Pole sumy kind. Rodzaj wypełnienia tła. kind może być tylko jedną z tych wartości:
solidFill

object (SolidFill)

Wypełnienie jednolitym kolorem.
stretchedPictureFill

object (StretchedPictureFill)

Rozciągnięte wypełnienie obrazu.

StretchedPictureFill

Rozciągnięty obraz wypełni się. Strona lub jej element są w całości wypełnione określonym obrazem. Obraz zostanie rozciągnięty, aby zmieścił się w kontenerze.

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

string

Odczytywanie obiektu contentUrl:

Adres URL zdjęcia o domyślnym czasie aktywności wynoszącym 30 minut. Ten adres URL jest oznaczony tagiem konta osoby wysyłającej prośbę. Każda osoba, która otrzymała adres URL, uzyska dostęp do zdjęcia jako pierwotna osoba zgłaszająca prośbę. Jeśli zmienią się ustawienia udostępniania prezentacji, dostęp do zdjęcia może zostać utracony.

Zapisywanie parametru contentUrl:

W momencie wstawienia zdjęcie jest pobierane raz, a jego kopia jest zapisywana i wyświetlana w prezentacji. Rozmiar zdjęcia nie może przekraczać 50 MB, a obraz nie może być większy niż 25 megapikseli i musi być w formacie PNG, JPEG lub GIF.

Długość podanego adresu URL nie może przekraczać 2 kB.
size

object (Size)

Oryginalny rozmiar wypełnienia obrazu. 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 pary kolorów betonu.

ThemeColorPair

Para mapowania typu koloru motywu na kolor 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 kolorowi motywu powyżej.

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.