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 = สไลด์
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 ที่เกี่ยวข้องกับหน้าเว็บที่มี SLIDE pageType เท่านั้น

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

string

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

string

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

object (Page)

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

boolean

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

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

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