REST Resource: presentations.pages

Resource: Halaman

Halaman dalam presentasi.

Representasi JSON 
{
  "objectId": string,
  "pageType": enum (PageType),
  "pageElements": [
    {
      object (PageElement)
    }
  ],
  "revisionId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "commentAnchors": [
    {
      object (CommentAnchor)
    }
  ],
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of mutually exclusive fields.
}
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 menegaskan bahwa revisi presentasi tidak berubah sejak operasi baca terakhir. Hanya diisi jika pengguna memiliki akses edit ke presentasi.

ID revisi bukan berupa angka berurutan, 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 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.
commentAnchors[]

object (CommentAnchor)

Hanya output. Anchor komentar yang ada di halaman.

comments[]

object (CommentThread)

Hanya output. Rangkaian komentar yang terkait dengan halaman. Hanya diisi jika halaman diambil melalui GetPageRequest dengan commentsViewMode yang diisi. Jika tidak, komentar akan ditampilkan di Presentation melalui GetPresentationRequest.

commentsViewMode

enum (CommentsViewMode)

Hanya output. Mode tampilan komentar yang diterapkan ke halaman. Hanya diisi jika halaman diambil melalui GetPageRequest dengan commentsViewMode yang diisi.

Properti yang khusus untuk setiap jenis halaman. Master tidak memerlukan properti tambahan. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
slideProperties

object (SlideProperties)

Slide properti tertentu. Hanya ditetapkan jika pageType = SLIDE.
layoutProperties

object (LayoutProperties)

Properti khusus tata letak. 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.
Akhir kolom yang saling eksklusif.

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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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 mutually exclusive fields.
}
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 terlebih dahulu transformasi elemen halaman dengan transformasi semua grup induknya. Jika elemen halaman tidak berada 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. Digabungkan dengan deskripsi untuk menampilkan teks alternatif.

Kolom tidak didukung untuk elemen Group.
description

string

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

Kolom tidak didukung untuk elemen Group.
Jenis elemen yang diwakili oleh PageElement ini. Setiap pesan berisi properti apa pun yang khusus untuk jenis elemen halaman tersebut. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
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 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 tidak ditautkan ditampilkan sebagai gambar.
speakerSpotlight

object (SpeakerSpotlight)

Video Pembicara.
Akhir kolom yang saling eksklusif.

Grup

Jenis PageElement yang merepresentasikan kumpulan PageElement yang digabungkan.

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

object (PageElement)

Kumpulan elemen dalam grup. Ukuran minimum grup adalah 2.

WordArt

Jenis PageElement yang merepresentasikan 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 batas Video Pembicara. Jika tidak disetel, tidak ada garis batas.
shadow

object (Shadow)

Bayangan Sorotan Pembicara. Jika tidak ditetapkan, tidak ada 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. Setelan 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 di 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 diwarisi dari halaman induk jika ada. Jika halaman tidak memiliki induk, pengisian latar belakang akan menggunakan pengisian yang sesuai di editor Slide secara default.
colorScheme

object (ColorScheme)

Skema warna 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 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 ThemeColorType pertama ke warna konkretnya harus diberikan. Warna untuk ThemeColorTypes yang tersisa akan diabaikan.

PageBackgroundFill

Pengisian latar belakang halaman.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of mutually exclusive fields.
}
Kolom
propertyState

enum (PropertyState)

Status properti pengisian latar belakang.

Memperbarui pengisian di halaman akan secara implisit memperbarui kolom ini menjadi RENDERED, kecuali jika nilai lain ditentukan dalam permintaan yang sama. Untuk tidak mengisi halaman, tetapkan kolom ini ke NOT_RENDERED. Dalam hal ini, kolom pengisian lainnya yang ditetapkan dalam permintaan yang sama akan diabaikan.
Jenis pengisian latar belakang. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
solidFill

object (SolidFill)

Isian warna solid.
stretchedPictureFill

object (StretchedPictureFill)

