REST Resource: presentations.pages

संसाधन: पेज

प्रज़ेंटेशन में मौजूद कोई पेज.

जेएसओएन के काेड में दिखाना 
{
  "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 = मास्टर हो.

PageType

पेज किस तरह का है.

Enums
SLIDE स्लाइड पेज.
MASTER कोई मास्टर स्लाइड पेज.
LAYOUT लेआउट पेज.
NOTES नोट वाला पेज.
NOTES_MASTER नोट मास्टर पेज.

PageElement

पेज पर रेंडर किया जाने वाला विज़ुअल एलिमेंट.

जेएसओएन के काेड में दिखाना 
{
  "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 Sheets से एम्बेड किया गया लिंक किया गया चार्ट. अलग किए गए चार्ट, इमेज के तौर पर दिखते हैं.
speakerSpotlight

object (SpeakerSpotlight)

स्पीकर स्पॉटलाइट.

ग्रुप

यह PageElement टाइप, PageElements के जोड़े गए कलेक्शन को दिखाता है.

जेएसओएन के काेड में दिखाना 
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
फ़ील्ड
children[]

object (PageElement)

ग्रुप में एलिमेंट का कलेक्शन. ग्रुप का साइज़ कम से कम दो होना चाहिए.

WordArt

वर्ड आर्ट को दिखाने वाला PageElement टाइप.

जेएसओएन के काेड में दिखाना 
{
  "renderedText": string
}
फ़ील्ड
renderedText

string

वर्ड आर्ट के रूप में रेंडर किया जाने वाला टेक्स्ट.

SpeakerSpotlight

स्पीकर स्पॉटलाइट को दिखाने वाला PageElement.

जेएसओएन के काेड में दिखाना 
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
फ़ील्ड
speakerSpotlightProperties

object (SpeakerSpotlightProperties)

स्पीकर स्पॉटलाइट की विशेषताएं.

SpeakerSpotlightProperties

SpeakerSpotlight की प्रॉपर्टी.

जेएसओएन के काेड में दिखाना 
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
फ़ील्ड
outline

object (Outline)

स्पीकर स्पॉटलाइट की आउटलाइन. अगर यह नीति सेट नहीं है, तो इसका कोई आउटलाइन नहीं होता.
shadow

object (Shadow)

स्पीकर स्पॉटलाइट की परछाई. अगर यह नीति सेट नहीं है, तो इसका कोई शैडो नहीं होगा.

SlideProperties

Page की वे प्रॉपर्टी जो सिर्फ़ pageType SLIDE वाले पेजों के लिए काम की हैं.

जेएसओएन के काेड में दिखाना 
{
  "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 लेआउट वाले पेजों के लिए काम की हैं.

जेएसओएन के काेड में दिखाना 
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
फ़ील्ड
masterObjectId

string

मास्टर का वह ऑब्जेक्ट आईडी जिस पर यह लेआउट आधारित है.
name

string

लेआउट का नाम.
displayName

string

लेआउट का ऐसा नाम जिसे कोई भी व्यक्ति आसानी से पढ़ सके.

NotesProperties

Page की वे प्रॉपर्टी जो सिर्फ़ pageType NOTES वाले पेजों के लिए काम की हैं.

जेएसओएन के काेड में दिखाना 
{
  "speakerNotesObjectId": string
}
फ़ील्ड
speakerNotesObjectId

string

नोट वाले इस पेज पर आकार का ऑब्जेक्ट आईडी, जिसमें संबंधित स्लाइड के लिए प्रज़ेंटर के नोट शामिल हैं. ऐसा हो सकता है कि असली आकार, नोट पेज पर हमेशा मौजूद न हो. इस ऑब्जेक्ट आईडी का इस्तेमाल करके टेक्स्ट डालने से आकार अपने-आप बन जाएगा. इस मामले में, असल आकार का ऑब्जेक्ट आईडी अलग हो सकता है. presentations.get या pages.get कार्रवाई हमेशा सबसे नया ऑब्जेक्ट आईडी दिखाएगी.

MasterProperties

Page की वे प्रॉपर्टी जो सिर्फ़ pageType मास्टर वाले पेजों के लिए काम की हैं.

जेएसओएन के काेड में दिखाना 
{
  "displayName": string
}
फ़ील्ड
displayName

string

मास्टर का कोई ऐसा नाम जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.

PageProperties

Page की प्रॉपर्टी.

पेज, पैरंट पेज की प्रॉपर्टी इनहेरिट करेगा. पेज टाइप के आधार पर, क्रम को SlideProperties या LayoutProperties में तय किया जाता है.

जेएसओएन के काेड में दिखाना 
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
फ़ील्ड
pageBackgroundFill

object (PageBackgroundFill)

पेज का बैकग्राउंड फ़िल. अगर यह नीति सेट नहीं है, तो बैकग्राउंड में भरने की सुविधा, पैरंट पेज के मौजूद होने पर इनहेरिट की जाती है. अगर किसी पेज का पैरंट पेज मौजूद नहीं है, तो Slides एडिटर में डिफ़ॉल्ट तौर पर, बैकग्राउंड में कॉन्टेंट भर जाता है.
colorScheme

object (ColorScheme)

पेज की कलर स्कीम. अगर यह नीति सेट नहीं है, तो कलर स्कीम पैरंट पेज से इनहेरिट की जाती है. अगर पेज का कोई पैरंट पेज मौजूद नहीं है, तो कलर स्कीम, Slides के एडिटर की डिफ़ॉल्ट कलर स्कीम का इस्तेमाल करके, Slides की डिफ़ॉल्ट कलर स्कीम का इस्तेमाल करती है.

सिर्फ़ शुरुआती 12 ThemeColorType के कंक्रीट कलर में ही बदलाव किया जा सकता है. इसके अलावा, सिर्फ़ Master पेजों की कलर स्कीम को अपडेट किया जा सकता है. फ़ील्ड को अपडेट करने के लिए, एक कलर स्कीम दी जानी चाहिए. इसमें पहले 12 थीमColorTypes से लेकर उनके कंक्रीट कलर तक, मैपिंग शामिल हैं. बाकी के TopicsColorTypes के कलर को अनदेखा कर दिया जाएगा.

PageBackgroundFill

पेज का बैकग्राउंड फ़िल.

जेएसओएन के काेड में दिखाना 
{
  "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

स्ट्रेच्ड पिक्चर फ़िल. पेज या पेज में पूरी तरह से इमेज दी गई है. तस्वीर को इसके कंटेनर में फ़िट करने के लिए फैलाया गया है.

जेएसओएन के काेड में दिखाना 
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
फ़ील्ड
contentUrl

string

contentUrl पढ़ना:

किसी तस्वीर का यूआरएल, जिसका डिफ़ॉल्ट लाइफ़टाइम 30 मिनट होता है. यह यूआरएल, अनुरोध करने वाले व्यक्ति के खाते से टैग किया गया है. जिस व्यक्ति के पास यूआरएल है वह मूल अनुरोध करने वाले व्यक्ति के तौर पर, फ़ोटो को असरदार तरीके से ऐक्सेस करता है. अगर प्रज़ेंटेशन की शेयर करने की सेटिंग बदल जाती है, तो हो सकता है कि तस्वीर को ऐक्सेस न किया जा सके.

contentUrl लिखना:

इंसर्शन के समय, तस्वीर को एक बार फ़ेच किया जाता है. इसकी एक कॉपी को प्रज़ेंटेशन में दिखाने के लिए सेव कर दिया जाता है. फ़ोटो का साइज़ 50 एमबी से कम और 25 मेगापिक्सल से ज़्यादा नहीं होना चाहिए. साथ ही, फ़ोटो PNG, JPEG या GIF फ़ॉर्मैट में से किसी एक में होनी चाहिए.

दिया गया यूआरएल ज़्यादा से ज़्यादा 2 kB का हो सकता है.
size

object (Size)

चित्र फ़िल का मूल आकार. इस फ़ील्ड को सिर्फ़ पढ़ा जा सकता है.

ColorScheme

किसी पेज के लिए पहले से तय रंगों का पैलेट.

जेएसओएन के काेड में दिखाना 
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
फ़ील्ड
colors[]

object (ThemeColorPair)

थीमColorType और उससे जुड़े कंक्रीट रंगों के जोड़े.

ThemeColorPair

एक जोड़ा, जिसमें किसी थीम के कलर टाइप को उसके कंक्रीट रंग से मैप किया जा रहा है.

जेएसओएन के काेड में दिखाना 
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
फ़ील्ड
type

enum (ThemeColorType)

थीम का रंग किस तरह का है.
color

object (RgbColor)

ऊपर दी गई थीम के रंग के हिसाब से कंक्रीट का रंग.

तरीके

get

 प्रज़ेंटेशन में बताए गए पेज का सबसे नया वर्शन डाउनलोड करता है.

getThumbnail

 प्रज़ेंटेशन में बताए गए पेज के सबसे नए वर्शन का थंबनेल जनरेट करता है और थंबनेल इमेज का यूआरएल देता है.