الطلب
نوع واحد من التحديثات المراد تطبيقه على العرض التقديمي.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
kind . نوع التعديل يجب توفّر حقل واحد بالضبط.
يمكن أن تكون السمة kind
واحدة فقط من العناصر التالية:
|
|
createSlide
|
تنشئ شريحة جديدة. |
createShape
|
لإنشاء شكل جديد. |
createTable
|
لإنشاء جدول جديد. |
insertText
|
إدراج نص في شكل جدول أو خلية. |
insertTableRows
|
إدراج صفوف في الجدول |
insertTableColumns
|
إدراج أعمدة في جدول |
deleteTableRow
|
لحذف صف من الجدول. |
deleteTableColumn
|
حذف عمود من الجدول |
replaceAllText
|
استبدال جميع مثيلات النص المحدد. |
deleteObject
|
حذف صفحة أو عنصر صفحة من العرض التقديمي |
updatePageElementTransform
|
تعديل تحويل عنصر صفحة |
updateSlidesPosition
|
تعديل موضع مجموعة من الشرائح في العرض التقديمي |
deleteText
|
لحذف نص من شكل أو خلية في الجدول |
createImage
|
لإنشاء صورة. |
createVideo
|
إنشاء فيديو |
createSheetsChart
|
لإنشاء رسم بياني مضمّن في "جداول بيانات Google". |
createLine
|
تنشئ سطرًا. |
refreshSheetsChart
|
إعادة تحميل رسم بياني من "جداول بيانات Google" |
updateShapeProperties
|
تعدّل سمات |
updateImageProperties
|
تعدّل سمات |
updateVideoProperties
|
تعدّل سمات |
updatePageProperties
|
تعدّل سمات |
updateTableCellProperties
|
تعدّل سمات |
updateLineProperties
|
تعدّل سمات |
createParagraphBullets
|
تنشئ التعداد النقطي للفقرات. |
replaceAllShapesWithImage
|
لاستبدال جميع الأشكال التي تطابق بعض المعايير بصورة. |
duplicateObject
|
تكرار شريحة أو عنصر صفحة. |
updateTextStyle
|
|
replaceAllShapesWithSheetsChart
|
يتم استبدال جميع الأشكال التي تطابق بعض المعايير برسم بياني في "جداول بيانات Google". |
deleteParagraphBullets
|
حذف التعداد النقطي من الفقرات |
updateParagraphStyle
|
|
updateTableBorderProperties
|
تعدّل سمات حدود الجدول في |
updateTableColumnProperties
|
تعدّل خصائص عمود |
updateTableRowProperties
|
تعدِّل هذه السمة خصائص
الصف |
mergeTableCells
|
يدمج الخلايا في |
unmergeTableCells
|
يتم إلغاء دمج الخلايا في
|
groupObjects
|
تجمّع العناصر، مثل عناصر الصفحة. |
ungroupObjects
|
يتم إلغاء تجميع العناصر، مثل |
updatePageElementAltText
|
تعدّل العنوان النص البديل و/أو وصف |
replaceImage
|
تستبدل صورة حالية بصورة جديدة. |
updateSlideProperties
|
تعديل خصائص الشريحة |
updatePageElementsZOrder
|
تحدِّد هذه السياسة ترتيب السمة |
updateLineCategory
|
تغيّر فئة |
rerouteLine
|
يعيد توجيه
|
إنشاء طلب شريحة
تنشئ شريحة.
تمثيل JSON |
---|
{ "objectId": string, "insertionIndex": integer, "slideLayoutReference": { object ( |
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر الذي قدّمه المستخدم.
وإذا حدّدت رقم تعريف، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (تتطابق مع regex
وإذا لم تحدِّد معرّفًا، سيتم إنشاء معرّف فريد. |
insertionIndex
|
فهرس اختياري يستند إلى صفر يشير إلى مكان إدراج الشرائح إذا لم تحدِّد فهرسًا، سيتم إنشاء الشريحة في النهاية. |
slideLayoutReference
|
مرجع التنسيق للشريحة الذي سيتم إدراجه، استنادًا إلى الشريحة الرئيسية الحالية، وهو أحد العناصر التالية:
إذا لم يتم العثور على LayoutReference في الشريحة الرئيسية الحالية، سيتم عرض خطأ طلب 400 غير صحيح.
إذا لم تحدّد مرجعًا للتنسيق، تستخدم الشريحة تنسيق
|
placeholderIdMappings[]
|
قائمة اختيارية لعمليات ربط أرقام تعريف العناصر من
|
مرجع التنسيق
مرجع تنسيق الشريحة قد يشير ذلك إلى أي مما يلي:
- تنسيق مسبق التحديد
- أحد التنسيقات في العرض التقديمي.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
kind . نوع LayoutReference
يمكن أن تكون السمة kind
واحدة فقط من العناصر التالية:
|
|
predefinedLayout
|
التنسيق المحدد مسبقًا. |
layoutId
|
رقم تعريف التنسيق: رقم تعريف العنصر لأحد التنسيقات في العرض التقديمي. |
تنسيق محدد مسبقًا
أنواع التنسيقات المحددة مسبقًا: هذه هي تنسيقات شائعة الاستخدام في العروض التقديمية. ومع ذلك، ما مِن ضمان بأنّ هذه التنسيقات متوفّرة في الشريحة الرئيسية الحالية لأنه قد يكون تم حذفها أو ليست جزءًا من المظهر المستخدَم. علاوةً على ذلك، قد يتم تغيير العناصر النائبة لكل تنسيق.
عمليات التعداد | |
---|---|
PREDEFINED_LAYOUT_UNSPECIFIED
|
تنسيق غير محدّد. |
BLANK
|
التنسيق الفارغ، بدون عناصر نائبة |
CAPTION_ONLY
|
التنسيق مع إضافة شرح في أسفل الصفحة |
TITLE
|
التنسيق مع عنوان وعنوان فرعي. |
TITLE_AND_BODY
|
التنسيق مع عنوان ونص. |
TITLE_AND_TWO_COLUMNS
|
تنسيق مع عنوان وعمودين. |
TITLE_ONLY
|
التنسيق الذي يحتوي على عنوان فقط. |
SECTION_HEADER
|
التنسيق مع عنوان قسم. |
SECTION_TITLE_AND_DESCRIPTION
|
التنسيق الذي يحتوي على عنوان وعنوان فرعي من جهة ووصف في الجهة الأخرى. |
ONE_COLUMN_TEXT
|
التنسيق الذي يحتوي على عنوان واحد ونص واحد في عمود واحد. |
MAIN_POINT
|
التنسيق مع نقطة رئيسية |
BIG_NUMBER
|
التنسيق الذي يحتوي على عنوان عدد كبير. |
LayoutPlaceholderIdMapping
تعيين رقم التعريف الذي يحدده المستخدم للعنصر النائب الذي سيتم إنشاؤه على شريحة من تنسيق محدد.
تمثيل JSON |
---|
{ "objectId": string, // Union field |
الحقول | |
---|---|
objectId
|
معرّف عنصر أضافه المستخدم للعنصر النائب المحدّد أعلاه والذي سيتم إنشاؤه في شريحة.
وإذا حدّدت رقم تعريف، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع regex
وإذا لم تحدِّد معرّفًا، سيتم إنشاء معرّف فريد. |
حقل الاتحاد
kind . النوع لتحديد العنصر النائب في التنسيق.
يمكن أن تكون السمة kind
واحدة فقط من العناصر التالية:
|
|
layoutPlaceholder
|
العنصر النائب في التنسيق الذي سيتم تطبيقه على الشريحة. ولا يمكن استخدام سوى |
layoutPlaceholderObjectId
|
رقم تعريف الكائن للعنصر النائب في التنسيق الذي سيتم تطبيقه على الشريحة. |
إنشاء طلب
لإنشاء شكل جديد.
تمثيل JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر الذي قدّمه المستخدم.
وإذا حدّدت رقم تعريف، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع regex
|
elementProperties
|
خصائص العنصر للشكل. |
shapeType
|
نوع الشكل |
خصائص الصفحة
السمات الشائعة لعنصر صفحة
ملاحظة: عند إنشاء السمة PageElement
، قد تعدِّل واجهة برمجة التطبيقات قيمَي size
وtransform
، إلا أنّ الحجم المرئي لن يتغيّر.
تمثيل JSON |
---|
{ "pageObjectId": string, "size": { object ( |
الحقول | |
---|---|
pageObjectId
|
معرّف العنصر للصفحة التي يظهر فيها العنصر |
size
|
حجم العنصر. |
transform
|
تحويل العنصر. |
طلب إنشاء جدول
لإنشاء جدول جديد.
تمثيل JSON |
---|
{
"objectId": string,
"elementProperties": {
object (
|
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر الذي قدّمه المستخدم.
وإذا حدّدت رقم تعريف، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع regex
وإذا لم تحدِّد معرّفًا، سيتم إنشاء معرّف فريد. |
elementProperties
|
خصائص العنصر في الجدول. سيتم إنشاء الجدول بالحجم المقدَّم، مع مراعاة الحد الأدنى للحجم. في حال عدم توفُّر حجم، سيتم تلقائيًا تغيير حجم الجدول. يجب أن تتضمّن تحويل الجدول مقياسًا واحدًا بدون مكوّنات للقص. في حال عدم إجراء أي تحويل، سيتم توسيط الجدول على الصفحة. |
rows
|
عدد الصفوف في الجدول. |
columns
|
عدد الأعمدة في الجدول. |
طلب نص
إدخال نص في شكل أو خلية في الجدول
تمثيل JSON |
---|
{
"objectId": string,
"cellLocation": {
object (
|
الحقول | |
---|---|
objectId
|
رقم تعريف الكائن للشكل أو الجدول الذي سيتم إدراج النص فيه. |
cellLocation
|
الموقع الجغرافي لخلايا الجدول الاختياري إذا كان سيتم إدراج النص في خلية في الجدول. يجب أن يشير الكائن idId إلى جدول، في حال توفّره. |
text
|
النص الذي سيتم إدراجه.
وسيؤدي إدراج حرف جديد ضمنيًا إلى إنشاء
سيتم تحديد أنماط النص للنص الذي يتم إدراجه تلقائيًا، مع الحفاظ على نمط النص المجاور بشكل عام. وفي معظم الحالات، تتم إضافة النص إلى ستتم إزالة بعض أحرف التحكم (U+0000-U+0008 وU+000C-U+001F) والأحرف من منطقة الاستخدام الخاص لأساسيات الخطة المتعددة اللغات على يونيكود (U+E000-U+F8FF). |
insertionIndex
|
الفهرس الذي سيتم إدراج النص فيه، بوحدات رموز يونيكود، استنادًا إلى
فهارس يستند المؤشر إلى صفر ويتم احتسابه من بداية السلسلة. يمكن تعديل الفهرس لمنع عمليات الإدراج داخل مجموعات رسومات يونيكود. وفي هذه الحالات، سيتم إدراج النص مباشرةً بعد مجموعة الرسم البياني. |
طلب جدولة الجدول
إدراج صفوف في الجدول
تمثيل JSON |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
الحقول | |
---|---|
tableObjectId
|
الجدول المراد إدراج الصفوف فيه. |
cellLocation
|
موقع الخلايا في الجدول المرجعي الذي سيتم إدراج الصفوف منه سيتم إدراج صف جديد أعلى (أو أدناه) الصف الذي تحتوي عليه الخلية المرجعية. إذا كانت الخلية المرجعية هي خلية مدمجة، سيتم إدراج صف جديد أعلى (أو أدناه) الخلية التي تم دمجها. |
insertBelow
|
ما إذا كان سيتم إدراج صفوف جديدة أسفل موقع الخلية المرجعية.
|
number
|
عدد الصفوف المراد إدراجها. يُسمح بإضافة 20 طلبًا كحد أقصى لكل طلب. |
طلب إدراج أعمدة
إدراج أعمدة في جدول
سيتم تغيير حجم الأعمدة الأخرى في الجدول لتلائم العمود الجديد.
تمثيل JSON |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
الحقول | |
---|---|
tableObjectId
|
الجدول المراد إدراج الأعمدة فيه. |
cellLocation
|
موقع الخلايا في الجدول المرجعي الذي سيتم إدراج الأعمدة منه سيتم إدراج عمود جديد على يسار (أو يمين) العمود الذي تتوفّر فيه الخلية المرجعية. إذا كانت الخلية المرجعية هي خلية مدمَجة، سيتم إدراج عمود جديد على يسار الخلية (أو على يمينها). |
insertRight
|
ما إذا كان سيتم إدراج أعمدة جديدة على يسار موقع الخلية المرجعية.
|
number
|
عدد الأعمدة المراد إدراجها. يُسمح بإضافة 20 طلبًا كحد أقصى لكل طلب. |
حذفطلب الجدول
لحذف صف من الجدول.
تمثيل JSON |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
الحقول | |
---|---|
tableObjectId
|
الجدول الذي تريد حذف الصفوف منه |
cellLocation
|
موقع الخلية في الجدول المرجعي الذي سيتم حذف صف منه سيتم حذف الصف الذي تمتد فيه هذه الخلية. إذا كانت هذه الخلية مدمجة، سيتم حذف صفوف متعددة. إذا لم تتبقَ أي صفوف في الجدول بعد هذا الحذف، سيتم حذف الجدول بأكمله. |
طلب حذف جدول الجدول
حذف عمود من الجدول
تمثيل JSON |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
الحقول | |
---|---|
tableObjectId
|
الجدول الذي تريد حذف الأعمدة منه |
cellLocation
|
موقع الخلية في الجدول المرجعي الذي سيتم حذف عمود منه سيتم حذف العمود الذي تمتده هذه الخلية. إذا كانت هذه الخلية مدمجة، سيتم حذف أعمدة متعددة. إذا لم تتبق أي أعمدة في الجدول بعد هذا الحذف، سيتم حذف الجدول بأكمله. |
استبدال كل النصوص
استبدال جميع مثيلات النص المطابق لمعايير بـ replace text
.
تمثيل JSON |
---|
{ "replaceText": string, "pageObjectIds": [ string ], // Union field |
الحقول | |
---|---|
replaceText
|
النص الذي سيحل محل النص المطابق |
pageObjectIds[]
|
إذا كانت السياسة غير فارغة، سيتم حصر المطابقات على عناصر الصفحة على الصفحات المحدّدة فقط.
يتم عرض الخطأ 400 غير صحيح في الطلب إذا تم توفير معرّف عنصر الصفحة في |
حقل الاتحاد
criteria . المعايير المستخدمة لمطابقة النص المطلوب استبداله.
يمكن أن تكون السمة criteria
واحدة فقط من العناصر التالية:
|
|
containsText
|
للعثور على نص في شكل يتطابق مع هذه السلسلة الفرعية. |
سلسلة فرعية للمعايير
معيار يطابق سلسلة نصية معيّنة في شكل أو جدول.
تمثيل JSON |
---|
{ "text": string, "matchCase": boolean } |
الحقول | |
---|---|
text
|
تمثّل هذه السمة النص المطلوب البحث عنه في الشكل أو الجدول. |
matchCase
|
تحدّد هذه السياسة ما إذا كان البحث يجب أن يحترم حالة الأحرف التالية:
|
حذف الكائن
يؤدي إلى حذف عنصر، إما pages
أو page elements
من العرض التقديمي.
تمثيل JSON |
---|
{ "objectId": string } |
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر للصفحة أو عنصر الصفحة المطلوب حذفه
بعد عملية الحذف، إذا كانت السمة في حال تم حذف عنصر نائب في أحد التنسيقات، سيتم أيضًا حذف أي عناصر نائبة فارغة. |
تعديل صفحة الصفحة
تعديل تحويل عنصر صفحة
سيؤدي تحديث تحويل مجموعة إلى تغيير التحوّل المطلق لعناصر الصفحة في تلك المجموعة، ما قد يؤدي إلى تغيير مظهرها. يمكنك الاطّلاع على مستندات
PageElement.transform
للحصول على مزيد من التفاصيل.
تمثيل JSON |
---|
{ "objectId": string, "transform": { object ( |
الحقول | |
---|---|
objectId
|
رقم تعريف عنصر العنصر المراد تعديله. |
transform
|
مصفوفة تحويل الإدخال المستخدمة لتعديل عنصر الصفحة |
applyMode
|
وضع تطبيق تعديل الإحالات الناجحة |
وضع التطبيق
تمثّل هذه السمة أوضاع تطبيق تعديل البيانات.
عمليات التعداد | |
---|---|
APPLY_MODE_UNSPECIFIED
|
وضع غير محدّد |
RELATIVE
|
تطبيق مصفوفة AffineTransform الجديدة على المصفوفة الحالية، واستبدال المصفوفة الحالية بالتسلسل الناتج. |
ABSOLUTE
|
تستبدل مصفوفة AffineTransform الحالية الحالية. |
تعديلطلب موضع في "العروض التقديمية من Google"
تعديل موضع الشرائح في العرض التقديمي
تمثيل JSON |
---|
{ "slideObjectIds": [ string ], "insertionIndex": integer } |
الحقول | |
---|---|
slideObjectIds[]
|
أرقام تعريف الشرائح في العرض التقديمي التي يجب نقلها. يجب أن تكون الشرائح في هذه القائمة بترتيب عرض تقديمي بدون نسخ مكرّرة. |
insertionIndex
|
الفهرس الذي يجب إدراج الشرائح فيه، استنادًا إلى ترتيب الشريحة قبل حدوث عملية النقل يجب أن تكون القيمة بين صفر وعدد الشرائح في العرض التقديمي، بما يشمل هذين الخيارين. |
حذف نص
لحذف نص من شكل أو خلية في الجدول
تمثيل JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر للشكل أو الجدول الذي سيتم حذف النص منه. |
cellLocation
|
الموقع الجغرافي لخلايا الجدول الاختياري إذا كان سيتم حذف النص من خلية في الجدول يجب أن يشير الكائن idId إلى جدول، في حال توفّره. |
textRange
|
نطاق النص المطلوب حذفه، استنادًا إلى
فهارس
هناك دائمًا حرف سطر جديد ضمني في نهاية نص شكل أو خلية في الجدول لا يمكن حذفه.
سيستخدم قد يؤدي حذف النص الذي يتجاوز حدود الفقرة إلى حدوث تغييرات في أنماط الفقرة والقوائم أثناء دمج الفقرتين. يتم توسيع النطاقات التي تتضمن وحدة رمز واحدة فقط لزوج بديل لتتضمّن كلتا وحدتين من الرموز. |
النطاق
تحدِّد نطاقًا متجاورًا لمجموعة مفهرسة، مثل الأحرف في النص.
تمثيل JSON |
---|
{
"startIndex": integer,
"endIndex": integer,
"type": enum (
|
الحقول | |
---|---|
startIndex
|
الفهرس الاختياري الصفري لبداية المجموعة. مطلوبة لـ
|
endIndex
|
الفهرس الاختياري القائم على الصفر لنهاية المجموعة. مطلوبة لـ
|
type
|
تمثّل هذه السمة نوع النطاق. |
Type
أنواع النطاقات.
عمليات التعداد | |
---|---|
RANGE_TYPE_UNSPECIFIED
|
نوع النطاق غير محدد. يجب عدم استخدام هذه القيمة. |
FIXED_RANGE
|
نطاق ثابت. يجب تحديد كل من startIndex وendIndex .
|
FROM_START_INDEX
|
تبدأ النطاق في
startIndex
وتستمر حتى نهاية المجموعة. ويجب عدم تحديد
endIndex .
|
ALL
|
لضبط النطاق ليكون طول المجموعة بالكامل. ويجب عدم تحديد كل من startIndex وendIndex .
|
إنشاء صورة
لإنشاء صورة.
تمثيل JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر الذي قدّمه المستخدم.
وإذا حدّدت رقم تعريف، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع regex
وإذا لم تحدِّد معرّفًا، سيتم إنشاء معرّف فريد. |
elementProperties
|
خصائص العنصر في الصورة عندما لا تتوافق نسبة العرض إلى الارتفاع للحجم المقدّم مع نسبة العرض إلى الارتفاع للصورة، يتمّ تعديل حجمها وتوسيطها في ما يتعلق بالمقاس للحفاظ على نسبة العرض إلى الارتفاع. ويتم تطبيق الإحالة الناجحة المقدَّمة بعد هذه العملية.
والسمة
والسمة |
حقل الاتحاد
image_source . نوع مصدر الصورة
يمكن أن تكون السمة image_source
واحدة فقط من العناصر التالية:
|
|
url
|
عنوان URL للصورة يتم استرجاع الصورة مرة واحدة في وقت الإدراج، ويتم تخزين نسخة لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألا تتجاوز 25 ميغابكسل، ويجب أن تكون بأحد تنسيقات PNG أو JPEG أو GIF.
يجب أن يكون عنوان URL المقدّم متاحًا للجميع وأن يصل طوله إلى 2 كيلوبايت. يتم حفظ عنوان URL مع الصورة، ويظهر في الحقل
|
طلب إنشاء فيديو
إنشاء فيديو
ملاحظة: يتطلب إنشاء فيديو من Google Drive أن يحتوي التطبيق الذي يقدّم الطلب على نطاق واحد على الأقل من نطاقات Drive أو drive.readonly أو drive.file.
تمثيل JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر الذي قدّمه المستخدم.
وإذا حدّدت رقم تعريف، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع regex
وإذا لم تحدِّد معرّفًا، سيتم إنشاء معرّف فريد. |
elementProperties
|
خصائص العنصر للفيديو
والسمة
والسمة |
source
|
مصدر الفيديو |
id
|
تمثّل هذه السمة المعرّف الفريد لمصدر الفيديو الخاص بهذا الفيديو. على سبيل المثال، بالنسبة إلى فيديو YouTube https://www.youtube.com/watch?v=7U3axjORYZ0، يكون المعرّف هو 7U3axjORYZ0. بالنسبة إلى فيديو Google Drive https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q رقم التعريف هو 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q. للوصول إلى ملف فيديو على Google Drive، قد تحتاج إلى إضافة مفتاح مورد إلى عنوان HTTP لمجموعة فرعية من الملفات القديمة. للحصول على مزيد من المعلومات، يُرجى الاطّلاع على الوصول إلى الملفات التي تمت مشاركتها باستخدام رابط باستخدام مفاتيح الموارد. |
إنشاء طلب في "جداول بيانات Google"
لإنشاء رسم بياني مضمّن في "جداول بيانات Google".
ملاحظة: يتطلب إنشاء الرسم البياني واحدًا على الأقل من نطاقات spreadsheets.readonly أو جداول البيانات أو drive.readonly أو drive.file أو Drive.
تمثيل JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر الذي قدّمه المستخدم. ويجب أن يكون المعرّف فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ رقم التعريف بحرف [a-zA-Z0-9_] ثم يتبعه أي عدد من الأحرف التالية [a-zA-Z0-9_-:]. يجب ألا يقل طول المعرّف عن 5 أو أكثر من 50. وفي حال ترك هذا الحقل فارغًا، سيتم إنشاء معرّف فريد. |
elementProperties
|
خصائص العنصر للرسم البياني عندما لا تتطابق نسبة العرض إلى الارتفاع للحجم المقدَّم مع نسبة العرض إلى الارتفاع في الرسم البياني، يتم تغيير حجم الرسم البياني وتوسيطه في ما يتعلّق بالمقاس للحفاظ على نسبة العرض إلى الارتفاع. ويتم تطبيق الإحالة الناجحة المقدَّمة بعد هذه العملية. |
spreadsheetId
|
رقم تعريف جدول بيانات "جداول بيانات Google" الذي يحتوي على الرسم البياني. وقد تحتاج إلى إضافة مفتاح مورد إلى عنوان HTTP لمجموعة فرعية من الملفات القديمة. للحصول على مزيد من المعلومات، يُرجى الاطّلاع على الوصول إلى الملفات التي تمت مشاركتها باستخدام رابط باستخدام مفاتيح الموارد. |
chartId
|
رقم تعريف الرسم البياني المحدّد في جدول بيانات "جداول بيانات Google". |
linkingMode
|
الوضع الذي يرتبط به الرسم البياني في جدول البيانات المصدر. في حال عدم تحديد هذا الحقل، سيكون الرسم البياني صورة غير مرتبطة. |
وضع الربط
الوضع الذي يرتبط به الرسم البياني في جدول البيانات المصدر.
عمليات التعداد | |
---|---|
NOT_LINKED_IMAGE
|
الرسم البياني غير مرتبط بجدول البيانات المصدر ولا يمكن تعديله. وسيتم إدراج رسم بياني غير مرتبط كصورة. |
LINKED
|
يسمح ربط الرسم البياني بتعديله، وسيظهر للمتعاونين الآخرين رابط يؤدي إلى جدول البيانات. |
إنشاء طلب
تنشئ سطرًا.
تمثيل JSON |
---|
{ "objectId": string, "elementProperties": { object ( |
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر الذي قدّمه المستخدم.
وإذا حدّدت رقم تعريف، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع regex
وإذا لم تحدِّد معرّفًا، سيتم إنشاء معرّف فريد. |
elementProperties
|
خصائص العنصر في السطر |
lineCategory
|
فئة السطر الذي سيتم إنشاؤه.
تم الإيقاف
: استخدِم
ويتم تحديد السمة
إذا حدّدت السمة
|
category
|
فئة السطر الذي سيتم إنشاؤه.
ويتم تحديد السمة
إذا حدّدت السمة
إذا لم تحدّد قيمة
إذا لم تحدّد أي منهما، يتم استخدام
|
الفئة
فئات الأسطر.
عمليات التعداد | |
---|---|
STRAIGHT
|
الموصِّلات المستقيمة، بما في ذلك الموصِّل المستقيم 1 وتكون الفئة التلقائية هي سمة غير محدّدة. |
BENT
|
موصِّلات المنحنى، بما في ذلك الموصلات المقوّسة 2 إلى 5. |
CURVED
|
الموصلات المنحنية، بما في ذلك الموصل منحن 2 إلى 5. |
إعادة تحميل رسم بياني من جداول البيانات
ستتم إعادة تحميل الرسم البياني المضمّن في "جداول بيانات Google" عن طريق استبداله بأحدث إصدار من الرسم البياني من "جداول بيانات Google".
ملاحظة: تتطلب إعادة تحميل الرسوم البيانية واحدًا على الأقل من نطاقات sheet.readonly أو جداول البيانات أو Drive.readonly أو Drive.
تمثيل JSON |
---|
{ "objectId": string } |
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر في الرسم البياني المطلوب إعادة تحميله |
طلب تعديل شكل
عدِّل خصائص Shape
.
تمثيل JSON |
---|
{
"objectId": string,
"shapeProperties": {
object (
|
الحقول | |
---|---|
objectId
|
معرِّف العنصر للشكل الذي يتم تطبيق التعديلات عليه. |
shapeProperties
|
خصائص الشكل المراد تعديلها. |
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ الجذر
على سبيل المثال، لتعديل لون التعبئة الثابت لخلفية الشكل، اضبط
لإعادة ضبط السمة على قيمتها التلقائية، يجب تضمين اسم الحقل في قناع الحقل مع ترك الحقل نفسه بدون ضبط. |
طلب تعديل صورة
عدِّل خصائص Image
.
تمثيل JSON |
---|
{
"objectId": string,
"imageProperties": {
object (
|
الحقول | |
---|---|
objectId
|
رقم تعريف الصورة التي يتم تطبيق التعديلات عليها |
imageProperties
|
خصائص الصورة المراد تعديلها. |
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ الجذر
على سبيل المثال، لتعديل لون مخطط الصورة، اضبط لإعادة ضبط السمة على قيمتها التلقائية، يجب تضمين اسم الحقل في قناع الحقل مع ترك الحقل نفسه بدون ضبط. |
طلب تعديل خصائص الفيديو
عدِّل خصائص Video
.
تمثيل JSON |
---|
{
"objectId": string,
"videoProperties": {
object (
|
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر الذي يتم تطبيق التعديلات عليه |
videoProperties
|
خصائص الفيديو التي سيتم تعديلها. |
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ الجذر
على سبيل المثال، لتعديل لون مخطط الفيديو، اضبط
لإعادة ضبط السمة على قيمتها التلقائية، يجب تضمين اسم الحقل في قناع الحقل مع ترك الحقل نفسه بدون ضبط. |
طلب تعديل الصفحة
تعدّل سمات Page
.
تمثيل JSON |
---|
{
"objectId": string,
"pageProperties": {
object (
|
الحقول | |
---|---|
objectId
|
معرِّف كائن الصفحة التي تم تطبيق التحديث عليها. |
pageProperties
|
خصائص الصفحة المراد تعديلها. |
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ الجذر
على سبيل المثال، لتعديل لون التعبئة الثابت لخلفية الصفحة، اضبط
لإعادة ضبط السمة على قيمتها التلقائية، يجب تضمين اسم الحقل في قناع الحقل مع ترك الحقل نفسه بدون ضبط. |
تحديثتحديث الجدول الجدول
عدِّل خصائص TableCell
.
تمثيل JSON |
---|
{ "objectId": string, "tableRange": { object ( |
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر في الجدول. |
tableRange
|
نطاق الجدول الذي يمثّل المجموعة الفرعية من الجدول التي يتم تطبيق التعديلات عليها. وفي حال عدم تحديد نطاق للجدول، سيتم تطبيق التعديلات على الجدول بالكامل. |
tableCellProperties
|
خصائص الخلية في الجدول المطلوب تعديلها |
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ الجذر
على سبيل المثال، لتعديل لون تعبئة خلفية الخلية الثابتة للجدول، اضبط
لإعادة ضبط السمة على قيمتها التلقائية، يجب تضمين اسم الحقل في قناع الحقل مع ترك الحقل نفسه بدون ضبط. |
نطاق الجدول
يمثّل نطاق الجدول مرجعًا إلى مجموعة فرعية من الجدول.
من المهم ملاحظة أن الخلايا المحددة بنطاق النطاق لا تمثل بالضرورة مستطيلاً. على سبيل المثال، لنفترض أن لدينا جدولاً بحجم 3 × 3 حيث يتم دمج كل خلايا الصف الأخير معًا. يبدو الجدول كما يلي:
[ ][ ][ ]
[ ][ ][ ]
[ ]
يشير نطاق الجدول الذي يتضمّن الموقع الجغرافي = (0, 0) ونطاق الصف = 3 ونطاق العمود = 2 إلى الخلايا التالية:
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
تمثيل JSON |
---|
{
"location": {
object (
|
الحقول | |
---|---|
location
|
موقع بداية نطاق الجدول. |
rowSpan
|
نطاق الصف لنطاق الجدول. |
columnSpan
|
نطاق العمود لنطاق الجدول. |
طلب تعديل الموقع
تعدّل سمات Line
.
تمثيل JSON |
---|
{
"objectId": string,
"lineProperties": {
object (
|
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر للسطر الذي يتم تطبيق التحديث عليه. |
lineProperties
|
خصائص العنصر المطلوب تعديلها |
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ الجذر
على سبيل المثال، لتعديل لون التعبئة الثابت للسطر، اضبط
لإعادة ضبط السمة على قيمتها التلقائية، يجب تضمين اسم الحقل في قناع الحقل مع ترك الحقل نفسه بدون ضبط. |
إنشاء طلب ParagraphBullets
يتم إنشاء رموز نقطية لجميع الفقرات التي تتداخل مع نطاق فهرس النص المحدد.
يتم تحديد مستوى التداخل لكل فقرة من خلال حساب علامات التبويب الرئيسية أمام كل فقرة. لتجنب المسافة الزائدة بين النقطة النقطية والفقرة المقابلة، تتم إزالة علامات التبويب الرئيسية هذه عن طريق هذا الطلب. وقد يؤدي هذا إلى تغيير فهارس أجزاء النص.
إذا كانت الفقرة التي تسبق تعديل الفقرات مباشرةً في قائمة تتضمّن إعدادًا مسبقًا مطابقًا، تتم إضافة الفقرات التي يتم تعديلها إلى تلك القائمة السابقة.
تمثيل JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر للشكل أو الجدول الذي يحتوي على النص لإضافة رموز نقطية إليه. |
cellLocation
|
موقع اختياري لخلية الجدول إذا كان النص المطلوب تعديله في خلية جدول. يجب أن يشير الكائن idId إلى جدول، في حال توفّره. |
textRange
|
نطاق النص المطلوب تطبيق الإعدادات المسبقة على عنصر القائمة النقطية استنادًا إلى
فهارس |
bulletPreset
|
أنواع الرموز الرسومية النقطية التي سيتم استخدامها. الإعداد التلقائي هو
|
BulletGlyphPreset
الأنماط المُعدَّة مسبقًا للنصوص الرسومية للقوائم في نص.
تستخدم هذه الأنماط هذه الأنواع من التعداد النقطي:
-
ARROW
: سهم، يتوافق مع نقطة رمز يونيكود U+2794 -
ARROW3D
: سهم بتظليل ثلاثي الأبعاد، يقابل نقطة رمز يونيكود U+27a2 -
CHECKBOX
: مربّع مجوف يقابل نقطة الرمز يونيكود U+274f -
CIRCLE
: دائرة مفرغة، مقابل نقطة رمز يونيكود U+25cb -
DIAMOND
: ماسة ثابتة، مقابل نقطة رمز يونيكود U+25c6 -
DIAMONDX
: الشكل الماسي الذي يتضمّن علامة x، مطابقًا لنقطة الرمز يونيكود U+2756 -
HOLLOWDIAMOND
: ماسة مفرغة، مقابل نقطة رمز يونيكود U+25c7 -
DISC
: دائرة متصلة تقابل نقطة رمز يونيكود U+25cf -
SQUARE
: مربّع متصل يطابق نقطة الرمز يونيكود U+25a0 -
STAR
: نجمة، تتطابق مع نقطة رمز يونيكود U+2605 -
ALPHA
: حرف صغير، مثل "a" أو "b" أو "c". -
UPPERALPHA
: حرف كبير، مثل "A" أو "B" أو "C". -
DIGIT
: رقم، مثل "1" أو "2" أو "3". -
ZERODIGIT
: رقم يتم فيه احتساب الرقم المكوّن من رقم واحد مسبوقًا بصفر، مثل "01" أو "02" أو "03". إنّ الأرقام التي تحتوي على أكثر من رقم لا تكون مسبوقة بصفر. -
ROMAN
: رقم روماني صغير، مثل 'i' أو 'ii' أو 'iii'. -
UPPERROMAN
: رقم روماني كبير، مثل "I" أو "II" أو "III". -
LEFTTRIANGLE
: مثلث يشير إلى اليسار ويقابل نقطة رمز يونيكود U+25c4
عمليات التعداد | |
---|---|
BULLET_DISC_CIRCLE_SQUARE
|
قائمة نقطية تتضمّن
حرفَي DISC
وCIRCLE
وSQUARE
لأوّل 3 مستويات دمج في القائمة
|
BULLET_DIAMONDX_ARROW3D_SQUARE
|
قائمة نقطية تتضمّن
حرفَي DIAMONDX
وARROW3D
وSQUARE
لأوّل 3 مستويات دمج في القائمة
|
BULLET_CHECKBOX
|
قائمة نقطية تتضمّن
رموزًا نصية نقطية
CHECKBOX
لجميع مستويات دمج القوائم
|
BULLET_ARROW_DIAMOND_DISC
|
قائمة نقطية تتضمّن
حرفَي ARROW
وDIAMOND
وDISC
لأوّل 3 مستويات دمج في القائمة
|
BULLET_STAR_CIRCLE_SQUARE
|
قائمة نقطية تتضمّن
حرفَي STAR
وCIRCLE
وSQUARE
لأوّل 3 مستويات دمج في القائمة
|
BULLET_ARROW3D_CIRCLE_SQUARE
|
قائمة نقطية تتضمّن
حرفَي ARROW3D
وCIRCLE
وSQUARE
لأوّل 3 مستويات دمج في القائمة
|
BULLET_LEFTTRIANGLE_DIAMOND_DISC
|
قائمة نقطية تتضمّن
حرفَي LEFTTRIANGLE
وDIAMOND
وDISC
لأوّل 3 مستويات دمج في القائمة
|
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE
|
قائمة نقطية تتضمّن
حرفَي DIAMONDX
وHOLLOWDIAMOND
وSQUARE
لأوّل 3 مستويات دمج في القائمة
|
BULLET_DIAMOND_CIRCLE_SQUARE
|
قائمة نقطية تتضمّن
حرفَي DIAMOND
وCIRCLE
وSQUARE
لأوّل 3 مستويات دمج في القائمة
|
NUMBERED_DIGIT_ALPHA_ROMAN
|
قائمة مرقّمة تتضمّن
DIGIT و
ALPHA
وROMAN
رموز رسومية رقمية لأول 3 مستويات لدمج القائمة، متبوعةً بنقاط.
|
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS
|
قائمة مرقّمة تتضمّن
DIGIT و
ALPHA
وROMAN
حروف رسومية رقمية لأول 3 مستويات لإدراجها متبوعة بأقواس.
|
NUMBERED_DIGIT_NESTED
|
قائمة مرقّمة تتضمّن حروفًا أبجدية رقمية مكوّنة من DIGIT مع الفصل بينها بنقاط، حيث يستخدم كل مستوى دمج الرمز الرسومي لمستوى التداخل السابق كبادئة. على سبيل المثال: "1." "1.1". '2.', "2.2".
|
NUMBERED_UPPERALPHA_ALPHA_ROMAN
|
قائمة مرقّمة تتضمّن
UPPERALPHA و
ALPHA
وROMAN
رموز رسومية رقمية لأول 3 مستويات لدمج القائمة، متبوعةً بنقاط.
|
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT
|
قائمة مرقّمة تتضمّن
UPPERROMAN و
UPPERALPHA
وDIGIT
رموز رسومية رقمية لأول 3 مستويات لدمج القائمة، متبوعةً بنقاط.
|
NUMBERED_ZERODIGIT_ALPHA_ROMAN
|
قائمة مرقّمة تتضمّن
ZERODIGIT و
ALPHA
وROMAN
رموز رسومية رقمية لأول 3 مستويات لدمج القائمة، متبوعةً بنقاط.
|
استبدال كل الأشكال باستخدام طلب الصور
يتم استبدال جميع الأشكال التي تطابق المعايير المحددة بالصورة التي يتم تقديمها.
تكون الصور التي تحل محل الأشكال مستطيلة بعد إدراجها في العرض التقديمي ولا تأخذ أشكالها.
تمثيل JSON |
---|
{ "replaceMethod": enum ( |
الحقول | |
---|---|
replaceMethod
|
طريقة الاستبدال.
تم الإيقاف
: استخدِم
إذا حدّدت السمة
|
imageReplaceMethod
|
طريقة استبدال الصورة.
إذا حدّدت السمة
إذا لم تحدّد قيمة
إذا لم تحدِّد أيًا منهما، يتم استخدام CENTER_INSIDE. |
pageObjectIds[]
|
إذا كانت السياسة غير فارغة، سيتم حصر المطابقات على عناصر الصفحة على الصفحات المحدّدة فقط.
تعرض رسالة الخطأ 400 غير صحيح في حال توفّر معرّف عنصر الصفحة
|
حقل الاتحاد
criteria . المعايير التي يجب أن تطابق الأشكال ليتم استبدالها.
يمكن أن تكون السمة criteria
واحدة فقط من العناصر التالية:
|
|
containsText
|
في حال ضبط السياسة، سيحل هذا الطلب محل جميع الأشكال التي تحتوي على النص. |
حقل الاتحاد
image_source . نوع مصدر الصورة
يمكن أن تكون السمة image_source
واحدة فقط من العناصر التالية:
|
|
imageUrl
|
عنوان URL للصورة يتم استرجاع الصورة مرة واحدة في وقت الإدراج، ويتم تخزين نسخة لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألا تتجاوز 25 ميغابكسل، ويجب أن تكون بأحد تنسيقات PNG أو JPEG أو GIF.
لا يمكن أن يزيد عنوان URL المقدَّر عن 2 كيلوبايت. يتم حفظ عنوان URL نفسه مع الصورة ويظهر في الحقل |
طريقة الاستبدال
طريقة الاستبدال.
عمليات التعداد | |
---|---|
CENTER_INSIDE
|
تحجيم الصورة وتوسيطها لتتلاءم مع حدود الشكل الأصلي وتحافظ على نسبة العرض إلى الارتفاع للصورة. قد يكون الحجم المعروض للصورة أصغر من حجم الشكل. وهذه هي الطريقة التلقائية في حال عدم تحديد أحدها. |
CENTER_CROP
|
تحجيم الصورة وتوسيطها لملء حدود الشكل الأصلي. يمكن اقتصاص الصورة لملء الشكل. سيكون حجم الصورة مطابقًا لحجم الشكل الأصلي. |
طريقة استبدال الصورة
طريقة استبدال الصورة.
عمليات التعداد | |
---|---|
IMAGE_REPLACE_METHOD_UNSPECIFIED
|
طريقة استبدال الصور غير محدّدة يجب عدم استخدام هذه القيمة. |
CENTER_INSIDE
|
تحجيم الصورة وتوسيطها لتتلاءم مع حدود الشكل الأصلي وتحافظ على نسبة العرض إلى الارتفاع للصورة. قد يكون الحجم المعروض للصورة أصغر من حجم الشكل. وهذه هي الطريقة التلقائية في حال عدم تحديد أحدها. |
CENTER_CROP
|
تحجيم الصورة وتوسيطها لملء حدود الشكل الأصلي. يمكن اقتصاص الصورة لملء الشكل. سيكون حجم الصورة المعروض مطابقًا للشكل الأصلي. |
طلب عنصر مكرّر
تكرار شريحة أو عنصر صفحة.
عند تكرار شريحة، سيتم إنشاء الشريحة المكررة فورًا بعد الشريحة المحددة. عند إنشاء نسخة طبق الأصل من عنصر صفحة، سيتم وضع الصفحة المكرّرة في الصفحة نفسها مع الموضع الأصلي.
تمثيل JSON |
---|
{ "objectId": string, "objectIds": { string: string, ... } } |
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر المكرّر. |
objectIds
|
قد يحتوي العنصر المكرّر على عناصر أخرى، مثلاً عند تكرار شريحة أو عنصر صفحة مجموعة. تحدِّد هذه الخريطة كيفية إنشاء أرقام تعريف العناصر المكرّرة: المفاتيح هي أرقام تعريف العناصر الأصلية وقيمها هي أرقام التعريف التي سيتم تخصيصها للعنصر المكرّر المقابل. ويمكن أيضًا تحديد رقم تعريف تكرار عنصر المصدر في هذه الخريطة أيضًا، باستخدام القيمة نفسها لحقل
يجب أن تتوافق جميع المفاتيح مع أرقام التعريف الحالية في العرض التقديمي. يجب أن تكون جميع القيم فريدة في العرض التقديمي ويجب أن تبدأ بحرف أبجدي رقمي أو شرطة سفلية (تتطابق مع regex
في حال حذف أي أرقام تعريف لعناصر مصدر من الخريطة، سيتم تخصيص رقم تعريف عشوائي جديد. إذا كانت الخريطة فارغة أو بدون ضبط، ستتلقى جميع العناصر المكرّرة رقم تعريف عشوائيًا جديدًا. |
تعديل نمط النص
تمثيل JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
الحقول | |
---|---|
objectId
|
تمثّل هذه السمة رقم تعريف العنصر للشكل أو الجدول الذي يتضمّن النص المطلوب تصميمه. |
cellLocation
|
موقع الخلية في الجدول الذي يحتوي على النص للنمط. إذا كانت السمة |
style
|
الأنماط التي يتم ضبطها في النص. إذا كانت قيمة نمط معيّن تتطابق مع قيمة النمط الرئيسي، سيتم ضبط هذا النمط على اكتساب.
قد تؤدي تغييرات معينة في نمط النص إلى تغييرات أخرى تهدف إلى محاكاة سلوك محرّر "العروض التقديمية من Google". يمكنك الاطّلاع على مستندات |
textRange
|
نطاق النص للأسلوب. يمكن توسيع النطاق ليشمل أسطر جديدة. إذا كان النطاق يحتوي بالكامل على فقرة تنتمي إلى قائمة، يتم أيضًا تعديل النقطة في الفقرة بنمط النمط المطابق. |
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ الجذر
على سبيل المثال، لتعديل نمط النص بالخط الغامق، اضبط
لإعادة ضبط السمة على قيمتها التلقائية، يجب تضمين اسم الحقل في قناع الحقل مع ترك الحقل نفسه بدون ضبط. |
استبدال كل الأشكال باستخدام جداول بيانات Google
يتم استبدال جميع الأشكال التي تطابق المعايير المحددة بالرسم البياني في "جداول بيانات Google". سيتم تغيير حجم الرسم البياني وتوسيطه ليتسع في حدود الشكل الأصلي.
ملاحظة: يتطلب استبدال الأشكال باستخدام رسم بياني واحدًا على الأقل من جداول البيانات التي تتم قراءتها فقط أو جداول البيانات أو Drive.readonly أو Drive.
تمثيل JSON |
---|
{ "containsText": { object ( |
الحقول | |
---|---|
containsText
|
المعايير التي يجب أن تطابق الأشكال ليتم استبدالها. سيحل الطلب محل جميع الأشكال التي تحتوي على النص المعنيّ. |
spreadsheetId
|
رقم تعريف جدول بيانات "جداول بيانات Google" الذي يحتوي على الرسم البياني. |
chartId
|
رقم تعريف الرسم البياني المحدّد في جدول بيانات "جداول بيانات Google". |
linkingMode
|
الوضع الذي يرتبط به الرسم البياني في جدول البيانات المصدر. في حال عدم تحديد هذا الحقل، سيكون الرسم البياني صورة غير مرتبطة. |
pageObjectIds[]
|
إذا كانت السياسة غير فارغة، سيتم حصر المطابقات على عناصر الصفحة على الصفحات المحدّدة فقط.
تعرض رسالة الخطأ 400 غير صحيح في حال توفّر معرّف عنصر الصفحة
|
وضع الربط
الوضع الذي يرتبط به الرسم البياني في جدول البيانات المصدر.
عمليات التعداد | |
---|---|
NOT_LINKED_IMAGE
|
الرسم البياني غير مرتبط بجدول البيانات المصدر ولا يمكن تعديله. وسيتم إدراج رسم بياني غير مرتبط كصورة. |
LINKED
|
يسمح ربط الرسم البياني بتعديله، وسيظهر للمتعاونين الآخرين رابط يؤدي إلى جدول البيانات. |
حذف حذفPARgraphBulletsRequest
يتم حذف الرموز النقطية من جميع الفقرات التي تتداخل مع فهرس النص المحدّد
range
.
سيتم الاحتفاظ بمستوى التداخل لكل فقرة بشكل مرئي عن طريق إضافة مسافة بادئة إلى بداية الفقرة المقابلة.
تمثيل JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
الحقول | |
---|---|
objectId
|
معرّف الكائن للشكل أو الجدول الذي يحتوي على النص لحذف الرموز النقطية منه. |
cellLocation
|
موقع اختياري لخلية الجدول إذا كان النص المطلوب تعديله في خلية جدول. يجب أن يشير الكائن idId إلى جدول، في حال توفّره. |
textRange
|
نطاق النص المطلوب حذف الرموز النقطية استنادًا إلى
فهارس
|
تعديل ParagraphStyleRequest
يعدّل النمط جميع الفقرات ضمن Shape
أو Table
التي تتداخل مع نطاق فهرس النص المحدد.
تمثيل JSON |
---|
{ "objectId": string, "cellLocation": { object ( |
الحقول | |
---|---|
objectId
|
تمثّل هذه السمة رقم تعريف العنصر للشكل أو الجدول الذي يتضمّن النص المطلوب تصميمه. |
cellLocation
|
موقع الخلية في الجدول الذي يحتوي على الفقرة(الفقرات) للنمط. إذا كانت السمة |
style
|
نمط الفقرة |
textRange
|
نطاق النص الذي يحتوي على الفقرة(الفقرات) إلى النمط. |
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ الجذر
على سبيل المثال، لتعديل محاذاة الفقرة، اضبط
لإعادة ضبط السمة على قيمتها التلقائية، يجب تضمين اسم الحقل في قناع الحقل مع ترك الحقل نفسه بدون ضبط. |
تعديل RequestTableBorderProperties
تعدّل سمات حدود الجدول في Table
.
تمثيل JSON |
---|
{ "objectId": string, "tableRange": { object ( |
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر في الجدول. |
tableRange
|
نطاق الجدول الذي يمثّل المجموعة الفرعية من الجدول التي يتم تطبيق التعديلات عليها. وفي حال عدم تحديد نطاق للجدول، سيتم تطبيق التعديلات على الجدول بالكامل. |
borderPosition
|
موضع الحدود في نطاق الجدول الذي يجب أن تنطبق عليه التعديلات. وفي حال عدم تحديد موضع للحد الجغرافي، ستنطبق التعديلات على جميع الحدود في نطاق الجدول. |
tableBorderProperties
|
خصائص حدود الجدول المراد تعديلها |
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ الجذر
على سبيل المثال، لتعديل لون تعبئة لون الجدول الثابت، اضبط
لإعادة ضبط السمة على قيمتها التلقائية، يجب تضمين اسم الحقل في قناع الحقل مع ترك الحقل نفسه بدون ضبط. |
موضع الحدود
تمثّل هذه السمة موضع حدود الجدول.
عمليات التعداد | |
---|---|
ALL
|
جميع الحدود في النطاق |
BOTTOM
|
الحدود في أسفل النطاق |
INNER
|
الحدود في داخل النطاق. |
INNER_HORIZONTAL
|
الحدود الأفقية داخل بداخل النطاق. |
INNER_VERTICAL
|
الحدود العمودية على داخل النطاق. |
LEFT
|
الحدود على يمين النطاق. |
OUTER
|
الحدود على طول النطاق. |
RIGHT
|
الحدود على يسار النطاق |
TOP
|
الحدود في أعلى النطاق |
طلب تعديل جدول الأعمدة
تعدّل خصائص عمود Table
.
تمثيل JSON |
---|
{
"objectId": string,
"columnIndices": [
integer
],
"tableColumnProperties": {
object (
|
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر في الجدول. |
columnIndices[]
|
قائمة الفهارس المستندة إلى الصفر التي تحدِّد الأعمدة التي سيتم تعديلها. إذا لم تتوفر فهارس، سيتم تعديل جميع الأعمدة في الجدول. |
tableColumnProperties
|
خصائص عمود الجدول المطلوب تعديلها.
إذا كانت قيمة
|
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ الجذر
على سبيل المثال، لتعديل عرض العمود، اضبط
إذا تم تضمين "'ColumnWidth"' في قناع الحقل ولكن تم ترك السمة بدون ضبط، سيتم تلقائيًا ضبط عرض العمود على 406,400 EMU (32 نقطة). |
تعديلتحديث_صف_جدول
تعدِّل هذه السمة خصائص
الصف Table
.
تمثيل JSON |
---|
{
"objectId": string,
"rowIndices": [
integer
],
"tableRowProperties": {
object (
|
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر في الجدول. |
rowIndices[]
|
قائمة الفهارس المستندة إلى الصفر التي تحدِّد الصفوف التي سيتم تعديلها. في حال عدم توفّر أي فهارس، سيتم تعديل كل الصفوف في الجدول. |
tableRowProperties
|
خصائص صف الجدول المراد تعديلها. |
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ الجذر
على سبيل المثال، لتعديل الحد الأدنى لارتفاع الصف، اضبط
إذا تم تضمين "min شبكةHeight" في قناع الحقل ولكن تم ترك السمة بدون ضبط، سيتم تلقائيًا ضبط الحد الأدنى لارتفاع الصف على 0. |
طلب دمج خلايا الجدول
يدمج الخلايا في Table
.
تمثيل JSON |
---|
{
"objectId": string,
"tableRange": {
object (
|
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر في الجدول. |
tableRange
|
نطاق الجدول الذي يحدد الخلايا التي سيتم دمجها في الجدول. سيتم ربط أي نص في الخلايا التي يتم دمجها وتخزينها في خلية أعلى اليسار ("الرأس"). إذا كان النطاق غير مستطيل (وقد يحدث في بعض الحالات إذا كان النطاق يشمل الخلايا التي تم دمجها من قبل)، سيتم عرض الخطأ "400" غير صحيح في الطلب. |
إلغاء دمج خلايا الجدول
يتم إلغاء دمج الخلايا في
Table
.
تمثيل JSON |
---|
{
"objectId": string,
"tableRange": {
object (
|
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر في الجدول. |
tableRange
|
نطاق الجدول الذي يحدد خلايا الجدول التي سيتم إلغاء دمجها. سيتم إلغاء دمج كل الخلايا التي تم دمجها في هذا النطاق، ولن تتأثر الخلايا التي لم يتم إلغاء دمجها من قبل. إذا لم يحتوي النطاق على خلايا مدمَجة، لن تنفيذ أي إجراء. إذا كان هناك نص في أي من الخلايا المدمجة، سيظل النص في الخلية العليا اليسرى ("الرأس") من الكتلة الناتجة من الخلايا غير المدمجة. |
طلب طلب الكائن
تجمِّع العناصر لإنشاء مجموعة عناصر. على سبيل المثال، مجموعات
PageElements
لإنشاء
Group
على الصفحة نفسها مثل جميع الأطفال.
تمثيل JSON |
---|
{ "groupObjectId": string, "childrenObjectIds": [ string ] } |
الحقول | |
---|---|
groupObjectId
|
معرِّف عنصر أنشأه المستخدم ليتم إنشاء المجموعة له.
وإذا حدّدت رقم تعريف، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع regex
وإذا لم تحدِّد معرّفًا، سيتم إنشاء معرّف فريد. |
childrenObjectIds[]
|
أرقام تعريف العناصر المطلوب تجميعها
لا يمكن تجميع سوى عناصر الصفحة. يجب عرض عنصرَين على الأقل للصفحة نفسها في مجموعة أخرى. لا يمكن تجميع بعض عناصر الصفحات، مثل
|
إلغاء طلب المجموعة
يتم إلغاء تجميع العناصر، مثل groups
.
تمثيل JSON |
---|
{ "objectIds": [ string ] } |
الحقول | |
---|---|
objectIds[]
|
أرقام تعريف العناصر المراد إلغاء تجميعها.
لا يمكن إلغاء تجميع سوى السمة |
تعديل صفحة الصفحة البديلة النص
تعدّل العنوان النص البديل و/أو وصف page element
.
تمثيل JSON |
---|
{ "objectId": string, "title": string, "description": string } |
الحقول | |
---|---|
objectId
|
رقم تعريف عنصر العنصر الذي يتم تطبيق التعديلات عليه |
title
|
عنوان النص البديل المعدَّل لعنصر الصفحة. وفي حال ترك هذه السياسة بدون ضبط، سيتم الاحتفاظ بالقيمة الحالية. يظهر العنوان لبرامج قراءة الشاشة وواجهات تسهيل الاستخدام الأخرى. استخدم فقط قيمًا بشرية قابلة للقراءة ذات صلة بمحتوى عنصر الصفحة. |
description
|
الوصف النصي المعدَّل لعنصر الصفحة وفي حال ترك هذه السياسة بدون ضبط، سيتم الاحتفاظ بالقيمة الحالية. ويظهر الوصف لبرامج قراءة الشاشة وواجهات تسهيل الاستخدام الأخرى. استخدم فقط قيمًا بشرية قابلة للقراءة ذات صلة بمحتوى عنصر الصفحة. |
استبدال صورة
تستبدل صورة حالية بصورة جديدة.
سيؤدي استبدال صورة إلى إزالة بعض
image effects
من الصورة الحالية.
تمثيل JSON |
---|
{ "imageObjectId": string, "imageReplaceMethod": enum ( |
الحقول | |
---|---|
imageObjectId
|
رقم تعريف الصورة الحالية التي سيتم استبدالها يمكن استرداد المعرّف من ردّ على طلب الحصول على الإذن. |
imageReplaceMethod
|
طريقة الاستبدال. |
حقل الاتحاد
image_source . نوع مصدر الصورة
يمكن أن تكون السمة image_source
واحدة فقط من العناصر التالية:
|
|
url
|
عنوان URL للصورة يتم استرجاع الصورة مرة واحدة في وقت الإدراج، ويتم تخزين نسخة لعرضها داخل العرض التقديمي. يجب أن تكون الصور أقل من 50 ميغابايت، وألا تتجاوز 25 ميغابكسل، ويجب أن تكون بتنسيق PNG أو JPEG أو GIF.
لا يمكن أن يزيد عنوان URL المقدَّم عن 2 كيلوبايت. يتم حفظ عنوان URL مع الصورة، ويظهر في الحقل
|
طلب تعديل خصائص الشريحة
تعدِّل خصائص الشريحة.
تمثيل JSON |
---|
{
"objectId": string,
"slideProperties": {
object (
|
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر للشريحة التي يتم تطبيق التحديث عليها. |
slideProperties
|
خصائص الشريحة المراد تعديلها. |
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ جذر "slideالعروض" ضمنيًا ويجب عدم تحديده. يمكن استخدام
على سبيل المثال، لتعديل ما إذا كان سيتم تخطي شريحة، يمكنك ضبط
لإعادة ضبط السمة على قيمتها التلقائية، يجب تضمين اسم الحقل في قناع الحقل مع ترك الحقل نفسه بدون ضبط. |
تعديل صفحة الصفحة
يعدّل الترتيب Z لعناصر الصفحة. الترتيب حسب الترتيب هو ترتيب للعناصر في الصفحة من الخلف إلى الأمام. قد يغطي عنصر الصفحة في المقدمة العناصر الموجودة خلفه.
تمثيل JSON |
---|
{
"pageElementObjectIds": [
string
],
"operation": enum (
|
الحقول | |
---|---|
pageElementObjectIds[]
|
أرقام تعريف عناصر العناصر التي سيتم تعديلها. ويجب أن تكون جميع عناصر الصفحة على الصفحة نفسها، ويجب عدم تجميعها. |
operation
|
عملية الترتيب Z لتطبيق عناصر على الصفحة. وعند تطبيق العملية على عناصر صفحات متعددة، يتم عرض طلبات "ر" و"ز" النسبية ضمن عناصر هذه الصفحات قبل الاحتفاظ بالعملية. |
ZOrderOperation
عملية تعديل ترتيب Z لعنصر صفحة.
عمليات التعداد | |
---|---|
Z_ORDER_OPERATION_UNSPECIFIED
|
عملية غير محدّدة |
BRING_TO_FRONT
|
تجلب عناصر الصفحة إلى الجزء الأمامي من الصفحة. |
BRING_FORWARD
|
لجلب عناصر الصفحة إلى الصفحة التالية من خلال عنصر واحد بالنسبة إلى العنصر الأبعد إلى عناصر الصفحة المحددة. |
SEND_BACKWARD
|
ترسل عناصر الصفحة إلى الخلف على الصفحة حسب عنصر واحد بالنسبة إلى أبعد عنصر خلفها في عناصر الصفحة المحددة. |
SEND_TO_BACK
|
تُرسِل عناصر الصفحة إلى الجزء الخلفي من الصفحة. |
طلب تعديل الفئة
تغيّر فئة line
.
تمثيل JSON |
---|
{
"objectId": string,
"lineCategory": enum (
|
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر للسطر الذي يتم تطبيق التحديث عليه.
لا يمكن تعديل سوى السطر الذي يحتوي على
قد تتم إعادة توجيه الخط بعد تحديث الفئة. |
lineCategory
|
فئة العنصر المطلوب التحديث إليه.
ويتم تحديد العلامة
|
طلب إعادة التوجيه
يعيد توجيه
line
بحيث يتم ربطه في أقرب موقعَين للاتصال من خلال عناصر الصفحة المرتبطة.
تمثيل JSON |
---|
{ "objectId": string } |
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر المطلوب إعادة توجيهه.
لا يمكن إعادة توجيه سوى السطر الذي يتضمن
|