Wstęp

Interfejs API Prezentacji Google pozwala tworzyć i modyfikować prezentacje Google.

Aplikacje mogą integrować się z interfejsem Google Slides API, aby automatycznie tworzyć atrakcyjne prezentacje na podstawie danych przesłanych przez użytkownika i system. Możesz na przykład użyć szczegółów klientów z bazy danych i połączyć je ze wstępnie przygotowanymi szablonami oraz wybranymi opcjami konfiguracji, aby utworzyć gotowe prezentacje w mgnieniu oka.

Omówienie interfejsu API

Kolekcja Prezentacje zawiera metody umożliwiające pobieranie i aktualizowanie elementów w prezentacji.

Większość zadań związanych z interfejsem API do tworzenia prezentacji będzie prawdopodobnie obejmować tworzenie i aktualizowanie prezentacji. Należy to zrobić przy użyciu metody batchUpdate. Ta metoda pobiera listę obiektów Request, które pozwalają na:

  • Utwórz slajdy
  • Dodawanie elementów do slajdów, takich jak kształty lub tabele
  • Wstawianie, zmienianie i usuwanie tekstu
  • Stosowanie przekształceń do elementów
  • Zmiana kolejności slajdów

Więcej informacji znajdziesz w sekcji Aktualizacje zbiorcze. Prosty, kompleksowy przykład korzystania z interfejsu API znajdziesz w Przewodnikach dla początkujących.

Struktura prezentacji

Prezentacja w interfejsie API Prezentacji składa się ze stron, które zawierają 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 Arkuszy Google:

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

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

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

Pages

Prezentacje Google mają następujące rodzaje stron:

Magistrowie Główne wzorce definiują domyślne style tekstu, tła i elementów strony, które są wyświetlane na wszystkich slajdach korzystających z tego wzorca. Elementy strony, które muszą występować na wszystkich slajdach, powinny być dodane do wzorca. Większość prezentacji ma jeden wzorzec, ale niektóre mogą mieć ich kilka lub nie zawierają żadnych.
Układy Układy stanowią szablon określający domyślne rozmieszczanie elementów strony na slajdach przy użyciu układu. Każdy układ jest powiązany z jednym wzorem.
Prezentacje Te strony zawierają treści, które prezentujesz odbiorcom. Większość slajdów jest tworzona na podstawie wzorca i układu strony. Możesz określić, którego układu użyć w przypadku każdego slajdu.
Uwagi Te strony zawierają treść prezentacji, w tym kształt zawierający notatki dla prelegenta na slajdzie. Do każdego slajdu jest przypisana jedna strona z notatkami. Za pomocą interfejsu Slides API można modyfikować tylko tekst w kształcie notatek.
Notatki nadrzędne Główne wzorce określają domyślne style tekstu i elementy stron dla wszystkich stron notatek. Wzorce mastera Notes w interfejsie API Prezentacji są dostępne 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 przenosić, skalować i obracać razem.
Kształt Zwykły obiekt wizualny, taki jak prostokąty, wielokropki czy pola tekstowe. Kształty mogą zawierać tekst, więc są najczęściej używanymi elementami strony podczas tworzenia slajdów.
Obraz Grafika zaimportowana do Prezentacji.
Wideo Film zaimportowany do Prezentacji.
Linia Wizualna linia, krzywa lub oprogramowanie sprzęgające.
Tabela Siatka treści.
Obiekt WordArt Wizualny element tekstowy przypominający kształt.
Wykresy Arkuszy Wykres zaimportowany do Prezentacji z Arkuszy Google.

Aktualizacje zbiorcze

Metoda batchUpdate umożliwia aktualizowanie wielu aspektów prezentacji. Zmiany są grupowane, dzięki czemu w przypadku niepowodzenia jednego żądania nie są zapisywane żadne inne (potencjalnie zależne) zmiany.

Metoda batchUpdate działa przez pobieranie co najmniej 1 obiektu Request, z którego każdy określa 1 rodzaj żądania do wykonania. Istnieje wiele różnych rodzajów żądań. Poniżej przedstawiamy podział typów żądań na różne kategorie.

Praca z Prezentacjami: CreateSlajdRequest
UpdateSlajdsPositionRequest
Duplikat obiektu
UpdatePagePropertiesRequest
DeleteObjectRequest
Praca z elementami strony: CreateShapeRequest
CreateLineRequest
UpdatePageElementTransformRequest
UpdateShapePropertiesRequest
Duplikat obiektu
DeleteObjectRequest
Praca z tabelami: CreateTableRequest
InsertTableRowsRequest
Wstaw kolumnę tabel
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableRowProperties
UpdateRequestColumnProperties
UpdateTableBorderPropertiesRequest
UpdateTableCellPropertiesRequest
Żądanie MergeTableCells
Żądanie scalania komórek
DeleteObjectRequest
Praca z wykresami: CreateSheetChartRequest
RefreshRefreshChartRequest
Zastąp wszystkokształtywykresów_żądania
DeleteObjectRequest
Praca z obrazami i filmami: CreateImageRequest
CreateVideoRequest
UpdateImagePropertiesRequest
UpdateVideoPropertiesRequest
ReplaceAllShapesWithImageRequest
Duplikat obiektu
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. Odpowiedź, która nie zawiera odpowiedniej odpowiedzi, jest pusta. Różne żądania Create zazwyczaj zwracają odpowiedzi, dzięki czemu znasz identyfikator nowo dodanego obiektu.

Praca z identyfikatorami obiektów

Prezentacja w interfejsie API Prezentacji składa się ze stron i elementów stron. Te obiekty zawierają ciąg identyfikatora obiektu, który jest unikalny w prezentacji.

Określanie identyfikatorów obiektów podczas tworzenia

Podczas tworzenia stron lub elementów strony przy użyciu 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 UpdateUpdate, co minimalizuje liczbę wywołań interfejsu API Prezentacji i zmniejsza limit wykorzystania.

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

Gdy aplikacja chce śledzić obiekty przez dłuższy czas, nie polegaj na ich identyfikatorach, bo mogą one ulec zmianie. Więcej informacji znajdziesz w sekcji poniżej.

Śledzenie obiektów bez użycia ich identyfikatora

Podczas wysyłania żądania do interfejsu API identyfikator obiektu jest zwykle zachowywany. (wyjątki są wymienione w dokumentacji referencyjnej metody). Tworzenie kopii całej prezentacji za pomocą interfejsu Drive API także zachowuje identyfikatory obiektów.

Nie możesz jednak polegać na tym, że identyfikator obiektu pozostaje bez zmian po zmianie prezentacji w interfejsie Prezentacji. Jeśli na przykład użytkownik używa interfejsu Prezentacji do kopiowania i wklejania elementu strony, a następnie usuwa oryginał, ten element będzie teraz miał nowy unikalny identyfikator, a identyfikator podany wcześniej za pomocą interfejsu 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 zawartości lub tekstu alternatywnego.

Nowo utworzone prezentacje zwykle mają spójny zestaw identyfikatorów na potrzeby slajdów domyślnych, wzorcowych oraz pól tekstowych. Identyfikatory te mogą się zmieniać z czasem, 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 create() lub get().