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)
  },
  "commentAnchors": [
    {
      object (CommentAnchor)
    }
  ],
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode),

  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
}
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 renderowane na stronie;
revisionId

string

Tylko dane wyjściowe. Identyfikator wersji prezentacji. Może być używany w żądaniach aktualizacji, aby sprawdzić, czy od ostatniej operacji odczytu wersja prezentacji nie uległa zmianie. Wypełniane tylko wtedy, gdy użytkownik ma uprawnienia do edycji prezentacji.

Identyfikator wersji nie jest liczbą porządkową, 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 momentu zwrócenia i nie można go udostępniać 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. Zmiana identyfikatora może być jednak spowodowana również czynnikami wewnętrznymi, takimi jak zmiana formatu identyfikatora.
pageProperties

object (PageProperties)

właściwości strony,
commentAnchors[]

object (CommentAnchor)

Tylko dane wyjściowe. Reklamy zakotwiczone z komentarzami na stronie.
comments[]

object (CommentThread)

Tylko dane wyjściowe. wątki komentarzy powiązane ze stroną; Wartość jest podawana tylko wtedy, gdy strona została pobrana za pomocą elementu GetPageRequest z wypełnionym polem commentsViewMode. W przeciwnym razie komentarze są zwracane w Presentation za pomocą GetPresentationRequest.
commentsViewMode

enum (CommentsViewMode)

Tylko dane wyjściowe. Tryb wyświetlania komentarzy zastosowany na stronie. Wartość jest podawana tylko wtedy, gdy strona została pobrana za pomocą elementu GetPageRequest z wypełnionym polem commentsViewMode.
Właściwości, które są specyficzne dla każdego typu strony. Wersje master nie wymagają żadnych dodatkowych właściwości. Poniżej znajduje się lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
slideProperties

object (SlideProperties)

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

object (LayoutProperties)

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

object (NotesProperties)

Uwagi dotyczące konkretnych właściwości. Ustaw tylko wtedy, gdy pageType = NOTES.
masterProperties

object (MasterProperties)

Opanuj określone właściwości. Ustaw tylko wtedy, gdy pageType = MASTER.
Koniec pól wykluczających się nawzajem.

PageType

Typ strony.

Wartości w polu enum
SLIDE strona slajdu,
MASTER strona slajdu wzorcowego;
LAYOUT strona układu,
NOTES strona z notatkami,
NOTES_MASTER strona wzorcowa notatek;

PageElement

Element wizualny renderowany na stronie.

Zapis JSON 
{
  "objectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  },
  "title": string,
  "description": string,

  "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)
  }
}
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 jest określany przez jego przekształcenie bezwzględne. Aby obliczyć przekształcenie bezwzględne, połącz przekształcenie elementu strony z przekształceniami wszystkich jego grup nadrzędnych. Jeśli element strony nie znajduje się w grupie, jego bezwzględne przekształcenie jest takie samo jak wartość w tym polu.

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

string

Tytuł elementu strony. W połączeniu z opisem 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 wyświetla tekst alternatywny.

Pole nie jest obsługiwane w przypadku elementów Group.
Rodzaj elementu, który reprezentuje ten PageElement. Każda wiadomość zawiera właściwości, które są specyficzne dla danego rodzaju elementu strony. Poniżej znajduje się lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
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 z filmem.
line

object (Line)

Element strony w linii.
table

object (Table)

Element strony tabeli.
wordArt

object (WordArt)

Element strony WordArt.
sheetsChart

object (SheetsChart)

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

object (SpeakerSpotlight)

Okienko prezentującego.
Koniec pól wykluczających się nawzajem.

Grupa

Typ PageElement reprezentujący połączoną kolekcję elementów strony.

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

object (PageElement)

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

WordArt

Typ PageElement reprezentujący obiekt WordArt.

Zapis JSON 
{
  "renderedText": string
}
Pola
renderedText

string

Tekst renderowany jako tekst dekoracyjny.

SpeakerSpotlight

Rodzaj PageElement reprezentujący okienko prezentujące.

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

object (SpeakerSpotlightProperties)

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

SpeakerSpotlightProperties

Właściwości elementu SpeakerSpotlight.

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

object (Outline)

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

object (Shadow)

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

