À propos de cet article

J'ai récemment touché la nouvelle API mailchimp Je vais vous expliquer la méthode d'introduction et comment l'utiliser rapidement.

Jusqu'à présent, seul l'ancien sdk de ici était préparé, donc j'étais comme quand il ne serait pas utilisable. (peut être)

Cette fois, l'API a été renouvelée et un nouveau sdk officiel a été publié, donc je l'ai touché pour un transfert, donc je vais le garder comme un disque. https://mailchimp.com/developer/blog/

Environnement, prérequis, etc.

(environnement)

ruby 2.7.1
rails 6.0.2

(Prérequis)

Vous avez déjà un compte mailchimp

(API tactile)

Mailchimp Marketing API
github:https://github.com/mailchimp/mailchimp-marketing-ruby

Préparation préalable

Ajouter une gemme

gem 'MailchimpMarketing'

Créer une clé API pour mailchimp

C'était dans un endroit un peu difficile à comprendre.

Compte> Extras> Clé API> Bouton Créer une clé

Une clé sera générée, donc c'est OK

Préparation du client

Je l'ai écrit si je regarde la référence, mais ...


mailchimp = MailchimpMarketing::Client.new
mailchimp.set_config({
  :api_key => 'YOUR_API_KEY',
  :server => 'YOUR_SERVER_PREFIX'
})

mailchimp.ping.get
# {"health_status": "Everything's Chimpy!"}OK si

YOUR_SERVER_PREFIX ajoute les caractères après - dans la clé API. Si c'est xxxxxxxxxxxxx-us8, alors ʻus8`

Je l'ai écrit en ici, mais je ne l'ai pas lu correctement et le domaine du service Si je l'ai mis correctement, je n'ai pas pu me connecter et je suis resté bloqué pendant environ une heure. (Stupide)

Méthode de fonctionnement de base

#Liste liste
mailchimp.lists.get_all_lists

#Ajouter la liste
#email ... email que vous souhaitez ajouter_address
#* Si l'adresse existe déjà, ce sera une exception, il est donc préférable d'utiliser put selon le cas.
mailchimp.lists.add_list_member(
  'list_id',
  {
    email_address: email
  }
)

#Liste mise
#email ・ ・ ・ email que vous souhaitez mettre_address
# ※subscriber_hash correspond au hash MD5 de l'adresse e-mail.
mailchimp.lists.set_list_member(
 'list_id',
  Digest::MD5.hexdigest(email),
  {
    email_address: email,
    status_if_new: "subscribed"
  }
)

#Obtenir des membres
#email ・ ・ ・ Email que vous souhaitez rechercher_address
#* S'il n'existe pas, ce sera une exception, il vaut donc mieux ne pas l'utiliser pour la confirmation d'existence.
client.lists.get_list_member('list_id', Digest::MD5.hexdigest(email))

#Rechercher des membres dans la liste
#* Je ne peux pas rechercher par e-mail ou par hachage MD ... C'est subtil, obtenez_list_Vous pouvez utiliser membre ...
#Unique lors de l'enregistrement_email_Un élément appelé id est généré, alors utilisez-le pour la vérification d'existence par e-mail
mailchimp.lists.get_list_members_info(
  MAIL_CHIMP_LIST_ID,
  {
    unique_email_id: unique_email_id,
    status: 'subscribed'
  }
)

#Mise à jour des membres
#Email que vous souhaitez mettre à jour
mailchimp.lists.update_list_member(
 'list_id',
  Digest::MD5.hexdigest(email),
  {
    status: 'unsubscribed' #Se désabonner
  }
)

Source de référence

Référence officielle de mailchimp

[RUBY] Histoire de toucher mailchimp-api v3