العمل مع القوائم

إنشاء قائمة جديدة

create_list()

الوصف

أدخل الدالة في حقل "الحاسبة" في إعدادات الكتلة:

create_list(name) - تنشئ قائمة جديدة. النتيجة هي معرف القائمة.

المعلمات:

! name - اسم القائمة. يُحدد الاسم بين علامتي اقتباس مفردة.

مثال

list_id = create_list("registered")

إنشاء قائمة من الكتلة بدون تكرارات

create_list_if_not_exist()

الوصف

create_list_if_not_exist('list_name') - تنشئ قائمة جديدة إذا لم تكن موجودة بالفعل بهذا الاسم وتعيد معرفها، أو تعيد معرف القائمة الموجودة.

المعلمة المطلوبة:

list_name - اسم القائمة الجديدة المراد إنشاؤها.

مثال

new_list = create_list_if_not_exist('List of participants')

إضافة عميل إلى القائمة

add_to_list()

الوصف

add_to_list(list_id, client_id) - يضيف عميلاً إلى قائمة. لا تُرجع الدالة أي قيمة.

المعلمات:

! list_id - معرف القائمة

client_id - معرف عميل MaviBot. إذا لم يُقدم، يُستخدم معرف العميل الحالي.

نقل عميل إلى القائمة

move_to_list()

الوصف

move_to_list(list_id, client_id) - ينقل عميلاً إلى القائمة (مهم! يُزال العميل من جميع القوائم الأخرى ويُنقل إلى القائمة المحددة). النتيجة هي قيمة منطقية (True أو False).

المعلمات:

! list_id - معرف القائمة

client_id - معرف عميل MaviBot. إذا لم يُقدم، يُستخدم معرف العميل الحالي.

إزالة عميل من القائمة

remove_from_list()

الوصف

remove_from_list(list_id, client_id) - يزيل عميلاً بالمعرف المحدد client_id من القائمة.

المعلمات:

! list_id - معرف القائمة

client_id - معرف عميل MaviBot. إذا لم يُقدم، يُستخدم معرف العميل الحالي.

حذف القوائم

remove_list_from_project(list_id, clear_list)

الوصف
! list_id - معلمة مطلوبة؛ معرف القائمة المراد حذفها.

clear_list — معلمة اختيارية؛ تقبل قيمتين: True أو False (الافتراضي هو False).

إذا لم تقدم هذه المعلمة وكانت القائمة تحتوي على عملاء، ستتلقى الرد التالي:
"Can't delete list, list not empty"

إذا كانت القائمة فارغة، سيتم حذفها دون مشاكل. ومع ذلك، إذا قمت بتعيين clear_list إلى True، سيتم حذف القائمة بغض النظر عما إذا كانت تحتوي على عملاء أم لا.

حذف العلامات

remove_label_from_project(list_id, clear_list)

الوصف
! list_id - معلمة مطلوبة؛ معرف العلامة المراد حذفها.

clear_list - معلمة اختيارية؛ تقبل قيمتين: True أو False (الافتراضي هو False).

إذا لم تقدم هذه المعلمة وكانت العلامة مخصصة لعملاء، ستتلقى الرد التالي:
"Can't delete list, list not empty"

إذا لم تكن العلامة مخصصة لأي عملاء، سيتم حذفها دون مشاكل. ومع ذلك، إذا تم تعيين clear_list إلى True، سيتم حذف العلامة بغض النظر عما إذا كانت مخصصة لعملاء أم لا.

مسح قائمة العملاء

clear_list()

الوصف

clear_list(list_id) - يمسح قائمة العملاء

المعلمات:

! list_id - معرف القائمة. بعد الاستخدام، ستتم إزالة جميع العملاء من القائمة المحددة.

الحصول على عدد العملاء في القائمة

list_size()

الوصف

list_size(list_id) – يحسب العدد الإجمالي للعملاء في القائمة

المعلمات:

! list_id- معرف القائمة

حساب عدد الإدخالات الفريدة للعملاء عبر قوائم متعددة

lists_joint_count()

الوصف

lists_joint_count(massive_list) – يحسب العدد الإجمالي للإدخالات الفريدة للعملاء عبر قوائم متعددة. تأخذ الدالة مصفوفة من معرفات القوائم كمدخل وتُرجع رقمًا.

