サポートされるメソッド

X-Watson-Metadata ヘッダーは、以下のメソッドで使用できます。

• WebSocket 要求の場合

  • /v1/recognize

  要求の x-watson-metadata クエリー・パラメーターで顧客 ID を指定して接続を開始します。 このクエリー・パラメーターの引数は URL エンコードする必要があります (例: customer_id%3dmy_customer_ID)。 顧客 ID は、この接続を介して送信される認識要求を通じて渡されるすべてのデータに関連付けられます。

• 同期 HTTP 要求の場合:

  • POST /v1/recognize

  顧客 ID は、個別の要求を通じて送信されるデータに関連付けられます。

• 非同期 HTTP 要求の場合:

  • POST /v1/register_callback
  • POST /v1/recognitions

  顧客 ID は、許可リストに登録されたコールバック URL に関連付けられるか、個別の認識要求を通じて送信されるデータに関連付けられます。

• コーパス、カスタム単語、または文法をカスタム言語モデルに追加するための要求の場合:

  • POST /v1/customizations/{customization_id}/corpora/{corpus_name}
  • POST /v1/customizations/{customization_id}/words
  • PUT /v1/customizations/{customization_id}/words/{word_name}
  • POST /v1/customizations/{customization_id}/grammars/{grammar_name}

  顧客 ID は、その要求によって追加または更新されるコーパス、カスタム単語、または文法に関連付けられます。

• 音声リソースをカスタム音響モデルに追加するための要求の場合:

  • POST /v1/acoustic_customizations/{customization_id}/audio/{audio_name}

  顧客 ID は、その要求によって追加または更新される音声リソースに関連付けられます。

顧客 ID の指定の例

次の例では、my_customer_ID 要求を通じて渡されるデータに POST /v1/recognize という顧客 ID を関連付けます。

IBM Cloud

curl -X POST -u "apikey:{apikey}" \
--header "X-Watson-Metadata: customer_id=my_customer_ID" \
--header "Content-Type: audio/wav" \
--data-binary @audio.wav \
"{url}/v1/recognize"

IBM Cloud Pak for Data IBM Software Hub

curl -X POST \
--header "Authorization: Bearer {token}" \
--header "X-Watson-Metadata: customer_id=my_customer_ID" \
--header "Content-Type: audio/wav" \
--data-binary @audio.wav \
"{url}/v1/recognize"

顧客データの削除の例

次の例では、my_customer_ID という顧客 ID のすべてのデータを削除します。

IBM Cloud

curl -X DELETE -u "apikey:{apikey}" \
"{url}/v1/user_data?customer_id=my_customer_ID"

IBM Cloud Pak for Data IBM Software Hub

curl -X DELETE \
--header "Authorization: Bearer {token}" \
"{url}/v1/user_data?customer_id=my_customer_ID"