Interfejs Google Slides API umożliwia tworzenie, przenoszenie i usuwanie slajdów. Przykłady na tej stronie pokazują typowe operacje na slajdach przy użyciu metody presentations.batchUpdate.
W tych przykładach użyto tych zmiennych:
- PRESENTATION_ID—wskazuje, gdzie należy podać identyfikator prezentacji. Wartość tego identyfikatora możesz znaleźć w adresie URL prezentacji.
- PAGE_ID i PAGE_ID2 – wskazują, gdzie należy podać identyfikatory obiektów stron. Wartość tej opcji możesz pobrać z adresu URL lub za pomocą żądania odczytu interfejsu API.
Te przykłady są przedstawione jako żądania HTTP, aby były neutralne pod względem języka. Aby dowiedzieć się, jak wdrożyć aktualizację zbiorczą w różnych językach za pomocą bibliotek klienta interfejsu Google API, zapoznaj się z tymi przewodnikami: Tworzenie slajdu i Dodawanie kształtów i tekstu.
Kopiowanie slajdu
Ten przykładowy kod presentations.batchUpdate pokazuje, jak za pomocą metody DuplicateObjectRequest skopiować slajd i wstawić go w prezentacji po oryginale.
Pierwotny slajd jest określany przez PAGE_ID.
W prośbie możesz określić, czy w kopii mają się znaleźć niektóre czy wszystkie identyfikatory elementów strony (z niektórymi ograniczeniami). W tym przykładzie oryginalny slajd zawiera element tabeli (określony przez TABLE_ELEMENT_ID), który jest mapowany na nową tabelę (określoną przez COPY_TABLE_ELEMENT_ID) w kopii slajdu (określonej przez COPY_PAGE_ID). Wszystkie inne elementy w kopii mają losowe identyfikatory.
Więcej informacji o kopiowaniu PageElement, w tym pól tekstowych, obrazów, tabel, podstawowych kształtów, linii i osadzonych filmów, znajdziesz w przykładowym artykule Kopiowanie i edytowanie elementu.
Oto protokół żądania kopiowania slajdu:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"duplicateObject": {
"objectId": PAGE_ID,
"objectIds": {
"PAGE_ID": "COPY_PAGE_ID",
"TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID"
}
}
}
]
}
Tworzenie slajdu
Ten przykładowy kod presentations.batchUpdate pokazuje, jak za pomocą metody CreateSlideRequest utworzyć slajd i wstawić go jako czwarty slajd (z licznikiem licząc od 0) w prezentacji.insertionIndex
Nowy slajd ma używać PredefinedLayout w TITLE_AND_TWO_COLUMNS. Możesz podać ciąg znaków, który ma być używany jako PAGE_ID na slajdzie (z niektórymi ograniczeniami), albo pozwolić interfejsowi API wygenerować PAGE_ID, pomijając to pole w żądaniu.
Oto protokół żądania służący do tworzenia slajdu:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createSlide": {
"objectId": "PAGE_ID",
"insertionIndex": 3,
"slideLayoutReference": {
"predefinedLayout": "TITLE_AND_TWO_COLUMNS"
}
}
}
]
}
Tworzenie slajdu i modyfikowanie placeholderów
Ten przykładowy kod presentations.batchUpdate pokazuje, jak za pomocą metody CreateSlideRequest utworzyć slajd za pomocą obiektu PredefinedLayout TITLE_AND_TWO_COLUMNS.
Możesz podać ciąg znaków, który ma być używany jako PAGE_ID slajdu (z niektórymi ograniczeniami).
placeholderIdMappings używa metody Type elementu TITLE. Element TITLE_ID odwołuje się do kształtu zastępczego slajdu, więc można go modyfikować.
Oto protokół żądania służący do tworzenia slajdu i modyfikowania elementów zastępczych:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createSlide": {
"objectId": PAGE_ID,
"slideLayoutReference": {
"predefinedLayout": "TITLE_AND_TWO_COLUMNS"
},
"placeholderIdMappings": [
{
"layoutPlaceholder": {
"type": "TITLE",
"index": 0
},
"objectId": TITLE_ID,
},
],
}
},
{
"insertText": {
"objectId": TITLE_ID,
"text": "This is my slide title",
}
},
]
}
Przenoszenie slajdów w nowe miejsce
Poniższy przykładowy kod presentations.batchUpdate pokazuje, jak za pomocą metody UpdateSlidesPositionRequest przenieść 2 wybrane slajdy na początek prezentacji, zachowując ich względną kolejność.
Podane identyfikatory slajdów (PAGE_ID i PAGE_ID2) muszą być podane w kolejności obecnej prezentacji, bez duplikatów. insertionIndex oparte na wartości 0 oznacza miejsce, w którym należy wstawić slajdy, na podstawie kolejności przed przeniesieniem. Wartość musi zawierać się w przedziale od 0 do liczby slajdów w prezentacji (włącznie).
Oto protokół przesyłania żądania przeniesienia slajdu na nową pozycję:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updateSlidesPosition": {
"slideObjectIds": [
PAGE_ID,
PAGE_ID2
],
"insertionIndex": 0
}
}
]
}
Ustawianie obrazu tła slajdu
Poniższy przykładowy kod presentations.batchUpdate pokazuje, jak użyć metody UpdatePagePropertiesRequest, aby ustawić obraz tła slajdu określony przez parametr PAGE_ID. Interfejs API pobiera obraz za pomocą funkcji IMAGE_URL.
Maska pola służy do określenia, że tylko tło slajdu powinno zostać zmienione, aby zachować inne właściwości. Skuteczność reklam zwiększa też używanie masek pól.
Możesz też użyć metody UpdatePagePropertiesRequest, aby ustawić tło slajdu jako jednolity kolor.
Oto protokół żądania ustawiania obrazu tła slajdu:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updatePageProperties": {
"objectId": PAGE_ID,
"pageProperties": {
"pageBackgroundFill": {
"stretchedPictureFill": {
"contentUrl": IMAGE_URL
}
}
},
"fields": "pageBackgroundFill"
}
}
]
}
Wygeneruj miniaturę
Możesz wygenerować miniaturę najnowszej wersji konkretnej strony w prezentacji, wywołując metodę presentations.pages.getThumbnail, która zwraca miniaturę strony jako adres URL treści. Adres URL obrazu ma domyślny okres istnienia wynoszący 30 minut.
Możesz też podać wartości mimeType i thumbnailSize zwracane za pomocą pola ThumbnailProperties jako parametru zapytania.
Oto protokół żądania służący do wygenerowania miniatury strony z ustawionym parametrem ThumbnailProperties:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM
{
"width": 800,
"height": 450,
"contentUrl": "CONTENT_URL"
}