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, których używają Page i PageElement, mają taką 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żna go używać w żądaniach aktualizacji, aby potwierdzić, ż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 ciągiem sekwencyjnym, ale tekstem nieprzejrzystym. Format identyfikatora wersji może się z czasem zmienić. Zwrócony identyfikator wersji jest ważny tylko przez 24 godziny po zwróceniu i nie można go udostępniać innym użytkownikom. Jeśli identyfikator wersji nie zmienia się między wywołaniami, prezentacja się nie zmieniła. Natomiast zmieniony identyfikator (tej samej prezentacji i użytkownika) zwykle oznacza, że prezentacja została zaktualizowana. Zmiana identyfikatora może być jednak wynikają z czynników wewnętrznych, takich jak zmiany formatu dokumentu.

pageProperties

object (PageProperties)

Właściwości strony.

Pole sumy: properties. Właściwości 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)

Określ właściwości slajdu. Ustaw tylko wtedy, gdy pageType = SLIDE.

layoutProperties

object (LayoutProperties)

Właściwości określonego układu. Ustaw tylko wtedy, gdy pageType = LAYOUT.

notesProperties

object (NotesProperties)

Właściwości specyficzne dla notatek. Ustaw tylko wtedy, gdy pageType = NOTATKI.

masterProperties

object (MasterProperties)

Użyj właściwości nadrzędnych. Ustaw tylko wtedy, gdy pageType = MASTER.

Typ strony

Typ strony.

Wartości w polu enum
SLIDE Strona slajdu
MASTER Strona slajdu.
LAYOUT Strona układu.
NOTES Strona Notatki.
NOTES_MASTER Strona mastera notatek.

Element PagePage

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)
  }
  // End of list of possible types for union field element_kind.
}
Pola
objectId

string

Identyfikator obiektu tego elementu strony. Identyfikatory obiektów, których używają google.apps.slides.v1.Page i google.apps.slides.v1.PageElement, mają taką samą przestrzeń nazw.

size

object (Size)

Rozmiar elementu strony.

transform

object (AffineTransform)

Przekształcenie elementu strony.

Wygląd elementu strony jest określany na podstawie przekształcenia bezwzględnego. Aby obliczyć współczynnik przekształcenia bezwzględnego, przenieś przekształcenie elementu strony ze zmianami we wszystkich jego grupach nadrzędnych. Jeśli element strony nie należy do grupy, jego bezwzględna przekształcenie jest taka sama jak wartość w tym polu.

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

title

string

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

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

description

string

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

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

Pole sumy: element_kind. Rodzaj elementu reprezentowanego przez ten element PagePage. Każda wiadomość zawiera wszystkie właściwości właściwe dla danego typu strony. element_kind może mieć tylko jedną z tych wartości:
elementGroup

object (Group)

Kolekcja elementów strony połączonych w jedną jednostkę.

shape

object (Shape)

Kształt ogólny.

image

object (Image)

Element strony obrazu.

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)

Połączony wykres umieszczony w Arkuszach Google. Odłączone wykresy są przedstawiane jako obrazy.

Grupa

Rodzaj PageElement reprezentujący dołączoną kolekcję elementów ElementElements.

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

object (PageElement)

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

Obiekt WordArt

Rodzaj PageElement reprezentujący obiekt WordArt.

Zapis JSON
{
  "renderedText": string
}
Pola
renderedText

string

Tekst wyrenderowany jako obiekt WordArt.

Właściwości slajdu

Właściwości elementu Page, które mają znaczenie tylko w przypadku stron typu SLIDE.

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 usługa jest tylko do odczytu.

masterObjectId

string

Identyfikator obiektu głównego, na którym oparty jest ten slajd. Ta usługa jest tylko do odczytu.

notesPage

object (Page)

Strona notatek, z którą jest powiązany ten slajd. Określa wygląd strony z notatkami podczas drukowania lub eksportowania slajdów z notatkami. Strona notatek dziedziczy właściwości z elementu notes master. Kształt symbolu zastępczego typu BODY na stronie notatek zawiera notatki dla prelegenta na tym slajdzie. Identyfikator tego kształtu jest podany w polu speakerNotesObjectId. Strona notatek jest tylko do odczytu z wyjątkiem treści i stylów kształtu notatek. Ta usługa jest tylko do odczytu.

isSkipped

boolean

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

Właściwości układu

Właściwości elementu Page mają zastosowanie tylko w przypadku stron z funkcją 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

