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),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of mutually exclusive fields.
}
الحقول
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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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 mutually exclusive fields.
}
الحقول
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

تحديد ما إذا كان سيتم تخطّي الشريحة في وضع العرض التقديمي القيمة التلقائية هي "خطأ".

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 فقط. لتعديل الحقل، يجب توفير نظام ألوان يتضمّن عمليات ربط من جميع ThemeColorTypes الـ 12 الأولى إلى ألوانها المحدّدة. سيتم تجاهل ألوان ThemeColorTypes المتبقية.

PageBackgroundFill

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of mutually exclusive fields.
}
الحقول
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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "shapeTextAnchors": {
    object (ShapeTextAnchors)
  },
  "tableCellAnchors": {
    object (TableCellAnchors)
  }
  // End of mutually exclusive fields.
}
الحقول
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 للصورة المصغّرة.