Exceptions

Typed exception classes used throughout the library. Domain-specific exceptions (Sheets, Slides, Admin SDK, network) extend a common Exception base class for consistent error handling.

A New marker indicates a function added in the latest release; a Deprecated marker indicates a function scheduled for removal in a future release.

Service-specific exceptions

Exception	Description
`AdminDirectoryException`	Represents an exception thrown when the Admin SDK Directory Service is not available or enabled.
`InvalidGridRangeException`	Represents an exception thrown when an invalid `GridRange` object is provided.
`InvalidRangeException`	Represents an exception thrown when an invalid `Range` object is provided.
`InvalidSheetException`	Represents an exception thrown when an invalid `Sheet` object is provided.
`InvalidSpreadsheetException` New	Represents an exception thrown when an invalid `Spreadsheet` object is provided.
`InvalidPresentationException` New	Represents an exception thrown when an invalid `Presentation` object is provided.
`SlideNotFoundException` New	Represents an exception thrown when a `Slide` object is not found.

Core exceptions

Exception	Description
`Exception`	Base class for all custom exceptions.
`RuntimeException`	Exception thrown during application execution.
`AuthenticationException` New	Exception thrown during authentication failures.
`AuthorizationException` New	Exception thrown when the current user is known but is not permitted to perform the action.
`EmptyStringException`	Exception thrown when a non-empty string is required but an empty one is provided.
`IllegalArgumentException`	Exception thrown when an invalid or inappropriate argument is passed to a method.
`IllegalStateException` New	Exception thrown when a method is invoked at an illegal or inappropriate time.
`InvalidEmailFormatException`	Exception thrown when an email address does not follow the expected format.
`InvalidStringException`	Exception thrown when a string is expected but another type is received.
`NullPointerException`	Exception thrown when `null` is encountered where an object is required.
`RepositoryIsNotDefinedException` New	Exception thrown when a repository is not defined.
`ServiceIsNotDefinedException` New	Exception thrown when a service is not defined.

23 September 2026

This documentation was generated with AI (Claude) from the library's source code.