beautypg.com

Google Apps Security and Compliance Services Web Services Application Programming Interface Guide, Early Access Version 1.5 User Manual

Page 40

background image

38

Message Security and Compliance Application Programming Interface Guide RELEASE EA version 1.5

Exceptions

Service Management API AutomatedBatch Exceptions

Batch Exception -- This exception is specific to the batch interface layer of
the Service Management API. These are any errors reported by a particular
batch command, field, or batch interface condition. Some of these errors
are requests failures and some are serious conditions.

Recommended Solution -- If this exception is thrown during the
development cycle, stop the application. To determine the specific batch
error, go to the Administration Console and run the batch command.

StatusException -- This exception is used to trigger an exception without a
real problem in the system. This exception is specific to the Service
Management web service’s test utility. If the test utility is called with a ‘false’
value to test the exception connection between the web service and your
application, the StatusException is returned for a successful round-trip
connection.

API Infrastructure Common Exceptions

AdminBlockException -- Specified API license key blocked for
administrative reasons

AuthenticationException -- Invalid authentication tokens and other auth
errors

InternalException -- Internal exceptions caused by server-wide problems

InvalidValueException -- One or more element values does not validate

MalformedKeyException -- Malformed API license key

MissingElementException -- One or more required elements is missing
from the input

NoSuchKeyException -- Specified API license key does not exist

UnknownInternalException -- Exceptions caused by server-side problems
that have not been handled.

For more information about the API Infrastructure exceptions, see “Exception
Management” on page 20.