enum AuthenticationError.Reason (v202508)

  • AuthenticationError.Reason lists potential reasons for authentication failures when using various services including AdRuleService, AdjustmentService, AdsTxtService, and many others.

  • Reasons for authentication errors include ambiguous or missing authentication headers, invalid email or OAuth, unknown service, and network access issues.

  • Network-specific errors like network API access being disabled, network not found, or network code being required when the user has access to multiple networks are also listed.

  • System-level and account-specific issues such as connection errors, a Google account already associated with a network, or an account being under investigation can also cause authentication failures.

  • An UNKNOWN value is returned if the actual authentication error reason is not available in the API version being used.


Namespace
https://www.google.com/apis/ads/publisher/v202508
Enumeration Description
AMBIGUOUS_SOAP_REQUEST_HEADER The SOAP message contains a request header with an ambiguous definition of the authentication header fields. This means either the authToken and oAuthToken fields were both null or both were specified. Exactly one value should be specified with each request.
INVALID_EMAIL The login provided is invalid.
AUTHENTICATION_FAILED Tried to authenticate with provided information, but failed.
INVALID_OAUTH_SIGNATURE The OAuth provided is invalid.
INVALID_SERVICE The specified service to use was not recognized.
MISSING_SOAP_REQUEST_HEADER The SOAP message is missing a request header with an authToken and optional networkCode.
MISSING_AUTHENTICATION_HTTP_HEADER The HTTP request is missing a request header with an authToken
MISSING_AUTHENTICATION The request is missing an authToken
NETWORK_API_ACCESS_DISABLED The network does not have API access enabled.
NO_NETWORKS_TO_ACCESS The user is not associated with any network.
NETWORK_NOT_FOUND No network for the given networkCode was found.
NETWORK_CODE_REQUIRED The user has access to more than one network, but did not provide a networkCode.
CONNECTION_ERROR An error happened on the server side during connection to authentication service.
GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK The user tried to create a test network using an account that already is associated with a network.
UNDER_INVESTIGATION The account is blocked and under investigation by the collections team. Please contact Google for more information.
UNKNOWN The value returned if the actual value is not exposed by the requested API version.