Interfejs API Prezentacji Google umożliwia tworzenie, przenoszenie i usuwanie slajdów. Przykłady na tej stronie pokazują niektóre typowe operacje na slajdach wykonywane przy użyciu metody presentations.batchUpdate.
W poniższych przykładach używane są te zmienne:
- PRESENTATION_ID – wskazuje, gdzie podajesz identyfikator prezentacji. Wartość tego identyfikatora można poznać w adresie URL prezentacji.
- PAGE_ID i PAGE_ID2 – wskazuje miejsce, w którym podajesz identyfikatory obiektów strony. Wartość tę można pobrać z adresu URL lub za pomocą żądania odczytu interfejsu API.
Te przykłady są prezentowane jako żądania HTTP bez względu na język. Aby dowiedzieć się, jak wdrożyć aktualizację zbiorczą w różnych językach za pomocą bibliotek klienta interfejsu API Google, przeczytaj te przewodniki: Tworzenie slajdu oraz Dodawanie kształtów i tekstu.
Kopiowanie slajdu
Poniższy przykładowy kod presentations.batchUpdate pokazuje, jak użyć metody DuplicateObjectRequest do skopiowania slajdu i wstawienia go w prezentacji po oryginału.
Oryginalny slajd jest określony przez atrybut PAGE_ID.
Żądanie pozwala określić, czy niektóre czy wszystkie identyfikatory elementów strony powinny znajdować się w kopii (z pewnymi ograniczeniami). W tym przykładzie oryginalny slajd zawiera element tabeli (określony przez TABLE_ELEMENT_ID), który jest zmapowany na nową tabelę (określoną przez COPY_TABLE_ELEMENT_ID) w tekście slajdu (określoną przez COPY_PAGE_ID). Pozostałe elementy w tekście otrzymują losowe identyfikatory.
Więcej informacji o kopiowaniu elementu PageElement, w tym pól tekstowych, obrazów, tabel, podstawowych kształtów, linii i umieszczonych na niej filmów, znajdziesz w przykładowym kopiowaniu i edytowaniu 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"
}
}
}
]
}
Utwórz slajd
Poniższy przykładowy kod presentations.batchUpdate pokazuje, jak użyć metody CreateSlideRequest do utworzenia slajdu i wstawienia go jako czwartego slajdu w prezentacji (insertionIndex).
Nowy slajd jest ustawiony na użycie właściwości PredefinedLayout z TITLE_AND_TWO_COLUMNS. Możesz określić ciąg znaków, który będzie używany jako PAGE_ID slajdu (z pewnymi ograniczeniami) lub zezwolić interfejsowi API na wygenerowanie PAGE_ID, pomijając to pole w żądaniu.
Oto protokół żądania do utworzenia 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 obiektów zastępczych
Z przykładowego kodu presentations.batchUpdate dowiesz się, jak utworzyć slajd za pomocą metody CreateSlideRequest za pomocą metody PredefinedLayout TITLE_AND_TWO_COLUMNS.
Możesz podać ciąg znaków, który będzie używany jako obiekt PAGE_ID slajdu (z pewnymi ograniczeniami).
W obiekcie placeholderIdMappings używana jest właściwość Type właściwości TITLE. Element TITLE_ID odwołuje się do zastępczego kształtu slajdu, dzięki czemu można go zmodyfikować.
Oto protokół żądań do tworzenia slajdów i modyfikowania obiektó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",
}
},
]
}
Przenieś slajdy na nowe miejsce
Poniższy przykładowy kod presentations.batchUpdate pokazuje, jak za pomocą metody UpdateSlidesPositionRequest przenieść 2 określone slajdy na początek prezentacji z zachowaniem ich względnej kolejności.
Określone identyfikatory slajdów (PAGE_ID i PAGE_ID2) należy podać w dotychczasowej kolejności prezentacji, bez duplikatów. Wartość insertionIndex liczona od zera oznacza miejsce wstawienia slajdów (na podstawie kolejności ich przenoszenia). Wartość musi mieścić się w przedziale od 0 do liczby slajdów w prezentacji.
Następujący protokół żądania służy do przenoszenia slajdów do nowej pozycji:
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 za pomocą metody UpdatePagePropertiesRequest ustawić obraz tła slajdu wskazanej przez właściwość PAGE_ID. Interfejs API pobiera obraz za pomocą IMAGE_URL.
Maska pola służy do określenia, że w celu zachowania innych właściwości należy zmienić tylko tło slajdu. Użycie masek terenowych również zwiększa wydajność.
Za pomocą metody UpdatePagePropertiesRequest można też ustawić jednolity kolor tła slajdu.
Oto protokół żądań 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 określonej strony w prezentacji, wywołując metodę presentations.pages.getThumbnail, która zwraca obraz miniatury strony jako adres URL treści. Domyślny adres URL obrazu to 30 minut.
Możesz też określić mimeType i thumbnailSize zwrócone za pomocą pola ThumbnailProperties jako parametru zapytania.
Oto protokół żądania do generowania 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"
}