Operacje prezentacji

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

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