Wprowadzenie

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 systemy. 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. Znaleziono do zgłaszania wielu różnych rodzajów próśb. Oto zestawienie typów żądań: pogrupowane według różnych kategorii.

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, 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 wysł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().