Troubleshoot and fix Meet Add-on errors

This guide provides instructions about how to resolve specific Google Meet Add-ons SDK errors that you might encounter while building and testing Meet Add-ons.

To get details about an error, use the MeetAddonError object. It contains an errorType attribute which specifies the type of error.

Error types

The following are the error types generated when the Meet Add-ons SDK throws an error, along with explanation on how to interpret them and guidance on what to do when you get them.

Error Error message Action
CoactivityIsOngoing Cannot perform operation while a collaboration is ongoing. Make sure a collaboration isn't ongoing.
DestinationNotReady The recipient frame isn't connected using the Meet Add-ons SDK and cannot receive the notification. Make sure the destination frame is connected before sending messages to it.
InvalidCloudProjectNumber Cloud project number provided by Meet doesn't match the one passed in by the Meet Add-ons SDK. Make sure that the correct Cloud project number is passed into the SDK as a string when calling createAddonSession or exposeToMeetWhenScreenSharing. This parameter is automatically appended by Meet to any iframe URLs. Make sure your infrastructure doesn't modify URL parameters (for example, as part of a redirect) before using the passed value.
InvalidCollaborationStartingState CollaborationStartingState iframe URLs don't match the origins of the URLs provided in the add-on manifest. Make sure that the CollaborationStartingState iframe URL origins match the origins of the URLs provided in the add-on manifest. For more information, see Add-on security.
MissingUrlParameter Missing required Meet Add-ons SDK URL parameter. This parameter is automatically appended by Meet to the iframe URL. Make sure your infrastructure doesn't modify URL parameters (for example, as part of a redirect).
NeedsMainStageContext This method can only be invoked if the add-on is running in the main stage. Use getFrameType to check whether the add-on is running in the main stage before invoking this method.
NeedsSidePanelContext This method can only be invoked if the add-on is running in the side panel. Use getFrameType to check whether the add-on is running in the side panel before invoking this method.
NotSupportedInStandalone This method isn't supported in standalone mode. Don't call this method in standalone mode.
RequiresEapEnrollment This feature is only available to early access partners. Remove usage of this feature, as Meet Add-ons SDK early access enrollment is closed.
SizeLimitExceededCollaborationStartingState The size of the collaborationStartingState URLs and/or its data exceeds the limits allowed. Make sure that the CollaborationStartingState URL size is less than 512 characters and the data size is less than 4,096 characters.
SizeLimitExceededFrameToFrameMessage The size of the frame-to-frame message exceeds the limits allowed. Make sure that the frame-to-frame message size is less than 1 MB.
UserNotInitiator The user isn't the initiator of the current collaboration. Make sure that the user is the initiator of the current collaboration or that the collaboration has ended.
InternalError An internal Meet error has occurred. No further information is available.