[RUBY] Die Geschichte, wie man mailchimp-api v3 berührt

Über diesen Artikel

Ich habe kürzlich die neue Mailchimp-API berührt Ich werde die Einführungsmethode erklären und wie man sie schnell benutzt.

Bisher wurde nur das alte SDK von hier vorbereitet, sodass ich dachte, es wäre nicht verwendbar. (vielleicht)

Dieses Mal wurde die API erneuert und ein neues offizielles SDK wurde veröffentlicht. Ich habe es für eine Übertragung angefasst, also werde ich es als Aufzeichnung aufbewahren. https://mailchimp.com/developer/blog/

Umwelt, Voraussetzungen usw.

(Umgebung)

• ruby 2.7.1
• rails 6.0.2

(Voraussetzung)

• Sie haben bereits ein Mailchimp-Konto

(Touch API)

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

Vorbereitungen

Edelstein hinzufügen

gem 'MailchimpMarketing'

Erstellen eines API-Schlüssels für Mailchimp

Es war an einem Ort, der etwas schwer zu verstehen war.

Konto> Extras> API-Schlüssel> Schaltfläche Schlüssel erstellen

Ein Schlüssel wird generiert, dies ist also in Ordnung

Kundenvorbereitung

Ich habe es geschrieben, wenn ich mir die Referenz ansehe, aber ...

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 wenn

YOUR_SERVER_PREFIX fügt die Zeichen nach - des API-Schlüssels hinzu. Wenn es "xxxxxxxxxxxxxx-us8" ist, dann "us8"

Ich habe es in [hier] geschrieben (https://mailchimp.com/developer/guides/marketing-api-quick-start/#make-your-first-api-call), aber ich habe es und die Domain des Dienstes nicht richtig gelesen Wenn ich es richtig einlegte, konnte ich keine Verbindung herstellen und blieb ungefähr eine Stunde lang stecken. (Blöd)

Grundlegende Betriebsmethode

#Liste Liste
mailchimp.lists.get_all_lists

#Liste hinzufügen
#E-Mail ... E-Mail, die Sie hinzufügen möchten_address
#* Wenn die Adresse bereits vorhanden ist, handelt es sich um eine Ausnahme. Je nach Fall ist es daher besser, put zu verwenden.
mailchimp.lists.add_list_member(
  'list_id',
  {
    email_address: email
  }
)

#Liste setzen
#E-Mail ・ ・ ・ E-Mail, die Sie setzen möchten_address
# ※subscriber_Der Hash entspricht dem MD5-Hash der E-Mail-Adresse.
mailchimp.lists.set_list_member(
 'list_id',
  Digest::MD5.hexdigest(email),
  {
    email_address: email,
    status_if_new: "subscribed"
  }
)

#Holen Sie sich Mitglieder
#E-Mail ・ ・ ・ E-Mail, die Sie suchen möchten_address
#* Wenn es nicht existiert, ist es eine Ausnahme, daher ist es besser, es nicht zur Existenzbestätigung zu verwenden.
client.lists.get_list_member('list_id', Digest::MD5.hexdigest(email))

#Suchen Sie nach Mitgliedern aus der Liste
#* Ich kann nicht per E-Mail oder MD-Hash suchen ... Es ist subtil, bekommen_list_Sie können Mitglied verwenden ...
#Einzigartig bei Registrierung_email_Ein Element mit dem Namen id wird generiert. Verwenden Sie es daher zur Überprüfung der Existenz per E-Mail
mailchimp.lists.get_list_members_info(
  MAIL_CHIMP_LIST_ID,
  {
    unique_email_id: unique_email_id,
    status: 'subscribed'
  }
)

#Mitglieder-Update
#E-Mail, die Sie aktualisieren möchten
mailchimp.lists.update_list_member(
 'list_id',
  Digest::MD5.hexdigest(email),
  {
    status: 'unsubscribed' #Abmelden
  }
)

Referenzquelle

Mailchimp Official Reference