Pengisian gambar yang direntangkan.
Akhir kolom yang saling eksklusif.

StretchedPictureFill

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

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 dapat hilang jika setelan berbagi presentasi berubah.

Menulis contentUrl:

Gambar diambil sekali 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 format PNG, JPEG, atau GIF.

URL yang diberikan dapat memiliki panjang maksimal 2 kB.
size

object (Size)

Ukuran asli pengisi 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.

CommentAnchor

Berisi daftar semua lokasi dalam Page yang ditambatkan ke CommentThread melalui anchorId yang sama. Beberapa anchor terpisah dapat merujuk ke lokasi yang sama, baik dalam Page maupun di berbagai halaman,

Representasi JSON 
{
  "anchorId": string,
  "objectAnchors": [
    {
      object (ObjectAnchor)
    }
  ]
}
Kolom
anchorId

string

Hanya output. ID unik penanda komentar.
objectAnchors[]

object (ObjectAnchor)

Hanya output. Semua lokasi berbasis ID objek dalam halaman yang merujuk ke ID anchor.

ObjectAnchor

Mewakili data penanda komentar yang terkait dengan objek Slide, misalnya Page atau PageElement.

Representasi JSON 
{
  "objectId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "shapeTextAnchors": {
    object (ShapeTextAnchors)
  },
  "tableCellAnchors": {
    object (TableCellAnchors)
  }
  // End of mutually exclusive fields.
}
Kolom
objectId

string

Hanya output. Halaman atau elemen halaman tempat rangkaian komentar ditambatkan.
Hanya output. Rentang teks dalam elemen halaman yang menjadi tempat rangkaian komentar ditambatkan. Akan kosong jika anchor komentar ditujukan untuk seluruh halaman atau elemen halaman, bukan rentang teks dalam elemen. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
shapeTextAnchors

object (ShapeTextAnchors)

Diisi untuk Shapes yang memiliki komentar yang ditambatkan ke rentang teks dalam [text][google.apps.slides.v1.Shape.TextContent] bentuk.
tableCellAnchors

object (TableCellAnchors)

Diisi untuk Tables yang memiliki komentar yang ditambatkan ke rentang teks dalam satu atau beberapa sel tabel.
Akhir kolom yang saling eksklusif.

ShapeTextAnchors

Menampilkan rentang teks dalam bentuk yang dicakup oleh penanda komentar.

Representasi JSON 
{
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
Kolom
ranges[]

object (TextRange)

Daftar rentang teks yang dicakup oleh penanda komentar.

TextRange

Menentukan rentang teks yang berdekatan dalam text bentuk atau sel tabel.

Representasi JSON 
{
  "startIndex": integer,
  "endIndex": integer
}
Kolom
startIndex

integer

Indeks berbasis nol dari rentang awal. Kolom ini adalah Int32Value untuk mengakomodasi kasus penggunaan mendatang dengan rentang terbuka.
endIndex

integer

Indeks berbasis nol dari akhir rentang. Kolom ini adalah Int32Value untuk mengakomodasi kasus penggunaan mendatang dengan rentang terbuka.

TableCellAnchors

Mewakili rentang sel tabel dalam tabel yang dicakup oleh penanda komentar.

Representasi JSON 
{
  "cellRanges": [
    {
      object (TableCellTextRanges)
    }
  ]
}
Kolom
cellRanges[]

object (TableCellTextRanges)

Daftar semua sel tabel dalam tabel yang memiliki teks yang tercakup oleh penanda dalam tabel.

TableCellTextRanges

Menampilkan rentang teks dalam sel tabel yang dicakup oleh penanda komentar.

Representasi JSON 
{
  "cellLocation": {
    object (TableCellLocation)
  },
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
Kolom
cellLocation

object (TableCellLocation)

Lokasi sel tabel.
ranges[]

object (TextRange)

Daftar semua rentang teks yang dicakup oleh penanda di sel ini.

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.