نظرة عامة
مكّن وكلاءك من إنشاء وتحرير وإدارة عروض Google Slides التقديمية. أنشئ العروض التقديمية، وحدّث المحتوى، واستورد البيانات من Google Sheets، وأدر الصفحات والصور المصغرة، وبسّط سير عمل العروض التقديمية باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.المتطلبات الأساسية
قبل استخدام تكامل Google Slides، تأكد من توفر ما يلي:- حساب CrewAI AMP مع اشتراك فعّال
- حساب Google مع إمكانية الوصول إلى Google Slides
- ربط حساب Google الخاص بك عبر صفحة التكاملات
إعداد تكامل Google Slides
1. ربط حساب Google الخاص بك
- انتقل إلى تكاملات CrewAI AMP
- ابحث عن Google Slides في قسم تكاملات المصادقة
- انقر على Connect وأكمل عملية OAuth
- امنح الصلاحيات اللازمة للوصول إلى العروض التقديمية وجداول البيانات وDrive
- انسخ رمز المؤسسة من إعدادات التكامل
2. تثبيت الحزمة المطلوبة
3. إعداد متغير البيئة
Agent(apps=[]), يجب تعيين متغير البيئة
CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك..env:
الإجراءات المتاحة
google_slides/create_blank_presentation
google_slides/create_blank_presentation
title(string, مطلوب): عنوان العرض التقديمي.
google_slides/get_presentation_metadata
google_slides/get_presentation_metadata
presentationId(string, مطلوب): معرّف العرض التقديمي المراد استرجاعه.
google_slides/get_presentation_text
google_slides/get_presentation_text
presentationId(string, مطلوب): معرّف العرض التقديمي.
google_slides/get_presentation
google_slides/get_presentation
presentationId(string, مطلوب): معرّف العرض التقديمي المراد استرجاعه.fields(string, اختياري): الحقول المراد تضمينها في الاستجابة.
google_slides/batch_update_presentation
google_slides/batch_update_presentation
presentationId(string, مطلوب): معرّف العرض التقديمي المراد تحديثه.requests(array, مطلوب): قائمة بالتحديثات المراد تطبيقها.writeControl(object, اختياري): يوفر التحكم في كيفية تنفيذ طلبات الكتابة.
google_slides/get_slide_text
google_slides/get_slide_text
presentationId(string, مطلوب): معرّف العرض التقديمي.pageObjectId(string, مطلوب): معرّف الشريحة/الصفحة.
google_slides/get_page
google_slides/get_page
presentationId(string, مطلوب): معرّف العرض التقديمي.pageObjectId(string, مطلوب): معرّف الصفحة المراد استرجاعها.
google_slides/get_thumbnail
google_slides/get_thumbnail
presentationId(string, مطلوب): معرّف العرض التقديمي.pageObjectId(string, مطلوب): معرّف الصفحة لإنشاء الصورة المصغرة.
google_slides/create_slide
google_slides/create_slide
presentationId(string, مطلوب): معرّف العرض التقديمي.insertionIndex(integer, اختياري): مكان إدراج الشريحة (قائم على الصفر). إذا حُذف، تُضاف في النهاية.
google_slides/create_slide_with_layout
google_slides/create_slide_with_layout
presentationId(string, مطلوب): معرّف العرض التقديمي.layout(string, مطلوب): نوع التخطيط. أحد:BLANK,TITLE,TITLE_AND_BODY,TITLE_AND_TWO_COLUMNS,TITLE_ONLY,SECTION_HEADER,ONE_COLUMN_TEXT,MAIN_POINT,BIG_NUMBER.insertionIndex(integer, اختياري): مكان الإدراج (قائم على الصفر). حُذف للإضافة في النهاية.
google_slides/create_text_box
google_slides/create_text_box
presentationId(string, مطلوب): معرّف العرض التقديمي.slideId(string, مطلوب): معرّف الشريحة لإضافة مربع النص إليها.text(string, مطلوب): المحتوى النصي لمربع النص.x(integer, اختياري): موضع X بوحدة EMU (914400 = 1 بوصة). الافتراضي: 914400.y(integer, اختياري): موضع Y بوحدة EMU. الافتراضي: 914400.width(integer, اختياري): العرض بوحدة EMU. الافتراضي: 7315200.height(integer, اختياري): الارتفاع بوحدة EMU. الافتراضي: 914400.
google_slides/delete_slide
google_slides/delete_slide
presentationId(string, مطلوب): معرّف العرض التقديمي.slideId(string, مطلوب): معرّف الشريحة المراد حذفها.
google_slides/duplicate_slide
google_slides/duplicate_slide
presentationId(string, مطلوب): معرّف العرض التقديمي.slideId(string, مطلوب): معرّف الشريحة المراد تكرارها.
google_slides/move_slides
google_slides/move_slides
presentationId(string, مطلوب): معرّف العرض التقديمي.slideIds(array of strings, مطلوب): مصفوفة من معرّفات الشرائح المراد نقلها.insertionIndex(integer, مطلوب): الموضع المستهدف (قائم على الصفر).
google_slides/insert_youtube_video
google_slides/insert_youtube_video
presentationId(string, مطلوب): معرّف العرض التقديمي.slideId(string, مطلوب): معرّف الشريحة لإضافة الفيديو إليها.videoId(string, مطلوب): معرّف فيديو YouTube (القيمة بعد v= في عنوان URL).
google_slides/insert_drive_video
google_slides/insert_drive_video
presentationId(string, مطلوب): معرّف العرض التقديمي.slideId(string, مطلوب): معرّف الشريحة لإضافة الفيديو إليها.fileId(string, مطلوب): معرّف ملف Google Drive للفيديو.
google_slides/set_slide_background_image
google_slides/set_slide_background_image
presentationId(string, مطلوب): معرّف العرض التقديمي.slideId(string, مطلوب): معرّف الشريحة لتعيين الخلفية لها.imageUrl(string, مطلوب): عنوان URL المتاح للعموم للصورة المراد استخدامها كخلفية.
google_slides/create_table
google_slides/create_table
presentationId(string, مطلوب): معرّف العرض التقديمي.slideId(string, مطلوب): معرّف الشريحة لإضافة الجدول إليها.rows(integer, مطلوب): عدد الصفوف في الجدول.columns(integer, مطلوب): عدد الأعمدة في الجدول.
google_slides/create_table_with_content
google_slides/create_table_with_content
presentationId(string, مطلوب): معرّف العرض التقديمي.slideId(string, مطلوب): معرّف الشريحة لإضافة الجدول إليها.rows(integer, مطلوب): عدد الصفوف في الجدول.columns(integer, مطلوب): عدد الأعمدة في الجدول.content(array, مطلوب): محتوى الجدول كمصفوفة ثنائية الأبعاد. مثال: [[“Year”, “Revenue”], [“2023”, “$10M”]].
google_slides/import_data_from_sheet
google_slides/import_data_from_sheet
presentationId(string, مطلوب): معرّف العرض التقديمي.sheetId(string, مطلوب): معرّف Google Sheet المراد الاستيراد منه.dataRange(string, مطلوب): نطاق البيانات المراد استيرادها من الورقة.
google_slides/upload_file_to_drive
google_slides/upload_file_to_drive
file(string, مطلوب): بيانات الملف المراد رفعها.presentationId(string, مطلوب): معرّف العرض التقديمي لربط الملف المرفوع.
google_slides/link_file_to_presentation
google_slides/link_file_to_presentation
presentationId(string, مطلوب): معرّف العرض التقديمي.fileId(string, مطلوب): معرّف الملف المراد ربطه.
google_slides/get_all_presentations
google_slides/get_all_presentations
pageSize(integer, اختياري): عدد العروض التقديمية المراد إرجاعها لكل صفحة.pageToken(string, اختياري): رمز للترقيم.
google_slides/delete_presentation
google_slides/delete_presentation
presentationId(string, مطلوب): معرّف العرض التقديمي المراد حذفه.
أمثلة الاستخدام
إعداد Agent أساسي لـ Google Slides
إدارة محتوى العروض التقديمية
استكشاف الأخطاء وإصلاحها
المشاكل الشائعة
أخطاء الصلاحيات- تأكد من أن حساب Google الخاص بك لديه الصلاحيات المناسبة لـ Google Slides
- تحقق من أن اتصال OAuth يتضمن النطاقات المطلوبة للعروض التقديمية وجداول البيانات وDrive
- تحقق من صحة معرّفات العروض التقديمية ووجودها
- تأكد من أن لديك صلاحيات الوصول للعروض التقديمية التي تحاول تعديلها
- تأكد من صحة تنسيق طلبات التحديث الدفعي وفقاً لمواصفات Google Slides API
- تحقق من وجود معرّفات الكائنات للشرائح والعناصر في العرض التقديمي