Czytelna nazwa układu dla człowieka.

Właściwości Notes

Właściwości elementu Page istotne tylko dla stron z parametrem pageType NOTES.

Zapis JSON
{
  "speakerNotesObjectId": string
}
Pola
speakerNotesObjectId

string

Identyfikator obiektu kształtu na tej stronie notatek, który zawiera notatki dla odpowiedniego slajdu. Właściwy kształt nie zawsze istnieje na stronie notatek. Wstawianie tekstu za pomocą tego identyfikatora obiektu automatycznie utworzy kształt. W takim przypadku rzeczywisty kształt może mieć inny identyfikator obiektu. Działanie presentations.get lub pages.get zawsze zwraca najnowszy identyfikator obiektu.

Właściwości nadrzędne

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

Zapis JSON
{
  "displayName": string
}
Pola
displayName

string

Czytelna dla człowieka nazwa mastera.

Właściwości strony

Właściwości elementu Page.

Strona odziedziczy właściwości ze strony nadrzędnej. W zależności od typu strony hierarchię definiuje się jako SlideProperties lub LayoutProperties.

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

object (PageBackgroundFill)

Wypełnianie strony w tle. Jeśli zasada jest nieskonfigurowana, wypełnienie tła jest dziedziczone ze strony nadrzędnej, jeśli taka strona istnieje. Jeśli strona nie ma elementu nadrzędnego, domyślne wypełnienie tła jest domyślnie zgodne z odpowiednim wypełnieniem w edytorze Prezentacji.

colorScheme

object (ColorScheme)

Schemat kolorów strony. Jeśli zasada jest nieskonfigurowana, schemat kolorów jest dziedziczony ze strony nadrzędnej. Jeśli strona nie ma elementu nadrzędnego, schemat kolorów użyje domyślnego schematu kolorów Prezentacji, który jest zgodny z domyślnymi schematami kolorów w edytorze Prezentacji.

Edytować można tylko konkretne kolory z pierwszych 12 ThemeColorType. Dodatkowo możesz aktualizować tylko schemat kolorów na stronach Master. Aby zaktualizować to pole, musisz podać schemat kolorów zawierający mapowanie wszystkich 12 pierwszych typów motywów motywu na kolory konkretne. Kolory pozostałych typów motywu ThemeColorType będą ignorowane.

Element tła w tle

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.

Zaktualizowanie wartości na stronie spowoduje domyślne zaktualizowanie tego pola do wartości RENDERED, chyba że w jednym żądaniu określono inną wartość. Aby uniknąć wypełnienia strony, ustaw w tym polu wartość NOT_RENDERED. W takim przypadku wszystkie pozostałe pola wypełnienia ustawione w tym samym żądaniu zostaną zignorowane.

Pole sumy: kind. Rodzaj tła. kind może mieć tylko jedną z tych wartości:
solidFill

object (SolidFill)

Wypełnienie jednolitym kolorem.

stretchedPictureFill

object (StretchedPictureFill)

Rozciągnij obraz.

RozciągniętyObraz

Wypełnienie rozciągniętego obrazu. Strona lub jej element jest całkowicie wypełniony określonym obrazem. Zdjęcie jest rozciągnięte, aby mieściło się w pojemniku.

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

string

Odczytywanie zawartości pola 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żdy, kto ma adres URL, uzyskuje dostęp do zdjęcia jako osoba, która wysłała prośbę. Jeśli ustawienia udostępniania prezentacji zostaną zmienione, możesz utracić dostęp do zdjęcia.

Zapisywanie parametru contentUrl:

Obraz jest pobierany raz podczas wstawiania, a kopia jest przechowywana w celu wyświetlania w prezentacji. Zdjęcia muszą być w rozmiarze mniejszym niż 50 MB, nie mogą przekraczać 25 megapikseli i muszą być w formacie PNG, JPEG lub GIF.

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

size

object (Size)

Oryginalny rozmiar obrazu. To pole jest tylko do odczytu.

Schemat kolorów

Paleta wstępnie zdefiniowanych kolorów na stronie.

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

object (ThemeColorPair)

ThemeColorType i odpowiadające im pary betonowe.

Para kolorów motywu

Para określająca typ koloru motywu na kolor betonowy, jaki reprezentuje.

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

enum (ThemeColorType)

Typ koloru motywu.

color

object (RgbColor)

Betonowy kolor odpowiadający powyższemu 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.