New Marketing CampaignsPUTã䜿çšããŠèšå®ãããã«ã¹ã¿ã ãã£ãŒã«ãã§é£çµ¡å
ãäœæã§ããŸãã
/ marketing / contactsAPI
{
contacts: [
{
email: '[email protected]',
custom_fields: {
purchaseTime: -1,
activations: 0,
partner: 'none',
userCreationTime: 1544997675,
lastSigningTime: 1544997675,
emailVerified: 1,
disabled: 0,
displayName: 'Rv',
photoURL: 'https://lh6.googleusercontent.com/-,
uid: 'uid'
}
}
]
}
芳å¯invalid custom field ids supplied - partner,emailVerified,photoURL,uid,purchaseTime,activations,userCreationTime,lastSigningTime,disabled,displayName
+1
ç§ã¯ä»æ¥åãåé¡ã«ééããŸããã ç§ã¯ãã£ãããµããŒãã§ãããæã¡åºããŸããïŒãã®åé¡ãåç §ããŠãã ããïŒã 圌ãã®åå¿ïŒ
ãããŠãããã¯æè¿èµ·ãã£ãŠããŸããããªãã ãã§ã¯ãããŸãããæ®å¿µãªãããçŸåšãã®åé¡ãåé¿ããæ¹æ³ã¯ãããŸãããç§ãã¡ã®äžçŽãšã³ãžãã¢ã¯ãã®åé¡ã«æ°ã¥ããŠããŸããã
ããã¯ç§ãå ¬åŒã®APIãŠã§ããµã€ãã§åŸããã®ã§ã
å ¬åŒAPIã§ãåãåé¡ããããŸãã cURLã³ãŒãçæã¹ãããããååŸãããšãæ©èœããŸãã
çŸåšã®APIã¯ååã§ã¯ãªãfield_idãæåŸ ããŠããããã§ãã
https://mc.sendgrid.com/custom-fieldsããŒãžãããŒããããšãã«SendGridå ã®ãããã¯ãŒã¯ãã©ãã£ãã¯ãæ€æ»ãããšãfield_idsãšååãè¿ã/ field_definitionsã®å¿çã確èªã§ããŸãã
SendGridã¯ãããã³ããšã³ãã«ãã®IDå€ã衚瀺ãããããªã¯ãšã¹ãã§ååãåãå ¥ããããã«APIãæŽæ°ããå¿ èŠããããŸãã
ããªãã¯ããããæ£ããã§ãã 圌ãã®ãµããŒãã誰ã«ã§ã圹ç«ã€ããšãã§ããã®ã¯æ²ããããšã§ãã ãããŠãã¡ãããIDã䜿çšãããšãAPIã®äœ¿çšãã¯ããã«é£ãããªããŸãã
æ°ãããã£ãŒã«ããäœæãããšãã«ã«ã¹ã¿ã ãã£ãŒã«ããšã³ããã€ã³ããidãè¿ããã©ããããŸãã¯ãããååŸããå¿
èŠããããã©ããã«æ°ã¥ããŸãããïŒ
@AAverin GUIã§ã«ã¹ã¿ã ãã£ãŒã«ããäœæããã®ã§ããã
ãµããŒãã«ãããšãã«ã¹ã¿ã ãã£ãŒã«ãåã¯ãè¿œå ã®custom_fieldsãªããžã§ã¯ãã䜿çšããã«ããã€ããŒãã«çŽæ¥æž¡ãããšã§äœ¿çšã§ããŸãã
åäœããŸãããããã£ãŒã«ãã®å€ãèšå®ãããŠããŸããã§ããã
ãšã«ãããã«ã¹ã¿ã ãã£ãŒã«ãã¯ã»ã°ã¡ã³ãã«ã®ã¿å¿
èŠã§ãããæ°ããããŒã±ãã£ã³ã°ã«ã¯ã»ã°ã¡ã³ãã¯ãããŸããã ã§ã¯ãã«ã¹ã¿ã ãã£ãŒã«ããå®å
šã«ã¹ãããããã ãã§ããããã
ã ãããåé¡ãéããããã ãã«ã
æ£ãããã€ããŒãã¯æ¬¡ã®ããã«ãªããŸãã
{
contacts: [
{
email: '[email protected]',
purchaseTime: -1,
activations: 0,
partner: 'none',
userCreationTime: 1544997675,
lastSigningTime: 1544997675,
emailVerified: 1,
disabled: 0,
displayName: 'Rv',
photoURL: 'https://lh6.googleusercontent.com/-,
uid: 'uid'
}
]
}
圌ãã¯ãŸããAPIããã¥ã¡ã³ãããã¹ãããŠæŽæ°ããããšãçŽæããŸãã
ããã«é¢ããæŽæ°ã¯ãããŸããïŒ
custom_fieldså
ã«ãã£ãŒã«ãåãããå Žåããåããšã©ãŒãçºçããŸãã
custom_fieldså
ãŸãã¯å
éšã§ãã£ãŒã«ãIDã䜿çšããŠããšã©ãŒã¯çºçããŸããããé£çµ¡å
ã¯ä¿åãããŸããã
ç§ããã®ã¢ãžã¥ãŒã«ã§ã¯ãªãcurlãçŽæ¥äœ¿çšããŠããã®ã§ãåé¡ã¯sendgridåŽã«ãããšæããŸãã
@soramister
ãµããŒãããåŸãæåŸã®çãã¯ãã«ã¹ã¿ã ãã£ãŒã«ãã«å€ãèšå®ãããšãã«ç¹å¥ãªIDã䜿çšããããšã«ãªã£ãŠãããšããããšã§ããã
äžèšã®@adanotã®åçãåç
§ããŠãã ããã
ããã§ããã«ã¹ã¿ã ã»ã°ã¡ã³ããäœæããããšã¯ã§ããªããããçŸæç¹ã§ã¯ã«ã¹ã¿ã ãã£ãŒã«ãã¯ãã圹ã«ç«ããªãã ããã§ããã«ã¹ã¿ã ãã£ãŒã«ããéä¿¡ããããšã¯ã§ããŸãããå®éã«ã¯ããããäœã«ã䜿çšããããšã¯ã§ããŸããã
@AAverin
ç§ããã£ãŒã«ãIDã§è©ŠããŠã¿ãŸããã ãšã©ãŒã¡ãã»ãŒãžã¯è¡šç€ºãããŸããããé£çµ¡å
ã¯ä¿åãããŸããã
@soramisterã»ã°ã¡ã³ããæ¬ èœããŠãããããäžéšã®æ©èœãåå ã§ã代ããã«Mailerliteã«åãæ¿ããããšãæ€èšããŠããããããŸã è©ŠããŠããŸããã
ãšã«ããããµããŒãã«ãããšã GET https://api.sendgrid.com/v3/marketing/field_definitions
åŒã³åºãã䜿çšããŠãäœæããã«ã¹ã¿ã ãã£ãŒã«ããååŸã§ããã¯ãã§ãã
次ã«ãå€ã®è¿œå /æŽæ°ã«é¢å¿ã®ããã«ã¹ã¿ã ãã£ãŒã«ãã®IDãååŸãããããã䜿çšããŠé£çµ¡å
ãè¿œå /æŽæ°ããå¿
èŠããããŸãïŒ PUT https://api.sendgrid.com/v3/marketing/contacts
ããããã€ããŒããµããŒããç§ã«äžããäŸã§ãã custom_fields
ãã£ãŒã«ãã®ããŒã¯ããããã®ç¹å¥ãªIDã§ãã
{
"contacts": [
{
"email": "[email protected]",
"address_line_1": "123 main st",
"custom_fields":
{
"e6_T": "5555555555",
"e5_T": "Acme Group"
}
}]
}
ãã£ãŒã«ãIDãè©ŠããŠã¿ãŸããã ã³ãã³ããæåããŠããéïŒãšã©ãŒã¯è¿ãããŸããïŒãé£çµ¡å ã¯è¿œå ãããŸããã
@soramister
ç§ã«ã¯å
æ°ããã§ãã
ãã¹ãŠã®ãŠãŒã¶ãŒã®ã«ã¹ã¿ã ãã£ãŒã«ãããŒã¿ãæ£åžžã«æž¡ãããšãã§ããŸãã
@soramisterSendgridã衚瀺ããããŸã§ã«çŽ1åããããŸãã
ãããæ©èœãããããã®ã«ã¹ã¿ã ãã£ãŒã«ãIDã¯äœã§ããå¿ èŠããããŸããïŒ @AAverin ããã€ããŒãã®äŸã説æããŠãã ããã
ãã£ãŒã«ãIDãè©ŠããŠã¿ãŸããã ã³ãã³ããæåããŠããéïŒãšã©ãŒã¯è¿ãããŸããïŒãé£çµ¡å ã¯è¿œå ãããŸããã
ããããã å¿çã§ãžã§ãIDãååŸããŸããããããŒã¿ãsendgridã«ãªãããã§ã
ãããã£ãŠãç§ã«ãšã£ãŠãæ°ããé£çµ¡å APIã䜿çšããã«ã¹ã¿ã ãã£ãŒã«ãã¯ç¢ºå®ã«æ©èœããŠããŸããã ã«ã¹ã¿ã ãã£ãŒã«ãIDã䜿çšããŠã¿ãŸãããã䜿çšããŠããŸããã IDããªããšããç¡å¹ãªã«ã¹ã¿ã ãã£ãŒã«ãIDãæäŸãããŸããããšãããšã©ãŒãçºçããŸããIDã¯æ©èœããŸã/æåããŸãããããŒã¿ã¯æŽæ°ãããŸãã
{
"list_ids": [
"4fb6cca6-06dc-4aa2-b7cb-851a4e3be37e"
],
"contacts": [
{
"email": "[email protected]",
"first_name": "Test",
"custom_fields": {
"e1_N": "100000",
"e2_N": "100000"
}
}
]
}
sendgridã§äœæãããé£çµ¡å
ã衚瀺ããããŸã§ã«æéããããå ŽåããããŸãããé£çµ¡å
ã¯äœæãããŠããŸããïŒ
ããªãã®ãªããžã§ã¯ãã¯èŠæ ããããŸãã
sendgridã§äœæãããé£çµ¡å ã衚瀺ããããŸã§ã«æéããããå ŽåããããŸãããé£çµ¡å ã¯äœæãããŠããŸããïŒ
ããªãã®ãªããžã§ã¯ãã¯èŠæ ããããŸãã
æ¬åœã«å¥åŠãªããšã§ããé£çµ¡å ã¯ãã«ã¹ã¿ã ãã£ãŒã«ããå«ããªãå Žåã«ã®ã¿äœæãããŸãã ããããã©ããžè¡ãã®ãå°ãéæ¹ã«æ®ããŠããŸã
@ Lucania001ãåãåé¡ãæ±ããŠããŸãïŒ Sendgridã®APIã«ã¯æ¬åœã«æå¿ããŸããã§ããã éåžžã«ããããŠäžéæã§ãã äœãèµ·ãã£ãŠããã®ãã«ã€ããŠã®æŽå¯ã¯ã»ãšãã©ãªãããšã³ããã€ã³ããšãã®åäœã説æããããã®ããã¥ã¡ã³ããã»ãšãã©ãããŸããã
ãã£ãŒã«ãåã§ã¯ãªããã£ãŒã«ãIDã䜿çšããŠããé£çµ¡å ã®ã«ã¹ã¿ã ãã£ãŒã«ããæŽæ°ã§ããŸããã ããã¯ã§ããã ãæ©ã察åŠããå¿ èŠããããŸããããããªããšã顧客ã¯ç¡é§ã«ãªããŸãã
ã«ã¹ã¿ã ãã£ãŒã«ãããªããšãAPIã®SendGridã®ãè©ŠããŠã¿ããã»ã¯ã·ã§ã³ã䜿çšããŠäœæãããé£çµ¡å ãååŸããããšããã§ããŸããã ç§ãåŸãã®ã¯ããã ãã§ãïŒ
{{
ããšã©ãŒãïŒ[
{{
"åé"ïŒ ""ã
"ã¡ãã»ãŒãž"ïŒ "ç¡å¹ãªJSON"
}
]
}
ã«ã¹ã¿ã ãã£ãŒã«ãããªããšãAPIã®SendGridã®ãè©ŠããŠã¿ããã»ã¯ã·ã§ã³ã䜿çšããŠäœæãããé£çµ¡å ãååŸããããšããã§ããŸããã ç§ãåŸãã®ã¯ããã ãã§ãïŒ
{{
ããšã©ãŒãïŒ[
{{
"åé"ïŒ ""ã
"ã¡ãã»ãŒãž"ïŒ "ç¡å¹ãªJSON"
}
]
}
ãããè©ŠããŠã¿ãã®ã¯ãŸã£ããããŸããããŸããã éµäŸ¿é éå¡ãéããŠãããè©ŠããŠãã ããã ãã ããä»ã®äººãšåãåé¡ãçºçããå¯èœæ§ããããŸãã
ããã«ã¡ã¯ã
ãã®åé¡ã«æ»ã£ãŠãä¿®æ£ããããã©ããã確èªããŸããã ããã§ã¯ãªãã åé¡ã¯ãŸã ååšããŠããŸãã
ãããç§ãcurlãªã¯ãšã¹ãã§è©Šããããšã§ãïŒ
curl --request PUT --url https://api.sendgrid.com/v3/marketing/contacts --header'authorizationïŒBearer {{API_KEY}}} '--header "Content-TypeïŒapplication / json"- -data '{"list_ids"ïŒ["f85956da-5696-4d8b-826d-84ac6e27cb2f"]ã "contacts"ïŒ[{"address_line_1"ïŒnullã "city"ïŒnullã "country"ïŒ "UK"ã "email "ïŒ" [email protected] "ã" first_name "ïŒ" Test "ã" last_name "ïŒ" TEST "ã" postal_code "ïŒnullã" state_province_region "ïŒnullã" custom_fields "ïŒ{" e4_T "ïŒ" EN " ã "e2_D"ïŒnullã "e1_T"ïŒ "ã«ã¹ã¿ã ãã£ãŒã«ã"ã "e3_T"ïŒ " http://google.com/ "}}]} '
custom_fieldså€ãåé€ãããšãæ©èœããŸãã é£çµ¡å
ãäœæãããŸãã è¿œå ãçŽããŠãé£çµ¡å
ã¯è¿œå ãããŸããã
ã©ã¡ãã®å Žåãããšã©ãŒãªãã§ãžã§ãIDãè¿ããŸãã
ã©ãããããããæããŠãã ããã
SendGridã®èª°ãããã®ã¹ã¬ãããgithubå
šè¬ã«æ³šæãæã£ãŠãããšã¯æããŸããã
ããªããã§ããå¯äžã®ããšã¯ããŠã§ããµã€ãã§ãµããŒãããããã«çŽæ¥æžãããšã§ããé垞圌ãã¯å©ããŸãã
ç§ã«ãšã£ãŠã®è§£æ±ºçã¯ãSendGridããå¥ã®ãµãŒãã¹ã«åãæ¿ããããšã§ããããSendGridã§é£çµ¡å
ãäœæããéã«åé¡ãçºçããŠããã®ã«ããã§ã«ãã¹ãŠãå®è¡ãããŠããŸãã
èŠçŽãããšãAAverinã«æè¬ããŸããcustom_fieldã®é£çµ¡å ãäœæããã«ã¯ãIDãæå®ããååã§ã¯ãªãããšãç¥ã£ãŠããã ãã§ãsendgridã¯ãGEThttpsïŒ//api.sendgrid.com/v3/marketing/field_definitionsãä»ããŠååŸã§ããç¬èªã®IDãé©çšããŸãã
èŠçŽãããšãAAverinã«æè¬ããŸããcustom_fieldã®é£çµ¡å ãäœæããã«ã¯ãIDãæå®ããååã§ã¯ãªãããšãç¥ã£ãŠããã ãã§ãsendgridã¯ãGEThttpsïŒ//api.sendgrid.com/v3/marketing/field_definitionsãä»ããŠååŸã§ããç¬èªã®IDãé©çšããŸãã
äžèšã®ããã«ãIDã®sendgridã䜿çšããŠããããã¯æ©èœããŸãã
ã«ã¹ã¿ã ãã£ãŒã«ãã䜿çšããŠè€æ°ã®é£çµ¡å ãäœæããããã«æ©èœããã«ãŒã«ã®äŸã次ã«ç€ºããŸãã
curl -X PUT https://api.sendgrid.com/v3/marketing/contacts -H "Content-TypeïŒapplication / json" -H 'èªèšŒïŒBearer API_KEY' --data '{"contacts"ïŒ[{" email "ïŒ" [email protected] "ã" custom_fields "ïŒ{" e2_N "ïŒ1}}ã{" email "ïŒ" [email protected] "ã" first_name "ïŒ" Joe "ã" last_name "ïŒ" Dirte "ã" custom_fields "ïŒ{" e2_N "ïŒ2}}]} '
@soramisterç§ã¯ããªãã®ã«ãŒã«ãªã¯ãšã¹ãã§éãã ã custom_fieldsã«nullå€ãå«ããªãå Žåããªã¯ãšã¹ãã¯æ©èœããŸãã ãã«ãšã³ããªã¯reserved_fieldsã«å¯ŸããŠã¯æ£åžžã«æ©èœããããã§ãããcustom_fieldsã«å¯ŸããŠã¯æ©èœããŸããã nullå€ã®ãšã³ããªãå«ãŸããªãããã«ãªã¯ãšã¹ããåçã«æ§ç¯ãããšãåé¡ãä¿®æ£ãããã¯ãã§ãã
@adanotã«æè¬ã
æ°ããé£çµ¡å ã®äœæã«é¢ããã«ã¹ã¿ã ãã£ãŒã«ããªããžã§ã¯ãã®ã¡ã¿ããŒã¿ã¯ãããã¥ã¡ã³ãã«èšèŒãããŠããå¿ èŠããããŸãã ãšããã§ã @ adanotãš@AAverinã«æè¬ã
ãŸããã«ã¹ã¿ã æ¥ä»ãã£ãŒã«ãã®åœ¢åŒãå€æŽãããŸãããåŸæ¥ã®ããŒã±ãã£ã³ã°APIã§ã¯"10/12/2019"
ãçŸåšã¯"2019-10-12T23:14:20Z"
ã§ãISO 8601 ZuluTimeã§ãã
圌ãã®UIã¯ãŸã å€ãæ¥ä»åœ¢åŒã瀺ããŠããŸãããããã§ãæ··ä¹±ãæããŸãã 以åã¯æ¥ä»ãå ¥ããããšãã§ããã®ãšåãããã«ãã«ã¹ã¿ã ã®æ¥ä»ãã£ãŒã«ãã®æå»ã䜿çšããŠã»ã°ã¡ã³ããäœæã§ããã°ãè¯ãããšã§ãã
ç§ã¯ä»æ¥ãã®åé¡ã«ééããŸããã ã«ã¹ã¿ã ãã£ãŒã«ããå«ãé£çµ¡å
ãè¿œå ãããšãAPIã¯job_id
ãè¿ããŸãããé£çµ¡å
ã¯è¿œå ãããŸããã
ç§ã«ãšã£ãŠã®åé¡ã¯ãããŒã«å€ããããã¹ããã«ã¹ã¿ã ãã£ãŒã«ãã«éä¿¡ããŠããããšã§ããã 代ããã«ããããã®ããŒã«å€ãæååãšããŠéä¿¡ãããšãåé¡ã解決ããŸããã
ããŒã±ãã£ã³ã°APIãšcustom_fieldsã¯æ¬åœã«æªå€¢ã§ããã ããã¥ã¡ã³ãã«ã¯ãæ°ããé£çµ¡å ãããŒã±ãã£ã³ã°ãªã¹ãã«è¿œå ãããšãã«custom_fieldIDãéä¿¡ããããã«æ瀺ãããŠããŸãã 次ã«ããããè¡ããšããç¡å¹ãªcustom_fieldIDãã¡ãã»ãŒãžãè¿ãããŸãã ããã¥ã¡ã³ãã®ã©ãã«ãããããã®å¥åŠãªãe1_Tãã¹ã¿ã€ã«ã®custom_fieldIDãéä¿¡ããã®ãèŠããšã¯èšããŸããã ä»ã«èª°ãïŒ
ãã ããPUTãªã¯ãšã¹ããéä¿¡ããcustom_fieldsãšã³ããã€ã³ãã§GETãªã¯ãšã¹ããå®è¡ãããšãã«è¿ãããIDã®ä»£ããã«ãe1_Tãã¹ã¿ã€ã«ã®custom_field IDã䜿çšãããšãæ°ããé£çµ¡å ãè¿œå ããã®ã«å®å šã«æ©èœããŸãã
ããããªãã
Sendgridã®ããã¥ã¡ã³ãã«ã¯ããã«ã¹ã¿ã ãã£ãŒã«ããæŽæ°ãŸãã¯åé€ããå Žåã¯ãè¿ãããIDå€ãä¿åããå¿ èŠããããŸãããšæžãããŠããŸããç§ã®å Žåãè¿ãããIDå€ã¯ãå¥åŠãªãe1_Tãã¹ã¿ã€ã«ã§ããããããã䜿çšããŠããŸããããŸãæ©èœããŸã..ãã ã®èŠçããªã圌ãããã£ãŒã«ãåãååŸããããã«èšå®ããªãã£ãã®ãã¯ç§ãè¶ ããŠããŸãã
ãããŒãºã¯ãã«ã¹ã¿ã ãã£ãŒã«ãã®IDãååŸããããã®APIã§ãã
ãã ããsend grid apiã䜿çšãããšããªã¯ãšã¹ãããšã«1ã€ã®ã«ã¹ã¿ã ãã£ãŒã«ããè¿œå /æŽæ°ã§ããŸãã
ã«ã¹ã¿ã ãã£ãŒã«ãåããã€ããŒãã§çŽæ¥æž¡ãéãã«ã¹ã¿ã ãã£ãŒã«ããè¿œå /æŽæ°ããŸãã
ãŸã çããæ¢ããŠãã人ã®ããã«ã以äžã®ãã€ããŒãã®äŸïŒ
contacts: [
{
email: "[email protected]",
first_name: "test",
last_name: "test",
custom_fields: {
e7_T: "TRUE"
}
}
]
ã€ãŸããcustom_fieldsã¯ãªããžã§ã¯ãã§ãããkeyã¯ã«ã¹ã¿ã ãã£ãŒã«ãIDã§ã-ç§ã®å Žåã¯e7_T
æ¬åœã«æªãAPIãã¶ã€ã³ãimo
æãåèã«ãªãã³ã¡ã³ã
çŸåšã®APIã¯ååã§ã¯ãªãfield_idãæåŸ ããŠããããã§ãã
https://mc.sendgrid.com/custom-fieldsããŒãžãããŒããããšãã«SendGridå ã®ãããã¯ãŒã¯ãã©ãã£ãã¯ãæ€æ»ãããšãfield_idsãšååãè¿ã/ field_definitionsã®å¿çã確èªã§ããŸãã
SendGridã¯ãããã³ããšã³ãã«ãã®IDå€ã衚瀺ãããããªã¯ãšã¹ãã§ååãåãå ¥ããããã«APIãæŽæ°ããå¿ èŠããããŸãã