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

このページでは、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 時間以上かからないようにして、デバイスまたはユーザーの数を減らすことができます。この方法では複数のクエリが必要になります。詳細については、デバイスを検索するをご覧ください。