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 ของรูปภาพขนาดย่อ