REST Resource: presentations.pages

แหล่งข้อมูล: หน้า

หน้าในงานนําเสนอ

การแสดง 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.
}
ช่อง
objectId

string

รหัสออบเจ็กต์สําหรับหน้านี้ รหัสออบเจ็กต์ที่ Page และ PageElement ใช้ร่วมกันจะใช้เนมสเปซเดียวกัน
pageType

enum (PageType)

ประเภทของหน้า
pageElements[]

object (PageElement)

องค์ประกอบของหน้าที่แสดงผลในหน้าเว็บ
revisionId

string

เอาต์พุตเท่านั้น รหัสการแก้ไขของงานนําเสนอ ใช้ในคําขออัปเดตเพื่อยืนยันว่าไม่มีการเปลี่ยนแปลงงานนําเสนอนับตั้งแต่การดําเนินการอ่านครั้งล่าสุด ข้อมูลจะปรากฏก็ต่อเมื่อผู้ใช้มีสิทธิ์แก้ไขงานนําเสนอ

รหัสการแก้ไขไม่ใช่ตัวเลขตามลําดับ แต่เป็นสตริงที่คลุมเครือ รูปแบบของรหัสการแก้ไขอาจเปลี่ยนแปลงเมื่อเวลาผ่านไป รหัสการแก้ไขที่แสดงผลจะรับประกันว่าจะใช้ได้เป็นเวลา 24 ชั่วโมงหลังจากได้รับการคืนสินค้าเท่านั้น และไม่สามารถแชร์กับผู้ใช้ได้ หากรหัสการแก้ไขไม่มีการเปลี่ยนแปลงระหว่างการโทร งานนําเสนอจะไม่เปลี่ยนแปลง ในทางกลับกัน รหัสที่เปลี่ยนแปลง (สําหรับงานนําเสนอและผู้ใช้เดียวกัน) มักจะหมายถึงงานนําเสนอได้รับการอัปเดตแล้ว อย่างไรก็ตาม รหัสที่เปลี่ยนแปลงอาจเกิดจากปัจจัยภายใน เช่น การเปลี่ยนแปลงรูปแบบรหัส
pageProperties

object (PageProperties)

พร็อพเพอร์ตี้ของหน้าเว็บ
ช่อง Union properties พร็อพเพอร์ตี้ที่เฉพาะเจาะจงสําหรับแต่ละประเภทหน้าเว็บ ต้นฉบับไม่จําเป็นต้องมีพร็อพเพอร์ตี้เพิ่มเติม properties ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
slideProperties

object (SlideProperties)

เลื่อนพร็อพเพอร์ตี้แบบเจาะจง ตั้งค่าก็ต่อเมื่อ pageType = SLIDE
layoutProperties

object (LayoutProperties)

พร็อพเพอร์ตี้ที่เจาะจงของเลย์เอาต์ ตั้งค่าเมื่อ pageType = LAYOUT เท่านั้น
notesProperties

object (NotesProperties)

ระบุพร็อพเพอร์ตี้ที่ต้องการ ตั้งค่าเมื่อ pageType = หมายเหตุเท่านั้น
masterProperties

object (MasterProperties)

ระบุพร็อพเพอร์ตี้ที่เฉพาะเจาะจง ตั้งค่าเมื่อ pageType = MASTER เท่านั้น

ประเภทหน้าเว็บ

ประเภทของหน้า

Enum
SLIDE หน้าสไลด์
MASTER หน้าสไลด์หลัก
LAYOUT หน้าเลย์เอาต์
NOTES หน้าโน้ต
NOTES_MASTER หน้าต้นฉบับโน้ต

องค์ประกอบของหน้า

องค์ประกอบภาพที่แสดงผลในหน้าเว็บ

การแสดง 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.
}
ช่อง
objectId

string

รหัสออบเจ็กต์สําหรับองค์ประกอบของหน้านี้ รหัสออบเจ็กต์ที่ google.apps.slides.v1.Page และ google.apps.slides.v1.PageElement ใช้ร่วมกันจะใช้เนมสเปซเดียวกัน
size

