メインコンテンツへスキップ
できないこと、数値の読み方、数や大きさの上限、エラーの対処をまとめます。

できないこと

  • コンテンツの作成、編集、公開、削除
  • 公開時と違うパラメータの値での、チャートやアナリティクスの再計算
  • Exploratory Server に公開されていないものの読み取り。Exploratory Desktop の中だけにあるプロジェクトなどです。これらには、別の Desktop MCP を使います。

数値と計算の条件

  • 数値は、公開されたときの値です。
  • チャート単体で公開したものは、描画に使ったデータの先頭 100 行だけを返すので、合算して合計として扱わないでください。
  • ブラウザで閲覧者がパラメータを変えた結果は、MCP からは取得できません。
  • チャートとアナリティクスの結果には、集計方法、チャートのフィルタ、context.parameters、context.data_as_of が含まれます。
  • query_dataset は、dataset.version と dataset.updated_at を返します。

数や大きさの上限

エラーの一覧と対処

失敗した道具は、isError: true の結果を返します。本文は、error_code と message を持つ JSON で、場合により url と details も持ちます。引数の誤りでは、details.field がその引数を示します。 SERVER_BUSY のとき:
  • 数秒おいて再度呼び出します。
  • 2 回続いたら、繰り返さずに時間をおきます。
  • 書き出しの上限の場合は、最大 1 時間待ちます。
query_dataset は、問い合わせの誤りを別の形で返します。error.code、error.message、error.field を持ち、独自のコードを使います。例:
  • DATASET_NOT_FOUND
  • ACCESS_DENIED
  • CHANNEL_DISABLED
  • DATASET_ACCESS_DENIED(結合時)
  • DATASET_NOT_QUERYABLE
  • INVALID_COLUMN
  • INVALID_FILTER
  • AMBIGUOUS_COLUMN
  • JOIN_TYPE_MISMATCH
  • QUERY_LIMIT_EXCEEDED
  • QUERY_TIMEOUT
問い合わせが混み合っているときは、RATE_LIMIT_EXCEEDED か QUERY_ENGINE_UNAVAILABLE が返るので、数秒おいて再度呼び出します。result.has_more が true なら、絞り込むか、集計するか、dataframe_export を使います。 dataframe_export は、ほかの道具と同じ error_code の形式です。問い合わせの誤りは INVALID_PARAMETER で返り、元のコードは details.code に含まれます。

回数の上限

1 人の利用者が 1 分間に 120 回を超えて要求すると、HTTP 429 と RATE_LIMITED が返ります。1 分待ってください。 同じアドレスから(IPv4 は同じアドレス、IPv6 は同じ /64 の範囲で数えます)、15 分のうちに 30 回を超えて、拒否された API キーが送られると、「Too many failed API key attempts. Try again later.」というメッセージつきの HTTP 429 になります。有効なキーは数えません。キーを直して、しばらくしてからやり直します。