Interfejs API Prezentacji Google umożliwia tworzenie i modyfikowanie prezentacji Google.
Aplikacje można zintegrować z interfejsem API Prezentacji Google, aby tworzyć atrakcyjne prezentacje automatycznie na podstawie danych przekazywanych przez użytkowników i systemów. Możesz na przykład: wykorzystuj dane klienta z bazy danych i łącz je ze wstępnie zaprojektowanymi szablonów i wybranych opcji konfiguracji w celu tworzenia gotowych prezentacji. w bardzo krótkim czasie.
Omówienie interfejsu API
Kolekcja Prezentacje zapewnia które pozwalają pobierać i aktualizować elementy w prezentacji.
Większość pracy w interfejsie Prezentacji API będzie pewnie dotyczyć tworzenia i aktualizowania. prezentacje. Użyjesz do tego celu batchUpdate; ta metoda pobiera listę Wyślij prośbę dzięki którym możesz:
- 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. Zobacz przewodniki dla początkujących To prosty, kompleksowy przykład korzystania z interfejsu API.
Struktura prezentacji
Prezentacja w interfejsie Prezentacji API składa się ze stron, które zawierają .
Identyfikator prezentacji może pochodzić z adresu URL:
https://docs.google.com/presentation/d/presentationId/edit
Identyfikator prezentacji jest ciągiem znaków zawierającym litery, cyfry i znaki specjalne znaków. Możesz użyć poniższego wyrażenia regularnego do wyodrębnienia Identyfikator prezentacji z adresu URL Arkuszy Google:
/presentation/d/([a-zA-Z0-9-_]+)
Jeśli znasz interfejs Drive API, presentationId
odpowiada
Identyfikator pliku.
.
Strony i ich elementy są identyfikowane za pomocą identyfikatorów obiektów.
Pages
Prezentacje Google zawierają następujące rodzaje stron:
Magistrowie | Miary slajdów określają domyślne style tekstu, tło i stronę elementów występujących na wszystkich slajdach, w których używany jest ten element główny. Strona elementy, które muszą występować na wszystkich slajdach, należy dodać do wzorca. Większość w prezentacjach jest jeden element nadrzędny, ale niektóre mogą mieć kilka lub żadne. |
Układy | Układy to szablon rozmieszczenia elementów strony domyślnie na slajdach z zastosowaniem układu. Każdy układ jest powiązany z jednym 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. Możesz określić, który ma być używany na każdym slajdzie podczas jego tworzenia. |
Uwagi | Strony te zawierają materiały do prezentacji, w tym kształt zawierający notatki dla prelegenta na slajdzie. Każdy slajd przedstawia jeden odpowiednią stronę z uwagami. Można użyć tylko tekstu w kształcie notatek zmodyfikowane przy użyciu interfejsu API Prezentacji. |
Mistrzowie notatek | Szablony notatek definiują domyślne style tekstu i elementy strony dla wszystkich stronach z uwagami. W interfejsie Prezentacji API dokumenty główne notatek są tylko do odczytu. |
Elementy strony
Elementy strony to komponenty wizualne umieszczane na stronach. Interfejs API ujawnia kilka rodzajów elementów strony:
Grupa | Zestaw elementów strony traktowanych jako osobna jednostka. Mogą mogą być jednocześnie przesuwać, skalowane i obracane. |
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 slajdach. |
Obraz | Grafika zaimportowana do Prezentacji Google. |
Wideo | Film zaimportowany do Prezentacji Google. |
Linia | 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 elementów prezentacji. Zmiany są grupowane w wsadę, dzięki której w przypadku niepowodzenia jednego żądania nie następuje żadne z pozostałych (potencjalnie zależne). zmiany są zapisywane.
Metoda batchUpdate
działa, gdy
Wyślij prośbę
każdy z nich określa jeden rodzaj żądania do wykonania. Istnieją
do zgłaszania wielu różnych rodzajów próśb. Oto zestawienie typów żądań:
pogrupowane według różnych kategorii.
Metoda batchUpdate
zwraca treść odpowiedzi,
zawierający znak
Odpowiedź
dla każdego żądania. Każda odpowiedź zajmuje ten sam indeks co odpowiednia
żądania; w przypadku żądań bez odpowiedniej odpowiedzi, odpowiedź w tym indeksie
– wartość 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. Obiekty te zawierają ciąg identyfikatora obiektu, który jest unikalny w obrębie prezentacji.
Określanie identyfikatorów obiektów podczas tworzenia
Tworząc strony lub elementy strony za pomocą batchUpdate, może opcjonalnie określić identyfikator nowego obiektu. Dzięki temu możesz utworzyć i zmodyfikuje go w tym samym żądaniu wsadowym, minimalizując liczbę wywołań interfejsu Prezentacji API i ograniczać wykorzystanie limitu.
W większości przypadków zalecamy generowanie losowego identyfikatora obiektu. Jeśli na przykład
używa języka Java, java.util.UUID.randomUUID().toString()
powinien działać dobrze.
Gdy aplikacja chce śledzić obiekty w dłuższym okresie Nie polegaj na identyfikatorze obiektu, bo może się on zmienić. Zobacz poniższe informacje .
Śledzenie obiektów bez użycia identyfikatora obiektu
Po przesłaniu żądania do interfejsu Prezentacji API identyfikator obiektu jest zwykle zachowywany. (Dowolnie są wymienione w dokumentacji metody). Tworzenie kopii całej prezentacji za pomocą interfejsu Drive API zachowuje też identyfikatory obiektów.
Nie możesz jednak polegać na tym, że identyfikator obiektu nie zmienia się po prezentacji został zmieniony w interfejsie Prezentacji. Na przykład jeśli użytkownik korzysta z Prezentacji Interfejs umożliwiający skopiowanie i wklejenie elementu strony, a następnie usunięcie oryginalnego elementu strony. otrzyma teraz nowy, unikalny identyfikator oraz identyfikator podany wcześniej za pośrednictwem interfejsu API zostaną utracone. Dlatego nie zalecamy przechowywania identyfikatorów obiektów ilość miejsca na dane aplikacji. Obiekty w prezentacji należy znajdować poprzez jego zawartości tekstowej lub tekstu alternatywnego.
Nowo utworzone prezentacje zwykle domyślnie używają spójnego zestawu identyfikatorów slajdy, elementy główne i pola tekstowe. Identyfikatory mogą się z czasem zmieniać, więc nie zalecamy polegania na tej funkcji. Zamiast tego znajdź elementy którą chcesz zmodyfikować za pomocą obiektu prezentacji zwracanego przez wywołania create() lub get().