テーブルからレコードを削除する

API を使用して、テーブルから 1 つまたは複数の既存のレコードを削除します。

URL

次の形式の URL を使用して、API を呼び出します。

アプリケーション アクセスキーを指定するで説明されている方法のいずれかを使用して、アプリケーション アクセスキーを渡す必要があります。たとえば HTTP クエリ文字列の中で渡すときは、次の形式を使用します。

https://api.appsheet.com/api/v2/apps/{appId}/tables/{tableName}/Action?applicationAccessKey=<アプリケーション アクセスキー>

リクエストの本文

HTTP リクエストの本文には、以下の要素が含まれます。

• アクション名の Delete。

• オプションのプロパティ（Locale、Location、Timezone など）。

  Date、Time、DateTime、Decimal、Percent、Price のデータ値を検証するときは、Locale が使用されます。たとえば、Locale が en-US の場合、日付値は MM/DD/YYYY 形式で入力する必要があります。Locale が en-GB の場合、日付値は DD/MM/YYYY 形式で入力する必要があります。

• 削除対象の Rows 要素（複数可）。
  各 Row 値には、削除するレコードのキーフィールド値のフィールド値を含めることができます。以下の例で、レコードのキーフィールドには FirstName と LastName があります。
  
  2 つ以上の行を削除したい場合、それぞれの行を別々の API 呼び出しで削除するよりも、1 回の API 呼び出しですべての行を削除する方が効率的です。データ プロバイダに対しては複数回の呼び出しを行うため、1 回の API 呼び出しを使用することで効率が大幅に向上します。

{
"Action": "Delete",
"Properties": {
   "Locale": "en-US",
   "Location": "47.623098, -122.330184",
   "Timezone": "Pacific Standard Time",
   "UserSettings": {
      "Option 1": "value1",
      "Option 2": "value2"
   }
},
"Rows": [
{
"FirstName": "Jan",
"LastName": "Jones"
},
{
"FirstName": "Ian",
"LastName": "Ivans",
}
]

レスポンスの本文

API は削除された行を HTTP コンテンツで返します。

{
  "Rows": [
{
"_RowNumber": 10,
"FirstName": "Jan",
"LastName": "Jones",
"Age": 33,
"Department": "Accounting",
"Street": "110 Beach Blvd",
"City": "Newport Beach",
"State": "CA",
"Zip": 92661,
"Home Phone": 4257868765,
"Fax": 4253214432,
"Date Hired": "10/31/2014",
"Arrived": "8:15:25",
"Departed": "18:30:33",
"Last Review": "08/31/2017 23:59:59",
"Rating": 0.9950,
"Salary": 3333.45,
"Image": "http://images6.fanpop.com/image/photos/36300000/Emilia-Clarke-image-emilia-clarke-36399128-460-276.jpg"
},
{
"_RowNumber": 11,
"FirstName": "Ian",
"LastName": "Ivans",
"Age": 22,
"Department": "Payroll",
"Street": "118 E Oceanfront",
"City": "Newport Beach",
"State": "CA",
"Zip": 92661,
"Home Phone": 4257868148,
"Fax": 4253217798,
"Date Hired": "09/30/2014",
"Arrived": "7:40:25",
"Departed": "19:22:33",
"Last Review": "09/30/2017 23:59:59",
"Rating": 0.9750,
"Salary": 4444.45,
"Image": "http://images4.fanpop.com/image/photos/16300000/Christopher-Walken-3-christopher-walken-16367376-720-480.jpg"
}
]
}

レスポンス HTTP のステータス コード

アクション呼び出し時のレスポンス HTTP ステータス コードをご覧ください。

レコードを削除した場合の結果

1. 受信 Webhook リクエストで指定したキーフィールド値がレコードの取得に使用されます。
2. レコードがテーブルから削除されます。
3. 自動化ワークフロー（ある場合）が新規行ごとに個別に呼び出されます。
4. 削除されたレコードが HTTP コンテンツに返されます。

エラー: キーを含む行が見つからない

次のエラーに関する情報については、API 呼び出しのトラブルシューティングをご覧ください。

Row having key '<キー値>' not found