Error handling
Stay organized with collections
Save and categorize content based on your preferences.
Error Code
Possible Causes
Resolutions
400 PRECONDITION_FAILED
The reader you are trying to delete with DeleteReader
still has active entitlements.
Remove all entitlements from the reader, or use the force=true
option with the DeleteReader
`request.
403 PERMISSION_DENIED
- The service account lacks the required role for the method being called (e.g., a
Subscription Linking Viewer
attempting to update entitlements).
- Verify that you have configured the correct Google Cloud project number in Publisher Center.
- Ensure the service account has one of the roles
.
- Subscription Linking Admin
- Subscription Linking Viewer
- Subscription Linking Entitlements Viewer
404 NOT_FOUND
The specified publicationId
or ppid
doesn't exist.
Verify that the provided publicationId
and ppid
are correct and exist.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-06-13 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-13 UTC."],[[["\u003cp\u003eServices return a 500 error code when they experience a failure.\u003c/p\u003e\n"],["\u003cp\u003eA 404 error code indicates a resource, like a reader or publication, was not found.\u003c/p\u003e\n"],["\u003cp\u003eWhen a valid resource isn't accessible to the OAuth service account due to permissions, a GCP IAM error is triggered.\u003c/p\u003e\n"]]],[],null,["# Error handling\n\n| Error Code | Possible Causes | Resolutions |\n|---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `400 PRECONDITION_FAILED` | The reader you are trying to delete with `DeleteReader` still has active entitlements. | Remove all entitlements from the reader, or use the `force=true` option with the [`DeleteReader`](/news/subscribe/subscription-linking/api/methods#deletereader)\\`request. |\n| `403 PERMISSION_DENIED` | - The service account is not associated with [the Google Cloud project](/news/subscribe/subscription-linking/implementation/synchronize-user-entitlements#google_cloud_setup) you configured in Publisher Center. \u003c!-- --\u003e - The service account lacks the required role for the method being called (e.g., a `Subscription Linking Viewer` attempting to update entitlements). | - Verify that you have configured the correct Google Cloud project number in Publisher Center. \u003c!-- --\u003e - If you are using Account Default Credentials (ADC) with [`gcloud auth application-default login`](https://cloud.google.com/docs/authentication/application-default-credentials#personal) command, ensure you have [`Service Account Token Creator`](https://cloud.google.com/iam/docs/service-account-permissions#token-creator-role) role. \u003c!-- --\u003e - Ensure the service account has [one of the roles](/news/subscribe/subscription-linking/implementation/synchronize-user-entitlements#create_a_service_account). - Subscription Linking Admin \u003c!-- --\u003e - Subscription Linking Viewer \u003c!-- --\u003e - Subscription Linking Entitlements Viewer |\n| `404 NOT_FOUND` | The specified `publicationId` or `ppid` doesn't exist. | Verify that the provided `publicationId` and `ppid` are correct and exist. |"]]
