REST Resource: presentations.pages

Kaynak: Sayfa

Sunudaki bir sayfa.

JSON gösterimi
{
  "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.
}
Alanlar
objectId

string

Bu sayfanın nesne kimliği. Page ve PageElement tarafından kullanılan nesne kimlikleri aynı ad alanını paylaşır.

pageType

enum (PageType)

Sayfanın türü.

pageElements[]

object (PageElement)

Sayfada oluşturulan sayfa öğeleri.

revisionId

string

Yalnızca çıkış. Sununun düzeltme kimliği. Son okuma işleminden bu yana sunu düzeltmesinin değişmediğini iddia etmek için güncelleme isteklerinde kullanılabilir. Yalnızca kullanıcının sunu için düzenleme erişimi varsa doldurulur.

Düzeltme kimliği sıralı bir sayı değil, opak bir dizedir. Düzeltme kimliğinin biçimi zaman içinde değişebilir. Döndürülen düzeltme kimliğinin, yalnızca iade edildikten sonra 24 saat boyunca geçerli olacağı garanti edilir ve bu kimlik kullanıcılar arasında paylaşılamaz. Görüşmeler arasında düzeltme kimliği değişmiyorsa sunu da değişmemiştir. Buna karşılık, kimliğin değiştirilmesi (aynı sunu ve kullanıcı için) genellikle sununun güncellendiği anlamına gelir. Ancak kimliğin değiştirilmesi, kimlik biçimi değişiklikleri gibi dahili faktörlerden de kaynaklanıyor olabilir.

pageProperties

object (PageProperties)

Sayfanın özellikleri.

Birleştirme alanı properties. Her sayfa türüne özgü özellikler. Ana slaytlar herhangi bir ek mülk gerektirmez. properties şunlardan yalnızca biri olabilir:
slideProperties

object (SlideProperties)

Slayta özgü özellikleri seçin. Yalnızca pageType = SLIDE ise ayarlayın.

layoutProperties

object (LayoutProperties)

Düzene özel özellikler. Yalnızca pageType = LAYOUT ise ayarlayın.

notesProperties

object (NotesProperties)

Notlara özgü özellikler. Yalnızca pageType = NOTES ise ayarlayın.

masterProperties

object (MasterProperties)

Belirli mülklerde ana hatlar oluşturun. Yalnızca pageType = MASTER ise ayarlayın.

PageType

Sayfanın türü.

Sıralamalar
SLIDE Slayt sayfası.
MASTER Ana slayt sayfası.
LAYOUT Düzen sayfası.
NOTES Notlar sayfası.
NOTES_MASTER Notlar ana sayfası.

PageElement

Bir sayfada oluşturulan görsel öğe.

JSON gösterimi
{
  "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.
}
Alanlar
objectId

string

Bu sayfa öğesinin nesne kimliği. google.apps.slides.v1.Page ve google.apps.slides.v1.PageElement tarafından kullanılan nesne kimlikleri aynı ad alanını paylaşır.

size

object (Size)

Sayfa öğesinin boyutu.

transform

object (AffineTransform)

Sayfa öğesinin dönüşümü.

Sayfa öğesinin görsel görünümü, mutlak dönüşümüyle belirlenir. Mutlak dönüşümü hesaplamak için bir sayfa öğesinin dönüşümünü, tüm üst gruplarının dönüşümleriyle önceden bağlayın. Sayfa öğesi bir grupta bulunmuyorsa mutlak dönüşümü bu alandaki değerle aynı olur.

Yeni oluşturulan Group için ilk dönüşüm her zaman kimlik dönüşümüdür.

title

string

Sayfa öğesinin başlığı. Alternatif metni görüntülemek için açıklamayla birleştirilir.

Bu alan, Group öğeleri için desteklenmiyor.

description

string

Sayfa öğesinin açıklaması. Alternatif metnin gösterilmesi için başlıkla birleştirilir.

Bu alan, Group öğeleri için desteklenmiyor.

Birleştirme alanı element_kind. Bu PageElement'ın temsil ettiği öğenin türü. Her ileti, söz konusu sayfa öğesine özgü özellikler içerir. element_kind şunlardan yalnızca biri olabilir:
elementGroup

object (Group)

Tek bir birim olarak birleştirilen sayfa öğelerinden oluşan bir koleksiyon.