object (Size)

ขนาดขององค์ประกอบหน้าเว็บ
transform

object (AffineTransform)

การเปลี่ยนองค์ประกอบของหน้า

ลักษณะที่มองเห็นได้ขององค์ประกอบหน้าเว็บกําหนดโดยการแปลงแบบสัมบูรณ์ หากต้องการคํานวณการเปลี่ยนสัมบูรณ์ ให้แปลงรูปแบบองค์ประกอบของหน้ากับการเปลี่ยนของกลุ่มหลักทั้งหมด หากองค์ประกอบของหน้าไม่อยู่ในกลุ่ม การแปลงสัมบูรณ์จะเหมือนกันกับค่าในช่องนี้

การเปลี่ยนรูปแบบครั้งแรกสําหรับ Group ที่สร้างขึ้นใหม่คือการเปลี่ยนข้อมูลประจําตัวเสมอ
title

string

ชื่อองค์ประกอบของหน้า รวมกับคําอธิบายเพื่อแสดงข้อความแสดงแทน

ช่องนี้ไม่รองรับองค์ประกอบ Group
description

string

คําอธิบายองค์ประกอบของหน้าเว็บ รวมกับชื่อเพื่อแสดงข้อความแสดงแทน

ช่องนี้ไม่รองรับองค์ประกอบ Group
ช่อง Union element_kind ประเภทองค์ประกอบที่ PageElement แสดง แต่ละข้อความจะมีพร็อพเพอร์ตี้เฉพาะสําหรับองค์ประกอบของหน้าเว็บประเภทนั้นๆ element_kind ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
elementGroup

object (Group)

คอลเล็กชันขององค์ประกอบหน้าเว็บจะรวมกันเป็นหน่วยเดียว
shape

object (Shape)

รูปร่างทั่วไป
image

object (Image)

องค์ประกอบของหน้ารูปภาพ
video

object (Video)

องค์ประกอบของหน้าวิดีโอ
line

object (Line)

องค์ประกอบของหน้ารายการโฆษณา
table

object (Table)

องค์ประกอบของหน้าตาราง
wordArt

object (WordArt)

องค์ประกอบหน้าศิลป์
sheetsChart

object (SheetsChart)

แผนภูมิที่ลิงก์ที่ฝังจาก Google ชีต แผนภูมิที่ยกเลิกการลิงก์แล้วจะแสดงเป็นรูปภาพ

กลุ่ม

ประเภท PageElement ที่แสดงชุดองค์ประกอบของหน้าเว็บที่เข้าร่วม

การแสดง JSON 
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
ช่อง
children[]

object (PageElement)

คอลเล็กชันขององค์ประกอบในกลุ่ม ขนาดต่ําสุดของกลุ่มคือ 2

ศิลปะ WordArt

ประเภท PageElement ที่แสดงถึงข้อความศิลป์

การแสดง JSON 
{
  "renderedText": string
}
ช่อง
renderedText

string

ข้อความที่แสดงผลเป็นข้อความศิลป์

คุณสมบัติสไลด์

พร็อพเพอร์ตี้ของ Page ที่เกี่ยวข้องกับหน้าเว็บที่มี pageType SLIDE เท่านั้น

การแสดง JSON 
{
  "layoutObjectId": string,
  "masterObjectId": string,
  "notesPage": {
    object (Page)
  },
  "isSkipped": boolean
}
ช่อง
layoutObjectId

string

รหัสออบเจ็กต์ของเลย์เอาต์ที่สไลด์นี้อิงตาม พร็อพเพอร์ตี้นี้เป็นแบบอ่านอย่างเดียว
masterObjectId

string

รหัสออบเจ็กต์ของต้นแบบที่สไลด์นี้อิงตาม พร็อพเพอร์ตี้นี้เป็นแบบอ่านอย่างเดียว
notesPage

object (Page)

