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 na prezentacjach wykonywane za pomocą 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 Google API, zapoznaj się z tymi przewodnikami:

Tworzenie prezentacji

Poniższy presentations.create przykładowy kod pokazuje, jak utworzyć pusty plik prezentacji o nazwie "Moja nowa prezentacja".

Puste pliki prezentacji można też tworzyć za pomocą metody Google Drive API files.create przez określenie application/vnd.google-apps.presentation jako typu 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 do zwracania listy plików prezentacji z Dysku, zawierającej 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 presentations.batchUpdate przykładowy kod pokazuje, jak użyć metody ReplaceAllTextRequest do zastąpienia 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.”. Obejmuje to tekst w polach tekstowych i innych kształtach, na slajdach oraz w slajdach wzorcowych. W tym przypadku zastępowanie tekstu uwzględnia wielkość liter, ponieważ matchCase jest ustawione na true.

Oto 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."
      }
    }
  ]
}