メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
概要

Analytics API は、無効なクエリのデバッグに役立つ詳細なエラーメッセージを返します。このページでは、よくあるエラーのケースとその解決方法について説明します。

​
エラーレスポンスの形式

エラーが発生すると、APIは内容を説明するメッセージを含むエラーレスポンスを返します。 
{
  "error": "Error message describing what went wrong"
}

​
よくあるエラー

​
認証エラー

Error: Invalid service keyCause: 指定されたサービスキーが無効か、失効しています。解決策:
  • サービスキーが正しいことを確認する
  • サービスキーが失効していないことを確認する
  • 必要に応じて新しいサービスキーを生成する
Error: Insufficient permissionsCause: サービスキーに、呼び出しているエンドポイントに必要な権限が付与されていません。解決策:
  • チーム設定でサービスキーの権限を更新する
  • 各エンドポイントに必要な権限については、API の概要を参照する

​
クエリ構造のエラー

Error: at least one field or aggregation is requiredCause: クエリリクエストに選択項目または集計が含まれていません。解決策: クエリリクエストに少なくとも 1 つの選択項目を追加してください。
"selections": [
  {
    "field": "num_acceptances",
    "aggregation_function": "QUERY_AGGREGATION_SUM"
  }
]
Error: invalid query table: QUERY_DATA_SOURCE_UNSPECIFIEDCause: data_source フィールドのスペルミスである可能性があります。解決策: データソースのスペルを再確認してください。有効な値は次のとおりです。
  • QUERY_DATA_SOURCE_USER_DATA
  • QUERY_DATA_SOURCE_CHAT_DATA
  • QUERY_DATA_SOURCE_COMMAND_DATA
  • QUERY_DATA_SOURCE_PCW_DATA
Error: all selection fields should have an aggregation function, or none of them shouldCause: 集計関数が設定されている選択項目と、設定されていない選択項目が混在しています。解決策: すべての選択項目に集計関数を追加するか、すべての選択項目から削除してください。Invalid:
"selections": [
  {
    "field": "num_acceptances",
    "aggregation_function": "QUERY_AGGREGATION_SUM"
  },
  {
    "field": "num_lines_accepted",
    "aggregation_function": "QUERY_AGGREGATION_UNSPECIFIED"
  }
]
Valid:
"selections": [
  {
    "field": "num_acceptances",
    "aggregation_function": "QUERY_AGGREGATION_SUM"
  },
  {
    "field": "num_lines_accepted",
    "aggregation_function": "QUERY_AGGREGATION_SUM"
  }
]

​
フィールドと集計のエラー

Error: invalid aggregation function for string type field ide: QUERY_AGGREGATION_SUMCause: 指定されたフィールド型では、この集計関数はサポートされていません。解決策: 各フィールドで利用可能な集計関数については、利用可能なフィールド セクションを確認してください。文字列フィールドで通常利用できるのは COUNT と UNSPECIFIED のみです。
Error: tried to aggregate on a distinct field: distinct_developer_days. Consider aggregating on the non-distinct fields instead: [api_key date]Cause: distinct_* パターンのフィールドは、集計セクションでは利用できません。解決策: 集計には、提案されている代替フィールドを利用してください。Invalid:
"aggregations": [
  {
    "field": "distinct_developer_days",
    "name": "distinct_developer_days"
  }
]
Valid:
"aggregations": [
  {
    "field": "api_key",
    "name": "api_key"
  },
  {
    "field": "date",
    "name": "date"
  }
]
Error: duplicate field alias for selection/aggregation: num_acceptancesCause: 複数の選択または集計で同じ名前が使用されています。解決策: すべてのフィールドエイリアスが一意であることを確認してください。名前を指定しない場合、デフォルトでは {aggregation_function}_{field_name} が使用されます。

​
データフィルタリングエラー

エラー: invalid group name: GroupName原因: 指定されたグループ名は、組織内に存在しません。解決策:
  • グループ名のスペルを再確認する
  • チーム設定にそのグループが存在することを確認する
  • チームダッシュボードに表示されているグループ名を正確に利用する
エラー: invalid timestamp format原因: タイムスタンプが正しい RFC 3339 形式ではありません。解決策: 正しいタイムスタンプ形式を利用してください:
2023-01-01T00:00:00Z
有効な使用例:
  • 2024-01-01T00:00:00Z
  • 2024-12-31T23:59:59Z
  • 2024-06-15T12:30:45Z
エラー: Cannot use both group_name and emails parameters原因: Cascade Analytics リクエストで、group_name パラメータと emails パラメータの両方が指定されています。解決策: group_name または emails のいずれか一方のみを利用し、両方は指定しないでください:無効:
{
  "group_name": "engineering",
  "emails": ["user@example.com"]
}
有効:
{
  "group_name": "engineering"
}
または:
{
  "emails": ["user@example.com", "user2@example.com"]
}

​
レート制限

エラー: 429 Too Many Requests原因: API のレート制限を超過しました。解決策:
  • 追加のリクエストを送信する前にしばらく待つ
  • クライアントに指数バックオフを実装する
  • 可能であれば、複数のクエリを 1 つのリクエストにまとめる
  • より高いレート制限が必要な場合は、サポートに問い合わせる

​
デバッグのヒント

​
1. まずはシンプルに始める

まずは基本的なクエリから始めて、徐々に複雑にしていきます。 
{
  "service_key": "your_key",
  "query_requests": [
    {
      "data_source": "QUERY_DATA_SOURCE_USER_DATA",
      "selections": [
        {
          "field": "num_acceptances",
          "aggregation_function": "QUERY_AGGREGATION_COUNT"
        }
      ]
    }
  ]
}

​
2. フィールド名を確認する

フィールド名が正しいか、利用可能なフィールドのドキュメントで再確認してください。

​
3. 集計の互換性を確認する

選択しているフィールドの型に、使用する集計関数が対応していることを確認してください。

​
4. フィルターを個別にテストする

クエリで期待どおりの結果が返ってこない場合は、フィルターを1つずつ外して、問題を切り分けてみてください。

​
5. JSON を適切な形式で記述する

JSON が正しい形式になっており、すべての文字列が正しく引用符で囲まれていることを確認してください。

​
サポートが必要な場合

問題が引き続き発生する場合:
  1. エラーメッセージをよく確認してください - ほとんどのエラーには、問題の対処法に関する具体的な案内が含まれています
  2. 使用例を確認してください - クエリの構造を、ドキュメント内の正常に動作する使用例と比較してください
  3. サポートに連絡してください - 具体的なエラーメッセージとクエリを添えて、Devin Desktop Support にお問い合わせください

​
API バージョンに関する注意事項

API バージョン 1.10.0 以降では、エラー処理とバリデーションが改善されています。古いバージョンを使用している場合は、より詳細なエラーメッセージを利用するため、更新をご検討ください。