概要 

使用例

1. Webサイトで製品を購入した顧客に、製品に関するフィードバックアンケートを送信したい場合。
   
2. 旅行後に帰国した旅行者から、旅行に関するフィードバックを収集したい場合。
   
3. 病院での診断後、患者にフィードバックアンケートを送信したい場合。
   
4. イベントや展示会終了後、ブースを訪れた見込み客からフィードバックを収集したい場合。
   
5. 受講者がオンライン講座を受講後、講座や学習体験についてのアンケートを受講者に送信したい場合。
   
6. 入社後の従業員研修について、フィードバックを収集したい場合。

用語

1. OAuth：ユーザーのパスワードや認証情報を知らせることなくリソースや情報に安全にアクセス可能な標準のプロトコルです。
   
2. クライアント：アンケートを配信するため、Zoho SurveyへAPIリクエストを送信するアプリケーションです。
   
3. クライアントID：Zohoにアプリケーションを登録する際に付与される一意のIDです。
   
4. クライアント シークレット：Zohoにアプリケーションを登録する際に生成される一意のキーです。セキュリティ上の安全のため、クライアントシークレットは厳重に保管しなければなりません。
   
5. 認可トークン：アクセストークン／リフレッシュトークンを生成するために使用される一時的なトークンです。組織固有のグラントトークンの生成は一度きりです。
   
6. アクセストークン：アンケートへの配信機能にアクセスするため、Zoho Survey APIへ送信されるトークンです。アクセストークンを使用することで、Zoho Survey APIに安全にアクセスできます。各アクセストークンは1時間のみ有効です。また、アクセストークンは設定されたスコープ（アクセス権の範囲）の操作にのみ使用できます。
   
7. リフレッシュトークン：新しいアクセストークンを取得するために使用できるトークンです。このトークンは、ユーザーによって取り消されるまで有効です。
   
8. API実行数の上限：API実行数の上限とは、同時に実行可能なAPIリクエストの最大数です。

前提条件 

1. Zoho Surveyの有効なユーザー認証情報。
   
2. Zoho Survey APIにアクセスするために有効な認証トークンまたはOAuth。
   
3. Zoho Surveyのポータルで、メール配信の設定が完了済みであること。

Zoho Survey APIの有効化の手順 

アプリケーションを登録するには  

1. クライアントIDとクライアントシークレットを生成するには、Zoho の開発者コンソールにアプリケーションを登録します。
   
2. クライアントIDとクライアントシークレットを生成した後、クライアントの種類に応じて「ZohoSurvey.invitation.CREATE」のスコープを使用し、組織専用の認可トークンを生成します。認可トークンは、独自のクライアントアプリケーションやサーバーベースのアプリケーションの場合にのみ必要です。
   
3. 生成された認可トークンをコピーします。アプリケーションの種類に応じたクライアントIDとクライアントシークレットの生成方法については、こちらをご覧ください。
   

アクセストークンとリフレッシュトークンの生成方法    

注意：

1. サーバーベースのアプリケーションの場合、アクセス種類のパラメーターを「offline」に設定し、認証リクエストを送信してください。そうすることで、初回の認証リクエスト時にアクセストークンと共にリフレッシュトークンも受け取りることができます。アクセストークンの有効期限が切れると、リフレッシュトークンを使ってアクセストークンを再生成することができます。
   
2. 各アクセストークンは、1時間のみ有効です。また、アクセストークンは設定されたスコープ（アクセス権の範囲）の操作にのみ使用できます。
   
3. 新しいアクセストークンを生成するには、リフレッシュトークンを使用します。リフレッシュトークンには有効期限がないため、アクセストークンの有効期限が切れた際に、アクセストークンを再生成するために使用できます。 
   

 メール配信の設定 

1. Zoho Surveyのポータルで、［公開］→［配信］→［メール］→［メールを作成する］の順に移動します。
   

1. ［送信者情報］セクションで、［条件に基づく連絡先の抽出］ を選択し、［次へ］をクリックします。
   
   

1. アンケートの配信間隔で、［一回のみに配信する］ または［定期的に配信する］を選択します。定期的な配信を選択する場合、条件を実行する間隔を設定する必要があります。
   
   

1. APIリクエストのURLを受信するには、［作成する］をクリックします。 ［公開］→［メール］→［配信済みのアンケート］に移動し、APIの実行履歴を確認できます。
   

1. リクエストURLをコピーし、以下のように変数を設定します。
   

リクエストの本文

注： 

POSTリクエストごとに複数の連絡先を追加できます。

サンプルリクエスト  

  HTTPSステータスコード

注意 

1. リフレッシュトークンの無効化：リフレッシュトークンを無効化するには、ドメイン固有のZoho Accounts URLを使用し、トークンの無効化リクエストを送信する必要があります。　　 詳細はこちら。
   
2. トークンの有効期限：トークンの保存件数や一度に送信できるリクエスト数には上限があります。詳細はこちら。
   
3. アンケート配信で、1分あたりに送信可能なAPIリクエストの上限は60件です。