Interfejs API Prezentacji Google umożliwia tworzenie plików prezentacji i zarządzanie istniejącymi.
Na tej stronie znajdziesz przykłady typowych operacji na prezentowaniu stron za pomocą metody presentations.batchUpdate
.
Te przykłady są prezentowane jako żądania HTTP bez względu na język. Aby dowiedzieć się, jak wdrożyć aktualizację zbiorczą w różnych językach za pomocą bibliotek klienta interfejsu API Google, przeczytaj te przewodniki:
- Tworzenie prezentacji i zarządzanie nimi
- Wyszukiwanie plików i folderów
- Scalanie danych w prezentację
Tworzenie prezentacji
Poniższy przykładowy kod presentations.create
pokazuje, jak utworzyć pusty plik prezentacji o nazwie „Moja nowa prezentacja”.
Możesz też utworzyć puste pliki prezentacji za pomocą metody files.create
interfejsu Google Drive API. W tym celu wybierz application/vnd.google-apps.presentation
jako typ MIME.
Poniżej znajduje się protokół żądania do utworzenia prezentacji:
POST https://slides.googleapis.com/v1/presentations
{ "title": "My New Presentation" }
Wyświetl listę istniejących plików prezentacji
Interfejs Prezentacji Google nie zapewnia metody pobierania listy prezentacji, ale Drive API tak.
Metoda files.list
(przedstawiona poniżej) używa masek pól do zwracania listy plików do prezentacji z Twojego Dysku, zawierających identyfikator, nazwę pliku i link umożliwiający jego otwarcie. W żądaniu typ MIME jest też określony w żądaniu application/vnd.google-apps.presentation
.
Poniżej znajduje się protokół żądania do wyświetlenia listy istniejących plików prezentacji:
GET https://www.googleapis.com/drive/v3/files?q="mimeType=application/vnd.google-apps.presentation"&fields=files(id,name,webViewLink)
Odpowiedź na to żądanie ma taką strukturę:
{ "files": [ { "id": "abcdefghijklmnopqrstuvwxyz0123456789", "name": "Project Vision", "webViewLink": "https://docs.google.com/a/google.com/presentation/d/abcdefghijklmnopqrstuvwxyz0123456789/edit?usp=drivesdk" }, { "id": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789", "name": "Untitled Presentation", "webViewLink": "https://docs.google.com/a/google.com/presentation/d/ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/edit?usp=drivesdk" }, ... ] }
Zastępowanie tekstu w całej prezentacji
Z przykładowego kodu presentations.batchUpdate
poniżej dowiesz się, jak za pomocą metody ReplaceAllTextRequest
zastępować tekst w całej prezentacji (określony przez PRESENTATION_ID). Wartość identyfikatora prezentacji znajdziesz w adresie URL prezentacji.
Każde wystąpienie ciągu „Gizmo Corp.” jest zastępowane tekstem „Gadżet Inc.”. Dotyczy to tekstu w polach tekstowych i innych kształtach, na slajdach i w elementach nadrzędnych. W tym przypadku zastępowanie tekstu ma znaczenie, jeśli ustawisz w polu matchCase
wartość true
.
Poniżej znajduje się protokół żądania do zastępowania tekstu w całej prezentacji:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "replaceAllText": { "containsText": { "text": "Gizmo Corp.", "matchCase": true }, "replaceText": "Gadget Inc." } } ] }