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 แสดงคอลเล็กชันขององค์ประกอบหน้าเว็บที่รวมเข้าด้วยกัน

การแสดง 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 รูปร่างตัวยึดตำแหน่งที่มีประเภทเป็น 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:

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