エラーコードのトラブルシューティング

このページでは、Directory API の使用中に発生する可能性のある一般的なエラーコードについて説明します。

503 Service unavailable

ユーザーまたはデバイスの大規模なリストを取得するために nextPageToken メソッドを使用したときに、リクエストに 60 分以上かかる場合、このエラーが発生する可能性があります。このエラーは、Directory API の制限によるものです。

完全なエラー レスポンスは次のとおりです。

{
  "error": {
    "code": 503,
    "message": "Service unavailable. Please try again",
    "errors": [
      {
        "message": "Service unavailable. Please try again",
        "domain": "global",
        "reason": "backendError"
      }
    ]
  }
}

このエラーを回避するには、フィルタを使用してクエリを実行し、個々のオペレーションの完了に 1 時間以上かからないようにすることで、デバイスまたはユーザーの数を減らすことができます。この方法では複数のクエリが必要です。詳しくは、デバイスを検索するをご覧ください。