REST Resource: presentations.pages

Zasób: Page

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of mutually exclusive fields.
}
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 potwierdzić, ż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ą 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. kotwice komentarzy na stronie,

comments[]

object (CommentThread)

Tylko dane wyjściowe. wątki komentarzy powiązane ze stroną. Wypełnione tylko wtedy, gdy strona została pobrana za pomocą 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. Wypełnione tylko wtedy, gdy strona została pobrana za pomocą GetPageRequest z wypełnionym polem commentsViewMode.

Właściwości, które są specyficzne dla każdego typu strony. Wersje główne nie wymagają żadnych dodatkowych właściwości. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
slideProperties

object (SlideProperties)

Właściwości wjazdu. 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 usług. Ustaw tylko wtedy, gdy pageType = NOTES.
masterProperties

object (MasterProperties)

Opanuj konkretne 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 wzorca slajdów;
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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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 mutually exclusive fields.
}
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ć transformację bezwzględną, połącz transformację elementu strony z transformacjami wszystkich jego grup nadrzędnych. Jeśli element strony nie należy do grupy, 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.

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

To pole nie jest obsługiwane w przypadku elementów Group.
Rodzaj elementu, który reprezentuje ten element strony. 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 wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
elementGroup

object (Group)

Zbiór elementów strony połączonych w jedną jednostkę.
shape

object (Shape)

Ogólny kształt.
image

object (Image)

Element strony z obrazem.
video

object (Video)

Elementu strony z filmem.
line

object (Line)

Element strony w postaci 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 word art.

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)

Obrys 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 zastępczy typu BODY na stronie notatek zawiera notatki do tego slajdu. Identyfikator tego kształtu jest określony w polu speakerNotesObjectId. Strona notatek jest tylko do odczytu, z wyjątkiem treś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 do 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 są istotne tylko w przypadku stron o wartości pageType MASTER.

Zapis JSON 
{
  "displayName": string
}
Pola
displayName

string

Nazwa wersji głównej w formie czytelnej dla człowieka.

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 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 taka istnieje. Jeśli strona nie ma elementu nadrzędnego, wypełnienie tła jest domyślnie ustawione na odpowiednie wypełnienie 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 Google, który jest zgodny z domyślnymi ustawieniami w edytorze Prezentacji.

Edytować można tylko konkretne kolory pierwszych 12 ThemeColorType. Możesz też zaktualizować 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),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of mutually exclusive fields.
}
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 podano inną wartość. Aby strona nie miała wypełnienia, ustaw to pole na NOT_RENDERED. W tym 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 wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
solidFill

object (SolidFill)

Wypełnienie jednolitym kolorem.
stretchedPictureFill

object (StretchedPictureFill)

Rozciągnięte wypełnienie 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 określonym obrazem. Obraz jest rozciągany, aby pasował do kontenera.

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

string

Odczytywanie adresu URL treści:

Adres URL obrazu z domyślnym czasem życia wynoszącym 30 minut. Ten adres URL jest oznaczony tagiem konta osoby wysyłającej żądanie. Każda osoba, która ma adres URL, może uzyskać dostęp do obrazu jako pierwotny wnioskodawca. Dostęp do obrazu może zostać utracony, jeśli zmienią się ustawienia udostępniania prezentacji.

Tworzenie adresu URL treści:

Obraz jest pobierany raz 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 formacie 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 konkretne 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, np. Page lub PageElement.

Zapis JSON 
{
  "objectId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "shapeTextAnchors": {
    object (ShapeTextAnchors)
  },
  "tableCellAnchors": {
    object (TableCellAnchors)
  }
  // End of mutually exclusive fields.
}
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 puste, 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 wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
shapeTextAnchors

object (ShapeTextAnchors)

Wypełnione w przypadku Shapes, które mają komentarze przypisane 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 przypisane do zakresów tekstu w co najmniej jednej komórce tabeli.
Koniec pól wykluczających się nawzajem.

ShapeTextAnchors

Reprezentuje zakresy tekstu w kształcie objęte 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ńca 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 w tabeli objęte 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 obrazu miniatury.