/
Video Application Status Messages

Video Application Status Messages

Status messages returned by the video API.

Status Message

Code Type

Description

INITIATED

Status

Once GumGum Contextual has checked that the URL is properly formed and does not already exist in the cache, the request is passed to the GumGum Contextual classification systems and the status updates to INITIATED.

DOWNLOADING

Status

The GumGum Contextual classification system is downloading the video for processing.

ANALYZING

Status

The GumGum Contextual classification system is analyzing text and images extracted from the video to identify the following:

  • IAB categories

  • Keywords

  • Threats

  • Sentiments

PROCESSED

Status

The video has been processed and the GumGum Contextual analysis JSON is available.

VIDEO_DOWNLOAD_FAILED

Application Error

The video could not be downloaded. Please reach out to GumGum Contextual support for further information.

Response HTTP Code
HTTP/1.1: 200
Example Invalid Request

{ "uuid": "486b4a12-e2a3-5eef-8310-68bb38f6379e", "url": "https://host.com/some/video.mp4", "errors": [ { "reason": "VIDEO_DOWNLOAD_FAILED" } ] }

 

VIDEO_DOWNLOAD_FAILED_WITH_403

Application Error

Occurs when GumGum Contextual attempts to download a Video but was blocked and/or unauthorized to perform this action by the entity hosting the video.

  • Possible resolutions: Reach out to the publisher or agent hosting the video to provide access to GumGum Contextual for downloading the content. In any case, you would have to retry your request to process a video.

Response HTTP Code
HTTP/1.1: 200
Example Invalid Request

{ "uuid": "486b4a12-e2a3-5eef-8310-68bb38f6379e", "url": "https://host.com/some/video.mp4", "errors": [ { "reason": "VIDEO_DOWNLOAD_FAILED_WITH_403" } ] }

VIDEO_DOWNLOAD_FAILED_WITH_404

Application Error

Occurs when GumGum Contextual attempts to download a Video the asset was not found. Usually, this means that the provided video url is no longer valid or incorrectly references a video.

  • Possible resolutions include: Reaching out the publisher or agent hosting a video to provide an updated video. In any case, you would have to retry your request to process a video.

Response HTTP Code
HTTP/1.1: 200
Example Invalid Request

{ "uuid": "486b4a12-e2a3-5eef-8310-68bb38f6379e", "url": "https://host.com/some/video.mp4", "errors": [ { "reason": "VIDEO_DOWNLOAD_FAILED_WITH_404" } ] }

VIDEO_TRANSCRIPTION_FAILED

Application Error

Generating a video transcription failed. In such cases, GumGum Contextual may rely on just the visual component to provide classification results. Please reach out to GumGum Contextual support for further information.

Response HTTP Code
HTTP/1.1: 200
Example Invalid Request

 

VIDEO_OCR_FAILED

Application Error

Optical Character Recognition failed for the provided video. Note that OCR is an optional step in our process. Receiving this code is rare, but if encountered, please reach out to GumGum Contextual support for further information.

Response HTTP Code
HTTP/1.1: 200
Example Invalid Request

 

VIDEO_NOT_FOUND

Application Error

The provided uuid is not associated with a video. Please verify that the correct uuid provided by GumGum Contextual is used.

Response HTTP Code
HTTP/1.1: 200
Example Invalid Request

 

LANGUAGE_NOT_SUPPORTED

Application Error

The inferred language of a transcription is not supported by GumGum Contextual. In such cases, GumGum Contextual may rely on just the visual component to provide classification results.

Response HTTP Code
HTTP/1.1: 200
Example Invalid Request

 

LANGUAGE_DETECTION_FAILED

Application Error

There was an error inferring the language of a transcription. In such cases, GumGum Contextual may rely on just the visual component to provide classification results.

Response HTTP Code
HTTP/1.1: 200
Example Invalid Request

 

VIDEO_CLASSIFICATION_FAILED

Application Error

There was a problem processing a video. Please reach out to GumGum Contextual support for further information.

Response HTTP Code
HTTP/1.1: 200
Example Invalid Request

 

URL_MUST_NOT_BE_EMPTY

Validation Error

The provided url was empty. This can apply to a callbackUrl or url field.

Response HTTP Code
HTTP/1.1: 400
Example Invalid Request

 

URL_MALFORMED

Validation Error

The provided url was malformed. This can apply to a callbackUrl or url field.

Response HTTP Code
HTTP/1.1: 400
Example Invalid Request

 

URL_MISSING_HTTP_PROTOCOL

Validation Error

The provided url did not include an HTTP schema. This can apply to a callbackUrl or url.

Response HTTP Code
HTTP/1.1: 400
Example Invalid Request

 

 

Related content


The contents of these documents and any attachments contain GumGum, Inc. confidential information and are legally protected from disclosure.