REST Resource: presentations.pages

المصدر: صفحة

صفحة في عرض تقديمي

تمثيل JSON 
{
  "objectId": string,
  "pageType": enum (PageType),
  "pageElements": [
    {
      object (PageElement)
    }
  ],
  "revisionId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "commentAnchors": [
    {
      object (CommentAnchor)
    }
  ],
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode),

  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
}
الحقول
objectId

string

تمثّل هذه السمة معرّف العنصر لهذه الصفحة. تتشارك معرّفات العناصر المستخدَمة من خلال Page وPageElement مساحة الاسم نفسها.
pageType

enum (PageType)

تمثّل هذه السمة نوع الصفحة.
pageElements[]

object (PageElement)

عناصر الصفحة المعروضة على الصفحة
revisionId

string

النتائج فقط. معرّف النسخة السابقة للعرض التقديمي يمكن استخدامها في طلبات التعديل للتأكّد من أنّ مراجعة العرض التقديمي لم تتغيّر منذ آخر عملية قراءة. يتم ملء هذا الحقل فقط إذا كان لدى المستخدم إذن تعديل العرض التقديمي.

رقم تعريف المراجعة ليس رقمًا تسلسليًا بل سلسلة مبهمة. قد يتغيّر تنسيق رقم تعريف المراجعة بمرور الوقت. لا يُضمن أن يكون معرّف المراجعة الذي تم إرجاعه صالحًا إلا لمدة 24 ساعة بعد إرجاعه، ولا يمكن مشاركته بين المستخدمين. إذا لم يتغيّر رقم تعريف المراجعة بين الطلبات، يعني ذلك أنّ العرض التقديمي لم يتغيّر. في المقابل، يشير رقم التعريف المتغيّر (للعرض التقديمي والمستخدم نفسهما) عادةً إلى أنّه تم تعديل العرض التقديمي. ومع ذلك، يمكن أن يكون رقم التعريف المتغيّر ناتجًا أيضًا عن عوامل داخلية، مثل تغييرات في تنسيق رقم التعريف.
pageProperties

object (PageProperties)

خصائص الصفحة
commentAnchors[]

object (CommentAnchor)

النتائج فقط. تمثّل هذه السمة نقاط ربط التعليقات المتوفّرة على الصفحة.
comments[]

object (CommentThread)

النتائج فقط. سلاسل التعليقات المرتبطة بالصفحة لا تتم تعبئة هذا الحقل إلا إذا تم جلب الصفحة من خلال GetPageRequest مع تعبئة commentsViewMode. بخلاف ذلك، يتم عرض التعليقات في Presentation من خلال GetPresentationRequest.
commentsViewMode

enum (CommentsViewMode)

النتائج فقط. تمثّل هذه السمة وضع عرض التعليقات المطبَّق على الصفحة. تتم تعبئة هذا الحقل فقط إذا تم جلب الصفحة من خلال GetPageRequest مع commentsViewMode تمّت تعبئته.
الخصائص الخاصة بكل نوع من أنواع الصفحات لا تتطلّب المستندات الرئيسية أي سمات إضافية. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
slideProperties

object (SlideProperties)

سمات خاصة بالشرائح يتم ضبطها فقط إذا كان pageType = SLIDE.
layoutProperties

object (LayoutProperties)

السمات الخاصة بالتصميم يجب ضبطها فقط إذا كانت pageType = LAYOUT.
notesProperties

object (NotesProperties)

ملاحظات حول خصائص معيّنة يجب ضبطها فقط إذا كانت pageType = NOTES.
masterProperties

object (MasterProperties)

السمات الرئيسية المحدّدة يتم ضبطها فقط إذا كان pageType = MASTER.
نهاية الحقول التي يستبعد كلّ منها الآخر

PageType

تمثّل هذه السمة نوع الصفحة.

عمليات التعداد
SLIDE صفحة شريحة
MASTER صفحة شريحة رئيسية
LAYOUT صفحة تنسيق
NOTES صفحة ملاحظات
NOTES_MASTER صفحة رئيسية للملاحظات

PageElement

عنصر مرئي يتم عرضه على صفحة

تمثيل JSON 
{
  "objectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  },
  "title": string,
  "description": string,

  "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)
  }
}
الحقول
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.
نوع العنصر الذي يمثّله PageElement. تحتوي كل رسالة على أي سمات خاصة بنوع عنصر الصفحة هذا. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
elementGroup

