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 slajdzie 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"
}