الوثائق

Google

Calendar و Sheets و Drive و Google Ads و Analytics 4 و Search Console و Business Profile والتحقّق من العنوان البريدي — كل قدرة تُربَط بشكل مستقلّ، بنمط BYO.

يجمع تكامل Google عدّة قدرات: Calendar و Sheets و Drive و Google Ads و Google Analytics 4 و Search Console و Business Profile والتحقّق من العنوان البريدي. تُربَط كل منها بشكل مستقلّ (لا تمنح سوى النطاقات المفيدة)، عبر «تسجيل الدخول عبر Google» (OAuth مُدار) أو تطبيقك الخاص.

Calendar (Google Calendar)

  • سرد الأحداث في تقويم خلال فترة (google.calendar_list_events، node بـ google_calendar_list_events) — مفيد ليعرف وكيل agent مدى توفّرك.
  • إنشاء حدث (google.calendar_create_event، node بـ google_calendar_create_event) — مثلاً لحجز موعد مؤكَّد.
  • حذف حدث (google.calendar_delete_event) — انطلاقاً من مُعرِّفه.
  • إطلاق pipeline قبل حدث — يستطلع مستقبِل google_calendar_inbound التقويم دورياً، ويمكنه ألّا يُطلِق إلّا للأحداث التي تبدأ قريباً (تذكير، تحضير موعد). أمّا التفاعل الفوري مع تعديل في التقويم فغير متاح.

الاستخدام النموذجي: مساعد شخصي يتحقّق من التقويم، ويقترح فترة زمنية، ثم ينشئ الموعد.

Google Sheets

  • قراءة ورقة (google.sheets_read، node بـ google_sheets_read) — جلب الصفوف لمعالجتها في pipeline.
  • إلحاق صفوف عبر أداة google.sheets_append أو node بـ google_sheets_append (كتابة exactly-once).
  • نشر جدول (google.sheets_publish، node بـ google_sheets_publish) — ينشئ مصنّفاً جديداً متعدّد الأوراق ويُعيد عنوان URL الخاص به. تنبيه: يكون المصنّف عامّاً افتراضياً.

الاستخدام النموذجي: تسجيل كل تشغيل pipeline في ورقة تتبّع، أو استخدام ورقة بوصفها قاعدة إعداد أعمال صغيرة.

Google Drive

  • البحث والقراءة في الملفات (google.drive_search، google.drive_read)، ورفع مستند (google.drive_upload)، وإنشاء مجلّد، ونقل ملف، والنقل إلى سلّة المهملات (قابل للتراجع).
  • nodes بـ google_drive_list / google_drive_download / google_drive_upload — السرد والجلب وإيداع الملفات (الرفع exactly-once).
  • مراقبة المجلّدات — يكتشف مستقبِل google_drive_changes الملفات الجديدة في مجلّد (استقصاء polling مع مؤشّر cursor) ويُطلِق pipeline.

نطاق Drive حسّاس: افتراضياً، لا تطلب betool سوى الوصول إلى الملفات التي تنشئها أو التي تفتحها أنت لها (drive.file).

  • تقرير الأداء — جلب مقاييس حملاتك (google.ads_report).
  • إدارة حملة — تعديل ميزانيتها اليومية (google.ads_update_budget) أو إيقافها مؤقتاً / إعادة تفعيلها (google.ads_update_campaign_status).
  • رفع التحويلات — إعادة دفع التحويلات دون اتصال (offline) إلى Google Ads عبر node بـ google_ads_conversion_upload.

Google Analytics 4 و Search Console

  • Analytics 4 — تقرير جمهور خصائص GA4 الخاصة بك (google.analytics_report، node بـ google_analytics_report)، للقراءة فقط.
  • Search Console — أداء البحث لمواقعك: الاستعلامات، والصفحات، والنقرات، ومرّات الظهور (google.search_console_report، node بـ google_search_console_report)، للقراءة فقط.

Google Business Profile

  • المراجعات — سرد المراجعات ومتوسّط تقييم ملف تجاري (google.gbp_list_reviews، node بـ google_business_report)، والردّ علناً على مراجعة (google.gbp_reply_review).
  • المنشورات — نشر منشور على الملف التجاري (google.gbp_create_post، node بـ google_business_post).

التحقّق من العنوان

تقوم أداة google.verify_address بـ التحقّق من عنوان بريدي وتسويته (مفيد قبل إرسال بريد فعلي أو لتنظيف سجل عميل).

الربط (BYO + بديل احتياطي على مستوى المورّد)

  1. الإعدادات ← الخدمات ← Google، تبويب الحسابات.
  2. اربط كل قدرة تحتاج إليها: «تسجيل الدخول عبر Google»، أو بيانات اعتماد تطبيق OAuth الخاص بك. يستخدم التحقّق من العنوان مفتاح API.
  3. للتحقّق من العنوان فقط: إن لم تكن قد أعددت مفتاحك الخاص، يمكن لـ betool توجيه الاستدعاء عبر مفتاح مورّد مُجمَّع (ترتيب الحلّ مفتاحك > المفتاح المشترك).

تُنفَّذ جميع قدرات OAuth على حساب Google الخاص بك، دون احتساب استهلاك (metering) ولا هامش من betool. ولا يُفوتَر بالأرصدة سوى التحقّق من العنوان المارّ عبر مفتاح المورّد المشترك.