หน้าโน้ตที่เชื่อมโยงกับสไลด์นี้ ซึ่งจะกําหนดลักษณะที่ปรากฏของหน้าโน้ตเมื่อพิมพ์หรือส่งออกสไลด์ด้วยบันทึกของผู้บรรยาย หน้าโน้ตจะรับช่วงพร็อพเพอร์ตี้จาก notes master รูปร่างของตัวยึดตําแหน่งที่มีประเภท Body ในหน้าโน้ตมีบันทึกของผู้บรรยายสําหรับสไลด์นี้ ID ของรูปร่างนี้จะระบุโดยช่อง speakerNotesObjectId หน้าหมายเหตุเป็นแบบอ่านอย่างเดียว ยกเว้นเนื้อหาข้อความและรูปแบบของรูปร่างบันทึกของผู้บรรยาย พร็อพเพอร์ตี้นี้เป็นแบบอ่านอย่างเดียว
isSkipped

boolean

เลือกว่าจะข้ามสไลด์ในโหมดงานนําเสนอหรือไม่ ค่าเริ่มต้นจะเป็น "เท็จ"

พร็อพเพอร์ตี้เลย์เอาต์

พร็อพเพอร์ตี้ Page เกี่ยวข้องกับหน้าเว็บที่มี pageType LAYOUT เท่านั้น

การแสดง JSON 
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
ช่อง
masterObjectId

string

รหัสออบเจ็กต์ของต้นแบบที่เลย์เอาต์นี้ตั้งอยู่
name

string

ชื่อของเลย์เอาต์
displayName

string

ชื่อเลย์เอาต์ที่มนุษย์อ่านได้

พร็อพเพอร์ตี้โน้ต

พร็อพเพอร์ตี้ของ Page ที่เกี่ยวข้องกับหน้าเว็บที่มี pageType NoteS เท่านั้น

การแสดง JSON 
{
  "speakerNotesObjectId": string
}
ช่อง
speakerNotesObjectId

string

รหัสออบเจ็กต์ของรูปร่างในหน้าโน้ตนี้ที่มีบันทึกของผู้บรรยายสําหรับสไลด์ที่เกี่ยวข้อง รูปร่างที่แท้จริงอาจไม่มีอยู่บนหน้าโน้ตเสมอไป การแทรกข้อความโดยใช้รหัสออบเจ็กต์นี้จะสร้างรูปร่างโดยอัตโนมัติ ในกรณีนี้ รูปร่างจริงอาจมีรหัสออบเจ็กต์อื่น การดําเนินการ presentations.get หรือ pages.get จะแสดงรหัสออบเจ็กต์ล่าสุดเสมอ

พร็อพเพอร์ตี้หลัก

พร็อพเพอร์ตี้ของ Page ที่เกี่ยวข้องกับหน้าเว็บที่มี pageMA MASTER เท่านั้น

การแสดง JSON 
{
  "displayName": string
}
ช่อง
displayName

string

ชื่อต้นฉบับที่มนุษย์อ่านได้

พร็อพเพอร์ตี้หน้าเว็บ

พร็อพเพอร์ตี้ของ Page

หน้าเว็บจะรับช่วงพร็อพเพอร์ตี้จากหน้าระดับบนสุด ลําดับชั้นได้รับการกําหนดเป็น SlideProperties หรือ LayoutProperties โดยขึ้นอยู่กับประเภทหน้าเว็บ

การแสดง JSON 
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
ช่อง
pageBackgroundFill

object (PageBackgroundFill)

การเติมพื้นหลังของหน้า หากไม่ได้ตั้งค่า การเติมพื้นหลังจะเป็นไปตามหน้าระดับบนสุด (หากมี) หากหน้าเว็บไม่มีระดับบนสุด การเติมพื้นหลังโดยค่าเริ่มต้นจะเป็นการเติมที่เกี่ยวข้องในเครื่องมือแก้ไขสไลด์
colorScheme

object (ColorScheme)

รูปแบบสีของหน้าเว็บ หากไม่ได้ตั้งค่า รูปแบบสีจะรับค่ามาจากหน้าหลัก หากหน้าเว็บไม่มีระดับบนสุด รูปแบบสีจะใช้รูปแบบสีเริ่มต้นของสไลด์ที่ตรงกับค่าเริ่มต้นในเครื่องมือแก้ไขสไลด์

