REST Resource: presentations.pages

Resource: Halaman

Sebuah 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 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 ID tersebut dikembalikan dan tidak dapat dibagikan ke pengguna lain. Jika ID revisi tidak berubah di antara panggilan, presentasi tidak berubah. Sebaliknya, ID yang berubah (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 dapat berupa salah satu dari berikut:
slideProperties

object (SlideProperties)

Properti spesifik slide. Hanya tetapkan jika pageType = SLIDE.

layoutProperties

object (LayoutProperties)

Properti khusus tata letak. Hanya tetapkan jika pageType = LAYOUT.

notesProperties

object (NotesProperties)

Properti khusus catatan. Hanya disetel jika pageType = CATATAN.

masterProperties

object (MasterProperties)

Kuasai properti khusus. Hanya tetapkan jika pageType = MASTER.

PageType

Jenis halaman.

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

PageElement

Elemen visual yang dirender pada 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 dari 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 PageElement ini. Setiap pesan berisi properti apa pun 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 unit tunggal.

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 tertaut ditampilkan sebagai gambar.

speakerSpotlight

object (SpeakerSpotlight)

Sorotan Pembicara.

Grup

Jenis PageElement yang mewakili kumpulan gabungan PageElement.

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

object (PageElement)

Kumpulan elemen dalam grup. Ukuran grup minimum 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 mewakili 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 besar Sorotan Pembicara. Jika tidak disetel, kartu tidak akan 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. Fitur 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 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 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 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)

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 12 ThemeColorTypes pertama ke warna konkretnya harus diberikan. 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 isian latar belakang.

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

Kolom union kind. Jenis isian latar belakang. kind hanya dapat berupa salah satu dari berikut:
solidFill

object (SolidFill)

Isian warna solid.

stretchedPictureFill

object (StretchedPictureFill)

Isi gambar yang direntangkan.

StretchedPictureFill

Isian gambar yang direntangkan. Halaman atau elemen halaman diisi sepenuhnya dengan gambar yang ditentukan. Gambar direntangkan agar sesuai dengan container-nya.

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 secara efektif mengakses gambar sebagai pemohon asli. Akses ke gambar mungkin akan hilang jika setelan berbagi presentasi berubah.

Menulis contentUrl:

Gambar akan diambil satu kali pada waktu penyisipan dan salinannya 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.

Panjang URL yang diberikan maksimal 2 kB.

size

object (Size)

Ukuran asli isian gambar. Kolom ini bersifat hanya baca.

ColorScheme

Palet warna standar untuk sebuah halaman.

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

object (ThemeColorPair)

ThemeColorType dan pasangan warna konkret yang sesuai.

ThemeColorPair

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 tertentu dalam presentasi.

getThumbnail

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