Listelerle Çalışma

Yeni bir liste oluştur

create_list()

Açıklama

Fonksiyonu blok ayarlarındaki "Hesap Makinesi" alanına girin:

create_list(name) - yeni bir liste oluşturur. Sonuç, liste kimliğidir.

Parametreler:

! name - liste adı. Ad, tek tırnak içinde belirtilir.

Örnek

list_id = create_list("registered")

Bloktan yinelenen olmadan liste oluşturma

create_list_if_not_exist()

Açıklama

create_list_if_not_exist('list_name') - verilen ada sahip bir liste henüz yoksa yeni bir liste oluşturur ve tanımlayıcısını döndürür veya mevcut listenin tanımlayıcısını döndürür.

Gerekli parametre:

list_name - oluşturulacak yeni liste için bir ad.

Örnek

new_list = create_list_if_not_exist('List of participants')

Listeye müşteri ekleme

add_to_list()

Açıklama

add_to_list(list_id, client_id) - bir müşteriyi listeye ekler. Fonksiyon hiçbir şey döndürmez.

Parametreler:

! list_id - liste kimliği

client_id - MaviBot müşteri kimliği. Sağlanmazsa, mevcut müşterinin kimliği kullanılır.

Müşteriyi listeye taşıma

move_to_list()

Açıklama

move_to_list(list_id, client_id) - bir müşteriyi listeye taşır (Önemli! Müşteri diğer tüm listelerden kaldırılır ve belirtilene taşınır). Sonuç bir boole değeridir (True veya False).

Parametreler:

! list_id - liste kimliği

client_id - MaviBot müşteri kimliği. Sağlanmazsa, mevcut müşterinin kimliği kullanılır.

Müşteriyi listeden kaldırma

remove_from_list()

Açıklama

remove_from_list(list_id, client_id) - belirtilen client_id'ye sahip müşteriyi listeden kaldırır.

Parametreler:

! list_id - liste kimliği

client_id - MaviBot müşteri kimliği. Sağlanmazsa, mevcut müşterinin kimliği kullanılır.

Listeleri silme

remove_list_from_project(list_id, clear_list)

Açıklama
! list_id - gerekli parametre; silinecek listenin kimliği.

clear_list — isteğe bağlı parametre; iki değer alır: True veya False (varsayılan False).

Bu parametreyi sağlamazsanız ve listede müşteriler varsa, aşağıdaki yanıtı alırsınız:
"Can't delete list, list not empty"

Liste boşsa, sorunsuz bir şekilde silinir. Ancak, clear_list'i True olarak ayarlarsanız, listede müşteri olup olmadığına bakılmaksızın liste silinir.

Etiketleri silme

remove_label_from_project(list_id, clear_list)

Açıklama
! list_id - gerekli parametre; silinecek etiketin kimliği.

clear_list - isteğe bağlı parametre; iki değer alır: True veya False (varsayılan False).

Bu parametre sağlanmazsa ve etiket müşterilere atanmışsa, aşağıdaki yanıtı alırsınız:
"Can't delete list, list not empty"

Etiket hiçbir müşteriye atanmamışsa, sorunsuz bir şekilde silinir. Ancak, clear_list True olarak ayarlanırsa, etiket müşterilere atanıp atanmadığına bakılmaksızın silinir.

Müşteri listesini temizleme

clear_list()

Açıklama

clear_list(list_id) - müşteri listesini temizler

Parametreler:

! list_id - liste kimliği. Kullanımdan sonra, tüm müşteriler belirtilen listeden kaldırılacaktır.

Listedeki müşteri sayısını alma

list_size()

Açıklama

list_size(list_id) – listedeki toplam müşteri sayısını sayar

Parametreler:

! list_id- liste kimliği

Birden çok listedeki benzersiz müşteri girişlerinin sayısını sayma

lists_joint_count()

Açıklama

lists_joint_count(massive_list) – birden çok listedeki benzersiz müşteri girişlerinin toplam sayısını sayar. Fonksiyon girdi olarak bir dizi liste kimliği alır ve bir sayı döndürür.

Parametreler:

! massive_list - benzersiz müşteri girişlerinin sayılacağı liste kimliklerini içeren bir dizi. Biçim şöyledir: ['list_id1', 'list_id2', ..., 'list_idN']

Kopyalamak için kod örneği

/*Creating a list*/
list_id = create_list('New list')

/*Check if the client is in the list*/
k=inlist(list_id, client_id)

/*Get the size of the list — total number of clients in the list*/
razm=list_size(1)

/*Get the total number of unique client entries across multiple lists*/
k=lists_joint_count('[144636,144634]')

Müşterinin listede olup olmadığını kontrol etme

inlist()

Açıklama

inlist(list_id,client_id) - bir müşterinin listede olup olmadığını kontrol eder. Sonuç bir boole değeridir (True veya False).

Parametreler:

! list_id - liste kimliği

client_id - MaviBot müşteri kimliği. Sağlanmazsa, mevcut müşterinin kimliği kullanılır.

Sohbet katılımcısının belirli bir listede olup olmadığını kontrol etme

some_client_in_list()

Açıklama

some_client_in_list(list_id, recepient)

Parametreler:

! list_id - liste kimliği;

! recepient - kontrol edilen mesajlaşma kullanıcı kimliği (platform_id). Sohbetler için, değişkenin değeri chat_member_id'dir.

Değerleri döndürür:

True - müşteri listede;

False - müşteri belirtilen listede değil.

Örnek

Kopyalamak için kod örneği

/*Example of checking if a chat participant is in the list, where the first parameter is the list ID, and the second is the user's chat ID*/

r = some_client_in_list(123456, chat_member_id)

Bir listeden öğeleri alma

count_occurrences()

Açıklama

count_occurrences(array, element) - listede bulunan belirtilen öğelerin sayısını döndürür.

Parametreler:

array - gerekli parametre; öğe listesi

element - gerekli parametre; sayılacak öğe

Listeden rastgele bir müşteri kimliği alma

random_list_member(list_id)

Açıklama

random_list_member(list_id) - belirtilen listede rastgele bir müşteri kimliği döndürür.

list_id - gerekli parametre, liste kimliği.

Müşterilerinizi içeren liste kimliği "Listeler" bölümünde bulunabilir:

Hesap Makinesinde listelerle çalışma örneği

"Hesap Makinesi" içinde listelerle çalışmak için işlevleri kullanma örneğine bakalım.

Önemli! Daha sonra kullanmak için yeni bir liste kimliği kaydetmeniz gerekir. Bunu yapmak için, işlev sonucunu bir değişkene atayın, yani list_id = ...

Artık liste ile diğer işlemleri kolayca gerçekleştirebilirsiniz — bir müşterinin listede olup olmadığını kontrol etme, müşteri ekleme, taşıma veya kaldırma.

Örneğin, 12333 kimlikli listede bir müşteri olup olmadığını kontrol edelim: