分析データへのプログラムによるアクセスについてよく寄せられる質問

この記事では、プログラムでパートナーの分析情報データにアクセスする方法に関してよく質問される質問についてパートナー センター。

API の応答

200 (成功) 以外の API 応答を受け取る可能性のあるさまざまなシナリオは何ですか?

次の表で、API の応答と、それを受け取った場合の対処方法について説明します。

エラーの説明 エラー コード トラブルシューティング
権限がありません 401 これは認証の例外です。 アプリケーション (AAD) トークンAzure Active Directoryを確認します。 AAD トークンは 60 分間有効です。その後、AAD トークンを再生成する必要があります。
無効なテーブル名です 400 データセットの名前が間違っています。 "Get All Datasets" API を呼び出して、データセット名を再確認します。
列名が正しくありません 400 クエリ内の列の名前が正しくありません。 "すべてのデータセットの取得" API を呼び出して列名を再確認するか、データ定義の列名を参照します
null または欠損値です 400 API の要求ペイロードの一部としての必須パラメーターがない可能性があります。
無効なレポート パラメーターです 400 レポート パラメーターが正しいことを確認してください。 たとえば、RecurrenceInterval パラメーターに 4 未満の値を指定できます。
繰り返し間隔は 4 から 2160 の間である必要があります 400 RecurrenceInterval 要求パラメーターの値が 4 から 2160 の間で指定します。
無効な QueryId です 400 生成された QueryId を再確認します。
作成に無効なレポート パラメーター - レポートの開始時刻は、現在の UTC 時刻から少なくとも 4 時間である必要があります 400 要求ペイロードの一部としての Start Time パラメーターは、過去にすることはできません。 レポートの開始時刻は、現在の UTC 時刻から 4 時間以上である必要があります。
要求された値 'string' が見つかりません 400 要求パラメーターまたは形式を更新したかどうかを callbackurl 確認します。
指定されたフィルターで項目が見つかりませんでした。 404 レポート実行の取得 API で使用されている reportID パラメーターを確認します。
指定されたフィルター条件で実行された実行はありません。 reportId または executionId を再確認し、レポートのスケジュールされた実行時間後に API を再試行します 404 reportId が正しいか確認します。 要求ペイロードで指定されている、レポートのスケジュールされた実行時間の後に API を再試行します。
レポートの作成中に内部エラーが発生しました。 関連付け ID <> 500 フィールド StartTime、QueryStartTime、QueryEndTime の日付の形式 が正しいか 確認します。
Service unavailable (サービス利用不可) 500 サービスを継続的に利用できない (5xx エラー) 場合は、サポート チケットを開きます。

レコードがありません

セキュリティで保護された場所からレポートをダウンロードすると、API 応答 200 が表示されます。 なぜ "レコードがありません" が表示されるのでしょうか? クエリ内の文字列に、列ヘッダーに許可されている値のいずれかが含まれているかどうかを確認してください。 たとえば、次のクエリは結果を返しません。

SELECT CustomerTenantId, CustomerTpId, WorkloadName, Month, MonthlyActiveUsers 
FROM OfficeUsage 
WHERE IsDuplicateRowForPGA = 'False' 
ORDER BY CustomerTenantId DESC

この例では、 に使用できる値は 0 または IsDuplicateRowForPGA 1 です。 さまざまな列で 使用できるすべての値 については、「データ定義」を参照してください。