Interfejs Google Slides API umożliwia tworzenie i modyfikowanie prezentacji w Prezentacjach Google.
Aplikacje mogą się integrować z interfejsem API Prezentacji Google, aby automatycznie tworzyć atrakcyjne prezentacje slajdów na podstawie danych użytkownika i systemu. Możesz na przykład użyć danych klientów z bazy danych i połączyć je z wstępnie zaprojektowanymi szablonami oraz wybranymi opcjami konfiguracji, aby w krótkim czasie utworzyć gotowe prezentacje.
Omówienie interfejsu API
Kolekcja prezentacje zawiera metody, które umożliwiają pobieranie i aktualizowanie elementów w prezentacji.
Większość Twojej pracy z interfejsem Slides API będzie polegać na tworzeniu i aktualizowaniu prezentacji. Aby to zrobić, użyj metody batchUpdate. Ta metoda przyjmuje listę obiektów Request, które umożliwiają wykonywanie takich czynności jak:
- 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 Zbiorcze aktualizacje. Aby zobaczyć prosty przykład korzystania z interfejsu API, zapoznaj się z przewodnikami na temat korzystania z niego.
Struktura prezentacji
Prezentacja w interfejsie Slides API składa się ze stron zawierających 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 ich elementy są identyfikowane za pomocą identyfikatorów obiektów.
Pages
Prezentacje Google zawierają te typy stron:
| Magistrowie | Wzorce slajdów definiują 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ą się pojawiać na wszystkich slajdach, należy dodać do szablonu. Większość prezentacji ma jeden plik główny, ale niektóre mogą mieć ich kilka lub żaden. |
| Układy | Układy służą jako szablony domyślnego rozmieszczenia elementów strony na slajdach. Każdy układ jest powiązany z jednym układem głównym. |
| Prezentacje | Te strony zawierają treści, które prezentujesz odbiorcom. Większość slajdów opiera się na szablonie i układzie. Podczas tworzenia slajdu możesz określić układ, którego chcesz użyć. |
| Uwagi | Te strony zawierają treści do rozdawania podczas prezentacji, w tym kształt zawierający notatki dla wykładowcy. Każdy slajd ma jedną odpowiadającą mu stronę z notatkami. Za pomocą interfejsu Slides API można modyfikować tylko tekst w kształcie notatek. |
| Pliki master notatek | Właściciele notatek definiują domyślne style tekstu i elementy stron dla wszystkich stron notatek. W interfejsie Slides API szablony notatek są tylko do odczytu. |
Elementy strony
Elementy strony to wizualne komponenty 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 przesuwać, skalować i obracać razem. |
| Kształt | Prosty obiekt wizualny, np. prostokąty, elipsy i pola tekstowe. Kształty mogą zawierać tekst, dlatego są to najczęściej używane elementy strony do tworzenia slajdów. |
| Obraz | Grafika zaimportowana do Prezentacji |
| Wideo | Film zaimportowany do Prezentacji. |
| Linia | Wizualna linia, krzywa lub łącznik. |
| Tabela | Siatka 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 partiach, aby w przypadku niepowodzenia jednego żądania żadne z innych (potencjalnie zależnych) zmian nie zostały zapisane.
Metoda batchUpdate działa, przyjmując co najmniej 1 obiekt Request, z których każdy określa jeden rodzaj żądania do wykonania. Istnieją różne rodzaje żądań. Oto podział typów żądań na różne kategorie.
Metoda batchUpdate zwraca treść odpowiedzi, która zawiera odpowiedź dla każdego żądania. Każda odpowiedź zajmuje ten sam indeks co odpowiadające jej żądanie. W przypadku żądań, które nie mają odpowiedniej odpowiedzi, odpowiedź na tym indeksie będzie pusta. Różne żądania Create mają zwykle odpowiedzi, dzięki czemu znasz identyfikator nowo dodanego obiektu.
Praca z identyfikatorami obiektów
Prezentacja w interfejsie Slides API składa się z stron i elementów strony. Te obiekty zawierają ciąg znaków identyfikatora obiektu, który jest unikalny w ramach prezentacji.
Określanie identyfikatorów obiektów podczas tworzenia
Podczas tworzenia stron lub elementów strony za pomocą metody batchUpdate możesz opcjonalnie określić identyfikator nowego obiektu. Dzięki temu możesz utworzyć obiekt i zmodyfikować go w ramach tego samego żądania zbiorczego, minimalizując liczbę wywołań interfejsu Slides API i zmniejszając wykorzystanie limitu.
W większości przypadków zalecamy generowanie losowego identyfikatora obiektu. Jeśli na przykład używasz Javy, funkcja java.util.UUID.randomUUID().toString() powinna działać dobrze.
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 sekcji poniżej.
Śledzenie obiektów bez używania identyfikatora obiektu
Gdy wysyłasz żądanie do interfejsu Slides API, identyfikator obiektu jest zwykle zachowany. (Wszelkie wyjątki są opisane w dokumentacji metody). Tworzenie kopii całej prezentacji za pomocą interfejsu Drive API również zachowuje identyfikatory obiektów.
Nie możesz jednak zakładać, że identyfikator obiektu nie ulegnie zmianie po zmianie prezentacji w interfejsie Slides. Jeśli na przykład ktoś użyje interfejsu Slides do skopiowania i wklejenia elementu 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 znajdź obiekty w prezentacji na podstawie ich tekstu lub tekstu alternatywnego.
Nowo utworzone prezentacje zwykle używają spójnego zestawu identyfikatorów domyślnych slajdów, szablonów i pól tekstowych. Te identyfikatory mogą się zmienić w trakcie użytkowania, dlatego nie zalecamy polegania na tej funkcji. Zamiast tego znajdź elementy, które chcesz zmodyfikować, za pomocą obiektu prezentacji zwróconego przez wywołania create() lub get().