Interfejs API Prezentacji Google umożliwia dodawanie i modyfikowanie elementów na stronach prezentacji.
z przykładów na tej stronie pokazują, jak wykonywać typowe operacje odczytu za pomocą
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 – wskazuje miejsce, w którym podajesz obiekt strony. Identyfikator. Możesz pobrać tę wartość z adresu URL lub za pomocą żądania odczytu interfejsu API.
- PAGE_ELEMENT_ID – wskazuje, gdzie udostępniasz stronę identyfikator obiektu elementu. Ty może określać ten identyfikator dla elementów, które tworzysz (z niektórymi ograniczenia) lub zezwolić interfejsowi Prezentacji API na jej automatyczne utworzenie. Identyfikatory elementów można pobierać 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? Więcej informacji znajdziesz w sekcji Dodawanie kształtów tekst.
Dodawanie pola tekstowego do slajdu
Poniżej
presentations.batchUpdate
przykładowy kod pokazuje, jak korzystać z
CreateShapeRequest
dodawania nowego pola tekstowego (zawierającego ciąg „Moje dodane pole tekstowe”) do
slajd określony przez PAGE_ID. W kolumnie
treść żądania – tworzy kształt pola tekstowego (o określonym rozmiarze
i sekundę na wstawienie do niego tekstu.
Pierwsze żądanie określa obiekt Identyfikator, który ma być używany w przypadku w polu tekstowym. Dzięki temu drugie żądanie może użyć go w tym samym wywołaniu interfejsu API, co zmniejsza nadmiarowe.
Oto protokół żądania umożliwiający dodanie pola tekstowego do slajdu:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createShape": {
"objectId": PAGE_ELEMENT_ID,
"shapeType": "TEXT_BOX",
"elementProperties": {
"pageObjectId": PAGE_ID,
"size": {
"width": {
"magnitude": 150,
"unit": "PT"
},
"height": {
"magnitude": 50,
"unit": "PT"
}
},
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 200,
"translateY": 100,
"unit": "PT"
}
}
}
},
{
"insertText": {
"objectId": PAGE_ELEMENT_ID,
"text": "My Added Text Box",
"insertionIndex": 0
}
}
]
}
Dodawanie obrazu do slajdu
Poniżej
presentations.batchUpdate
przykładowy kod pokazuje, jak korzystać z
CreateImageRequest
aby dodać obraz do slajdu określonego przez PAGE_ID.
Interfejs API pobiera obraz za pomocą interfejsu IMAGE_URL. Ta prośba także
skaluje i pozycjonuje obraz na slajdzie.
Oto protokół żądania dodawania obrazu do slajdu:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createImage": {
"url": IMAGE_URL,
"elementProperties": {
"pageObjectId": PAGE_ID,
"size": {
"width": {
"magnitude": 30,
"unit": "PT"
},
"height": {
"magnitude": 30,
"unit": "PT"
}
},
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 200,
"translateY": 100,
"unit": "PT"
}
}
}
}
]
}
Usuwanie strony lub elementu strony
Poniżej
presentations.batchUpdate
przykładowy kod pokazuje, jak korzystać z
DeleteObjectRequest
metoda usuwania elementu strony określonego przez PAGE_ELEMENT_ID
i slajd określony przez PAGE_ID za pomocą dwóch osobnych żądań.
Oto protokół żądania usunięcia strony lub jej elementu:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"deleteObject": {
"objectId": PAGE_ELEMENT_ID
},
"deleteObject": {
"objectId": PAGE_ID
}
}
]
}
Edytowanie tekstu w określonym kształcie
Poniżej
presentations.batchUpdate
przykładowy kod pokazuje, jak korzystać z
DeleteTextRequest
do zamiany części tekstu w kształcie określonym przez
PAGE_ELEMENT_ID W tym celu najpierw usuń tekst przy użyciu
startIndex liczony od zera, a następnie wstaw nowy tekst w tej pozycji. W tym
na przykład oryginalny ciąg tekstowy „Mój tekst kształtu: ????”. zostanie zastąpione ustawieniem „Mój”
Tekst kształtu: trapez”.
To żądanie dotyczy tylko tekstu o określonym kształcie. Aby zastąpić tekst wszędzie
w prezentacji, użyj
ReplaceAllTextRequest
.
Oto protokół żądania do edytowania tekstu o określonym kształcie:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"deleteText": {
"objectId": PAGE_ELEMENT_ID,
"textRange": {
"type": "FROM_START_INDEX",
"startIndex": 15
}
}
},
{
"insertText": {
"objectId": PAGE_ELEMENT_ID,
"text": "Trapezoid",
"insertionIndex": 15
}
}
]
}
Zastępowanie tagu kształtu obrazem
Tagi to pola tekstowe lub kształty z unikalną nazwą ciągu znaków, np. „nazwa-właściciela-konta”.
Poniżej
presentations.batchUpdate
przykładowy kod pokazuje, jak korzystać z
CreateImageRequest
zastąpienia pojedynczego wystąpienia tagu kształtu obrazem przy zachowaniu
i skalować ją w tym samym miejscu, by
pasowała do rozmiaru tagu, przy jednoczesnym zachowaniu
format obrazu.
Żądanie może też posłużyć do zastąpienia jednego obrazu innym. Żądanie polega na dodaniu nowego obrazu, a następnie usunięciu tagu.
Metoda CreateImageRequest zastępuje tylko określony kształt. Aby zastąpić tag
kształtów w dowolnym miejscu prezentacji, użyj
ReplaceAllShapesWithImageRequest
.
Tag kształtu ma te elementy
PageElement
właściwości (które można znaleźć za pomocą
presentations.pages.get
żądania):
{
"objectId": PAGE_ELEMENT_ID,
"size": {
"width": {
"magnitude": 3000000,
"unit": "EMU"
},
"height": {
"magnitude": 3000000,
"unit": "EMU"
}
},
"transform": {
"scaleX": 1.13,
"scaleY": 0.62,
"translateX": 4800000,
"translateY": 450000,
"unit": "EMU"
},
"shape": {
"shapeType": "RECTANGLE"
}
}
Kształt znajduje się na slajdzie określonym przez PAGE_ID. Aby określić
obrazu, który zastąpi kształt, interfejs API pobierze go za pomocą metody
IMAGE_URL Aby zachować współczynnik proporcji obrazu, ograniczając go
do rozmiaru tagu,
CreateImageRequest
ustawia rozmiar zdjęcia iloczynu rozmiaru i skali tagu oraz
skalowanie obrazu na 1. Więcej informacji znajdziesz w artykule Zachowanie aspektu
współczynnik proporcji.
Poniżej znajduje się protokół żądania zastępujący tag kształtu obrazem:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createImage": {
"url": IMAGE_URL,
"elementProperties": {
"pageObjectId": PAGE_ID,
"size": {
"width": {
"magnitude": 3000000 * 1.13,
"unit": "EMU"
},
"height": {
"magnitude": 3000000 * 0.62,
"unit": "EMU"
}
},
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 4800000,
"translateY": 450000,
"unit": "PT"
}
}
}
},
{
"deleteObject": {
"objectId": PAGE_ELEMENT_ID
}
}
]
}