メインコンテンツまでスキップ

Get a Dubbing Job

GET 
/bv/cms/v1/dubbing-jobs/:id

This API will get a specific dubbing job.

  • Return a 400/BadRequest error if the request body is invalid.
  • Return a 404/NotFound error if the requested resource is not found.

Request​

Path Parameters

    id stringrequired

    Required. The ID of the dubbing job.

Header Parameters

    x-bv-org-id stringrequired

    To invoke this API using api_token, you need to set the x-bv-org-id header to specify the organization for which you want to perform the action.

Responses​

A successful response.

Schema
    dubbing_job object

    Output only. The dubbing job.

    id string

    Identifier. The ID of the dubbing job.

    source_type stringrequired

    Possible values: [DUBBING_SOURCE_TYPE_VIDEO, DUBBING_SOURCE_TYPE_AUDIO]

    Required. The source type of the dubbing.

    source_id stringrequired

    Required. The source ID of the dubbing.

    source_lang_code stringrequired

    Required. The source language code. The format is ISO 639-1 or ISO 639-1+ISO 3166-1 (e.g., en or en-US).

    interval_sec object

    Optional. The interval of the dubbing.

    start object

    A representation of a decimal value, such as 2.5. Clients may convert values into language-native decimal formats, such as Java's BigDecimal or Python's decimal.Decimal.

    value string

    The decimal value, as a string.

    The string representation consists of an optional sign, + (U+002B) or - (U+002D), followed by a sequence of zero or more decimal digits ("the integer"), optionally followed by a fraction, optionally followed by an exponent.

    The fraction consists of a decimal point followed by zero or more decimal digits. The string must contain at least one digit in either the integer or the fraction. The number formed by the sign, the integer and the fraction is referred to as the significand.

    The exponent consists of the character e (U+0065) or E (U+0045) followed by one or more decimal digits.

    Services should normalize decimal values before storing them by:

    • Removing an explicitly-provided + sign (+2.5 -> 2.5).
    • Replacing a zero-length integer value with 0 (.5 -> 0.5).
    • Coercing the exponent character to lower-case (2.5E8 -> 2.5e8).
    • Removing an explicitly-provided zero exponent (2.5e0 -> 2.5).

    Services may perform additional normalization based on its own needs and the internal decimal implementation selected, such as shifting the decimal point and exponent value together (example: 2.5e-1 <-> 0.25). Additionally, services may preserve trailing zeroes in the fraction to indicate increased precision, but are not required to do so.

    Note that only the . character is supported to divide the integer and the fraction; , should not be supported regardless of locale. Additionally, thousand separators should not be supported. If a service does support them, values must be normalized.

    The ENBF grammar is:

    DecimalString =
      [Sign] Significand [Exponent];

    Sign = '+' | '-';

    Significand =
      Digits ['.'] [Digits] | [Digits] '.' Digits;

    Exponent = ('e' | 'E') [Sign] Digits;

    Digits = { '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' };

    Services should clearly document the range of supported values, the maximum supported precision (total number of digits), and, if applicable, the scale (number of digits after the decimal point), as well as how it behaves when receiving out-of-bounds values.

    Services may choose to accept values passed as input even when the value has a higher precision or scale than the service supports, and should round the value to fit the supported scale. Alternatively, the service may error with 400 Bad Request (INVALID_ARGUMENT in gRPC) if precision would be lost.

    Services should error with 400 Bad Request (INVALID_ARGUMENT in gRPC) if the service receives a value outside of the supported range.

    end object

    A representation of a decimal value, such as 2.5. Clients may convert values into language-native decimal formats, such as Java's BigDecimal or Python's decimal.Decimal.

    value string

    The decimal value, as a string.

    The string representation consists of an optional sign, + (U+002B) or - (U+002D), followed by a sequence of zero or more decimal digits ("the integer"), optionally followed by a fraction, optionally followed by an exponent.

    The fraction consists of a decimal point followed by zero or more decimal digits. The string must contain at least one digit in either the integer or the fraction. The number formed by the sign, the integer and the fraction is referred to as the significand.

    The exponent consists of the character e (U+0065) or E (U+0045) followed by one or more decimal digits.

    Services should normalize decimal values before storing them by:

    • Removing an explicitly-provided + sign (+2.5 -> 2.5).
    • Replacing a zero-length integer value with 0 (.5 -> 0.5).
    • Coercing the exponent character to lower-case (2.5E8 -> 2.5e8).
    • Removing an explicitly-provided zero exponent (2.5e0 -> 2.5).

    Services may perform additional normalization based on its own needs and the internal decimal implementation selected, such as shifting the decimal point and exponent value together (example: 2.5e-1 <-> 0.25). Additionally, services may preserve trailing zeroes in the fraction to indicate increased precision, but are not required to do so.

    Note that only the . character is supported to divide the integer and the fraction; , should not be supported regardless of locale. Additionally, thousand separators should not be supported. If a service does support them, values must be normalized.

    The ENBF grammar is:

    DecimalString =
      [Sign] Significand [Exponent];

    Sign = '+' | '-';

    Significand =
      Digits ['.'] [Digits] | [Digits] '.' Digits;

    Exponent = ('e' | 'E') [Sign] Digits;

    Digits = { '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' };

    Services should clearly document the range of supported values, the maximum supported precision (total number of digits), and, if applicable, the scale (number of digits after the decimal point), as well as how it behaves when receiving out-of-bounds values.

    Services may choose to accept values passed as input even when the value has a higher precision or scale than the service supports, and should round the value to fit the supported scale. Alternatively, the service may error with 400 Bad Request (INVALID_ARGUMENT in gRPC) if precision would be lost.

    Services should error with 400 Bad Request (INVALID_ARGUMENT in gRPC) if the service receives a value outside of the supported range.

    outputs object[]required

    Required. MaxItems: 1. The outputs of the dubbing. The maximum number of items is 1.

  • Array [
    • id string

    Output only. The file_id of the output.

    lang_code stringrequired

    Required. The language code. The format is ISO 639-1 or ISO 639-1+ISO 3166-1 (e.g., en or en-US).

  • ]
    • status string

    Possible values: [DUBBING_STATUS_CREATED, DUBBING_STATUS_PROCESSING, DUBBING_STATUS_SUCCEEDED, DUBBING_STATUS_FAILED]

    Output only. The status of the dubbing.

    error_infos object[]

    Output only. error infos when dubbing failed. Only available when the status is DUBBING_STATUS_FAILED.

  • Array [
    • reason string

    The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of [A-Z][A-Z0-9_]+[A-Z0-9], which represents UPPER_SNAKE_CASE.

    domain string

    The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com".

    metadata object

    Additional structured details about this error.

    Keys must match a regular expression of [a-z][a-zA-Z0-9-_]+ but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than {"instanceLimit": "100/request"}, should be returned as, {"instanceLimitPerRequest": "100"}, if the client exceeds the number of instances that can be created in a single (batch) request.

    property name* string
  • ]
    • created_at date-time

    Output only. The created time of the dubbing.

Loading...