Google Slides API umożliwia tworzenie i modyfikowanie prezentacji w Prezentacjach Google.
Aplikacje mogą integrować się z interfejsem Google Slides API, aby automatycznie tworzyć atrakcyjne prezentacje na podstawie danych dostarczonych przez użytkownika i system. Możesz na przykład użyć szczegółów klientów z bazy danych i połączyć je z gotowymi szablonami oraz wybranymi opcjami konfiguracji, aby tworzyć gotowe prezentacje w ułamku czasu, jaki zajęłoby ich ręczne przygotowanie.
Omówienie interfejsu API
Kolekcja presentations udostępnia metody, które umożliwiają pobieranie i aktualizowanie elementów prezentacji.
Większość pracy z interfejsem Slides API będzie prawdopodobnie polegać na tworzeniu i aktualizowaniu prezentacji. Możesz to zrobić za pomocą metody batchUpdate. Przyjmuje ona listę obiektów Request, które umożliwiają m.in.:
- Utwórz slajdy
- Dodawanie elementów do slajdów, takich jak kształty czy tabele
- Wstawianie, zmienianie i usuwanie tekstu
- Stosowanie przekształceń do elementów
- Zmiana kolejności slajdów
Więcej informacji znajdziesz w artykule Aktualizacje zbiorcze. W przewodnikach dla początkujących znajdziesz prosty przykład kompleksowego użycia interfejsu API.
Struktura prezentacji
Prezentacja w interfejsie Slides API składa się ze stron, które zawierają elementy strony.
Identyfikator prezentacji można uzyskać z adresu URL:
https://docs.google.com/presentation/d/presentationId/edit
Identyfikator prezentacji to ciąg znaków zawierający litery, cyfry i niektóre 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 elementy stron są identyfikowane za pomocą identyfikatorów obiektów.
Strony
Prezentacje Google zawierają te rodzaje stron:
| Magistrowie | Wzorce slajdów określają domyślne style tekstu, tło i elementy strony, które pojawiają się na wszystkich slajdach korzystających z tego wzorca. Elementy strony, które muszą pojawiać się na wszystkich slajdach, należy dodać do wzorca. Większość prezentacji ma jeden wzorzec, ale niektóre mogą mieć kilka lub nie mieć żadnego. |
| Układy | Układy służą jako szablon domyślnego rozmieszczenia elementów strony na slajdach, które korzystają z układu. Każdy układ jest powiązany z jednym wzorcem. |
| Prezentacje | Te strony zawierają treści, które prezentujesz odbiorcom. Większość slajdów jest oparta na wzorcu i układzie. Możesz określić, którego układu chcesz użyć w przypadku każdego slajdu podczas jego tworzenia. |
| Uwagi | Te strony zawierają materiały do prezentacji, w tym kształt z notatkami prelegenta. Każdy slajd ma odpowiadającą mu stronę z notatkami. Za pomocą interfejsu Slides API można modyfikować tylko tekst w kształcie notatek prelegenta. |
| Wzorce notatek | Wzorzec notatek określa domyślne style tekstu i elementy strony dla wszystkich stron notatek. W interfejsie Slides API wzorce 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 pojedyncza jednostka. Można je razem przenosić, skalować i obracać. |
| Kształt | Prosty obiekt wizualny, np. prostokąty, elipsy i pola tekstowe. Kształty mogą zawierać tekst, dlatego są najczęściej używanymi elementami strony do tworzenia slajdów. |
| Obraz | Grafika zaimportowana do Prezentacji. |
| Wideo | Film zaimportowany do Prezentacji. |
| Linia | linię, krzywą lub łącznik. |
| Tabela | siatkę treści, |
| WordArt | Element tekstowy, który zachowuje się bardziej jak kształt. |
| SheetsChart | Wykres zaimportowany do Prezentacji z Arkuszy Google. |
Aktualizacje zbiorcze
Metoda batchUpdate umożliwia aktualizowanie wielu aspektów prezentacji. Zmiany są grupowane w partie, dzięki czemu w przypadku niepowodzenia jednej z nich żadna z pozostałych (potencjalnie zależnych) zmian nie zostanie zapisana.
Metoda batchUpdate działa poprzez pobieranie co najmniej 1 obiektu Request, z którego każdy określa pojedynczy rodzaj żądania do wykonania. Istnieje wiele różnych rodzajów żądań. Oto podział typów żądań na różne kategorie.
Metoda batchUpdate zwraca treść odpowiedzi, która zawiera odpowiedź na każde żądanie. Każda odpowiedź zajmuje ten sam indeks co odpowiednie żądanie. W przypadku żądań, dla których nie ma odpowiedniej odpowiedzi, odpowiedź pod tym indeksem będzie pusta. Różne żądania Create zwykle mają odpowiedzi, dzięki czemu znasz identyfikator nowo dodanego obiektu.
Praca z identyfikatorami obiektów
Prezentacja w interfejsie Slides API składa się ze stron i elementów strony. Obiekty te zawierają ciąg znaków identyfikatora obiektu, który jest unikalny w prezentacji.
Określanie identyfikatorów obiektów podczas tworzenia
Podczas tworzenia stron lub elementów stron za pomocą metody batchUpdate możesz opcjonalnie podać identyfikator obiektu dla nowego obiektu. Dzięki temu możesz utworzyć obiekt i zmodyfikować go w ramach tego samego żądania batchUpdate, co minimalizuje liczbę wywołań interfejsu Slides API i zmniejsza
wykorzystanie limitu.
W większości przypadków zalecamy wygenerowanie losowego identyfikatora obiektu. Jeśli na przykład używasz Javy, java.util.UUID.randomUUID().toString() powinno działać prawidłowo.
Jeśli aplikacja ma śledzić obiekty przez dłuższy czas, nie polegaj na identyfikatorze obiektu, ponieważ może się on zmienić. Więcej informacji znajdziesz w następnej sekcji.
Śledzenie obiektów bez użycia identyfikatora obiektu
Gdy wysyłasz żądanie do interfejsu Slides API, identyfikator obiektu jest zwykle zachowywany. (Wszelkie wyjątki są wymienione w dokumentacji referencyjnej metody). Utworzenie kopii całej prezentacji za pomocą interfejsu Drive API również zachowuje identyfikatory obiektów.
Nie możesz jednak zakładać, że identyfikator obiektu pozostanie niezmieniony po wprowadzeniu zmian w prezentacji w interfejsie Prezentacji. Jeśli na przykład ktoś użyje interfejsu Slides, aby skopiować i wkleić element strony, a następnie usunie oryginał, element strony będzie miał nowy, unikalny identyfikator, a identyfikator podany wcześniej przez interfejs API zostanie utracony. W związku z tym nie zalecamy przechowywania identyfikatorów obiektów w pamięci aplikacji. Zamiast tego znajdź obiekty w prezentacji według ich treści tekstowej lub tekstu alternatywnego.
Nowo utworzone prezentacje zwykle używają spójnego zestawu identyfikatorów domyślnych slajdów, wzorców i pól tekstowych. Te identyfikatory mogą się z czasem zmieniać, dlatego nie zalecamy korzystania z tej funkcji. Zamiast tego znajdź elementy, które chcesz zmodyfikować, używając obiektu prezentacji zwróconego przez wywołania funkcji create() lub get().