جداول Google

هذه الميزة متاحة على التعرفة القصوى.

المحتويات

• كيفية إعداد جدول Google
• كيفية كتابة استعلام JSON
• كيفية كتابة الصفوف إلى أعمدة محددة
• كيفية كتابة البيانات إلى خلايا محددة
• كيفية حذف البيانات من خلايا محددة
• كيفية الكتابة إلى أول خلية فارغة في صف
• كيفية قراءة البيانات من جدول
• كيفية البحث عن نص في جدول (إرجاع أول صف مطابق)
• كيفية سرد جميع التطابقات في جدول
• كيفية حذف صف بالكامل (مع الإزاحة)
• كيفية حذف عمود بالكامل (مع الإزاحة)
• كيفية إنشاء أزرار لتحديد ورقة في جدول
• كيفية العمل من خلال حسابك
• كيفية التعامل مع أحرف الأعمدة
• كيفية تعيين متغيرات في أسماء الأعمدة
• كيفية حذف البيانات من جدول
• كيفية إضافة ورقة إلى جدول
• الأخطاء المحتملة
• دوال Google Sheets (API)

في هذه المقالة، سننظر في كيفية تفاعل البوتات مع جداول Google.

لاستخدام هذه الوظيفة، تحتاج إلى:

• جدول Google مع تمكين وصول التحرير عبر الرابط
• عنوان URL للدالة
• معلمات الاستعلام

كيفية كتابة استعلام JSON

انتقل إلى إعدادات الكتلة التي تريد إرسال الطلب منها.

حدد نوع الطلب POST JSON، وأدخل عنوان URL للدالة المطلوبة، وأضف المعلمات إلى حقل JSON POST parameters.

لرؤية الاستجابة التي يعيدها طلبك، أدخل {custom_answer} في حقل Answer، واحفظ الكتلة، وقم بالتشغيل عبر السلسلة.

يمكنك بعد ذلك حفظ القيم الفردية من الاستجابة في متغيرات في حقل Save Value from JSON Response باستخدام الصيغة التالية:

parameters_from_query -> your_variable

إذا كانت الاستجابة تحتوي على معلمات متداخلة، استخرجها على النحو التالي.

على سبيل المثال، إذا كانت الاستجابة:

{
  "cell_number": {
    "row": 4,
    "col": 2
  }
}

استخدم:

cell_number|row -> Row
cell_number|col -> Column

الآن دعونا ننظر بمزيد من التفصيل في ما يمكن للبوتات فعله مع جداول Google.

كيفية كتابة الصفوف إلى أعمدة محددة

يمكنك جمع البيانات من المستخدم وكتابتها إلى أول صف متاح في الجدول. يتم ذلك باستخدام دالة mapping.

يجب ملء الترويسة — يجب أن تحتوي خلية واحدة على الأقل في الصف الأول على قيمة.

عنوان URL للدالة:

https://store.mavibot.ai/function/gsheets

معلمات الاستعلام:

{
  "id": "table id",
  "mapping": {
    "a": "#{variable}",
    "b": "#{yet}",
    "c": "#{yet}",
    "d": "just text"
  }
}

إذا كنت تريد كتابة البيانات إلى ورقة أخرى غير الأولى، أضف معلمة list_name:

{
  "id": "table id",
  "mapping": {
    "a": "just text",
    "b": "#{variable}"
  },
  "list_name": "Sheet name"
}

حيث:

• id — معرف جدول Google الخاص بك. يمكنك الحصول عليه من عنوان URL لجداول Google.
• a, b, c, d — أسماء الأعمدة.
• list_name — اسم الورقة، على سبيل المثال "Sheet 2".

مثال على عنوان URL لجداول Google:

https://docs.google.com/spreadsheets/d/1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYKc4/edit#gid=0

في هذا المثال، معرف الجدول هو:

1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYKc4

إذا اكتمل الطلب بنجاح، ستكون الاستجابة على النحو التالي:

{
  "number_row": 8
}

يمكنك حفظ رقم الصف الذي تم إرجاعه واستخدامه لاحقًا.

إذا كنت لا تريد جعل الجدول قابلاً للتحرير علنًا عبر الرابط، فأنت بحاجة إلى تمرير معلمة creds_path مع المسار إلى ملف بيانات التفويض الخاص بك.

لمزيد من المعلومات، راجع قسم العمل من خلال حسابك.

مثال:

{
  "id": "table id",
  "mapping": {
    "a": "#{variable}",
    "b": "#{yet}",
    "c": "#{yet}",
    "d": "just text"
  },
  "creds_path": "path to your authorization data file"
}

كيفية كتابة البيانات إلى خلايا محددة

عنوان URL للدالة:

https://store.mavibot.ai/function/gsheets

معلمات الاستعلام:

{
  "id": "table id",
  "write": {
    "a1": "#{variable}",
    "b3": "#{yet}",
    "c1": "#{yet}",
    "d20": "just text"
  }
}

تتم كتابة البيانات إلى الخلايا المحددة التي تقدمها — في هذا المثال: A1, B3, C1, و D20.

يبدأ ترقيم الأعمدة من 1.

إذا كنت تريد كتابة البيانات إلى ورقة أخرى غير الأولى، أضف معلمة list_name:

