レコードの更新（PUT）

サブテーブルの更新をJavascriptで実装している際に気が付きましたが、
サブテーブルの更新部分の記載に誤りがあるように思います。

（誤）

"(テーブルのフィールドコード)": { 
    "value": { 
        "0":{ 
            "value": { 
                "(フィールドコード)": { 
                    "value": (フィールド値) 
                } 
            } 
        } 
    } 
 }

（正）

"(テーブルのフィールドコード)": { 
    "value": [ 
        { 
            "value": {
                "id": "0" 
                "(フィールドコード)": (フィールド値)
            } 
        } 
    ] 
 }

テーブルのフィールドコードのvalueに対応するものはオブジェクトではなく配列かと思います。

Hiroyuki Nakamuraさん

cybozu.com developer network事務局です。
リクエストボディのサブテーブルの記載内容を修正致しました。
ご指摘いただきありがとうございました。

テーブルのデータ更新で質問です。

「•リクエストのJSONデータに記述しないテーブル内のフィールド値は削除されます。」

とありますが、複数あるテーブル行のうち、１行だけ書き換えたて、ほかのテーブル行は残したい場合、

他のテーブル行は「テーブル行の『id』」だけを記入しておけば、現在のkintoneでは消えないようなのですが、

これは将来のバージョンアップも含めて消えることはないのでしょうか？

よろしくお願いいたします。

吉村啓治郎さん

ご質問いただきありがとうございます。
cybozu developer network運営事務局です。

複数あるテーブル行のうち1行だけ書き換えたい場合は、
吉村さんのおっしゃる通りテーブルのidを指定することで実現できます。

APIにつきましては、APIを利用して開発されたアプリなどに影響を与えないよう、
原則として機能の追加のみを行います。

ただし、次のような場合は API の仕様を変更することがありますので、その点はご了承ください。

・データ破壊やセキュリティ障害などの原因を除去するなど運用上、仕様の変更が必要な場合
・cybozu及び その各サービスの改修により派生的に変更が必要な場合

なお、API の仕様変更を伴うアップデートがある場合、それが適用される定期アップデートの 4 週間前までに、
変更の詳細を以下のサイトで公開致します。
サイトのお知らせ（http://developers.cybozu.com/ja/category/news/）

▼参考リンク
https://cybozudev.zendesk.com/hc/ja/articles/201793494

追加でご質問等ありましたらお気軽にご連絡ください。
よろしくお願い致します。

いつもお世話になっております。

レコードの一括更新の章に

「必須項目が設定されている場合には、その値をリクエストに含めてください。」

と記載がございますが、こちらは誤りではないでしょうか。

PUTの時は更新する項目のみを指定する認識でおります。

細かい点で恐縮でございますが、ご確認よろしくお願いいたします。

みなとん様

ご指摘をありがとうございます。

当方の環境でも確認し、該当の記述を削除いたしました。

POSTの記述と混同した可能性があり、大変申し訳ございませんでした。

今後ともどうぞよろしくお願いいたします。

お世話になっております。

以下ご確認いただけるでしょうか。

PUTのupdateKeyは日付は使えないのでしょうか。マニュアルには指定する値にObjectとありますが、下記のエラーが出ます。

{
"code": "GAIA_IN06",
"id": "1505999166-127152590",
"message": "レコードの更新に失敗しました。「updateKey」に指定したフィールド（code: DeliverDate)が不正です。「updateKey」には、文字列（1行）フィールドか数値フィールドのみ指定できます。また、フィールドの設定で、値の重複を禁止する必要があります。"
}

よろしくお願いします。

hana 様

ご連絡をありがとうございます。cybozu Development teamでございます。

仕様を確認したところ、2016年5月版より、updateKeyに指定できるフィールドは重複を禁止が設定された文字列(1行)と数値のみとなっており、日付フィールドについては遅くともそのタイミングから対象外となっております。

ドキュメントに記載がなかったため、リクエストパラメーター欄の説明欄に追記させていただきました。記載がなかった点について、申し訳ございませんでした。

どうぞよろしくお願いいたします。