SlideProperties

Właściwości Page, które są istotne tylko w przypadku stron o wartości pageType 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 właściwość jest tylko do odczytu.
masterObjectId

string

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

object (Page)

Strona notatek powiązana z tym slajdem. Określa wygląd strony z notatkami podczas drukowania lub eksportowania slajdów z notatkami prelegenta. Strona z notatkami dziedziczy właściwości z pliku notes master. Kształt obiektu zastępczego typu BODY na stronie notatek zawiera notatki do tego slajdu. Identyfikator tego kształtu jest określony w polu speakerNotesObjectId. Strona notatek jest dostępna tylko do odczytu, z wyjątkiem zawartości tekstowej i stylów kształtu notatek prelegenta. 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 Page są istotne tylko w przypadku stron o wartości pageType LAYOUT.

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

string

Identyfikator obiektu wzorca, 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 Page, które są istotne tylko w przypadku stron o wartości pageType NOTES.

Zapis JSON 
{
  "speakerNotesObjectId": string
}
Pola
speakerNotesObjectId

string

Identyfikator obiektu kształtu na tej stronie notatek, który zawiera notatki prelegenta dotyczące odpowiedniego slajdu. Rzeczywisty kształt może nie zawsze znajdować się na stronie notatek. Wstawienie tekstu za pomocą 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ą znaczenie tylko w przypadku stron o wartości pageType MASTER.

Zapis JSON 
{
  "displayName": string
}
Pola
displayName

string

Zrozumiała dla człowieka nazwa wersji głównej.

PageProperties

Właściwości elementu Page.

Strona odziedziczy właściwości 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 to pole nie jest ustawione, wypełnienie tła jest dziedziczone ze strony nadrzędnej (jeśli istnieje). Jeśli strona nie ma elementu nadrzędnego, wypełnienie tła jest domyślnie takie samo jak w edytorze Prezentacji.
colorScheme

object (ColorScheme)

Schemat kolorów strony. Jeśli nie jest ustawiony, 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, który jest zgodny z domyślnymi ustawieniami edytora Prezentacji.

Edytować można tylko konkretne kolory pierwszych 12 ThemeColorType. Można też aktualizować tylko schemat kolorów na stronach Master. Aby zaktualizować pole, należy podać schemat kolorów zawierający mapowania wszystkich pierwszych 12 typów ThemeColorTypes na ich konkretne kolory. Kolory pozostałych typów ThemeColorTypes zostaną zignorowane.

PageBackgroundFill

Wypełnienie tła strony.

Zapis JSON 
{
  "propertyState": enum (PropertyState),

  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
}
Pola
propertyState

enum (PropertyState)

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

Aktualizacja wypełnienia na stronie spowoduje automatyczne zaktualizowanie tego pola do wartości RENDERED, chyba że w tym samym żądaniu zostanie podana inna wartość. Aby na stronie nie było wypełnienia, ustaw w tym polu wartość NOT_RENDERED. W takim przypadku wszystkie inne pola wypełnienia ustawione w tym samym żądaniu zostaną zignorowane.
Rodzaj wypełnienia tła. Poniżej znajduje się lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
solidFill

object (SolidFill)

Wypełnienie jednolitym kolorem.
stretchedPictureFill

object (StretchedPictureFill)

Wypełnienie rozciągniętym obrazem.
Koniec pól wykluczających się nawzajem.

StretchedPictureFill

Rozciągnięte wypełnienie obrazem. Strona lub element strony jest w całości wypełniony wybranym obrazem. Obraz jest rozciągany, aby dopasować się do kontenera.

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

string

Odczytywanie adresu URL treści:

Adres URL zdjęcia z domyślnym czasem życia wynoszącym 30 minut. Ten adres URL jest oznaczony tagiem konta zgłaszającego. Każda osoba, która ma ten adres URL, może uzyskać dostęp do zdjęcia tak samo jak osoba, która pierwotnie o to poprosiła. Dostęp do obrazu może zostać utracony, jeśli zmienią się ustawienia udostępniania prezentacji.

Tworzenie adresu URL treści:

