Method: presentations.create

Tworzy pustą prezentację z tytułem podanym w żądaniu. Jeśli podano presentationId, jest ono używane jako identyfikator nowej prezentacji. W przeciwnym razie generowany jest nowy identyfikator. Pozostałe pola w żądaniu, w tym podana treść, są ignorowane. Zwraca utworzoną prezentację.

Żądanie HTTP

POST https://slides.googleapis.com/v1/presentations

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "presentationId": string,
  "pageSize": {
    object (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  },
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode)
}
Pola
presentationId

string

Identyfikator prezentacji.
pageSize

object (Size)

Rozmiar stron w prezentacji.
slides[]

object (Page)

Slajdy w prezentacji. Slajd dziedziczy właściwości z układu slajdu.
title

string

Tytuł prezentacji.
masters[]

object (Page)

Wzorce slajdów w prezentacji. Wzorzec slajdów zawiera wszystkie wspólne elementy strony i wspólne właściwości zestawu układów. Służą one do 3 celów:

  • Kształty zastępcze we wzorcu zawierają domyślne style tekstu i właściwości kształtu wszystkich kształtów zastępczych na stronach, które używają tego wzorca.
  • Właściwości strony wzorcowej określają wspólne właściwości strony dziedziczone przez jej układy.
  • Wszystkie inne kształty na slajdzie wzorcowym pojawiają się na wszystkich slajdach, które używają tego wzorca, niezależnie od ich układu.
layouts[]

object (Page)

Układy w prezentacji. Układ to szablon, który określa, jak treści są rozmieszczane i stylizowane na slajdach dziedziczących z tego układu.
locale

string

Ustawienia regionalne prezentacji jako tag języka IETF BCP 47.
revisionId

string

Tylko dane wyjściowe. Identyfikator wersji prezentacji. Może być używany w żądaniach aktualizacji, aby potwierdzić, że wersja prezentacji nie zmieniła się od ostatniej operacji odczytu. Wypełniane tylko wtedy, gdy użytkownik ma uprawnienia do edycji prezentacji.

Identyfikator wersji nie jest liczbą kolejną, ale niejasnym ciągiem znaków. Format identyfikatora wersji może się z czasem zmienić, dlatego należy go traktować jako nieprzezroczysty. Zwrócony identyfikator wersji jest ważny tylko przez 24 godziny od jego zwrócenia i nie można go udostępniać innym użytkownikom. Jeśli identyfikator wersji nie zmieni się między wywołaniami, oznacza to, że prezentacja nie uległa zmianie. Z kolei zmiana identyfikatora (w przypadku tej samej prezentacji i użytkownika) zwykle oznacza, że prezentacja została zaktualizowana. Zmiana identyfikatora może być jednak spowodowana również czynnikami wewnętrznymi, takimi jak zmiany formatu identyfikatora.
notesMaster

object (Page)

Wzorzec notatek w prezentacji. Służy on do 3 celów:

  • Kształty zastępcze we wzorcu notatek zawierają domyślne style tekstu i właściwości kształtu wszystkich kształtów zastępczych na notes pages. W szczególności kształt zastępczy SLIDE_IMAGE zawiera miniaturę slajdu, a kształt zastępczy BODY – notatki prelegenta.
  • Właściwości strony wzorcowej notatek określają wspólne właściwości strony dziedziczone przez wszystkie notes pages.
  • Wszystkie inne kształty we wzorcu notatek pojawiają się na wszystkich notes pages.

Wzorzec notatek jest tylko do odczytu.
comments[]

object (CommentThread)

Tylko dane wyjściowe. Wątki komentarzy powiązane z prezentacją.

commentsViewMode

enum (CommentsViewMode)

Tylko dane wyjściowe. Tryb wyświetlania komentarzy zastosowany do prezentacji.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję Presentation.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations

Więcej informacji znajdziesz w przewodniku Autoryzacja.