Operacje prezentacji

Interfejs Google Slides API umożliwia tworzenie plików prezentacji i zarządzanie istniejącymi. Przykłady na tej stronie pokazują niektóre typowe operacje prezentacji strony z użyciem metody presentations.batchUpdate.

Przykłady te są przedstawione jako żądania HTTP, aby były niezależne od języka. Aby dowiedzieć się, jak zaimplementować aktualizację zbiorczą w różnych językach za pomocą bibliotek klienta interfejsu Google API, zapoznaj się z tymi przewodnikami:

Tworzenie prezentacji

Poniższy przykładowy kodpresentations.create pokazuje, jak utworzyć pusty plik prezentacji o nazwie „My New Presentation” (Moja nowa prezentacja).

Możesz też utworzyć puste pliki prezentacji za pomocą metody files.create interfejsu Google Drive API, określając application/vnd.google-apps.presentation jako typ MIME.

Oto protokół żądania utworzenia prezentacji:

POST https://slides.googleapis.com/v1/presentations
 
{
  "title": "My New Presentation"
}

Wyświetlanie listy istniejących plików prezentacji

Interfejs Slides API nie udostępnia metody pobierania listy prezentacji, ale interfejs Drive API tak. Metoda files.list (przedstawiona poniżej) używa masek pól, aby zwrócić listę plików prezentacji z Dysku, zawierającą identyfikator pliku, nazwę pliku i link do otwarcia pliku. Żądanie określa też application/vnd.google-apps.presentation jako typ MIME.

Oto protokół żądania 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

Poniższy przykładowy kod presentations.batchUpdate pokazuje, jak używać metody ReplaceAllTextRequest do zastępowania tekstu w całej prezentacji określonej przez PRESENTATION_ID. Wartość identyfikatora prezentacji można znaleźć w adresie URL prezentacji.

Każde wystąpienie ciągu znaków „Gizmo Corp.” jest zastępowane tekstem „Gadget Inc.”. Dotyczy to tekstu w polach tekstowych i innych kształtach, na slajdach i w szablonach. W tym przypadku wielkość liter ma znaczenie, ponieważ ustawienie matchCase ma wartość true.

Poniżej znajdziesz protokół żądania zastąpienia 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."
      }
    }
  ]
}