shape

object (Shape)

Genel bir şekil.

image

object (Image)

Resim sayfası öğesi.

video

object (Video)

Video sayfası öğesi.

line

object (Line)

Satır sayfası öğesi.

table

object (Table)

Tablo sayfası öğesi.

wordArt

object (WordArt)

Word art sayfa öğesi.

sheetsChart

object (SheetsChart)

Google E-Tablolar'dan yerleştirilmiş bağlı bir grafik. Bağlantısı kaldırılan grafikler resim olarak gösterilir.

speakerSpotlight

object (SpeakerSpotlight)

Konuşmacı köşesi.

Grup

PageElements koleksiyonunu temsil eden PageElement türü.

JSON gösterimi
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
Alanlar
children[]

object (PageElement)

Gruptaki öğelerin koleksiyonu. Minimum boyut 2'dir.

WordArt

Word art'ı temsil eden bir PageElement türü.

JSON gösterimi
{
  "renderedText": string
}
Alanlar
renderedText

string

Word art olarak oluşturulan metin.

SpeakerSpotlight

Konuşmacı köşesini temsil eden bir PageElement türü.

JSON gösterimi
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
Alanlar
speakerSpotlightProperties

object (SpeakerSpotlightProperties)

Konuşmacı köşesinin özellikleri.

SpeakerSpotlightProperties

SpeakerSpotlight öğesinin özellikleri.

JSON gösterimi
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
Alanlar
outline

object (Outline)

Konuşmacı köşesinin ana hatları. Ayarlanmazsa dış çizgisi yoktur.

shadow

object (Shadow)

Konuşmacı köşesinin gölgesi. Ayarlanmazsa gölgesi olmaz.

SlideProperties

Yalnızca pageType SLIDE'sına sahip sayfalarla alakalı Page özellikleri.

JSON gösterimi
{
  "layoutObjectId": string,
  "masterObjectId": string,
  "notesPage": {
    object (Page)
  },
  "isSkipped": boolean
}
Alanlar
layoutObjectId

string

Bu slaytın temel aldığı düzenin nesne kimliği. Bu özellik salt okunurdur.

masterObjectId

string

Bu slaytın temel aldığı ana slaytın nesne kimliği. Bu özellik salt okunurdur.

notesPage

object (Page)

Bu slaytın ilişkili olduğu notlar sayfası. Slaytları konuşmacı notlarıyla yazdırırken veya dışa aktarırken, notlar sayfasının görsel görünümünü tanımlar. Notlar sayfası, özellikleri notes master öğesinden devralır. Notlar sayfasındaki BODY türündeki yer tutucu şekli, bu slayta ilişkin konuşmacı notlarını içerir. Bu şeklin kimliği, speakerNotesObjectId alanı tarafından tanımlanır. Metin içeriği ve konuşmacı notları şeklinin stilleri dışında notlar sayfası salt okunurdur. Bu özellik salt okunurdur.

isSkipped

boolean

Sunu modunda slaytın atlanıp atlanmadığı. Varsayılan olarak yanlış değerine ayarlanır.

LayoutProperties

Page özellikleri yalnızca pageType LAYOUT içeren sayfalarla alakalıdır.

JSON gösterimi
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
Alanlar
masterObjectId

string

Bu düzenin temel aldığı ana öğenin nesne kimliği.

name

string

Düzenin adı.

displayName

string

Düzenin kullanıcılar tarafından okunabilen adı.

NotesProperties

Yalnızca pageType NOTES içeren sayfalarla alakalı Page özellikleri.

JSON gösterimi
{
  "speakerNotesObjectId": string
}
Alanlar
speakerNotesObjectId

string

İlgili slayta ilişkin konuşmacı notlarını içeren, bu notlar sayfasındaki şeklin nesne kimliği. Gerçek şekil, notlar sayfasında her zaman bulunmayabilir. Bu nesne kimliğini kullanarak metin eklediğinizde şekil otomatik olarak oluşturulur. Bu durumda, gerçek şeklin farklı bir nesne kimliği olabilir. presentations.get veya pages.get işlemi her zaman en son nesne kimliğini döndürür.

MasterProperties

Yalnızca pageType MASTER öğesini içeren sayfalarla alakalı Page özellikleri.

