Method: presentations.create

Tworzy pustą prezentację z tytułem podanym w żądaniu. Jeśli podano presentationId, jest on używany jako identyfikator nowej prezentacji. W przeciwnym razie generowany jest nowy identyfikator. Pozostałe pola w żądaniu, w tym podane treści, 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)

wzorców slajdów w prezentacji; Wzorzec slajdów zawiera wszystkie typowe elementy strony i typowe właściwości zestawu układów. Pełnią one 3 funkcje:

  • Kształty zastępcze na 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, które są dziedziczone przez jej układy.
  • Wszystkie inne kształty na slajdzie wzorcowym pojawiają się na wszystkich slajdach korzystających z tego wzorca, niezależnie od ich układu.
layouts[]

object (Page)

układy w prezentacji, Układ to szablon, który określa sposób rozmieszczenia i formatowania treści na slajdach, które dziedziczą ten układ.
locale

string

Lokalizacja 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 sprawdzić, czy od ostatniej operacji odczytu wersja prezentacji nie uległa zmianie. Wypełniane tylko wtedy, gdy użytkownik ma uprawnienia do edycji prezentacji.

Identyfikator wersji nie jest liczbą porządkową, 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 momentu zwrócenia i nie można go udostępniać innym użytkownikom. Jeśli identyfikator wersji nie zmienia się między wywołaniami, prezentacja nie uległa zmianie. Z kolei zmieniony identyfikator (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 zmiana formatu identyfikatora.
notesMaster

object (Page)

wzorzec notatek w prezentacji; Spełnia 3 funkcje:

  • Kształty zastępcze na wzorcu notatek zawierają domyślne style tekstu i właściwości kształtów 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 zawiera notatki prelegenta.
  • Właściwości wzorca notatek określają wspólne właściwości strony dziedziczone przez wszystkie notes pages.
  • Wszystkie inne kształty na 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 utworzone wystąpienie elementu 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 po autoryzacji.