{
  "id": "table id",
  "write": {
    "a1": "#{variable}",
    "b3": "#{yet}",
    "c1": "#{yet}",
    "d20": "just text"
  },
  "list_name": "Sheet name"
}

إذا اكتمل الطلب بنجاح، لا يتم إرجاع أي معلمات.

إذا كنت لا تريد جعل الجدول قابلاً للتحرير علنًا عبر الرابط، فمرر معلمة creds_path مع المسار إلى ملف بيانات التفويض الخاص بك.

لمزيد من المعلومات، راجع قسم العمل من خلال حسابك.

مثال:

{
  "id": "table id",
  "write": {
    "a1": "#{variable}",
    "b3": "#{yet}",
    "c1": "#{more}",
    "d20": "just text"
  },
  "list_name": "Sheet name",
  "creds_path": "path to your authorization data file"
}

كيفية حذف البيانات من خلايا محددة

عنوان URL للدالة:

https://store.mavibot.ai/function/gsheets

معلمات الاستعلام:

{
  "id": "table id",
  "remove": [
    "a1",
    "b3",
    "c2"
  ]
}

يؤدي هذا إلى إزالة القيم من الخلايا المحددة — في هذا المثال: A1, B3, و C2.

يبدأ ترقيم الأعمدة من 1.

إذا كنت تريد إزالة القيم من الخلايا في ورقة أخرى غير الأولى، أضف معلمة list_name:

{
  "id": "table id",
  "remove": [
    "a1",
    "b3",
    "c2"
  ],
  "list_name": "Sheet name"
}

إذا اكتمل الطلب بنجاح، لا يتم إرجاع أي معلمات.

إذا كنت لا تريد جعل الجدول قابلاً للتحرير علنًا عبر الرابط، فمرر معلمة creds_path مع المسار إلى ملف بيانات التفويض الخاص بك.

لمزيد من المعلومات، راجع قسم العمل من خلال حسابك.

مثال:

{
  "id": "table id",
  "remove": [
    "a1",
    "b3",
    "c2"
  ],
  "list_name": "Sheet name",
  "creds_path": "path to your authorization data file"
}

كيفية الكتابة إلى أول خلية فارغة في صف

يمكنك كتابة البيانات إلى صف محدد. ستتم إضافة القيمة إلى أول خلية فارغة على يمين آخر خلية مملوءة.

يتم ذلك باستخدام دالة append_in_row.

عنوان URL للدالة:

https://store.mavibot.ai/function/gsheets

معلمات الاستعلام:

{
  "id": "table id",
  "append_in_row": "8",
  "value": "written value"
}

إذا كنت تريد كتابة البيانات إلى صف في ورقة أخرى غير الأولى، أضف معلمة list_name:

{
  "id": "table id",
  "append_in_row": "8",
  "value": "written value",
  "list_name": "Sheet name"
}

حيث:

• id — معرف جدول Google الخاص بك.
• append_in_row — رقم الصف حيث يجب كتابة القيمة.
• value — القيمة التي ستتم كتابتها إلى الخلية.
• list_name — اسم الورقة.

إذا اكتمل الطلب بنجاح، ستكون الاستجابة على النحو التالي:

{
  "number_col": 10,
  "col_name": "J3"
}

يمكنك حفظ القيم التي تم إرجاعها واستخدامها لاحقًا.

إذا كنت لا تريد جعل الجدول قابلاً للتحرير علنًا عبر الرابط، فمرر معلمة creds_path مع المسار إلى ملف بيانات التفويض الخاص بك.

مثال:

{
  "id": "table id",
  "append_in_row": "8",
  "value": "written value",
  "creds_path": "path to your authorization data file"
}

كيفية قراءة البيانات من الجدول

عنوان URL للدالة:

https://store.mavibot.ai/function/gsheets

معلمات الاستعلام:

{
  "id": "table id",
  "read": {
    "a1": "a1",
    "b3": "b4",
    "c1": "c10",
    "d20": "a1"
  }
}

استخدم معلمة read لتحديد النطاقات التي تريد استرجاعها.

على سبيل المثال:

• "a1": "a1" يعيد خلية واحدة.
• "c1": "c10" يعيد 10 قيم من العمود C.

تحتوي الاستجابة على عناوين الخلايا وقيمها.

يبدأ ترقيم الأعمدة من 1.

إذا كنت تريد قراءة القيم من ورقة أخرى غير الأولى، أضف معلمة list_name:

{
  "id": "table id",
  "read": {
    "a1": "a3",
    "b3": "b6"
  },
  "list_name": "Sheet name"
}

إذا اكتمل الطلب بنجاح، ستحتوي الاستجابة على أسماء الخلايا وقيمها.

مثال:

{
  "A1": "value 1",
  "A2": "value 2",
  "A3": "value 3"
}

إذا كنت لا تريد جعل الجدول قابلاً للتحرير علنًا عبر الرابط، فمرر معلمة creds_path مع المسار إلى ملف بيانات التفويض الخاص بك.

لمزيد من المعلومات، راجع قسم العمل من خلال حسابك.

مثال:

{
  "id": "table id",
  "read": {
    "a1": "a3",
    "b3": "b6"
  },
  "list_name": "Sheet name",
  "creds_path": "path to your authorization data file"
}