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)

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

object (SlideProperties)

พร็อพเพอร์ตี้เฉพาะสไลด์ ตั้งค่าเฉพาะในกรณีที่ pageType = SLIDE
layoutProperties

object (LayoutProperties)

พร็อพเพอร์ตี้เฉพาะของเลย์เอาต์ ตั้งค่าเฉพาะในกรณีที่ pageType = LAYOUT
notesProperties

object (NotesProperties)

บันทึกพร็อพเพอร์ตี้ที่เฉพาะเจาะจง ตั้งค่าเฉพาะในกรณีที่ pageType = NOTES
masterProperties

object (MasterProperties)

จัดการพร็อพเพอร์ตี้ที่เฉพาะเจาะจง ตั้งค่าเฉพาะในกรณีที่ pageType = MASTER

PageType

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

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

PageElement

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

การแสดง 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.
}
ช่อง
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
ฟิลด์สหภาพ 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 ชีต แผนภูมิที่ไม่ได้ลิงก์จะแสดงเป็นภาพ
speakerSpotlight

object (SpeakerSpotlight)

วิดีโอสปอตไลท์ผู้บรรยาย

กลุ่ม

ประเภท PageElement ที่แสดงถึงคอลเล็กชัน PageElements ที่รวมกัน

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

object (PageElement)

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

WordArt

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

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

string

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

SpeakerSpotlight

ประเภท PageElement ที่แสดงถึงวิดีโอสปอตไลท์ผู้บรรยาย

การแสดง JSON 
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
ช่อง
speakerSpotlightProperties

object (SpeakerSpotlightProperties)

คุณสมบัติของวิดีโอสปอตไลท์ผู้บรรยาย

SpeakerSpotlightProperties

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

การแสดง JSON 
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
ช่อง
outline

object (Outline)

ขอบของวิดีโอสปอตไลท์ผู้บรรยาย หากไม่ได้ตั้งค่า ข้อความจะไม่มีขอบ
shadow

object (Shadow)

เงาของวิดีโอสปอตไลท์ผู้บรรยาย หากไม่ได้ตั้งค่า จะไม่มีเงา

SlideProperties

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

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

string

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

string

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

object (Page)

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

boolean

ข้ามสไลด์ในโหมดการนำเสนอหรือไม่ ค่าเริ่มต้นคือ False

LayoutProperties

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

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

string

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

string

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

string

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

NotesProperties

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

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

string

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

MasterProperties

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

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

string

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

PageProperties

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

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

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

object (PageBackgroundFill)

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

object (ColorScheme)

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

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

PageBackgroundFill

สีพื้นหลังของหน้า

การแสดง 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 ในกรณีนี้ ระบบจะไม่สนใจช่องป้อนข้อมูลอื่นๆ ที่ตั้งค่าไว้ในคำขอเดียวกัน
ฟิลด์สหภาพ kind ประเภทการเติมพื้นหลัง kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
solidFill

object (SolidFill)

เติมสีทึบ
stretchedPictureFill

object (StretchedPictureFill)

รูปภาพที่ยืดให้เต็มพื้นที่

StretchedPictureFill

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

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

string

การอ่าน contentUrl

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

การเขียน contentUrl

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

URL ที่ระบุมีความยาวได้สูงสุด 2 KB
size

object (Size)

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

ColorScheme

ชุดสีที่กำหนดไว้ล่วงหน้าสำหรับหน้าเว็บ

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

object (ThemeColorPair)

ThemeColorType และคู่สีที่เฉพาะเจาะจงที่เกี่ยวข้อง

ThemeColorPair

คู่การแมปประเภทสีธีมกับสีที่เฉพาะเจาะจงซึ่งแสดงถึง

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

enum (ThemeColorType)

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

object (RgbColor)

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

เมธอด

get

 รับหน้าที่ระบุในเวอร์ชันล่าสุดของงานนำเสนอ

getThumbnail

 สร้างภาพขนาดย่อของหน้าเว็บที่ระบุในเวอร์ชันล่าสุดของงานนำเสนอและแสดงผล URL ของรูปภาพขนาดย่อ