Interfejs API Prezentacji Google umożliwia tworzenie i modyfikowanie prezentacji Google.
Aplikacje można zintegrować z interfejsem API Prezentacji Google, aby automatycznie tworzyć atrakcyjne prezentacje na podstawie danych przekazywanych przez użytkowników i system. Możesz na przykład wykorzystać dane klientów z bazy danych i połączyć je ze wstępnie zaprojektowanymi szablonami oraz wybranymi opcjami konfiguracji, aby szybko utworzyć gotowe prezentacje w ułamku czasu, który potrzeba na ręczne utworzenie prezentacji.
Omówienie interfejsu API
Kolekcja Prezentacje zawiera metody pobierania i aktualizowania elementów w prezentacji.
Większość pracy w interfejsie Prezentacji API będzie prawdopodobnie dotyczyć tworzenia i aktualizowania prezentacji. Użyjesz metody batchUpdate. Ta metoda pobiera listę obiektów Request, dzięki którym możesz na przykład:
- Utwórz slajdy
- dodawać do slajdów elementy takie jak kształty i tabele;
- Wstawianie, zmienianie i usuwanie tekstu
- Zastosuj przekształcenia do elementów
- Zmiana kolejności slajdów
Więcej informacji znajdziesz w artykule Aktualizacje zbiorcze. Zapoznaj się z przewodnikami dla początkujących, gdzie znajdziesz prosty, kompleksowy przykład korzystania z interfejsu API.
Struktura prezentacji
Prezentacja w interfejsie Prezentacji API składa się ze stron zawierających poszczególne elementy.
Identyfikator prezentacji może pochodzić z adresu URL:
https://docs.google.com/presentation/d/presentationId/edit
Identyfikator prezentacji to ciąg zawierający litery, cyfry i znaki specjalne. Aby wyodrębnić identyfikator prezentacji z adresu URL Arkuszy Google, możesz użyć tego wyrażenia regularnego:
/presentation/d/([a-zA-Z0-9-_]+)
Jeśli znasz interfejs Drive API, presentationId odpowiada identyfikatorowi zasobu File.
Strony i ich elementy są identyfikowane za pomocą identyfikatorów obiektów.
Pages
Prezentacje Google zawierają następujące rodzaje stron:
| Magistrowie | Miany slajdów określają domyślne style tekstu, tło i elementy strony, które pojawiają się na wszystkich slajdach, w których jest używany dany element główny. Elementy strony, które muszą występować na wszystkich slajdach, należy dodać do elementu głównego. Większość prezentacji ma 1 element nadrzędny, ale niektóre mogą mieć kilka lub żaden. |
| Układy | Układy to szablon domyślnego rozmieszczenia elementów strony na slajdach według układu. Każdy układ jest powiązany z 1 wzorcem głównym. |
| Prezentacje | Te strony zawierają treści, które udostępniasz odbiorcom. Większość slajdów jest oparta na elemencie głównym i układzie. Podczas tworzenia każdego slajdu możesz określić, którego układu chcesz użyć. |
| Notatki | Te strony zawierają treść materiałów do prezentacji, w tym kształt zawierający notatki dla prelegenta na slajdzie. Każdemu slajdowi odpowiada 1 strona notatek. Za pomocą interfejsu Prezentacji API można modyfikować tylko tekst w kształcie notatek. |
| Mistrzowie notatek | Szablony notatek definiują domyślne style tekstu i elementy strony dla wszystkich stron notatek. W interfejsie Prezentacji API dokumenty główne notatek są tylko do odczytu. |
Elementy strony
Elementy strony to komponenty wizualne umieszczane na stronach. Interfejs API udostępnia kilka rodzajów elementów strony:
| Grupa | Zestaw elementów strony traktowanych jako osobna jednostka. Można je przenosić, skalować i obracać razem. |
| Kształt | Zwykły obiekt wizualny, taki jak prostokąty, wielokropki i pola tekstowe. Kształty mogą zawierać tekst, więc są najczęstszym elementem strony do tworzenia slajdów. |
| Obraz | Grafika zaimportowana do Prezentacji Google. |
| Wideo | Film zaimportowany do Prezentacji Google. |
| Liniowy | Linia wizualna, krzywa lub łącznik. |
| Tabela | Siatka treści. |
| WordArt | Wizualny element tekstowy zawierający tekst, który przypomina kształt. |
| SheetsChart | Wykres zaimportowany do Prezentacji z Arkuszy Google. |
Aktualizacje zbiorcze
Metoda batchUpdate umożliwia aktualizowanie wielu aspektów prezentacji. Zmiany są grupowane zbiorczo, dzięki czemu w razie niepowodzenia jednego żądania nie są zapisywane żadne inne (potencjalnie zależne) zmiany.
Metoda batchUpdate działa, gdy przyjmuje co najmniej 1 obiekt Request, z których każdy określa 1 rodzaj żądania do wykonania. Jest wiele różnych rodzajów wniosków. Oto zestawienie typów żądań w różnych kategoriach.
Metoda batchUpdate zwraca treść odpowiedzi, która zawiera odpowiedź dla każdego żądania. Każda odpowiedź zajmuje ten sam indeks co odpowiednie żądanie. W przypadku żądań bez odpowiedniej odpowiedzi odpowiedź w tym indeksie będzie pusta. Różne żądania Create zwykle mają odpowiedzi, więc znasz identyfikator nowo dodanego obiektu.
Praca z identyfikatorami obiektów
Prezentacja w interfejsie Prezentacji API składa się ze stron i elementów strony. Te obiekty zawierają ciąg identyfikatora obiektu, który jest unikalny w obrębie prezentacji.
Określanie identyfikatorów obiektów podczas tworzenia
Podczas tworzenia stron lub elementów strony za pomocą metody batchUpdate możesz opcjonalnie podać identyfikator obiektu nowego obiektu. Dzięki temu możesz utworzyć obiekt i zmodyfikować go w tym samym żądaniu wsadowym, co zminimalizuje liczbę wywołań interfejsu Prezentacji API i zmniejszy wykorzystanie limitu.
W większości przypadków zalecamy generowanie losowego identyfikatora obiektu. Jeśli np. używasz Javy, java.util.UUID.randomUUID().toString() powinien się sprawdzić.
Gdy aplikacja chce śledzić obiekty przez dłuższy czas, nie polegaj na identyfikatorze obiektu, ponieważ może się on zmieniać. Więcej informacji znajdziesz w sekcji poniżej.
Śledzenie obiektów bez użycia identyfikatora obiektu
Po przesłaniu żądania do interfejsu Prezentacji API identyfikator obiektu jest zwykle zachowywany. (wszelkie wyjątki są wymieniane w dokumentacji metody). Utworzenie kopii całej prezentacji za pomocą interfejsu Drive API pozwala zachować identyfikatory obiektów.
Nie możesz jednak polegać na tym, że identyfikator obiektu nie zmienia się po zmianie prezentacji w interfejsie Prezentacji. Jeśli np. ktoś użyje interfejsu Prezentacji, aby skopiować i wkleić element strony, a potem usunie oryginał, element strony będzie miał nowy, unikalny identyfikator, a identyfikator podany wcześniej przez interfejs API zostanie utracony. Dlatego nie zalecamy przechowywania identyfikatorów obiektów w pamięci aplikacji. Zamiast tego obiekty w prezentacji należy wyszukiwać według tekstu lub tekstu alternatywnego.
Nowo utworzone prezentacje zwykle używają spójnego zestawu identyfikatorów slajdów, wzorców i pól tekstowych. Identyfikatory mogą się z czasem zmieniać, dlatego nie zalecamy korzystania z tej funkcji. Elementy, które chcesz zmodyfikować, znajdź za pomocą obiektu prezentacji zwracanych przez wywołania create() lub get().