أحد التطبيقات المفيدة لواجهة برمجة تطبيقات Google Slides هو دمج المعلومات من مصدر بيانات أو أكثر في مجموعة شرائح مصممة وفقًا لنموذج.
توضح هذه الصفحة كيف يمكنك أخذ البيانات من مصدر خارجي وإدراجها في عرض تقديمي للنموذج الحالي. يشبه المفهوم دمج البريد باستخدام معالج الكلمات وجدول البيانات.
وهناك عدة أسباب قد تجعل هذا المنهج مفيدًا:
من السهل على المصممين ضبط تصميم العرض التقديمي باستخدام محرر Google Slides. هذا أسهل بكثير من ضبط المعلمات في تطبيقك لتعيين تصميم الشريحة المعروضة.
يعد فصل المحتوى عن العرض التقديمي مبدأ تصميم شهيرًا له العديد من الفوائد.
وصفة أساسية
في ما يلي مثال على كيفية استخدام واجهة برمجة تطبيقات العروض التقديمية لدمج البيانات في عرض تقديمي:
قم بإنشاء عرضك التقديمي كما تريد أن يظهر باستخدام محتوى نائب لمساعدتك في التصميم.
لكل عنصر محتوى تدرجه، استبدل محتوى العنصر النائب بعلامة. العلامات هي مربعات نصية أو أشكال بسلسلة فريدة. تأكد من استخدام السلاسل التي من غير المحتمل أن تحدث بشكل طبيعي. على سبيل المثال، يمكنك استخدام
{{account-holder-name}}
علامة جيدة.في الرمز الخاص بك، استخدم Google Drive API لإنشاء نسخة من العرض التقديمي.
في الرمز البرمجي الخاص بك، استخدِم طريقة
batchUpdate
الخاصة بـ Slides API، مع مجموعة من طلباتreplaceAllText
، لإجراء جميع استبدالات النص خلال العرض التقديمي. استخدِم طلباتreplaceAllShapesWithImage
لإجراء بدائل للصور خلال العرض التقديمي.
بعد إنشاء مجموعة بطاقات تحتوي على علامات، احرص على إنشاء نسخة واستخدام واجهة برمجة التطبيقات Slides API لمعالجة النسخة. لا تستخدم واجهة برمجة تطبيقات "العروض التقديمية من Google" للتعامل مع نسخة "النموذج" الأساسية.
تتضمن الأقسام التالية مقتطفات رموز توضح بعضًا من هذه العملية. يمكنك أيضًا مشاهدة الفيديو أعلاه لمشاهدة مثال كامل (Python) يجمع بين العديد من المفاهيم من الأقسام الفردية أدناه.
دمج النص
يمكنك استخدام طلب replaceAllText
لاستبدال جميع مثيلات سلسلة نصية معينة
بعرض تقديمي بنص جديد. بالنسبة لعمليات الدمج، يكون هذا أبسط من العثور
على كل مثيل من النص واستبداله على حدة. أحد الأسباب التي تجعل هذا الأسلوب هو الأكثر تعقيدًا هو أنّه من الصعب توقُّع معرّفات عناصر الصفحة، خاصةً عندما يقوم المتعاونون بتنقيح عرض النموذج والحفاظ عليه.
مثال
يستخدم هذا المثال واجهة برمجة تطبيقات Drive لنسخ عرض تقديمي للنموذج، ما يؤدي إلى إنشاء نسخة جديدة من العرض التقديمي. ثم يستخدم Google Sheets API لقراءة البيانات من جدول بيانات Sheets، ويستخدم أخيرًا واجهة Slides API لتحديث العرض التقديمي الجديد.
يأخذ المثال البيانات من 3 خلايا في صف واحد من نطاق مُعنوَن في
جدول البيانات. وتستبدِل بعد ذلك تلك البيانات في العرض التقديمي أينما
تحدثت السلاسل {{customer-name}}
أو {{case-description}}
أو {{total-portfolio}}
.
برمجة تطبيقات
البدء
Java
JavaScript
Node.js
PHP
Python
Ruby
دمج الصور
يمكنك أيضًا دمج الصور في العرض التقديمي باستخدام طلب replaceAllShapesWithImage
. يستبدل هذا الطلب جميع مثيلات الأشكال التي تحتوي على السلسلة النصية المقدمة بالصورة المقدمة. يعمل الطلب تلقائيًا على تحديد موضع الصورة وتغيير حجمها لتلائم حدود شكل العلامة مع الحفاظ على نسبة العرض إلى الارتفاع للصورة.
مثال
يستخدم هذا المثال واجهة برمجة التطبيقات Google Drive API لنسخ عرض تقديمي للنموذج، ما يؤدي إلى إنشاء نسخة جديدة من العرض التقديمي. بعد ذلك، يستخدم Slides API للعثور على أي
شكل بالنص {{company-logo}}
واستبداله بصورة شعار الشركة. يستبدل الطلب أيضًا أي شكل بالنص {{customer-graphic}}
بصورة مختلفة.
برمجة تطبيقات
البدء
Java
JavaScript
Node.js
PHP
Python
Ruby
استبدال مربّع نص أو حالات صورة معيّنة
يُعد طلبا replaceAllText
وreplaceAllShapesWithImage
مفيدين لاستبدال العلامات في جميع أنحاء العرض التقديمي، ولكن
في بعض الأحيان تحتاج فقط إلى استبدال العناصر وفقًا لمعايير أخرى، مثل وضعها في شريحة معينة.
في هذه الحالات، يجب عليك استرداد أرقام تعريف أشكال العلامات التي تريد استبدالها. بالنسبة إلى استبدالات النص، يمكنك حذف النص الحالي في تلك الأشكال ثم إدراج النص الجديد (راجِع نموذج تعديل النص في شكل محدّد).
تُعد عمليات استبدال الصور أكثر تعقيدًا. لدمج صورة، يجب تنفيذ ما يلي:
- احصل على رقم تعريف شكل العلامة.
- انسخ معلومات المقاس وحوِّلها من العلامة.
- أضف صورتك إلى الصفحة، باستخدام معلومات الحجم والتحويل.
- احذف شكل العلامة.
وقد يتطلب الحفاظ على نسبة العرض إلى الارتفاع للصورة أثناء تغيير حجمها بعض العناية، كما هو موضّح في القسم التالي. شاهد أيضًا هذا النموذج: استبدال علامة شكل بصورة.
الحفاظ على نسبة العرض إلى الارتفاع
عند إنشاء صور باستخدام "العروض التقديمية من Google"، تستند ملاءمة العرض إلى حجم الصورة فقط، وليس إلى حجم البيانات وتحويلها. تُعتبر بيانات الحجم التي تقدّمها في طلب createImage
الحجم المطلوب للصورة. تناسب واجهة برمجة التطبيقات نسبة العرض إلى الارتفاع
للصورة مع هذا الحجم المطلوب، ثم تطبق التحويل المحدد.
عند استبدال علامة بصورة، يمكنك الحفاظ على نسبة العرض إلى الارتفاع للصورة من خلال تعيين حجم الصورة وقياسها على النحو التالي:
- width: تم ضبطها على ناتج
width
وscaleX
للعلامة - height: يتم ضبطه على ناتج
height
وscaleY
للعلامة - scale_x: تم ضبطه على
1
- scale_y: تم ضبطه على
1
يؤدي هذا إلى جعل واجهة برمجة تطبيقات العروض التقديمية تتناسب مع الصورة وفقًا
للحجم المرئي للعلامة، بدلاً من حجمها غير المقيَّم (راجع
استبدال علامة شكل بصورة).
يؤدي ضبط مَعلَمات التحجيم على 1
إلى منع تغيير حجم الصورة إلى مرّتَين.
ويضمن هذا الترتيب الحفاظ على نسبة العرض إلى الارتفاع للصورة، ويمنعها من تجاوز حجم شكل العلامة. تحتوي الصورة على نفس النقطة الوسطى لشكل العلامة.
إدارة النماذج
بالنسبة للعروض التقديمية للنماذج، والتي يحددها التطبيق ويملكها، قم بإنشاء القالب باستخدام حساب مخصص يمثل التطبيق. حسابات الخدمة هي خيار جيد وتتجنب التعقيدات مع سياسات Google Workspace التي تفرض قيودًا على المشاركة.
عند إنشاء مثيلات للعروض التقديمية من القوالب، استخدم دائمًا بيانات اعتماد المستخدم. ويمنح ذلك المستخدمين تحكمًا كاملاً في العرض التقديمي الناتج ويمنع مشاكل التوسيع المتعلقة بالحدود لكل مستخدم في Google Drive.
لإنشاء نموذج باستخدام حساب خدمة، اتّبِع الخطوات التالية باستخدام بيانات اعتماد التطبيق:
- أنشئ عرضًا تقديميًا باستخدام presentations.create في واجهة برمجة تطبيقات "العروض التقديمية من Google".
- يمكنك تعديل الأذونات للسماح لمستلمي العرض التقديمي بقراءته باستخدام permissions.create في Drive API.
- يمكنك تعديل الأذونات للسماح لمؤلفي النماذج بالكتابة فيها باستخدام permissions.create في Drive API.
- عدِّل النموذج على النحو المطلوب.
لإنشاء مثيل للعرض التقديمي، نفذ الخطوات التالية باستخدام بيانات اعتماد المستخدم:
- أنشئ نسخة من النموذج باستخدام files.copy في Drive API.
- استبدِل القيم باستخدام presentation.batchUpdate في واجهة برمجة التطبيقات للعروض التقديمية.