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)

خصائص محدّدة في Notes لا يتم التعيين إلا إذا كان pageType = NOTES.

masterProperties

object (MasterProperties)

أتقِن خصائص معيّنة. لا يتم التعيين إلا إذا كانت pageType = MASTER.

نوع الصفحة

نوع الصفحة.

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

عنصر الصفحة

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

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

المجموعة

نوع PageElement يمثل مجموعة من عناصر PageElements المنضمة.

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

object (PageElement)

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

WordArt

نوع PageElement يمثل Word Art.

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

string

النص المعروض في صورة Word Art.

خصائص الشرائح

خصائص Page ذات الصلة فقط بالصفحات التي تحتوي على نوع الصفحة 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".

خصائص التنسيق

تقتصر خصائص Page على الصفحات التي تحتوي على نوع الصفحة LAYOUT فقط.

تمثيل JSON
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
الحقول
masterObjectId

string

رقم تعريف العنصر الرئيسي الذي يستند إليه هذا التنسيق.

name

string

اسم التنسيق.

displayName

string

تمثّل هذه الخاصية اسم التنسيق القابل للقراءة.

خصائص Notes

خصائص Page ذات الصلة فقط بالصفحات التي تحتوي على pageType NOTES.

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

string

رقم تعريف الكائن للشكل على صفحة الملاحظات هذه التي تحتوي على ملاحظات المُحاضر في الشريحة المقابلة. قد لا يكون الشكل الفعلي موجودًا دائمًا في صفحة الملاحظات. سيؤدي إدراج نص باستخدام رقم تعريف الكائن هذا إلى إنشاء الشكل تلقائيًا. في هذه الحالة، قد يشتمل الشكل الفعلي على رقم تعريف عنصر مختلف. سيؤدي الإجراء presentations.get أو pages.get دائمًا إلى عرض أحدث رقم تعريف للعنصر.

الخصائص الرئيسية

خصائص Page ذات الصلة فقط بالصفحات التي تحتوي على pageType MASTER.

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

string

اسم الشريحة الرئيسية الذي يمكن للإنسان قراءته.

خصائص الصفحة

خصائص Page.

ستكتسب الصفحة خصائص من الصفحة الرئيسية. استنادًا إلى نوع الصفحة، يتم تحديد التدرّج الهرمي على SlideProperties أو LayoutProperties.

تمثيل JSON
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
الحقول
pageBackgroundFill

object (PageBackgroundFill)

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

colorScheme

object (ColorScheme)

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

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

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

يتم ملء خلفية الصفحة.

تمثيل 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)

ملء الصورة الممتدة.

ملء صورة تمدد

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

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

string

قراءة contentUrl:

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

كتابة contentUrl:

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

يجب ألا يزيد طول عنوان URL المقدّم عن 2 كيلوبايت.

size

object (Size)

الحجم الأصلي لملء الصورة. هذا الحقل للقراءة فقط.

نظام الألوان

لوحة الألوان المحددة مسبقًا للصفحة.

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

object (ThemeColorPair)

ThemeColorType وأزواج الألوان الخرسانية المقابلة لها.

زوج مظاهر

زوج يربط نوع لون المظهر بلون الخرسانة الذي يمثله.

تمثيل JSON
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
الحقول
type

enum (ThemeColorType)

نوع لون المظهر.

color

object (RgbColor)

اللون الخرساني المناسب لنوع لون المظهر أعلاه.

الطُرق

get

للحصول على أحدث نسخة من الصفحة المحددة في العرض التقديمي.

getThumbnail

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