REST Resource: presentations.pages

Resource: Halaman

Halaman dalam presentasi.

Representasi JSON
{
  "objectId": string,
  "pageType": enum (PageType),
  "pageElements": [
    {
      object (PageElement)
    }
  ],
  "revisionId": string,
  "pageProperties": {
    object (PageProperties)
  },

  // Union field properties can be only one of the following:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of list of possible types for union field properties.
}
Kolom
objectId

string

ID objek untuk halaman ini. ID objek yang digunakan oleh Page dan PageElement memiliki namespace yang sama.

pageType

enum (PageType)

Jenis halaman.

pageElements[]

object (PageElement)

Elemen halaman yang dirender di halaman.

revisionId

string

Hanya output. ID revisi presentasi. Dapat digunakan dalam permintaan update untuk menyatakan bahwa revisi presentasi belum berubah sejak operasi baca terakhir. Hanya diisi jika pengguna memiliki akses edit ke presentasi.

ID revisi bukan nomor urut, melainkan string buram. Format ID revisi dapat berubah dari waktu ke waktu. ID revisi yang dikembalikan hanya dijamin valid selama 24 jam setelah dikembalikan dan tidak dapat dibagikan kepada seluruh pengguna. Jika ID revisi tidak berubah di antara panggilan, presentasi tidak akan berubah. Sebaliknya, ID yang diubah (untuk presentasi dan pengguna yang sama) biasanya berarti presentasi telah diperbarui. Namun, perubahan ID juga dapat disebabkan oleh faktor internal seperti perubahan format ID.

pageProperties

object (PageProperties)

Properti halaman.

Kolom union properties. Properti yang spesifik untuk setiap jenis halaman. Master tidak memerlukan properti tambahan. properties hanya ada berupa salah satu diantara berikut:
slideProperties

object (SlideProperties)

Properti khusus slide. Hanya setel jika pageType = SLIDE.

layoutProperties

object (LayoutProperties)

Properti khusus tata letak. Hanya tetapkan jika pageType = TATA LETAK.

notesProperties

object (NotesProperties)

Properti khusus catatan. Hanya tetapkan jika pageType = NOTES.

masterProperties

object (MasterProperties)

Kuasai properti khusus. Hanya tetapkan jika pageType = MASTER.

PageType

Jenis halaman.

Enum
SLIDE Halaman slide.
MASTER Halaman slide master.
LAYOUT Halaman tata letak.
NOTES Halaman catatan.
NOTES_MASTER Halaman master catatan.

PageElement

Elemen visual yang dirender di halaman.

Representasi JSON
{
  "objectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  },
  "title": string,
  "description": string,

  // Union field element_kind can be only one of the following:
  "elementGroup": {
    object (Group)
  },
  "shape": {
    object (Shape)
  },
  "image": {
    object (Image)
  },
  "video": {
    object (Video)
  },
  "line": {
    object (Line)
  },
  "table": {
    object (Table)
  },
  "wordArt": {
    object (WordArt)
  },
  "sheetsChart": {
    object (SheetsChart)
  },
  "speakerSpotlight": {
    object (SpeakerSpotlight)
  }
  // End of list of possible types for union field element_kind.
}
Kolom
objectId

string

ID objek untuk elemen halaman ini. ID objek yang digunakan oleh google.apps.slides.v1.Page dan google.apps.slides.v1.PageElement memiliki namespace yang sama.

size

object (Size)

Ukuran elemen halaman.

transform

object (AffineTransform)

Transformasi elemen halaman.

Tampilan visual elemen halaman ditentukan oleh transformasi absolutnya. Untuk menghitung transformasi absolut, gabungkan transformasi elemen halaman dengan transformasi semua grup induknya. Jika elemen halaman tidak berada dalam grup, transformasi absolutnya akan sama dengan nilai di kolom ini.

Transformasi awal untuk Group yang baru dibuat selalu merupakan transformasi identitas.

title

string

Judul elemen halaman. Dikombinasikan dengan deskripsi untuk menampilkan teks alternatif.

Kolom ini tidak didukung untuk elemen Group.

description

string

Deskripsi elemen halaman. Dikombinasikan dengan judul untuk menampilkan teks alternatif.