object (Group)

مجموعة من عناصر الصفحة تم دمجها كوحدة واحدة.
shape

object (Shape)

شكل عام
image

object (Image)

عنصر صفحة صورة
video

object (Video)

عنصر صفحة فيديو
line

object (Line)

عنصر صفحة على شكل خط
table

object (Table)

عنصر صفحة جدول
wordArt

object (WordArt)

عنصر صفحة Word Art
sheetsChart

object (SheetsChart)

رسم بياني مرتبط مضمّن من "جداول بيانات Google" يتم تمثيل الرسوم البيانية غير المرتبطة كصور.
speakerSpotlight

object (SpeakerSpotlight)

فيديو مضمَّن للمُحاضر.
نهاية الحقول التي يستبعد كلّ منها الآخر

مجموعة

نوع PageElement يمثّل مجموعة مدمجة من PageElements

تمثيل JSON 
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
الحقول
children[]

object (PageElement)

مجموعة العناصر في المجموعة الحد الأدنى لحجم المجموعة هو شخصان.

WordArt

نوع PageElement يمثّل word art

تمثيل JSON 
{
  "renderedText": string
}
الحقول
renderedText

string

النص المعروض كـ word art.

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

تحدّد هذه السمة ما إذا كان سيتم تخطّي الشريحة في وضع العرض التقديمي. القيمة التلقائية هي 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)

تمثّل هذه السمة نظام الألوان في الصفحة. في حال عدم ضبطها، يتم اكتساب نظام الألوان من صفحة رئيسية. إذا لم يكن للصفحة عنصر رئيسي، سيتم استخدام نظام ألوان تلقائي في "العروض التقديمية من Google"، يتطابق مع الإعدادات التلقائية في محرر "العروض التقديمية من Google".

يمكن تعديل ألوان أول 12 ThemeColorType فقط. بالإضافة إلى ذلك، يمكن تعديل نظام الألوان في صفحات Master فقط. لتعديل الحقل، يجب توفير نظام ألوان يتضمّن عمليات ربط من جميع أول 12 ThemeColorType بألوانها المحدّدة. وسيتم تجاهل الألوان المتبقية في ThemeColorTypes.

PageBackgroundFill

تعبئة خلفية الصفحة

تمثيل JSON 
{
  "propertyState": enum (PropertyState),

  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
}
الحقول
propertyState

enum (PropertyState)

حالة سمة تعبئة الخلفية

سيؤدي تعديل عملية التعبئة في صفحة إلى تعديل هذا الحقل تلقائيًا إلى RENDERED، ما لم يتم تحديد قيمة أخرى في الطلب نفسه. لعدم عرض أي إعلان على الصفحة، اضبط قيمة هذا الحقل على NOT_RENDERED. في هذه الحالة، سيتم تجاهل أي حقول تعبئة أخرى تم ضبطها في الطلب نفسه.
تمثّل هذه السمة نوع تعبئة الخلفية. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
solidFill

object (SolidFill)

تعبئة بلون واحد
stretchedPictureFill

object (StretchedPictureFill)

تعبئة الصورة الممدّدة
نهاية الحقول التي يستبعد كلّ منها الآخر

StretchedPictureFill

ملء الصورة الممدّدة يتم ملء الصفحة أو عنصر الصفحة بالكامل بالصورة المحدّدة. يتم توسيع الصورة لتناسب الحاوية.

تمثيل JSON 
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
الحقول
contentUrl

string

قراءة contentUrl:

تمثّل هذه السمة عنوان URL لصورة تبلغ مدة صلاحيتها التلقائية 30 دقيقة. يتم وضع علامة على عنوان URL هذا باستخدام حساب مقدّم الطلب. يمكن لأي مستخدم لديه عنوان URL الوصول إلى الصورة كما لو كان هو مقدّم الطلب الأصلي. قد يتم فقدان إذن الوصول إلى الصورة في حال تغيير إعدادات مشاركة العرض التقديمي.

كتابة contentUrl:

يتم جلب الصورة مرة واحدة عند إدراجها ويتم تخزين نسخة منها لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألا تتجاوز 25 ميغابكسل، وأن تكون بأحد التنسيقات التالية: PNG أو JPEG أو GIF.

يمكن أن يصل طول عنوان URL المقدَّم إلى 2 كيلوبايت كحدّ أقصى.
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)

لون الخرسانة الذي يتوافق مع نوع لون المظهر أعلاه

