Wprowadzenie

Interfejs 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 systemy. Możesz na przykład wykorzystać informacje o klientach z bazy danych i połączyć je z wstępnie przygotowanymi szablonami i wybranymi opcjami konfiguracji, aby szybko utworzyć gotowe prezentacje w krótkim czasie, który zajmuje utworzenie ich ręcznie.

Omówienie interfejsu API

Kolekcja Prezentacje udostępnia metody, które umożliwiają pobieranie i aktualizowanie elementów prezentowanych w obrębie prezentacji.

Większość Twojej pracy z interfejsem Prezentacji Google będzie zapewne dotyczyła tworzenia i aktualizowania prezentacji. Użyjesz do tego metody batchUpdate. Ta metoda pobiera listę obiektów Request, które umożliwiają:

  • 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. Prosty, kompleksowy przykład korzystania z interfejsu API znajdziesz w przewodnikach dla początkujących.

Struktura prezentacji

Prezentacja w interfejsie Prezentacji Google składa się ze stron, które zawierają różne elementy.

Identyfikator prezentacji może pochodzić 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 w Arkuszach Google, użyj 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 Elementy główne slajdów definiują domyślne style tekstu, tła i elementy strony wyświetlane 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 1 element główny, ale niektóre mogą mieć ich kilka lub nie zawierać żadnego.
Układy Układy służą jako szablon domyślnego układu elementów strony na slajdach. Każdy układ jest powiązany z 1 wzorcem.
Prezentacje Te strony zawierają treści, które udostępniasz odbiorcom. Większość slajdów bazuje na elemencie nadrzędnym i układzie. Możesz określić układ, który ma zostać użyty w przypadku każdego tworzonego slajdu.
Uwagi Te strony zawierają materiały do prezentacji, w tym kształt zawierający notatki na slajdzie. Każdemu slajdowi odpowiada 1 strona z notatkami. Za pomocą interfejsu Prezentacji można zmieniać tylko tekst notatek w kształcie prowadzącego.
Mistrzowie notatek Elementy główne notatek określają domyślne style tekstu i elementy stron dla wszystkich stron z notatkami. Wzorce notatek w interfejsie Prezentacji są dostępne tylko do odczytu.

Elementy strony

Elementy strony to komponenty wizualne umieszczone na stronach. Interfejs API udostępnia kilka rodzajów elementów strony:

Grupa Zestaw elementów strony traktowanych jako pojedyncza jednostka. Można je przenosić, skalować i obracać.
Kształt Zwykły obiekt wizualny, np. prostokąty, wielokropki i pola tekstowe. Kształty mogą zawierać tekst, dlatego są one najczęściej używanymi elementami stron w przypadku slajdów.
Obraz Grafika zaimportowana do Prezentacji.
Wideo Film zaimportowany do Prezentacji.
Liniowy Wizualna linia, krzywa lub łącznik.
Tabela Siatka treści.
Obiekt WordArt Wizualny element tekstowy, który zachowuje się bardziej jak kształt.
Wykres w Arkuszach Wykres zaimportowany do Prezentacji z Arkuszy Google.

Aktualizacje zbiorcze

Metoda batchUpdate pozwala aktualizować wiele aspektów prezentacji. Zmiany są grupowane w grupie, więc jeśli jedno żądanie nie powiedzie się, żadne inne (potencjalnie zależne) zmiany nie są zapisywane.

Metoda batchUpdate przyjmuje co najmniej 1 obiekt Request, z których każdy określa jeden rodzaj żądania do wykonania. Jest wiele różnych rodzajów wniosków. Oto podział typów żądań podzielonych na różne kategorie.

Praca z Prezentacjami: CreateSlideRequest
UpdateSlidesPositionRequest
DuplikatObjectRequest
UpdatePagePropertiesRequest
DeleteObjectRequest
Praca z elementami strony: Create shapeRequest .
CreateLineRequest
UpdatePageElementTransformRequest
UpdateConditionPropertiesRequest
DuplikatObjectRequest
DeleteObjectRequest
Praca z tabelami: CreateTableRequest .
InsertTableRowsRequest
InsertTableKolumnyRequest
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableRowPropertiesRequest
UpdateTableColumnPropertiesRequest :
UpdateTableBorderPropertiesRequest
UpdateTableCellPropertiesRequest
MergeTableCellsRequest
Wyodrębnij żądanieKomórkiTabeli
DeleteObjectRequest
Praca z wykresami: CreateSheetsChartRequest
refreshSheetsChartRequest
Zastąp wszystkieKształtyWithSheetsChartRequest
DeleteObjectRequest
Praca z obrazami i filmami: CreateImageRequest .
CreateVideoRequest .
UpdateImagePropertiesRequest
UpdateVideoPropertiesRequest
ReplaceAll shapesWithImageRequest
DuplikatObjectRequest
DeleteObjectRequest
Praca z tekstem: InsertTextRequest
DeleteTextRequest
ReplaceAllTextRequest
CreateParagraphsRequest
Żądanie usunięcia punktu widzenia
UpdateTextStyleRequest
UpdateParagraphStyleRequest

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, dzięki czemu znasz identyfikator nowo dodanego obiektu.

Praca z identyfikatorami obiektów

Prezentacja w interfejsie Prezentacji Google 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

Podczas tworzenia stron lub ich elementów przy użyciu 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 „BatchUpdate”, co zminimalizuje liczbę wywołań interfejsu Prezentacji Google i zmniejszy wykorzystanie limitu.

W większości przypadków zalecamy wygenerowanie losowego identyfikatora obiektu. Jeśli na przykład używasz Javy, parametr java.util.UUID.randomUUID().toString() powinien działać prawidłowo.

Identyfikator obiektu może się zmienić, gdy aplikacja chce śledzić obiekty przez dłuższy czas. Więcej informacji znajdziesz w sekcji poniżej.

Śledzenie obiektów bez korzystania z identyfikatora obiektu

Gdy wysyłasz żądanie do interfejsu Prezentacji API, identyfikator obiektu jest zwykle zachowywany. (Wszelkie wyjątki są wskazywane w dokumentacji referencyjnej metody). Utworzenie kopii całej prezentacji za pomocą interfejsu Drive API również spowoduje zachowanie identyfikatorów obiektów.

Nie możesz jednak polegać na tym, że identyfikator obiektu nie zostanie zmieniony po zmianie prezentacji w interfejsie Prezentacji. Jeśli np. ktoś kopiuje i wkleja element strony w interfejsie Prezentacji, a potem usuwa oryginał, ten element 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. Obiekty w prezentacji należy wyszukiwać według ich zawartości tekstowej lub alternatywnego.

Nowo utworzone prezentacje korzystają zwykle ze spójnego zestawu identyfikatorów dla domyślnych slajdów, elementów głównych i pól tekstowych. 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 zwracanego przez wywołania create() lub get().