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 kliencie z bazy danych i połączyć je ze wstępnie zaprojektowanymi szablonami i wybranymi opcjami konfiguracji, aby szybciej stworzyć gotowe prezentacje i zająć się nimi ręcznie.

Omówienie interfejsu API

Kolekcja prezentacje zawiera metody, które umożliwiają pobieranie i aktualizowanie elementów prezentacji.

Większość pracy z interfejsem Prezentacji Google będzie prawdopodobnie dotyczyć tworzenia i aktualizowania prezentacji. Możesz to zrobić, korzystając z metody batchUpdate. Wykorzystuje ona 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. W przewodnikach dla początkujących znajdziesz prosty, kompleksowy przykład korzystania z interfejsu API.

Struktura prezentacji

Prezentacja w interfejsie Prezentacji API składa się ze stron, które zawierają elementy stron.

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 Arkuszy Google, możesz użyć poniższego wyrażenia regularnego:

/presentation/d/([a-zA-Z0-9-_]+)

Jeśli znasz interfejs Drive API, presentationId odpowiada identyfikatorowi zasobu Plik.

Strony i ich elementy są identyfikowane przez identyfikatory obiektów.

Pages

Prezentacje Google zawierają te rodzaje stron:

Magistrowie Główne elementy slajdów określają domyślne style tekstu, tło i elementy strony wyświetlane na wszystkich slajdach korzystających z tego wzorca. Elementy strony, które muszą pojawić się na wszystkich slajdach, należy dodać do wzorca. Większość prezentacji ma 1 element główny, ale niektóre mogą mieć kilka lub żadnego z nich.
Układy Układy służą jako szablon do domyślnego rozmieszczenia elementów strony na slajdach z wykorzystaniem układu. Każdy układ jest powiązany z jednym wzorcem.
Prezentacje Te strony zawierają treści, które chcesz pokazać swoim odbiorcom. Większość slajdów bazuje na elemencie nadrzędnym i układzie. Możesz określić układ, który ma być używany w przypadku poszczególnych slajdów podczas ich tworzenia.
Uwagi Te strony zawierają materiały potrzebne 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 notatek.
Mistrzowie notatek Mistrzowie notatek określają domyślne style tekstu i elementy stron dla wszystkich stron notatek. Elementy główne notatek są dostępne tylko do odczytu w interfejsie Prezentacji API.

Elementy strony

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

Grupa Zestaw elementów strony traktowanych jako pojedyncze jednostki. Można je jednocześnie 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 wykorzystywanymi elementami stron do tworzenia slajdów.
Obraz Grafika zaimportowana do Prezentacji.
Wideo Film zaimportowany do Prezentacji.
Liniowy Wizualna linia, krzywa lub połączenie.
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 pozwala aktualizować wiele aspektów prezentacji. Zmiany są grupowane w grupie, dzięki czemu jeśli jedno żądanie nie powiedzie się, nie są zapisywane żadne pozostałe (potencjalnie zależne) zmiany.

Metoda batchUpdate działa, przyjmując 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 zestawienie typów żądań pogrupowanych w różne kategorie.

Praca z Prezentacjami: CreateSlideRequest
UpdateSlidesPositionRequest
DuplicateObjectRequest
UpdatePagePropertiesRequest
DeleteObjectRequest
Praca z elementami strony: CreateShapeRequest
CreateLineRequest
UpdatePageElementTransformRequest
UpdateShapePropertiesRequest
DuplicateObjectRequest
DeleteObjectRequest
Praca z tabelami: CreateTableRequest
InsertTableRowsRequest
InsertTableColumnsRequest
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableRowPropertiesRequest
UpdateTableColumnPropertiesRequest
UpdateTableBorderPropertiesRequest
UpdateTableCellPropertiesRequest
MergeTableCellsRequest
UnmergeTableCellsRequest
DeleteObjectRequest
Praca z wykresami: CreateSheetsChartRequest
RefreshSheetsChartRequest
ReplaceAllShapesWithSheetsChartRequest
DeleteObjectRequest
Praca z obrazami i filmami: CreateImageRequest
CreateVideoRequest
UpdateImagePropertiesRequest
UpdateVideoPropertiesRequest
ReplaceAllShapesWithImageRequest
DuplicateObjectRequest
DeleteObjectRequest
Praca z tekstem: InsertTextRequest
DeleteTextRequest
ReplaceAllTextRequest
CreateParagraphBulletsRequest
DeleteParagraphBulletsRequest
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, 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 ich elementów za pomocą metody batchUpdate możesz opcjonalnie określić identyfikator nowego obiektu. Dzięki temu możesz utworzyć obiekt i zmodyfikować go w tym samym żądaniu wsadowym, co zminimalizuje liczbę wywołań interfejsu Prezentacji Google i zmniejszy wykorzystanie limitu.

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

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ą wywoływane w dokumentacji referencyjnej metody). Utworzenie kopii całej prezentacji za pomocą interfejsu Drive API również zachowuje identyfikatory obiektów.

Jednak po zmianie prezentacji w interfejsie Prezentacji nie będzie można polegać na tym, że identyfikator obiektu zostanie zmieniony. Jeśli na przykład ktoś użyje interfejsu Prezentacji Google, aby skopiować i wkleić element strony, a następnie usunąć oryginał, element ten będzie miał nowy unikalny identyfikator, a identyfikator podany wcześniej przez Ciebie za pomocą interfejsu API zostanie utracony. Dlatego nie zalecamy przechowywania identyfikatorów obiektów w pamięci aplikacji. Zamiast tego obiekty w prezentacji znajdziesz w tekście lub tekście alternatywnym.

Nowo utworzone prezentacje korzystają zwykle ze spójnego zestawu identyfikatorów dla domyślnych slajdów, wzorów 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ć, za pomocą obiektu prezentacji zwracanego przez wywołania create() lub get().