Interfejs API Prezentacji Google umożliwia tworzenie, przenoszenie i usuwanie slajdów. Przykłady w
na tej stronie można pokazać kilka typowych operacji na slajdach za pomocą funkcji
presentations.batchUpdate
.
W poniższych przykładach używane są te zmienne:
- PRESENTATION_ID – wskazuje, gdzie podajesz atrybuty prezentacja Identyfikator. Dostępne opcje wartość tego identyfikatora można znaleźć w adresie URL prezentacji.
- PAGE_ID i PAGE_ID2 – wskazuje, gdzie można podać obiekt strony identyfikatory. Możesz pobrać tę wartość 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 się uczyć Jak wdrożyć aktualizację zbiorczą w różnych językach przy użyciu interfejsu API Google? biblioteki klienta znajdziesz w tych przewodnikach: Tworzenie slajd i Dodaj kształty i tekst.
Kopiowanie slajdu
Poniżej
presentations.batchUpdate
przykładowy kod pokazuje, jak używać parametru
DuplicateObjectRequest
w celu 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 być treść (z niektórymi ograniczenia). W tym przykładzie oryginalny slajd zawiera element tabeli (określony przez TABLE_ELEMENT_ID), która jest zmapowana na nową tabelę (określoną przez COPY_TABLE_ELEMENT_ID) w tekście slajdu (określanym przez COPY_PAGE_ID). Wszystkie pozostałe elementy w kopii są przypisywane losowo Identyfikatory.
Więcej informacji o kopiowaniu
PageElement
,
takie jak pola tekstowe, obrazy, tabele, podstawowe kształty, linie i osadzone filmy,
zobacz przykład Skopiuj i edytuj
.
Oto protokół żądania do skopiowania 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żej
presentations.batchUpdate
przykładowy kod pokazuje, jak używać parametru
CreateSlideRequest
aby utworzyć slajd i wstawić go jako czwarty slajd (za pomocą metody
insertionIndex
) w prezentacji.
Nowy slajd jest ustawiony tak, aby używać funkcji
PredefinedLayout
z TITLE_AND_TWO_COLUMNS
. Możesz podać ciąg znaków, który będzie używany jako
PAGE_ID za slajd (z
ograniczenia),
lub zezwól interfejsowi API na wygenerowanie PAGE_ID, pomijając pole
do danego wniosku.
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
Poniżej
presentations.batchUpdate
przykładowy kod pokazuje, jak używać parametru
CreateSlideRequest
aby utworzyć slajd za pomocą
PredefinedLayout
z TITLE_AND_TWO_COLUMNS
.
Możesz podać ciąg znaków, który będzie używany jako PAGE_ID w przypadku slajdu.
(z pewnymi
ograniczenia).
placeholderIdMappings
korzysta z funkcji
Type
z
TITLE
Element TITLE_ID odwołuje się do zastępczego kształtu slajdu
więc można go zmodyfikować.
Poniżej znajduje się 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żej
presentations.batchUpdate
przykładowy kod pokazuje, jak używać parametru
UpdateSlidesPositionRequest
aby przenieść te dwa określone slajdy na początek
z zachowaniem ich względnej kolejności.
Określone identyfikatory slajdów (PAGE_ID i PAGE_ID2)
należy podać w istniejącej kolejności prezentacji, bez duplikatów.
od zera insertionIndex
określa, gdzie powinny zostać wstawione slajdy, na podstawie
zamówienia przed jego przeniesieniem. Wartość musi znajdować się w zakresie od 0 do
włącznie z liczbą 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żej
presentations.batchUpdate
przykładowy kod pokazuje, jak używać parametru
UpdatePagePropertiesRequest
metody ustawiania obrazu tła slajdu wskazanego przez
PAGE_ID Interfejs API pobiera obraz za pomocą
IMAGE_URL
Maska pola służy do określenia, że tylko tło slajdu należy zmienić, aby zachować pozostałe właściwości. Korzystanie z pola poprawiają też wydajność.
Można też użyć metody UpdatePagePropertiesRequest
do ustawienia
tło slajdu w jednolitym kolorze.
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ę
Miniaturę najnowszej wersji konkretnej strony możesz wygenerować w
prezentacji, używając funkcji
presentations.pages.getThumbnail
, która zwraca miniaturę strony jako adres URL treści. Obraz
Domyślny czas trwania adresu URL to 30 minut.
Możesz również określić mimeType
i thumbnailSize
zwrócone za pomocą parametru
ThumbnailProperties
jako parametr zapytania.
Poniżej znajduje się protokół żądania do wygenerowania miniatury strony z atrybutem
ThumbnailProperties
seta:
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" }