# Google Tables {% hint style="warning" %} هذه الميزة متاحة عند الحد الأقصى للتعرفة {% endhint %} * كيفية إعداد جدول Google * كيفية كتابة استعلام json * كيفية كتابة الأسطر إلى أعمدة محددة * كيفية تسجيل البيانات في خلايا محددة * كيفية حذف السجلات من خلايا محددة * كيفية الكتابة إلى أول خلية فارغة في صف * كيفية قراءة البيانات من الجدول * كيفية العثور على نص في جدول (إخراج الصف المناسب الأول) * كيفية سرد جميع التطابقات في جدول * كيفية حذف صف بالكامل (مع الإزاحة) * كيفية إزالة عمود بالكامل (مع الإزاحة) * كيفية إنشاء أزرار لاختيار ورقة في الجدول * كيفية العمل عبر حسابك * كيفية العمل مع أحرف الأعمدة * كيفية تعيين متغيرات في أسماء الأعمدة * كيفية الحذف من الجدول * كيفية إضافة ورقة إلى جدول خطأ محتمل في وظائف جدول Google (APIs) في هذه المقالة سننظر في كيفية تفاعل الروبوتات مع جداول Google. **لاستخدام هذه الوظيفة، تحتاج إلى:** * جدول Google، مفتوح للتحرير عبر الرابط * دالة URL * خيارات الاستعلام ## كيفية إعداد جدول Google !!! !!! !!! ## كيفية كتابة استعلام json انتقل إلى إعدادات الكتلة التي سنسجل فيها. اختر نوع استعلام POST-json، وأدخل عنوان URL للدالة التي نريدها، وأدخل المعلمات في حقل معلمات JSON POST (الشكل 5) لرؤية الاستجابة التي تأتي على طلبك، اكتب في حقل الإجابة {custom\_answer}، ثم احفظ ومرّر السلسلة. بعد ذلك، يمكنك حفظ كل قيمة من الإجابة في متغيرات في حقل حفظ القيمة من استجابة JSON باستخدام الصيغة: > parameters\_from\_query -> your\_variable إذا كانت المعلمات معقدة، فقم بتفكيكها كما يلي: > "cell\_number":{"row":4,"col":2} cell\_number|row -> الصف؛ cell\_number|col -> العمود الآن لنتعرف بمزيد من التفصيل على ما تفعله الروبوتات مع جداول Google. ## كيفية كتابة الأسطر إلى أعمدة محددة يمكنك جمع الكثير من البيانات من المستخدم وكتابتها في أول صف فارغ في الجدول. ويتم ذلك باستخدام **التعيين** . {% hint style="warning" %} يجب تعبئة العنوان (على الأقل خلية واحدة في الصف الأول) {% endhint %} دوال URL: [https://store.salebot.pro/function/gsheets ]() خيارات الاستعلام `{"id": "معرّف الجدول", "mapping":{"a"::"#{variable}", "b": "#{yet}", "c": "#{yet}", "d":"نص فقط"}}}` إذا كنت تريد كتابة السلاسل في غير الورقة الأولى، فعليك إضافة المعلمة list\_name إلى الاستعلام: `{"id": "معرّف الجدول", "mapping":{"a":"نص فقط", "b": "#{variable}"}, "list_name": "اسم الورقة"}` حيث إن id هو معرّف جدول Google الخاص بك. يمكنك الحصول عليه من الرابط إلى جدول Google الخاص بك (وهو ما يكون مميزًا بالخط العريض في الرابط أدناه). a وb وc وd هي مجرد أسماء أعمدة، وlist\_name هو اسم ورقتك (على سبيل المثال، "File 2") إذا لم تكن هناك مشكلة في تنفيذ الاستعلام، فستأتي الإجابة {"number\_row":8}. يمكنك حفظ رقم هذا الصف واستخدامه لاحقًا. إذا كنت لا تريد المخاطرة بتقييد الوصول إلى جدولك على حسابك، فيجب تمرير المعلمة creds\_path من عنوان URL لملف بياناتك. المزيد عن هذا في العمل عبر حسابك: `{"id": "معرّف الجدول", "mapping":{"a"::"#{variable}", "b": "#{yet}", "c": "#{yet}", "d":نص فقط"creds_": "المسار"way to your data file for authorization"}}` ## كيفية تسجيل البيانات في خلايا محددة دوال URL: ; الخيارات `{"id": "معرّف الجدول", "write":{"a1"::"#{variable}", "b3": "#{yet}", "c1": "#{yet}", "d20"نص فقط"}}. يتم التسجيل في خلايا محددة تحددها (في مثالنا a1 وb3 وc1 وd20)` {% hint style="warning" %} ترقيم الأعمدة يبدأ من واحد. {% endhint %} إذا كنت تريد كتابة السلاسل في غير الورقة الأولى، فعليك إضافة المعلمة list\_name إلى الاستعلام: {"id": "معرّف الجدول", "write":{"a1"::"#{variable}", "b3": "#{yet}", "c1": "#{yet}", "d20"نص فقط"}, "list\_name": "اسم الملف"}} إذا لم تكن هناك مشكلة في الاستعلام، فلا يتم إرجاع أي معلمات. إذا كنت لا تريد المخاطرة بتقييد الوصول إلى جدولك على حسابك، فيجب تمرير المعلمة creds\_path من عنوان URL لملف بياناتك. المزيد عن هذا في العمل عبر حسابك: `{"id": "معرّف الجدول", "write":{"a1"::"#{variable}", "b3": "#{yet}", "c1": "#{more}", "d20"نص فقط}, "cred_name""اسم الورقة", s_"path": "المسار إلى ملف بياناتك مع التفويض"}` !!! ## كيفية حذف السجلات من خلايا محددة دوال URL: ; `{"id": "معرّف الجدول", "remove":[a1", "b3", "c2"]}. يزيل القيم من خلايا محددة تحددها (في مثالنا a1 وb3 وc2)` {% hint style="warning" %} يبدأ ترقيم الأعمدة بالرقم واحد. {% endhint %} إذا كنت تريد إزالة الخلايا من الورقة الأولى، فعليك إضافة المعلمة list\_name إلى الاستعلام: `{"id": "معرّف الجدول", "remove":[a1", "b3", "c2"], "list_name": "اسم الملف"}` إذا لم تكن هناك مشكلة في الاستعلام، فلا يتم إرجاع أي معلمات. إذا كنت لا تريد المخاطرة بتقييد الوصول إلى جدولك على حسابك، فيجب تمرير المعلمة creds\_path من عنوان URL لملف بياناتك. مزيد من المعلومات عن هذا في العمل عبر حسابك: `{"id": "معرّف الجدول", "remove":[a1", "b3", "c2"], "list_name": "اسم الملف","creds_path": "المسار إلى ملف بياناتك للتفويض"}` ## كيفية الكتابة إلى أول خلية فارغة في صف يمكنك كتابة البيانات في الصف المحدد، وستتم الكتابة في خلية فارغة إلى يمين آخر خلية ممتلئة. ويتم ذلك باستخدام الدالة append\_in\_row. دوال URL: ; معلمات الاستعلام {"id": "معرّف الجدول", "append\_in\_row":"8", "value": "القيمة المكتوبة"} إذا كنت تريد كتابة الصفوف في غير الورقة الأولى، فيجب إضافة المعلمة list\_name: {"id": "معرّف الجدول", "append\_in\_row":", "value": "قيمة", "list\_name": "اسم الورقة"} حيث إن id هو معرّف جدول Google الخاص بك. يمكنك الحصول عليه من الرابط إلى جدول Google الخاص بك (وهو ما يكون مميزًا بالخط العريض في الرابط أدناه). append\_in\_row - رقم السطر للكتابة value هي القيمة التي ستُكتب في الخلية إذا لم تكن هناك مشكلة في تنفيذ الاستعلام، فستأتي الإجابة {"number\_col":10,"col\_name":"J3"}. يمكنك حفظ هذه الأرقام واستخدامها للعمل لاحقًا. إذا كنت لا تريد المخاطرة بتقييد الوصول إلى جدولك على حسابك، فيجب تمرير المعلمة creds\_path من عنوان URL لملف بياناتك. لمزيد من المعلومات، راجع العمل عبر حسابك: {"id": "معرّف الجدول", "mapping":"{"a":"#{variable}", "b": "#{more}", "c": "#{more}, "cred"نص فقط"},"s\_": "المسار إلى بياناتك مع"path}" ## كيفية قراءة البيانات من الجدول دوال URL: {"id": "معرّف الجدول", "read":{"a1":"a1", "b3": "b4", "c1": "c10", "d20":"a1"}} عيّن المعلمات لنقل النطاقات. في المثال "a1":"a1" يعيد خلية واحدة و"c1":"c10" يعيد 10 قيم من العمود c. قيمة الهاش المُعادة من عنوان الخلية والقيم منها. {% hint style="warning" %} يبدأ ترقيم الأعمدة بالرقم واحد. {% endhint %} إذا كنت تريد قراءة القيم من غير الورقة الأولى، فعليك إضافة المعلمة list\_name إلى الاستعلام: `{"id": "معرّف الجدول", "read"::{"a1":"a3", "b3": "b6"}, "list_name": "اسم الملف"}` إذا لم تكن هناك مشكلة في الاستعلام، فسيتم إرجاع اسم الخلية ومحتوياتها:"{"A1":" u043f u0440 u0438 u0432 u0435", "A2":" u0440 u0430"U043U0A"U0A0430." U0440A0A"U0A0430." u0444 u0443 u043d u043a u0446"} إذا كنت لا تريد المخاطرة بتقييد الوصول إلى جدولك على حسابك، فيجب تمرير المعلمة creds\_path من عنوان URL لملف بياناتك. مزيد من المعلومات عن هذا في العمل عبر حسابك: {"id": "معرّف الجدول", "read"::{"a1":"a3", "b3": "b6"}, "list\_name": "اسم الورقة","creds\_path": "المسار المسار المسار إلى ملف بياناتك للتفويض"} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/ar/integrations/google/tables.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.