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 pada halaman.
revisionId

string

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

ID revisi bukan angka berurutan, melainkan string buram. Format ID revisi mungkin berubah dari waktu ke waktu. ID revisi yang ditampilkan hanya dijamin valid selama 24 jam setelah dikembalikan dan tidak dapat dibagikan ke 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, ID yang diubah 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 disetel jika pageType = SLIDE.
layoutProperties

object (LayoutProperties)

Properti spesifik tata letak. Hanya tetapkan jika pageType = LAYOUT.
notesProperties

object (NotesProperties)

Mencatat properti khusus. Hanya tetapkan jika pageType = NOTES.
masterProperties

object (MasterProperties)

Menguasai properti tertentu. Hanya tetapkan jika pageType = MASTER.

Jenis Halaman

Jenis halaman.

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

Elemen Halaman

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)
  }
  // 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, kombinasikan transformasi elemen halaman dengan transformasi semua grup induknya. Jika elemen halaman tidak ada dalam grup, transformasi absolutnya sama dengan nilai dalam 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 Elemen Halaman ini. Setiap pesan berisi properti yang khusus 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 generik.
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 tautannya dibatalkan akan ditampilkan sebagai gambar.

Grup

Jenis PageElement yang mewakili kumpulan Gabungan Elemen Halaman.

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

object (PageElement)

Kumpulan elemen dalam grup. Ukuran minimum grup adalah 2.

Seni Kata

Jenis PageElement yang merepresentasikan seni kata.

Representasi JSON 
{
  "renderedText": string
}
Kolom
renderedText

string

Teks yang dirender sebagai seni kata.

PropertiSlide

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 didasarkan pada slide ini. Properti ini bersifat hanya baca.
notesPage

object (Page)

Halaman catatan yang terkait dengan slide ini. Layanan 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 TUBUH 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).

LayoutLayout

Properti Page hanya relevan untuk halaman dengan LAYOUT 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.

CatatanProperti

Properti Page yang hanya relevan untuk halaman dengan CATATAN pageType.

Representasi JSON 
{
  "speakerNotesObjectId": string
}
Kolom
speakerNotesObjectId

string

ID objek dari bentuk pada halaman catatan ini yang berisi catatan pembicara untuk slide yang bersangkutan. Bentuk sebenarnya mungkin tidak selalu ada di halaman catatan. Menyisipkan teks menggunakan ID objek ini akan secara 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.

Properti Master

Properti Page yang hanya relevan untuk halaman dengan MASTER pageType.

Representasi JSON 
{
  "displayName": string
}
Kolom
displayName

string

Nama master yang dapat dibaca manusia.

HalamanProperti

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)

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

object (ColorScheme)

Skema warna halaman. Jika tidak disetel, skema warna diwarisi dari halaman induk. Jika halaman tidak memiliki induk, skema warna menggunakan skema warna Slide default, yang sesuai dengan setelan default di editor Slide.

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

Pengisian Latar Belakang Halaman

Latar belakang halaman 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 pengisian latar belakang.

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

object (SolidFill)

Pengisi warna solid.
stretchedPictureFill

object (StretchedPictureFill)

Pengisian gambar yang direntangkan.

PengisianGambarMelebar

Gambar yang direntangkan terisi. Halaman atau elemen halaman diisi seluruhnya dengan gambar yang ditentukan. Gambar direntangkan agar sesuai dengan penampungnya.

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

string

Membaca contentUrl:

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

Menulis contentUrl:

Gambar diambil sekali pada waktu penyisipan dan salinannya disimpan untuk tampilan di dalam presentasi. Gambar harus berukuran kurang dari 50 MB, tidak boleh melebihi 25 megapiksel, dan harus dalam salah satu format PNG, JPEG, atau GIF.

URL yang diberikan dapat mencapai maksimum 2 kB.
size

object (Size)

Ukuran asli gambar. Kolom ini bersifat hanya baca.

Skema Warna

Palet warna standar untuk halaman.

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

object (ThemeColorPair)

ThemeColorType dan pasangan warna konkret yang sesuai.

PasanganWarnaTema

Sepasang pemetaan 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 versi terbaru dari halaman yang ditentukan dalam presentasi dan menampilkan URL ke gambar thumbnail.