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 podajesz 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 dla slajdu (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 na slajdzie (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" }