Obraz jest pobierany jednorazowo w momencie wstawienia, a jego kopia jest przechowywana do wyświetlania w prezentacji. Zdjęcia nie mogą mieć więcej niż 50 MB, nie mogą przekraczać 25 megapikseli i muszą być w jednym z tych formatów: PNG, JPEG lub GIF.

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

object (Size)

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

ColorScheme

Paleta predefiniowanych kolorów strony.

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

object (ThemeColorPair)

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

ThemeColorPair

Para mapująca typ koloru motywu na konkretny kolor, który reprezentuje.

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

enum (ThemeColorType)

Typ koloru motywu.
color

object (RgbColor)

Konkretny kolor odpowiadający typowi koloru motywu powyżej.

CommentAnchor

Zawiera listę wszystkich lokalizacji w Page, które są powiązane z CommentThread za pomocą tego samego anchorId. Wiele oddzielnych kotwic może odnosić się do tej samej lokalizacji w ramach Page lub na różnych stronach.

Zapis JSON 
{
  "anchorId": string,
  "objectAnchors": [
    {
      object (ObjectAnchor)
    }
  ]
}
Pola
anchorId

string

Tylko dane wyjściowe. Unikalny identyfikator kotwicy komentarza.
objectAnchors[]

object (ObjectAnchor)

Tylko dane wyjściowe. Wszystkie lokalizacje na stronie oparte na identyfikatorze obiektu, które odwołują się do identyfikatora kotwicy.

ObjectAnchor

Reprezentuje dane kotwicy komentarza powiązane z obiektem Prezentacji Google, np. Page lub PageElement.

Zapis JSON 
{
  "objectId": string,

  "shapeTextAnchors": {
    object (ShapeTextAnchors)
  },
  "tableCellAnchors": {
    object (TableCellAnchors)
  }
}
Pola
objectId

string

Tylko dane wyjściowe. Strona lub element strony, do którego jest przypięty wątek komentarzy.
Tylko dane wyjściowe. Zakresy tekstu w elemencie strony, do którego jest przypięty wątek komentarza. Będzie pusta, jeśli punkt zakotwiczenia komentarza dotyczy całej strony lub elementu strony, a nie zakresu tekstu w elemencie. Poniżej znajduje się lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
shapeTextAnchors

object (ShapeTextAnchors)

Wypełnione w przypadku Shapes, które mają komentarze przypięte do zakresów tekstu w [text][google.apps.slides.v1.Shape.TextContent] kształtu.
tableCellAnchors

object (TableCellAnchors)

Wypełniona w przypadku Tables, które mają komentarze przypięte do zakresów tekstu w co najmniej 1 komórce tabeli.
Koniec pól wykluczających się nawzajem.

ShapeTextAnchors

Reprezentuje zakresy tekstu w kształcie objętym kotwicą komentarza.

Zapis JSON 
{
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
Pola
ranges[]

object (TextRange)

Lista zakresów tekstu objętych kotwicą komentarza.

TextRange

Określa ciągły zakres tekstu w kształcie lub komórce tabeli text.

Zapis JSON 
{
  "startIndex": integer,
  "endIndex": integer
}
Pola
startIndex

integer

Indeks początkowy zakresu (liczony od zera). To pole jest typu Int32Value, aby uwzględnić przyszłe przypadki użycia z zakresami otwartymi.
endIndex

integer

Indeks końcowy zakresu liczony od zera. To pole jest typu Int32Value, aby uwzględnić przyszłe przypadki użycia z zakresami otwartymi.

TableCellAnchors

Reprezentuje zakresy komórek tabeli w tabeli objętej kotwicą komentarza.

Zapis JSON 
{
  "cellRanges": [
    {
      object (TableCellTextRanges)
    }
  ]
}
Pola
cellRanges[]

object (TableCellTextRanges)

Lista wszystkich komórek tabeli, w których tekst jest objęty kotwicą w tabeli.

TableCellTextRanges

Reprezentuje zakresy tekstu w komórce tabeli objęte kotwicą komentarza.

Zapis JSON 
{
  "cellLocation": {
    object (TableCellLocation)
  },
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
Pola
cellLocation

object (TableCellLocation)

Lokalizacja komórki tabeli.
ranges[]

object (TextRange)

Lista wszystkich zakresów tekstu objętych kotwicą w tej komórce.

Metody

get

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

getThumbnail

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