Kolom ini tidak didukung untuk elemen Group.

Kolom union element_kind. Jenis elemen yang diwakili PageElement ini. Setiap pesan berisi properti yang spesifik untuk jenis elemen halaman tersebut. element_kind hanya ada berupa salah satu diantara berikut:
elementGroup

object (Group)

Kumpulan elemen halaman yang digabungkan sebagai unit tunggal.

shape

object (Shape)

Bentuk generik.

image

object (Image)

Elemen halaman gambar.

video

object (Video)

Elemen halaman video.

line

object (Line)

Elemen halaman garis.

table

object (Table)

Elemen halaman tabel.

wordArt

object (WordArt)

Elemen halaman seni kata.

sheetsChart

object (SheetsChart)

Diagram tertaut yang disematkan dari Google Spreadsheet. Diagram yang dibatalkan tautannya ditampilkan sebagai gambar.

speakerSpotlight

object (SpeakerSpotlight)

Sorotan Pembicara.

Grup

Jenis PageElement yang mewakili kumpulan gabungan PageElements.

Representasi JSON
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
Kolom
children[]

object (PageElement)

Kumpulan elemen dalam grup. Ukuran minimum grup adalah 2.

WordArt

Jenis PageElement yang mewakili seni kata.

Representasi JSON
{
  "renderedText": string
}
Kolom
renderedText

string

Teks yang dirender sebagai seni kata.

SpeakerSpotlight

Jenis PageElement yang merepresentasikan Sorotan Pembicara.

Representasi JSON
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
Kolom
speakerSpotlightProperties

object (SpeakerSpotlightProperties)

Properti Sorotan Pembicara.

SpeakerSpotlightProperties

Properti SpeakerSpotlight.

Representasi JSON
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
Kolom
outline

object (Outline)

Garis batas Sorotan Pembicara. Jika tidak disetel, data tidak akan memiliki garis batas.

shadow

object (Shadow)

Bayangan Sorotan Pembicara. Jika tidak disetel, cakupan tidak akan memiliki bayangan.

SlideProperties

Properti Page yang hanya relevan untuk halaman dengan pageType SLIDE.

Representasi JSON
{
  "layoutObjectId": string,
  "masterObjectId": string,
  "notesPage": {
    object (Page)
  },
  "isSkipped": boolean
}
Kolom
layoutObjectId

string

ID objek tata letak yang menjadi dasar slide ini. Properti ini bersifat hanya baca.

masterObjectId

string

ID objek master yang menjadi dasar slide ini. Properti ini bersifat hanya baca.

notesPage

object (Page)

Halaman catatan yang terkait dengan slide ini. Mendefinisikan tampilan visual halaman catatan saat mencetak atau mengekspor slide dengan catatan pembicara. Halaman catatan mewarisi properti dari notes master. Bentuk {i>placeholder<i} dengan jenis BODY pada halaman catatan berisi catatan pembicara untuk slide ini. ID bentuk ini diidentifikasi dengan kolom speakerNotesObjectId. Halaman catatan bersifat hanya baca, kecuali untuk konten teks dan gaya bentuk catatan pembicara. Properti ini bersifat hanya baca.

isSkipped

boolean

Apakah slide dilewati atau tidak dalam mode presentasi. Nilai defaultnya adalah false (salah).

LayoutProperties

Properti Page hanya relevan untuk halaman dengan TATA LETAK pageType.

Representasi JSON
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
Kolom
masterObjectId

string

ID objek master yang menjadi dasar tata letak ini.

name

string

Nama tata letak.

displayName

string

Nama tata letak yang dapat dibaca manusia.

NotesProperties

Properti Page yang hanya relevan untuk halaman dengan pageType CATATAN.

Representasi JSON
{
  "speakerNotesObjectId": string
}
Kolom
speakerNotesObjectId

string

ID objek dari bentuk pada halaman catatan ini yang berisi catatan pembicara untuk slide yang sesuai. Bentuk yang sebenarnya mungkin tidak selalu ada di halaman catatan. Menyisipkan teks menggunakan ID objek ini akan membuat bentuk secara otomatis. Dalam hal ini, bentuk sebenarnya mungkin memiliki ID objek yang berbeda. Tindakan presentations.get atau pages.get akan selalu menampilkan ID objek terbaru.

