API を使用して、テーブルに新規レコード（複数可）を追加します。
関連項目: 例: 新しく追加したレコードをコピーする
URL
次の形式の URL を使用して、API を呼び出します。
POST https://{appsheet-region}/api/v2/apps/{appId}/tables/{tableName}/Action
各要素の意味は次のとおりです。
| 変数 | 説明 |
|
|
サポートされるデータ所在地のリージョンに基づいて API を呼び出すために使用されるドメイン。有効な値は次のとおりです。
注: |
{app-id} |
AppSheet アプリの ID。API を有効にしてアプリ ID を確認する方法については、クラウドベースのサービスの通信で API を有効にするをご覧ください。 |
{table-name) |
テーブルの名前。[Data] > [Tables] を選択し、テーブルの詳細を開いてテーブル名を確認します。 注: テーブル名は URL エンコード形式にする必要があります。 |
アプリケーション アクセスキーを指定するで説明されている方法のいずれかを使用して、アプリケーション アクセスキーを渡す必要があります。たとえば HTTP クエリ文字列の中で渡すときは、次の形式を使用します。
https://api.appsheet.com/api/v2/apps/{appId}/tables/{tableName}/Action?applicationAccessKey=<アプリケーション アクセスキー>
リクエストの本文
HTTP リクエストの本文には、以下の要素が含まれます。
- アクション名の
Add。 - オプションのプロパティ（
Locale、Location、Timezone、UserIdなど）。
Date、Time、DateTime、Decimal、Percent、Priceのデータ値を検証するときは、Localeが使用されます。たとえば、Localeがen-USの場合、日付値はMM/DD/YYYY形式で入力する必要があります。Locale がen-GBの場合、日付値はDD/MM/YYYY形式で入力する必要があります。 Rows要素（複数可）。
通常、各Row値には、追加するレコードのキーフィールド値が含まれている必要があります。ただし、キーフィールドに初期値が含まれている場合は、キーフィールド値を省略できます。たとえば、キーフィールドにUNIQUEID()またはRANDBETWEEN()の初期値が含まれている場合は、その値にキーフィールドが初期化されるため、キーフィールド値を省略する必要があります。
各Row値には、追加するレコード内の他のフィールドのフィールド値を含めることができます。以下の例で、レコードのキーフィールドにはFirstNameとLastNameがあります。
2 つ以上の行を追加するときは、各行を個別の API 呼び出しで追加するより、すべての行を一度の API 呼び出しで追加するほうが効率的です。データ プロバイダに対しては複数回の呼び出しを行うため、1 回の API 呼び出しを使用することで効率が大幅に向上します。
{
"Action": "Add",
"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",
"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"
},
{
"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"
}
]
}
レスポンスの本文
この 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 ステータス コードをご覧ください。
レコードを追加した場合の結果
- すべてのフィールドが初期値に初期化され、すべてのアプリの数式が計算されます。
- リクエストで指定したフィールド値が適用されます。
- アプリの数式が計算され、変更フィールドが更新されます。
Required、Required_If、Valid_Ifの各条件が適用されます。- レコードがテーブルに追加されます。
- 自動化（ある場合）が新規行ごとに個別に呼び出されます。
注: 自動化は、イベントソースがアプリデータ変更イベントに設定されている場合にのみトリガーされます。 - 追加されたレコードが HTTP コンテンツに返されます。