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 pembaruan untuk menyatakan bahwa revisi presentasi belum berubah sejak operasi baca terakhir. Hanya diisi jika pengguna memiliki akses edit ke presentasi.

ID revisi bukan angka berurutan, tetapi string buram. Format ID revisi dapat berubah dari waktu ke waktu. ID revisi yang dikembalikan hanya dijamin valid selama 24 jam setelah ID tersebut dikembalikan dan tidak dapat dibagikan ke pengguna lain. Jika ID revisi tidak berubah di antara panggilan, berarti presentasi belum berubah. Sebaliknya, ID yang diubah (untuk presentasi dan pengguna yang sama) biasanya berarti presentasi telah diperbarui. Namun, ID yang berubah 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 dapat berupa salah satu dari berikut:
slideProperties

object (SlideProperties)

Properti slide tertentu. Hanya ditetapkan jika pageType = SLIDE.
layoutProperties

object (LayoutProperties)

Tata letak properti tertentu. Hanya ditetapkan jika pageType = LAYOUT.
notesProperties

object (NotesProperties)

Mencatat properti tertentu. Hanya ditetapkan jika pageType = NOTES.
masterProperties

object (MasterProperties)

Menguasai properti tertentu. Hanya ditetapkan 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, lakukan pra-penggabungan transformasi elemen halaman dengan transformasi semua grup induknya. Jika elemen halaman tidak berada dalam grup, transformasi absolutnya 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 oleh PageElement ini. Setiap pesan berisi properti yang spesifik untuk jenis elemen halaman tersebut. element_kind hanya dapat berupa salah satu dari berikut:
elementGroup

object (Group)

Kumpulan elemen halaman yang digabungkan sebagai satu unit.
shape

object (Shape)

Bentuk umum.
image

object (Image)

Elemen halaman gambar.
video

object (Video)

Elemen halaman video.
line

object (Line)

Elemen halaman baris.
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 tidak ditautkan akan ditampilkan sebagai gambar.
speakerSpotlight

object (SpeakerSpotlight)

Sorotan Pembicara.

Grup

Jenis PageElement yang mewakili kumpulan PageElements yang digabungkan.

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

object (PageElement)

Kumpulan elemen dalam grup. Ukuran minimum grup adalah 2.

WordArt

Jenis PageElement yang mewakili word art.

Representasi JSON 
{
  "renderedText": string
}
Kolom
renderedText

string

Teks yang dirender sebagai kata seni.

SpeakerSpotlight

Jenis PageElement yang mewakili Sorotan Pembicara.

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

object (SpeakerSpotlightProperties)

Properti Video Pembicara.

SpeakerSpotlightProperties

Properti SpeakerSpotlight.

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

object (Outline)

Garis batas Sorotan Pembicara. Jika tidak ditetapkan, kolom ini tidak memiliki garis batas.
shadow

object (Shadow)

Bayangan Sorotan Pembicara. Jika tidak disetel, ikon 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 dikaitkan dengan slide ini. Format ini menentukan tampilan visual halaman catatan saat mencetak atau mengekspor slide dengan catatan pembicara. Halaman catatan mewarisi properti dari notes master. Bentuk placeholder dengan jenis BODY di halaman catatan berisi catatan pembicara untuk slide ini. ID bentuk ini diidentifikasi oleh 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 dalam mode presentasi. Nilai defaultnya adalah false (salah).

LayoutProperties

Properti Page hanya relevan untuk halaman dengan pageType LAYOUT.

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 NOTES.

Representasi JSON 
{
  "speakerNotesObjectId": string
}
Kolom
speakerNotesObjectId

string

ID objek bentuk di halaman catatan ini yang berisi catatan pembicara untuk slide yang sesuai. Bentuk sebenarnya mungkin tidak selalu ada di halaman catatan. Menyisipkan teks menggunakan ID objek ini akan otomatis membuat bentuk. 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)

Isi latar belakang halaman. Jika tidak disetel, isian latar belakang diwarisi dari halaman induk jika ada. Jika halaman tidak memiliki induk, isian latar belakang secara default akan menggunakan isian yang sesuai di editor Slide.
colorScheme

object (ColorScheme)

Skema warna pada halaman. Jika tidak disetel, skema warna akan diwarisi dari halaman induk. Jika halaman tidak memiliki induk, skema warna akan menggunakan skema warna Slide default, yang cocok dengan warna 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, skema warna yang berisi pemetaan dari semua 12 ThemeColorTypes pertama ke warna konkretnya harus disediakan. Warna untuk ThemeColorTypes yang tersisa akan diabaikan.

PageBackgroundFill

Isi latar belakang halaman.

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 isi latar belakang.

Memperbarui isi di halaman akan secara implisit memperbarui kolom ini menjadi RENDERED, kecuali jika nilai lain ditentukan dalam permintaan yang sama. Agar tidak ada isi di halaman, tetapkan kolom ini ke NOT_RENDERED. Dalam hal ini, kolom isi lainnya yang ditetapkan dalam permintaan yang sama akan diabaikan.
Kolom union kind. Jenis isi latar belakang. kind hanya dapat berupa salah satu dari berikut:
solidFill

object (SolidFill)

Isian warna solid.
stretchedPictureFill

object (StretchedPictureFill)

Isi gambar yang diregangkan.

StretchedPictureFill

Isi gambar yang direntangkan. Halaman atau elemen halaman diisi sepenuhnya dengan gambar yang ditentukan. Gambar diregangkan agar sesuai dengan penampung.

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 pun yang memiliki URL tersebut dapat mengakses gambar sebagai pemohon asli. Akses ke gambar dapat hilang jika setelan berbagi presentasi berubah.

Menulis contentUrl:

Gambar akan diambil satu kali pada waktu penyisipan dan salinannya disimpan untuk ditampilkan di dalam presentasi. Ukuran gambar harus kurang dari 50 MB, tidak boleh melebihi 25 megapiksel, dan harus dalam salah satu format PNG, JPEG, atau GIF.

Panjang URL yang diberikan maksimal 2 kB.
size

object (Size)

Ukuran asli isian gambar. Kolom ini bersifat hanya baca.

ColorScheme

Palet warna yang telah ditentukan untuk halaman.

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

object (ThemeColorPair)

ThemeColorType dan pasangan warna konkret yang sesuai.

ThemeColorPair

Pasangan 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 beton yang sesuai dengan jenis warna tema di atas.

Metode

get

 Mendapatkan versi terbaru halaman yang ditentukan dalam presentasi.

getThumbnail

 Membuat thumbnail versi terbaru halaman yang ditentukan dalam presentasi dan menampilkan URL ke gambar thumbnail.