JSON gösterimi
{
  "displayName": string
}
Alanlar
displayName

string

Ana kopyanın kullanıcılar tarafından okunabilen adı.

PageProperties

Page öğesinin özellikleri.

Sayfa, özellikleri üst sayfadan devralır. Sayfa türüne bağlı olarak hiyerarşi SlideProperties veya LayoutProperties içinde tanımlanır.

JSON gösterimi
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
Alanlar
pageBackgroundFill

object (PageBackgroundFill)

Sayfanın arka plan dolgusu. Politika ayarlanmazsa arka plan dolgusu varsa üst sayfadan devralınır. Sayfanın üst öğesi yoksa arka plan dolgusu varsayılan olarak Slaytlar düzenleyicisinde karşılık gelen dolguya ayarlanır.

colorScheme

object (ColorScheme)

Sayfanın renk şeması. Ayarlanmazsa renk şeması üst sayfadan devralınır. Sayfanın üst öğesi yoksa renk şeması, Slaytlar düzenleyicisindeki varsayılan değerlerle eşleşen varsayılan bir Slaytlar renk şeması kullanır.

Yalnızca ilk 12 ThemeColorType öğesinin somut renkleri düzenlenebilir. Buna ek olarak, yalnızca Master sayfalarındaki renk şeması güncellenebilir. Alanı güncellemek için ilk 12 ThemeColorType'ın tümünden somut renklerine eşlemeleri içeren bir renk şeması sağlanmalıdır. Kalan ThemeColorTypes için renkler yoksayılır.

PageBackgroundFill

Sayfa arka plan dolgusu.

JSON gösterimi
{
  "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.
}
Alanlar
propertyState

enum (PropertyState)

Arka plan dolgu özelliği durumu.

Bir sayfadaki dolgunun güncellenmesi, aynı istekte başka bir değer belirtilmediği sürece bu alanı dolaylı olarak RENDERED olarak günceller. Bir sayfada dolgu olmaması için bu alanı NOT_RENDERED olarak ayarlayın. Bu durumda, aynı istekte ayarlanmış diğer doldurma alanları yoksayılır.

Birleştirme alanı kind. Arka plan dolgusunun türü. kind şunlardan yalnızca biri olabilir:
solidFill

object (SolidFill)

Düz renk dolgusu.

stretchedPictureFill

object (StretchedPictureFill)

Uzatılmış resim dolgusu.

StretchedPictureFill

Uzatılmış resim dolgusu. Sayfa veya sayfa öğesi tamamen belirtilen resimle dolu. Resim, kapsayıcısına sığacak şekilde uzatılır.

JSON gösterimi
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
Alanlar
contentUrl

string

contentUrl okunuyor:

Varsayılan kullanım ömrü 30 dakika olan bir resmin URL'si. Bu URL, istekte bulunan kişinin hesabıyla etiketlenmiş. URL'ye sahip olan herkes, orijinal istekte bulunan kişi olarak resme etkili bir şekilde erişir. Sununun paylaşım ayarları değişirse resme erişim kaybedilebilir.

contentUrl'yi yazma:

Resim, ekleme zamanında bir kez getirilir ve bir kopyası sununun içinde görüntülemek üzere saklanır. Resimler 50 MB'tan küçük olmalı, 25 megapikselden büyük olmamalıdır ve PNG, JPEG veya GIF biçiminde olmalıdır.

Sağlanan URL en fazla 2 kB uzunluğunda olabilir.

size

object (Size)

Resmin orijinal boyutu. Bu alan salt okunurdur.

ColorScheme

Bir sayfa için önceden tanımlanmış renkler paleti.

JSON gösterimi
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Alanlar
colors[]

object (ThemeColorPair)

ThemeColorType ve karşılık gelen somut renk çiftleri.

ThemeColorPair

Bir tema renk türünü temsil ettiği somut renkle eşleyen bir çift.

JSON gösterimi
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
Alanlar
type

enum (ThemeColorType)

Tema renginin türü.

color

object (RgbColor)

Yukarıdaki tema rengi türüne karşılık gelen somut renk.

Yöntemler

get

Sunuda belirtilen sayfanın en son sürümünü alır.

getThumbnail

Sunuda belirtilen sayfanın en son sürümünün küçük resmini oluşturur ve küçük resme URL döndürür.