Operacje prezentacji

Interfejs API Prezentacji Google umożliwia tworzenie plików prezentacji i zarządzanie istniejącymi. Przykłady na tej stronie pokazują kilka typowych operacji wyświetlania 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, zapoznaj się z tymi przewodnikami:

Tworzenie prezentacji

Poniższy przykładowy kod presentations.create pokazuje, jak utworzyć pusty plik prezentacji zatytułowany „Moja nowa prezentacja”.

Puste pliki prezentacji można też utworzyć przy użyciu metody files.create interfejsu Google Drive API, podając application/vnd.google-apps.presentation jako typ MIME.

Oto protokół żądań tworzenia prezentacji:

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

Wyświetlanie listy istniejących plików prezentacji

Interfejs Prezentacji API nie udostępnia metody pobierania listy prezentacji, ale interfejs Drive API ją udostępnia. Metoda files.list (poniżej) wykorzystuje maski pól do zwracania listy plików prezentacji z Twojego Dysku wraz z identyfikatorem, nazwą pliku i linkiem umożliwiającym otwarcie pliku. W żądaniu jest też określony typ MIME application/vnd.google-apps.presentation.

Oto protokół żądania do wyświetlania 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żyć metody ReplaceAllTextRequest do zastępowania tekstu w całej prezentacji wskazanej przez zmienną PRESENTATION_ID. Wartość identyfikatora prezentacji możesz znaleźć w adresie URL prezentacji.

Każde wystąpienie ciągu „Gizmo Corp.” jest zastępowane tekstem „Gadżet Inc.”. Dotyczy to także tekstu w polach tekstowych i innych kształtach, na slajdach i w elementach głównych. W tym przypadku wielkość liter w zastępowaniu tekstu jest rozróżniana, jeśli w polu matchCase ustawiona jest wartość true.

Oto protokół żądań 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."
      }
    }
  ]
}