Przydatnym zastosowaniem interfejsu API Prezentacji Google jest scalanie informacji z jednego lub większą liczbę źródeł danych w prezentacji opartej na szablonie.
Na tej stronie opisujemy, jak pobierać dane ze źródła zewnętrznego i wstawić go do istniejącej prezentacji szablonu. Koncepcja polega na podobnie jak w przypadku kreatora e-maili w edytorze tekstu i arkuszu kalkulacyjnym.
Takie podejście jest przydatne z kilku powodów:
Projektanci mogą z łatwością dopracować projekt prezentacji za pomocą w edytorze Prezentacji Google. To znacznie łatwiejsze zadanie niż dostrajanie parametrów w aplikacji, aby ustawić wyrenderowany projekt slajdu.
Oddzielenie treści od prezentacji to dobrze znany projekt. z wieloma korzyściami.
Podstawowy przepis
Ten przykład ilustruje, jak można scalić dane w prezentację przy użyciu interfejsu API Prezentacji:
Prezentację można utworzyć tak, jak chcesz, za pomocą aby ułatwić Ci projektowanie.
Zastąp obiekt zastępczy dla każdego wstawianego elementu treści. które mają tag. Tagi to pola tekstowe lub kształty z unikalnym ciągiem znaków. Pamiętaj, by użyć ciągów znaków, które prawdopodobnie nie wystąpią prawidłowo. Przykład: Dobrym tagiem może być
{{account-holder-name}}
.W swoim kodzie użyj interfejsu Google Drive API, aby utworzyć kopię pliku prezentacji.
W kodzie użyj interfejsu API Prezentacji
batchUpdate
ze zbiorem funkcjireplaceAllText
zastępowania tekstu w całej prezentacji. Użyj formatureplaceAllShapesWithImage
żądań zastępowania obrazów w całej prezentacji.
Po utworzeniu prezentacji z tagami utwórz jej kopię i użycie jej interfejsu API do Prezentacji. Nie używaj interfejsu API Prezentacji aby zmodyfikować podstawowy „szablon”
Poniższe sekcje zawierają fragmenty kodu, które ilustrują niektóre z tych proces tworzenia konta. Aby zobaczyć pełny przykład, możesz również obejrzeć film powyżej. (Python), łącząc kilka koncepcji z poszczególnych sekcji poniżej.
Scal tekst
replaceAllText
żądania zastąpienia wszystkich wystąpień danego ciągu tekstowego w
prezentacji z nowym tekstem. W przypadku scalania jest to prostsze niż
znajdowanie i zastępowanie każdego wystąpienia tekstu z osobna. Jednym z powodów jest to,
polega na tym, że
identyfikatory elementów strony są trudne do przewidzenia,
zwłaszcza gdy współpracownicy dopracowują i utrzymują szablon.
prezentacji.
Przykład
W tym przykładzie użyto interfejsu Drive API do skopiowania szablonu prezentacji, dzięki czemu nowe wystąpienie prezentacji. Następnie odczytuje dane za pomocą interfejsu API Arkuszy Google z arkusza kalkulacyjnego Arkuszy, a na koniec używa interfejsu Prezentacje – interfejsu API nową prezentację.
W przykładzie pokazano dane z 3 komórek w jednym wierszu zakresu nazwanego w
arkusz kalkulacyjny. Następnie zastępuje te dane w prezentacji,
struny {{customer-name}}
,
{{case-description}}
lub
{{total-portfolio}}
.
Google Apps Script
Przeczytaj
Java
JavaScript
Node.js
PHP
Python
Ruby
Scal obrazy
Obrazy możesz też scalić z prezentacją za pomocą
replaceAllShapesWithImage
użytkownika. To żądanie zastępuje wszystkie wystąpienia kształtów zawierających
podany ciąg tekstowy z dostarczonym obrazem. Żądanie automatycznie
ustawia i skaluje obraz, by pasował do granic kształtu tagu,
z zachowaniem współczynnika proporcji obrazu.
Przykład
W tym przykładzie użyto interfejsu Google Drive API do skopiowania szablonu prezentacji, dzięki czemu
nowe wystąpienie prezentacji. a potem używa interfejsu Prezentacje –
dowolny kształt zawierający tekst {{company-logo}}
i zastąpić go obrazem logo firmy. Żądanie zastępuje również wszystkie
kształt zawierający tekst {{customer-graphic}}
z innym obrazem.
Google Apps Script
Przeczytaj
Java
JavaScript
Node.js
PHP
Python
Ruby
Zastępowanie określonych pól tekstowych lub wystąpień obrazu
replaceAllText
i replaceAllShapesWithImage
są przydatne do zastępowania tagów w całej prezentacji, ale
czasami wystarczy, że zastąpisz elementy zgodnie z innymi kryteriami,
co znajduje się na konkretnym slajdzie.
W takich przypadkach musisz pobrać identyfikatory kształtów tagów, które które chcesz zastąpić. Aby zastąpić tekst, usuń istniejące w tych kształtach, a następnie wstaw nowy tekst (zobacz przykład Edytowanie tekstu o określonym kształcie).
Zastępowanie obrazów jest bardziej złożone. Aby scalić obraz na obrazie, musisz:
- Uzyskaj identyfikator kształtu tagu.
- Skopiuj z tagu informacje o rozmiarze i przekształceniu.
- Dodaj obraz do strony, korzystając z informacji o rozmiarze i przekształceniu.
- Usuń kształt tagu.
Zachowanie współczynnika proporcji obrazu podczas skalowania go do pożądanego rozmiaru może wymagają szczególnej ostrożności, jak opisano w sekcji poniżej. Zobacz też ten przykład: Zastępowanie tagu kształtu obrazem.
Zachowaj proporcje
Podczas tworzenia obrazów za pomocą interfejsu Prezentacje – dopasowania proporcji opierają się wyłącznie na
rozmiaru obrazu, a nie rozmiaru
i przekształcania danych. Podane przez Ciebie dane dotyczące rozmiaru
w createImage
żądania jest uznawane za pożądany rozmiar obrazu. Interfejs API pasuje do
do wybranego rozmiaru obrazu, a potem zastosować dostarczone przekształcenie.
Zastępując tag obrazem, zachowujesz proporcje obrazu przez ustawienie rozmiaru i skalowania obrazu w następujący sposób:
- width: ustaw na iloczyn wartości
width
iscaleX
tagu - height: ustaw na iloczyn wartości
height
iscaleY
tagu - scale_x: ustaw wartość
1
. - scale_y: ustaw na
1
Sprawia to, że interfejs Prezentacji API dopasowuje proporcje obrazu zgodnie z
rozmiaru wizualnego tagu, a nie jego nieskalowanego rozmiaru (patrz
Zastąp tag kształtu obrazem.
Ustawienie parametrów skalowania na 1
uniemożliwia skalowanie obrazu
dwa razy.
Takie rozwiązanie zapewnia zachowanie współczynnika proporcji obrazu i uniemożliwia obrazu, tak by był większy niż rozmiar tagu. Obraz zawiera w tym samym punkcie środkowym co kształt tagu.
Zarządzaj szablonami
W przypadku prezentacji szablonów zdefiniowanych przez aplikację i będącej jej właścicielem utwórz używając dedykowanego konta reprezentującego aplikację. Konta usługi są dobrym wyborem i unikają komplikacji związanych z zasadami Google Workspace, które ograniczają udostępnianie.
Gdy tworzysz prezentacje na podstawie szablonów, zawsze używaj danych logowania użytkownika. Dzięki temu użytkownicy mają pełną kontrolę nad prezentowanej w ten sposób prezentacji i zapobiega problemom ze skalowaniem związanym z poszczególnymi użytkownikami. i ograniczeniami na Dysku Google.
Aby utworzyć szablon za pomocą konta usługi, wykonaj te czynności na stronie dane logowania do aplikacji:
- Utwórz prezentację przy użyciu polecenia presentations.create w interfejsie Prezentacji API.
- Zaktualizuj uprawnienia, aby odbiorcy prezentacji mogli odczytać ją za pomocą permissions.create (uprawnienia) w interfejsie Drive API;
- Zaktualizuj uprawnienia, aby umożliwić autorom szablonu zapisywanie w szablonie za pomocą permissions.create (uprawnienia) w interfejsie Drive API;
- W razie potrzeby zmodyfikuj szablon.
Aby utworzyć instancję prezentacji, wykonaj te czynności danymi logowania użytkownika:
- Utwórz kopię szablonu za pomocą atrybutu files.copy w interfejsie Drive API.
- Zastąp wartości za pomocą polecenia presentation.batchUpdate w interfejsie API Prezentacji.