バルビ電子メールIDの追加方法surveymonkey api v3

Question

バージョンv2のsurveymonkey apiの場合、配列に受信者リストを含むボディ 'https://api.surveymonkey.net/v2/batch/send_flow'はすべての受信者のemailIDをメッセージに単純に追加します。

バージョンv3の場合は、すべての受信者を一括で追加して、すべての受信者の電子メールを送信する簡単な方法はありますか？メッセージを送信する以下のフローでは、受信者のemailIDが1つだけ追加されます。そうでない場合は、新しいEメールIDを持つたびにPOST /コレクター/ {id}/messages/{id}/recipients] 1つのAPIコールで受信者リストにすべてのemailIDを追加し、その受信者リストにメッセージを送信するにはどうすればよいですか？/ID /コレクター/ {id} /メッセージ - > POST /コレクター/ {id} /メッセージ/ {id} /受信者 - > POST /コレクター/ {id }/messages/{id}/send

Answer 1

これを行う唯一の方法は、今すぐV3で提案した方法です。私が追加する唯一のことは、bulk recipient endpointがあることです。

ですから、これらを分割することを好む理由の

POST /surveys/{id}/collectors 
POST /collectors/{id}/messages 
POST /collectors/{id}/messages/{id}/recipients/bulk 
POST /collectors/{id}/messages/{id}/send 

パートは、より良いトランザクション管理のためにあるでしょう。たとえば、send_flowを呼び出してコレクタとメッセージを作成した場合、何らかの理由で受信者を追加しようとしてエラーが発生すると、コレクタ/メッセージが残ってしまいます。こうすることで、それぞれのエラーケースで何が起こるかを自分で処理できます。

SurveyMonkeyは、カプセル化されたバッチリクエストエンドポイントと同様の機能を持つSDKをリリースすることを検討していますが、現在はAPIでメッセージを送信するプロセスです。あなたはこのように一斉にあなたのメッセージに連絡先のリストを追加することができます

：：バルク受信者のエンドポイントの

使用例

POST /collectors/{id}/messages/{id}/recipients/bulk 
{ 
    "contact_ids": ["1000", "10001"] 
} 

あなたが連絡先のリストからすべての連絡先を追加することができますが、すべて一覧表示します

POST /collectors/{id}/messages/{id}/recipients/bulk 
{ 
    "contact_list_ids": ["2000", "20001"] 
} 

それとも、手動でこのように電子メールで連絡先の任意の数を追加することができます：

一度、このように

POST /collectors/{id}/messages/{id}/recipients/bulk 
{ 
    "contacts": [{ 
     "email": "user1@example.com", 
     "first_name": "User 1", 
     "last_name": "Testing" 
    },{ 
     "email": "user2@example.com", 
     "first_name": "User 2", 
     "last_name": "Testing" 
    }] 
} 

私はあなたが1つのリクエストからこれら3つのメソッドすべてを追加できると思います。