MasterProperties

Properti Page yang hanya relevan untuk halaman dengan pageType MASTER.

Representasi JSON
{
  "displayName": string
}
Kolom
displayName

string

Nama master yang dapat dibaca manusia.

PageProperties

Properti Page.

Halaman akan mewarisi properti dari halaman induk. Bergantung pada jenis halaman, hierarki ditentukan dalam SlideProperties atau LayoutProperties.

Representasi JSON
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
Kolom
pageBackgroundFill

object (PageBackgroundFill)

Isian latar belakang halaman. Jika tidak disetel, isian latar belakang akan diwariskan dari halaman induk jika ada. Jika halaman tidak memiliki induk, maka isian latar belakang akan ditetapkan secara default ke isian yang sesuai di editor Slide.

colorScheme

object (ColorScheme)

Skema warna halaman. Jika tidak disetel, skema warna akan diwariskan dari halaman induk. Jika halaman tidak memiliki induk, skema warna akan menggunakan skema warna Slide default, yang cocok dengan default di editor Slide.

Hanya warna konkret dari 12 ThemeColorType pertama yang dapat diedit. Selain itu, hanya skema warna di halaman Master yang dapat diperbarui. Untuk memperbarui kolom ini, skema warna yang berisi pemetaan dari 12 ThemeColorTypes pertama ke warna konkretnya harus diberikan. Warna untuk ThemeColorTypes yang tersisa akan diabaikan.

PageBackgroundFill

Latar belakang layar akan terisi.

Representasi JSON
{
  "propertyState": enum (PropertyState),

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of list of possible types for union field kind.
}
Kolom
propertyState

enum (PropertyState)

Status properti isian latar belakang.

Memperbarui isian pada halaman akan secara implisit memperbarui kolom ini menjadi RENDERED, kecuali jika nilai lain ditentukan dalam permintaan yang sama. Agar tidak ada pengisian di halaman, tetapkan kolom ini ke NOT_RENDERED. Dalam hal ini, kolom isian lain yang ditetapkan dalam permintaan yang sama akan diabaikan.

Kolom union kind. Jenis isian latar belakang. kind hanya ada berupa salah satu diantara berikut:
solidFill

object (SolidFill)

Isian warna solid.

stretchedPictureFill

object (StretchedPictureFill)

Isi gambar melebar.

StretchedPictureFill

Isi gambar yang direntangkan. Elemen halaman atau halaman diisi seluruhnya dengan gambar yang ditentukan. Gambar direntangkan agar sesuai dengan kontainernya.

Representasi JSON
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
Kolom
contentUrl

string

Membaca contentUrl:

URL ke gambar dengan masa aktif default 30 menit. URL ini diberi tag dengan akun pemohon. Siapa saja yang memiliki URL secara efektif mengakses gambar sebagai pemohon asli. Akses ke gambar mungkin hilang jika setelan berbagi presentasi berubah.

Menulis contentUrl:

Gambar diambil satu kali pada waktu penyisipan dan salinan disimpan untuk ditampilkan di dalam presentasi. Gambar harus berukuran kurang dari 50 MB, tidak boleh lebih dari 25 megapiksel, dan harus dalam format PNG, JPEG, atau GIF.

URL yang diberikan tidak boleh melebihi 2 kB.

size

object (Size)

Ukuran asli isian gambar. Kolom ini bersifat hanya baca.

ColorScheme

Palet warna yang telah ditentukan untuk sebuah halaman.

Representasi JSON
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Kolom
colors[]

object (ThemeColorPair)

ThemeColorType dan pasangan warna konkret yang sesuai.

ThemeColorPair

Sepasang yang memetakan jenis warna tema ke warna konkret yang diwakilinya.

Representasi JSON
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
Kolom
type

enum (ThemeColorType)

Jenis warna tema.

color

object (RgbColor)

Warna konkret yang sesuai dengan jenis warna tema di atas.

Metode

get

Mendapatkan versi terbaru dari halaman yang ditentukan dalam presentasi.

getThumbnail

Menghasilkan thumbnail dari versi terbaru halaman yang ditentukan dalam presentasi dan mengembalikan URL ke gambar thumbnail.