المعلمات:

! massive_list - مصفوفة تحتوي على معرفات القوائم التي سيتم حساب الإدخالات الفريدة للعملاء فيها. التنسيق هو: ['list_id1', 'list_id2', ..., 'list_idN']

مثال كود للنسخ

/*إنشاء قائمة*/
list_id = create_list('New list')

/*التحقق مما إذا كان العميل في القائمة*/
k=inlist(list_id, client_id)

/*الحصول على حجم القائمة — العدد الإجمالي للعملاء في القائمة*/
razm=list_size(1)

/*الحصول على العدد الإجمالي للإدخالات الفريدة للعملاء عبر قوائم متعددة*/
k=lists_joint_count('[144636,144634]')

التحقق مما إذا كان العميل في القائمة

inlist()

الوصف

inlist(list_id,client_id) - يتحقق مما إذا كان العميل في القائمة. النتيجة هي قيمة منطقية (True أو False).

المعلمات:

! list_id - معرف القائمة

client_id - معرف عميل MaviBot. إذا لم يُقدم، يُستخدم معرف العميل الحالي.

التحقق مما إذا كان مشارك في الدردشة موجودًا في قائمة محددة

some_client_in_list()

الوصف

some_client_in_list(list_id, recepient)

المعلمات:

! list_id - معرف القائمة؛

! recepient - معرف مستخدم المراسلة الذي يتم التحقق منه (platform_id). للدردشات، قيمة المتغير هي chat_member_id.

تُرجع القيم:

True - العميل موجود في القائمة؛

False - العميل غير موجود في القائمة المحددة.

مثال

مثال كود للنسخ

/*مثال للتحقق مما إذا كان مشارك في الدردشة موجودًا في القائمة، حيث المعلمة الأولى هي معرف القائمة، والثانية هي معرف الدردشة للمستخدم*/

r = some_client_in_list(123456, chat_member_id)

استرداد العناصر من قائمة

count_occurrences()

الوصف

count_occurrences(array, element) - تُرجع عدد العناصر المحددة الموجودة في القائمة.

المعلمات:

array - معلمة مطلوبة؛ قائمة العناصر

element - معلمة مطلوبة؛ العنصر المراد حسابه

الحصول على معرف عميل عشوائي من القائمة

random_list_member(list_id)

الوصف

random_list_member(list_id) - تُرجع معرف عميل عشوائي واحد في القائمة المحددة.

list_id - معلمة مطلوبة، معرف القائمة.

يمكن العثور على معرف القائمة، الذي يحتوي على عملائك، في قسم "القوائم":

مثال على العمل مع القوائم في الحاسبة

دعنا نلقي نظرة على مثال لاستخدام الدوال في "الحاسبة" للعمل مع القوائم.

مهم! تحتاج إلى حفظ معرف القائمة الجديدة لاستخدامها لاحقًا. للقيام بذلك، قم بتعيين نتيجة الدالة إلى متغير، أي list_id = ...

الآن يمكنك بسهولة إجراء عمليات أخرى على القائمة — التحقق مما إذا كان العميل في القائمة، أو إضافة، أو نقل، أو إزالة عميل.

على سبيل المثال، دعنا نتحقق مما إذا كان العميل في القائمة بالمعرف 12333:

من المريح جدًا استخدام القوائم عند عرض البيانات الإحصائية:

غالبًا ما يكون من الضروري الحصول على العدد الإجمالي للإدخالات الفريدة عبر مجموعة من القوائم — يمكن القيام بذلك بسهولة باستخدام الدالة lists_joint_count().

أ

الحصول على جميع معرفات قوائم العملاء

get_all_client_label_ids(client_id)

الوصف

get_all_client_list_ids(client_id) — تُرجع مصفوفة تحتوي على معرفات جميع القوائم التي ينتمي إليها العميل.

إذا لم يكن العميل ينتمي إلى أي قوائم، تُرجع الدالة مصفوفة فارغة: [].

المعلمات:

• client_id — معرف عميل Mavibot. إذا تم حذفه، يُستخدم معرف العميل الحالي.