Method: presentations.create

Tworzy pustą prezentację z tytułem podanym w żądaniu. Jeśli podany zostanie identyfikator presentationId, zostanie on użyty jako identyfikator nowej prezentacji. W przeciwnym razie zostanie wygenerowany nowy identyfikator. Pozostałe pola w żądaniu, łącznie z podaną 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)
  }
}
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)

Slajdy w prezentacji. Wzorzec slajdu zawiera wszystkie typowe elementy strony i właściwości wspólne dla zestawu układów. Służą one trzem celom:

  • Kształty zastępcze w elemencie głównym zawierają domyślne style tekstu i właściwości kształtów wszystkich kształtów zastępczych na stronach, które używają danego elementu głównego.
  • Właściwości strony głównej określają wspólne właściwości strony dziedziczone przez jej układy.
  • Wszelkie inne kształty na slajdzie głównym będą widoczne na wszystkich slajdach korzystających z tego elementu głównego, niezależnie od ich układu.
layouts[]

object (Page)

Układy w prezentacji. Układ to szablon określający sposób rozmieszczenia i stylu treści na slajdach dziedziczących ten układ.
locale

string

Język 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. To pole jest wypełniane tylko wtedy, gdy użytkownik ma uprawnienia do edycji prezentacji.

Identyfikator wersji nie jest kolejnym numerem, ale mglistym ciągiem znaków. Format identyfikatora wersji może się zmieniać z czasem, dlatego identyfikator powinien być nieprzezroczysty. Gwarantujemy, że zwrócony identyfikator wersji będzie ważny tylko przez 24 godziny po zwróceniu i nie będzie można go udostępniać użytkownikom. Jeśli identyfikator wersji nie zmienia się między wywołaniami, prezentacja nie uległa zmianie. Jeśli natomiast zmienisz identyfikator (dla tej samej prezentacji i tego samego użytkownika), oznacza to, że prezentacja została zaktualizowana. Jednak zmiana identyfikatora może wynikać z czynników wewnętrznych, takich jak zmiana formatu identyfikatora.
notesMaster

object (Page)

Mistrz notatek w prezentacji. Spełnia trzy cele:

  • Kształty zastępcze w elemencie głównym notatek zawierają domyślne style tekstu i właściwości kształtu wszystkich kształtów zastępczych w elemencie notes pages. Kształt zastępczy SLIDE_IMAGE zawiera miniaturę slajdu, a kształt zastępczy BODY – notatki.
  • Właściwości strony głównej notatek definiują wspólne właściwości strony dziedziczone przez wszystkie elementy notes pages.
  • Wszelkie inne kształty we wzorcu notatek będą widoczne we wszystkich elementach notes pages.

Główny notatki jest przeznaczony tylko do odczytu.

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 protokołu 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 na temat autoryzacji.