CommentAnchor

تحتوي على قائمة بجميع المواقع الجغرافية في Page التي يتم ربطها بـ CommentThread من خلال anchorId نفسه. قد تشير عدة علامات ارتساء منفصلة إلى الموقع الجغرافي نفسه، إما ضمن Page أو على صفحات مختلفة.

تمثيل JSON 
{
  "anchorId": string,
  "objectAnchors": [
    {
      object (ObjectAnchor)
    }
  ]
}
الحقول
anchorId

string

النتائج فقط. المعرّف الفريد لمرتكز التعليق
objectAnchors[]

object (ObjectAnchor)

النتائج فقط. جميع المواقع الجغرافية المستندة إلى معرّف الكائن ضمن صفحة تشير إلى معرّف عنصر الربط

ObjectAnchor

تمثّل هذه السمة بيانات مرجع التعليق المرتبطة بكائن "العروض التقديمية من Google"، مثل Page أو PageElement.

تمثيل JSON 
{
  "objectId": string,

  "shapeTextAnchors": {
    object (ShapeTextAnchors)
  },
  "tableCellAnchors": {
    object (TableCellAnchors)
  }
}
الحقول
objectId

string

النتائج فقط. الصفحة أو عنصر الصفحة الذي تم تثبيت سلسلة التعليقات عليه
النتائج فقط. نطاقات النص ضمن عنصر الصفحة الذي تم تثبيت سلسلة المحادثات عليه ستكون هذه السمة فارغة إذا كان رابط التعليق موجّهًا إلى الصفحة أو عنصر الصفحة بالكامل بدلاً من نطاق نصي ضمن العنصر. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
shapeTextAnchors

object (ShapeTextAnchors)

يتم ملء هذا الحقل Shapes التي تتضمّن تعليقات مرتبطة بنطاقات من النص في [text][google.apps.slides.v1.Shape.TextContent] للشكل.
tableCellAnchors

object (TableCellAnchors)

يتم ملء هذا العمود لصفوف Tables التي تتضمّن تعليقات مرتبطة بنطاقات من النص في خلية واحدة أو أكثر من خلايا الجدول.
نهاية الحقول التي يستبعد كلّ منها الآخر

ShapeTextAnchors

تمثّل هذه السمة نطاقات النص داخل شكل يغطّيه عنصر ربط تعليق.

تمثيل JSON 
{
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
الحقول
ranges[]

object (TextRange)

قائمة بنطاقات النص التي يغطيها عنصر ربط التعليق

TextRange

تحدّد هذه السمة نطاقًا متجاورًا من النص ضمن شكل أو خلية جدول text.

تمثيل JSON 
{
  "startIndex": integer,
  "endIndex": integer
}
الحقول
startIndex

integer

الفهرس الصفري لنطاق البداية هذا الحقل هو Int32Value لاستيعاب حالات الاستخدام المستقبلية ذات النطاقات المفتوحة.
endIndex

integer

الفهرس المستند إلى الصفر لنهاية النطاق هذا الحقل هو Int32Value لاستيعاب حالات الاستخدام المستقبلية ذات النطاقات المفتوحة.

TableCellAnchors

تمثّل هذه السمة نطاقات خلايا الجدول ضمن جدول يغطّيه رابط تعليق.

تمثيل JSON 
{
  "cellRanges": [
    {
      object (TableCellTextRanges)
    }
  ]
}
الحقول
cellRanges[]

object (TableCellTextRanges)

قائمة بجميع خلايا الجدول التي تحتوي على نص تغطيه أداة الربط في الجدول

TableCellTextRanges

تمثّل هذه السمة نطاقات النص داخل خلية جدول التي تغطيها علامة ارتساء التعليق.

تمثيل JSON 
{
  "cellLocation": {
    object (TableCellLocation)
  },
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
الحقول
cellLocation

object (TableCellLocation)

تمثّل هذه السمة الموقع الجغرافي لخلية الجدول.
ranges[]

object (TextRange)

قائمة بجميع نطاقات النصوص التي يغطيها العنصر الثابت في هذه الخلية.

الطُرق

get

 تعرض هذه الطريقة أحدث إصدار من الصفحة المحدّدة في العرض التقديمي.

getThumbnail

 تنشئ هذه الدالة صورة مصغّرة لأحدث إصدار من الصفحة المحدّدة في العرض التقديمي وتعرض عنوان URL للصورة المصغّرة.