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 prezentacji 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 określając application/vnd.google-apps.presentation jako typ MIME.

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 robi to 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 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 tekstu w polach tekstowych i innych kształtach, na slajdach oraz w szablonach. W tym przypadku wielkość liter w zastępowaniu tekstu jest rozróżniana, jeśli w polu matchCase ustawiona jest wartość 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."
      }
    }
  ]
}