会社、関係、カスタムオブジェクトAPIのエラーコード
重要 - 画像/情報は四半期ごとのリリースで更新されます!
四半期ごとのリリースにて、最新の機能・情報を反映し、画像を含めた情報は更新されます。
会社、関係、及びカスタムオブジェクトAPIのエラーコード
この記事では、会社、関係、及びカスタムオブジェクト:APIへのエラー応答で受け取る可能性のあるエラーコードの一覧を示します。エラーコードのサポートとして、エラーの説明、その理由、及びHTTPステータスコードが追加されました。
会社、関係、及びカスタムオブジェクトAPIの各API呼び出しに対するエラー応答のサンプルは、それぞれのAPIドキュメントに示されています。詳細については、会社APIドキュメント及びカスタムオブジェクトAPIドキュメントを参照してください。
以下にエラーコードの一覧を示します:
エラーコード (キー "errorCode") |
エラーの説明 (キー "errorDesc") |
理由 |
HTTPステータス コード |
---|---|---|---|
GSOBJ_1001 |
フィールドが許可された最大長を超えています |
文字列の長さが、オブジェクトメタデータで指定された長さよりも大きい場合。 |
400 |
GSOBJ_1002 |
無効なフィールドです。データマッピングを再度確認してください |
データタイプに無効な値が渡された場合 |
400 |
GSOBJ_1003 |
データの削除に失敗しました |
データベースに障害が発生した場合に起こります |
500 |
GSOBJ_1004 |
Gainsight IDが無効であるか、欠落しています。リクエストを再確認してください。 |
パスパラメーターのGSIDが空白またはnullの場合。 GSIDを使ったトランザクションの更新/削除の場合に適用されます |
400 |
GSOBJ_1005 |
日時形式が無効です (%s(列名)= %s(列値)) |
ユーザーによって送信された日時が、Gainsightによって指定された 日時形式のいずれによっても解析できない場合。 |
400 |
GSOBJ_1006 |
日時形式が無効です (%s(列名)= %s(列値)) |
ユーザーによって送信された日付が、Gainsightによって指定された 日付形式のいずれによっても解析できない場合。 |
400 |
GSOBJ_1007 |
フィールド値が無効です (%s(列名)= %s(列値)) |
フィールドがnull可能ではなく、ユーザーがnull値を送信した場合。 |
400 |
GSOBJ_1008 |
メッセージは一定ではありません。検証の種類によって異なります。 例: パーセンテージ: 値をパーセンテージとして解析できませんでした。(%s(列名) = %s(列値))。 ブーリアン:無効なブール値:%s(列値) (%s(列名) = %s(列値)) |
一般的なデータ検証エラー。データが解析されていないか、指定されたルールに違反している場合。 |
400 |
GSOBJ_1009 |
データのバッチ挿入に失敗しました |
データベースに障害が発生した場合に起こります |
500 |
GSOBJ_1010 |
GSID、変更日、作成日などの不変フィールドは変更することができません。リクエストを再度確認してください。 |
ユーザーがGSID又はそのような不変フィールド (例: ModifiedDate、CreatedDate、ScorecardId) を更新しようとしたとき |
400 |
GSOBJ_1011 |
指定された条件に一致するエンティティはありません。リクエストを再度確認してください |
特定の条件でデータベースから行が返されない場合 |
400 |
GSOBJ_1012 |
指定された値が無効です。ルックアップでを使うことはできません |
値で指定されたオプションが、選択リストオプションに一致する結果を持たない場合。 |
400 |
GSOBJ_1013 |
サーバーとの通信に失敗しました。管理者に連絡してください |
内部API呼び出しが失敗した場合 |
500 |
GSOBJ_1016 |
リクエスト本文が無効または空のため、エンドポイントに接続できませんでした |
ユーザーが空のリクエストを送信した場合 (本文なし又は空のマップ) |
400 |
GSOBJ_1017 |
内部サーバーにエラーが発生しました。サポートチームに連絡してください |
gs-objectsアプリケーションで予期しないエラーが発生した場合。 |
500 |
GSOBJ_1018 |
データタイプはまだサポートされていません |
gs-objectsでデータタイプが利用できない場合 (現在: WhoId, WhatId, JSON) |
400 |
GSOBJ_1019 |
無効なEメールアドレスが入力されました。(%s(列名) = %s(列値))。 |
無効なメール形式 |
400 |
GSOBJ_1020 |
指定された検索情報が無効です。確認してからもう再度お試しください |
ユーザーのデータオブジェクトでソースキーが利用できない場合 または ユーザーが有効なオブジェクト名を定義していません (nullでない/空白でない) |
500 |
GSOBJ_1021 |
指定されたデータマップから列をマップすることができませんでした。入力データマップを確認してください |
なし |
400 |
GSOBJ_1023 |
無効なAPIが呼び出されました。APIドキュメントを参照するか、サポート チームにお問い合わせください |
定義されたパスが正しくありません |
400 |
GSOBJ_1024 |
認証ヘッダーが無効です。APIリクエストを再度確認してください |
requestInfoとSecretがヘッダーで使えない場合 |
400 |
GSOBJ_1025 |
必要な列のデータがありません。データを再度確認してください |
フィールドが必須としてマークされているが、データが無効、空、又は利用できない場合 |
400 |
GSOBJ_1026 |
無効通貨値:検証に失敗しました。(%s(列名) = %s(列値))。 |
APIが通貨値の解析に失敗した場合 |
400 |
GSOBJ_1027 |
テキストが最大長を超えています。(%s(列名) = %s(列値))。 |
リッチテキストエリアフィールドのコンテンツの長さが定義された長さよりも長い場合 |
401 |
GSOBJ_1028 |
Null値チェックがこれを処理します (参照: GSOBJ_1007) |
フィールドが必須でデータが空の場合 |
400 |
GSOBJ_1029 |
Null値チェックがこれを処理します (参照: GSOBJ_1007) |
なし |
400 |
GSOBJ_1030 |
なし |
XSSスキャンはAPIゲートウェイによって行われるため、このシナリオには到達できません |
なし |
GSOBJ_1031 |
取引上限に達しました。指定された基準は、指定された制限よりも多くの行に影響を与えます |
DB操作が指定された制限を超えるたびに |
400 |
GSOBJ_1032 |
クエリパラメータ「キーs」がありません。クエリを検証してください |
クエリパラメータ「キーs」は使えますが、基準ラベルがありません |
400 |
GSOBJ_1033 |
クエリパラメータ「キーs」は存在しますが、基準ラベルがありません |
クエリパラメータ「キーs」が利用できせん。 |
400 |
GSOBJ_1034 |
キーフィールドの検証に失敗しました。フィールドは要求に存在する必要があり、値はnullであってはなりません |
このエラーは全てのキーフィールドの検証が中間層で実行されると直ぐに削除されます |
400 |
GSOBJ_1035 |
現在、リクエスト操作はサポートされていません。サポートチームに連絡してください |
現在、カスケード削除をサポートしていないため、UNSUPPORTED_OPERATION_ERROR を投げます |
500 |
GSOBJ_1036 |
提供された更新キーは一意でありません |
指定された基準が重複する行を返す場合 (従業員 = 10で200行を保持できる場合、提供されたAPIの場合、トランザクション動作があります。(1対1のマッピング) |
400 |
GSOBJ_1037 |
更新キーはルックアップフィールドの一部であってはなりません |
キー基準ではルックアップは許可されていません |
400 |
GSOBJ_1038 |
更新キーが要求に見つからないか、対応する値がnullです |
レコードのキーフィールドの値をnullにすることはできません |
400 |
GSOBJ_1039 |
更新/削除操作では、最大3つのキーが許可されます。リクエストを再度確認してください。 |
更新と削除の場合のキーの最大数は3つです。URL内のユーザー定義キーが3つより大きい場合、システムはエラーで応答します。 |
500 |
GSOBJ_1040 |
キーフィールドで使われる制限されたデータタイプ。リクエストを再度確認してください。 |
Multiselect、Lookupなどのキーフィールドで制限されたデータタイプが使用されている場合。 |
400 |
GSOBJ_1041 |
リクエスト本文でデータ一覧を空にすることはできません |
リクエストのレコードフィールドが空またはnullの場合 |
400 |
GSOBJ_1042 |
オブジェクト定義を取得できませんでした。リクエストを再度確認してください |
取得される最初のオブジェクト定義は「byci=1」で、子定義も取得されます。応答にルックアップオブジェクトの定義がマッピングに含まれていない場合、システムはこのエラーで応答します。 |
400 |
GSOBJ_1045 |
セルフルックアップ構成のマッピングに失敗しました。(厳密に1つのキーを含める必要があり、MultiMatch/NoMatchオプションは変更することができません) |
セルフルックアップの詳細が正しくない場合 |
400 |
GSOBJ_1046 |
指定された自己検索構成が無効です。マルチマッチ(デフォルト = FIRSTMATCH) 及び挿入(デフォルト = NULLABLE) オプションはデフォルト設定されており、変更することができません |
セルフルックアップ(フォールバックオプション)に関する設定が正しく設定されていない場合 |
500 |
GSOBJ_1047 |
リクエスト本文の解析に失敗しました。リクエストを再度確認してください |
Gainsight IDが無効または欠落している場合 |
400 |
GSOBJ_1048 |
ルックアップ列をマップすることができませんでした。リクエストを再度確認してください |
ルックアップ項目に記載されている列が間違っているか、ターゲットオブジェクトで使用することができない場合 |
400 |