เฉพาะสีคอนกรีตของ 12 ThemeColorType แรกเท่านั้นที่แก้ไขได้ นอกจากนี้ ยังอัปเดตได้เฉพาะรูปแบบสีในหน้า Master เท่านั้น ต้องมีการอัปเดตรูปแบบสีที่มีการแมปจาก ThemeColorTypes 12 รายการแรกไปยังสีคอนกรีต ระบบจะไม่สนใจสี ThemeColorTypes ที่เหลือ

พื้นหลังพื้นหลัง

เติมพื้นหลังของหน้า

การแสดง 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.
}
ช่อง
propertyState

enum (PropertyState)

สถานะพร็อพเพอร์ตี้การเติมพื้นหลัง

การอัปเดตการเติมหน้าเว็บจะอัปเดตช่องนี้เป็น RENDERED โดยอัตโนมัติ เว้นแต่จะระบุค่าอื่นในคําขอเดียวกัน หากไม่ต้องการให้มีการเติมข้อมูลในหน้า ให้ตั้งค่าช่องนี้เป็น NOT_RENDERED ในกรณีนี้ ระบบจะไม่สนใจช่องอัตราการส่งโฆษณาอื่นๆ ที่ตั้งค่าไว้ในคําขอเดียวกัน
ช่อง Union kind ประเภทของสีเติมพื้นหลัง kind ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
solidFill

object (SolidFill)

สีทึบ
stretchedPictureFill

object (StretchedPictureFill)

การเติมรูปภาพแบบขยาย

ฟิล์มยืด

การยืดรูปภาพแบบยืดเต็ม หน้าเว็บหรือองค์ประกอบของหน้าเต็มไปด้วยรูปภาพที่ระบุ รูปภาพจะยืดออกให้พอดีกับคอนเทนเนอร์

การแสดง JSON 
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
ช่อง
contentUrl

string

การอ่าน contentUrl:

URL ไปยังรูปภาพที่มีอายุการใช้งานเริ่มต้น 30 นาที URL นี้ติดแท็กด้วยบัญชีของผู้ขอ ทุกคนที่มี URL จะเข้าถึงรูปภาพในฐานะผู้ขอได้อย่างถูกต้อง คุณอาจเสียสิทธิ์เข้าถึงรูปภาพหากการตั้งค่าการแชร์ของงานนําเสนอมีการเปลี่ยนแปลง

การเขียน contentUrl:

ระบบจะดึงข้อมูลรูปภาพ 1 ครั้งในขณะแทรก และจะจัดเก็บสําเนาไว้เพื่อแสดงภายในงานนําเสนอ รูปภาพต้องมีขนาดไม่เกิน 50 MB และมีขนาดไม่เกิน 25 เมกะพิกเซล และต้องอยู่ในรูปแบบ PNG, JPEG หรือ GIF

URL ที่ระบุต้องมีความยาวไม่เกิน 2 KB
size

object (Size)

ขนาดเดิมของการเติมรูปภาพ ช่องนี้เป็นแบบอ่านอย่างเดียว

รูปแบบสี

ชุดสีของสีที่กําหนดไว้ล่วงหน้าของหน้าเว็บ

การแสดง JSON 
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
ช่อง
colors[]

object (ThemeColorPair)

ThemeColorType และคู่สีคอนกรีตที่เกี่ยวข้อง

การจับคู่ธีมสี

คู่จับคู่ประเภทสีธีมกับสีคอนกรีต

การแสดง JSON 
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
ช่อง
type

enum (ThemeColorType)

ประเภทของสีธีม
color

object (RgbColor)

สีคอนกรีตที่ตรงกับประเภทสีธีมด้านบน

วิธีการ

get

 ดาวน์โหลดหน้าเวอร์ชันล่าสุดในงานนําเสนอ

getThumbnail

 สร้างภาพขนาดย่อของหน้าเวอร์ชันล่าสุดในงานนําเสนอและแสดง URL ไปยังภาพขนาดย่อ