Operacje prezentacji

Interfejs API Prezentacji Google umożliwia tworzenie plików prezentacji i zarządzanie istniejącymi. Przykłady na tej stronie pokazują typowe operacje dotyczące wyświetlania strony za pomocą metody presentations.batchUpdate.

Te przykłady są przedstawione jako żądania HTTP, aby były neutralne pod względem 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 kod presentations.create pokazuje, jak utworzyć pusty plik prezentacji o nazwie „Moja nowa prezentacja”.

Puste pliki prezentacji można też tworzyć za pomocą interfejsu Google Drive API, korzystając z metody files.create i podając jako typ MIME wartość application/vnd.google-apps.presentation.

Oto protokół żądania tworzenia 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 udostępnia ją Drive API. Metoda files.list (opisana poniżej) używa masek pól, aby zwrócić listę plików prezentacji z Dysku, wraz z identyfikatorem pliku, jego nazwą i linkiem do otwarcia. Prośba określa również application/vnd.google-apps.presentation jako typ MIME.

Oto protokół żądania 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 następującą 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 za pomocą metody ReplaceAllTextRequest zastąpić tekst w całej prezentacji określony przez parametr PRESENTATION_ID. Wartość identyfikatora prezentacji możesz 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 oraz w szablonach. W tym przypadku wielkość liter ma znaczenie, ponieważ ustawienie matchCase zostało zmienione na true.

Oto protokół żądania zastąpienia tekstu w prezentacji:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "replaceAllText": {
          "containsText": {
            "text": "Gizmo Corp.",
            "matchCase": true
          },
          "replaceText": "Gadget Inc."
      }
    }
  ]
}