Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

チャネル情報の更新

チャネル情報には、チャネルの説明、フィールド名、チャネルの位置、メタデータ、公開またはプライベートのステータス、およびチャネルの名前が含まれます。チャネルを更新するには、https://api.thingspeak.com/channels/CHANNEL_ID に HTTP PUT を送信します (CHANNEL_ID をチャネルの ID に置き換えます)。

有効なパラメーターは次のとおりです。

  • api_key (文字列) - ユーザーの API キー。これはチャネル API キーとは異なるもので、プロファイル ページで確認することができます (必須)。

  • description (文字列) - チャネルの説明 (オプション)

  • elevation (整数) - メートル単位での標高 (オプション)

  • field1 (文字列) - Field 1 の名前 (オプション)

  • field2 (文字列) - Field 2 の名前 (オプション)

  • field3 (文字列) - Field 3 の名前 (オプション)

  • field4 (文字列) - Field 4 の名前 (オプション)

  • field5 (文字列) - Field 5 の名前 (オプション)

  • field6 (文字列) - Field 6 の名前 (オプション)

  • field7 (文字列) - Field 7 の名前 (オプション)

  • field8 (文字列) - Field 8 の名前 (オプション)

  • latitude (10 進数) - 度単位の緯度 (オプション)

  • longitude (10 進数) - 度単位の経度 (オプション)

  • metadata (テキスト) - チャネルのメタデータ。これには JSON、XML、その他のあらゆるデータを含めることができます (オプション)

  • name (文字列) - チャネルの名前 (オプション)

  • public_flag (true/false) - チャネルを公開するかどうか。既定値は false (オプション)

  • tags (文字列) - タグのコンマ区切りリスト (オプション)

  • url (文字列) - チャネルの Web ページの URL (オプション)

JSON

チャネルを更新するには、https://api.thingspeak.com/channels/CHANNEL_ID.json に HTTP PUT を送信します (CHANNEL_ID をチャネルの ID に置き換えます)。

PUT の例: 

PUT https://api.thingspeak.com/channels/4.json
    api_key=XXXXXXXXXXXXXXXX
    name=Updated Channel

応答は更新されたチャネルの JSON オブジェクトです。次に例を示します。 

{
  "id": 4,
  "name": "Updated Channel",
  "description": null,
  "metadata": null,
  "latitude": null,
  "longitude": null,
  "created_at": "2014-03-25T13:12:50-04:00",
  "elevation": null,
  "last_entry_id": null,
  "ranking": 15,
  "username": "iothans",
  "tags": [],
  "api_keys":
  [
    {
      "api_key": "XXXXXXXXXXXXXXXX",
      "write_flag": true
    }
  ]
}

XML

チャネルを更新するには、https://api.thingspeak.com/channels/CHANNEL_ID.xml に HTTP PUT を送信します (CHANNEL_ID をチャネルの ID に置き換えます)。

PUT の例: 

PUT https://api.thingspeak.com/channels/4.xml
    api_key=XXXXXXXXXXXXXXXX
    name=Updated Channel

応答は更新されたチャネルの XML オブジェクトです。次に例を示します。 

<?xml version="1.0" encoding="UTF-8"?>
<channel>
    <id type="integer">4</id>
    <name>Updated Channel</name>
    <description nil="true" />
    <metadata nil="true" />
    <latitude type="decimal" nil="true" />
    <longitude type="decimal" nil="true" />
    <created-at type="dateTime">2014-03-25T20:17:44-04:00</created-at>
    <elevation nil="true" />
    <last-entry-id type="integer" nil="true" />
    <ranking type="integer">15</ranking>
    <username>iothans</username>
    <tags type="array" />
    <api-keys type="array">
        <api-key>
            <api-key>XXXXXXXXXXXXXXXX</api-key>
            <write-flag type="boolean">true</write-flag>
        </api-key>
    </api-keys>
</channel>

関連するトピック