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

पेज का टाइप.

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

object (SpeakerSpotlight)

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

ग्रुप

PageElement टाइप, जो PageElements के जॉइंट कलेक्शन को दिखाता है.

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

object (PageElement)

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

WordArt

Word Art दिखाने वाला 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 की प्रॉपर्टी सिर्फ़ उन पेजों के लिए काम की हैं जिनका पेज टाइप लेआउट है.

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)

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

object (ColorScheme)

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

सिर्फ़ पहले 12 ThemeColorType के कंक्रीट रंगों में बदलाव किया जा सकता है. इसके अलावा, सिर्फ़ Master पेजों की कलर स्कीम अपडेट की जा सकती है. फ़ील्ड को अपडेट करने के लिए, एक कलर स्कीम देनी होगी. इसमें, पहले 12 ThemeColorTypes से उनके खास रंगों तक की मैपिंग होनी चाहिए. बाकी 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

कॉन्टेंट का यूआरएल पढ़ना:

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

contentUrl लिखना:

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

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

object (Size)

चित्र फ़िल का मूल आकार. यह फ़ील्ड सिर्फ़ पढ़ने के लिए है.

ColorScheme

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

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

object (ThemeColorPair)

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

ThemeColorPair

एक पेयर, जो थीम के रंग के टाइप को उस रंग से मैप करता है जिसे वह दिखाता है.

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

enum (ThemeColorType)

थीम के रंग का टाइप.
color

object (RgbColor)

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

तरीके

get

 प्रज़ेंटेशन में बताए गए पेज का नया वर्शन दिखाता है.

getThumbnail

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