エラーコードと例外
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
API エラー レスポンス
次の表に、Google Wallet API から返されるエラーコード、考えられる原因、解決策を示します。
例外 |
メッセージ例 |
候補 |
400 - BadRequestException(BadRequestException) |
リクエストに無効な引数が含まれています。無効なリソース ID: {1234567891234567899 - ABCD1234567}。 |
データ構造の型、形式、長さを確認し、正しい引数を渡します。 |
403 - PermissionDeniedException |
アクセスの拒否 |
サービス アカウントの正しいメールアドレスが、Business Pay and Wallet Console 内で承認されたユーザーであることを確認します。 |
404 - NotFoundException |
ウォレット オブジェクト {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3} が見つかりません。 |
PATCH リクエストまたは PUT リクエストを試す前にオブジェクト ID に対して GET を実行し、更新するオブジェクトがあり、それが最新であることを確認します。 |
404 - IssuerClassNotFoundException |
ウォレットのオブジェクト クラス {1234567891234567899.ABCD.1234567} が見つかりません。 |
更新を行う際は、PATCH リクエストまたは PUT リクエストの前に GET リクエストを行い、参照するクラスがあることを確認してください。また、リクエストで正しいペイロード(オブジェクトとクラス)が適切に使用されていることも確認します。 |
409 - AlreadyExistsException(すでに存在する例外) |
ウォレットのオブジェクト クラス {1234567891234567899.ABCD.1234567} はすでに存在します。 |
同じクラス ID の作成を試みる前に、クラス ID に対して GET を実行します。リソースが存在する場合は、PATCH または PUT を使用できます。 |
ウェブベースのエラー メッセージ
[Google ウォレットに追加] を使用してパスを保存しようとしたときにエラーが発生した場合リンクをクリックすると、デバッグに役立つエラー メッセージが表示されます。これらのメッセージは「デベロッパー」権限のあるユーザーにのみ表示されます。または「管理者」ロールが必要です。
表示されるエラー メッセージの例を以下に示します。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-29 UTC。
[null,null,["最終更新日 2025-08-29 UTC。"],[[["\u003cp\u003eThis page explains the various error codes returned by the Google Wallet API, including BadRequestException, PermissionDeniedException, NotFoundException, IssuerClassNotFoundException, and AlreadyExistsException.\u003c/p\u003e\n"],["\u003cp\u003eEach error code is accompanied by a description, potential causes, and suggestions for resolution, such as data validation, permission checks, and resource verification.\u003c/p\u003e\n"],["\u003cp\u003eBefore update requests (PATCH or PUT), it's crucial to perform a GET request to ensure the resource exists and you have the latest version to prevent conflicts.\u003c/p\u003e\n"],["\u003cp\u003eFor 'Add to Google Wallet' links, web-based error messages are displayed to developers and admins to aid in debugging issues during pass saving.\u003c/p\u003e\n"],["\u003cp\u003eThese messages provide insights into the problem, helping developers understand and resolve issues effectively.\u003c/p\u003e\n"]]],["The Google Wallet API returns specific error codes: 400 (BadRequestException) indicates an invalid argument, requiring checks on data structure. 403 (PermissionDeniedException) means the service account lacks authorization. 404 (NotFoundException) signals a missing Wallet Object or Class, needing a GET request before PATCH/PUT actions. 409 (AlreadyExistsException) indicates an existing class, suggesting a GET request and potential PATCH/PUT instead of creating it again. Web errors are displayed to developers and admins.\n"],null,["# Error codes and exceptions\n\nAPI error responses\n-------------------\n\nThe following table explains error codes that mayn be returned by the Google Wallet API, their possible causes, and solutions.\n\n| Exception | Example Message | Suggestion |\n|------------------------------------|---------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 400 - BadRequestException | Request contains an invalid argument. Invalid resource ID: {1234567891234567899 - ABCD1234567}. | Check the data structure for type, format and length and pass the correct argument. |\n| 403 - PermissionDeniedException | Permission Denied | Ensure the correct [Service Account](https://developers.google.com/wallet/retail/loyalty-cards/web/prerequisites#4.-authorize-the-service-account) email is an authorized user within your Business Pay and Wallet Console. |\n| 404 - NotFoundException | Wallet Object {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3} not found. | Perform a [GET](https://developers.google.com/wallet/generic/rest/v1/genericclass/get#http-request) on the Object ID before trying before a [PATCH](https://developers.google.com/wallet/generic/rest/v1/genericclass/patch#http-request) or [PUT](https://developers.google.com/wallet/generic/rest/v1/genericclass/update#http-request) request to ensure you have an object to update and that it's the latest. |\n| 404 - IssuerClassNotFoundException | Wallet Object Class {1234567891234567899.ABCD.1234567} not found. | When performing an update , ensure you do a [GET](https://developers.google.com/wallet/generic/rest/v1/genericclass/get#http-request) request before a [PATCH](https://developers.google.com/wallet/generic/rest/v1/genericclass/patch#http-request) or [PUT](https://developers.google.com/wallet/generic/rest/v1/genericclass/update#http-request) request to ensure you have a class to reference that it's the latest class. Also ensure the correct payload (object and class) is being used in the request correctly. |\n| 409 - AlreadyExistsException | Wallet Object Class {1234567891234567899.ABCD.1234567} already exists. | Perform a [GET](https://developers.google.com/wallet/generic/rest/v1/genericclass/get#http-request) on the Class ID before trying to create the same Class ID. If the resource exists you may want to use [PATCH](https://developers.google.com/wallet/generic/rest/v1/genericclass/patch#http-request) or [PUT.](https://developers.google.com/wallet/generic/rest/v1/genericclass/update#http-request) |\n\nWeb-based error messages\n------------------------\n\nIf something goes wrong when you attempt to save a pass using an 'Add to Google Wallet' link, you will be shown an informative error message to help you debug. These messages are only shown to users that have the 'Developer' or 'Admin' role for the associated Issuer account.\n\nHere is an example of the type of error message that might be displayed:"]]