Esta página se ha traducido con Cloud Translation API.

Clase TranslationServiceClient (3.12.0)

TranslationServiceClient(*, credentials: typing.Optional[google.auth.credentials.Credentials] = None, transport: typing.Optional[typing.Union[str, google.cloud.translate_v3.services.translation_service.transports.base.TranslationServiceTransport]] = None, client_options: typing.Optional[typing.Union[google.api_core.client_options.ClientOptions, dict]] = None, client_info: google.api_core.gapic_v1.client_info.ClientInfo = <google.api_core.gapic_v1.client_info.ClientInfo object>)

Proporciona operaciones de traducción de lenguaje natural.

Propiedades

transporte

Devuelve el transporte usado por la instancia del cliente.

Devoluciones
Tipo	Descripción
`TranslationServiceTransport`	El transporte que usa la instancia del cliente.

Métodos

TranslationServiceClient

TranslationServiceClient(*, credentials: typing.Optional[google.auth.credentials.Credentials] = None, transport: typing.Optional[typing.Union[str, google.cloud.translate_v3.services.translation_service.transports.base.TranslationServiceTransport]] = None, client_options: typing.Optional[typing.Union[google.api_core.client_options.ClientOptions, dict]] = None, client_info: google.api_core.gapic_v1.client_info.ClientInfo = <google.api_core.gapic_v1.client_info.ClientInfo object>)

Crea una instancia del cliente del servicio de traducción.

Parámetros
Nombre	Descripción
`credentials`	`Optional[google.auth.credentials.Credentials]` Las credenciales de autorización que se adjuntarán a las solicitudes. Estas credenciales identifican la aplicación en el servicio. Si no se especifica ninguna, el cliente intentará obtener las credenciales del entorno.
`transport`	`Union[str, TranslationServiceTransport]` El transporte que se va a usar. Si se define como None, se elige un transporte automáticamente.
`client_options`	`Optional[Union[google.api_core.client_options.ClientOptions, dict]]` Opciones personalizadas para el cliente. No tendrá efecto si se proporciona una instancia de `transport`. 1) La propiedad `api_endpoint` se puede usar para anular el endpoint predeterminado proporcionado por el cliente. La variable de entorno GOOGLE_API_USE_MTLS_ENDPOINT también se puede usar para anular el endpoint: "always" (usar siempre el endpoint mTLS predeterminado), "never" (usar siempre el endpoint normal predeterminado) y "auto" (cambiar automáticamente al endpoint mTLS predeterminado si hay un certificado de cliente presente; este es el valor predeterminado). Sin embargo, la propiedad `api_endpoint` tiene prioridad si se proporciona. (2) Si la variable de entorno GOOGLE_API_USE_CLIENT_CERTIFICATE es "true", se puede usar la propiedad `client_cert_source` para proporcionar el certificado de cliente para el transporte TLS mutuo. Si no se proporciona, se usará el certificado de cliente SSL predeterminado, si está presente. Si GOOGLE_API_USE_CLIENT_CERTIFICATE tiene el valor "false" o no se ha definido, no se usará ningún certificado de cliente.
`client_info`	`google.api_core.gapic_v1.client_info.ClientInfo` La información del cliente que se usa para enviar una cadena user-agent junto con las solicitudes de API. Si `None`, se usará la información predeterminada. Por lo general, solo tienes que definirlo si estás desarrollando tu propia biblioteca de cliente.

Excepciones
Tipo	Descripción
`google.auth.exceptions.MutualTLSChannelError`	Si no se ha podido crear el transporte TLS mutuo por algún motivo.

exit

__exit__(type, value, traceback)

Libera los recursos del transporte subyacente.

batch_translate_document

batch_translate_document(
    request: typing.Optional[
        typing.Union[
            google.cloud.translate_v3.types.translation_service.BatchTranslateDocumentRequest,
            dict,
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    source_language_code: typing.Optional[str] = None,
    target_language_codes: typing.Optional[typing.MutableSequence[str]] = None,
    input_configs: typing.Optional[
        typing.MutableSequence[
            google.cloud.translate_v3.types.translation_service.BatchDocumentInputConfig
        ]
    ] = None,
    output_config: typing.Optional[
        google.cloud.translate_v3.types.translation_service.BatchDocumentOutputConfig
    ] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.api_core.operation.Operation

Traduce un gran volumen de documentos en modo asíncrono por lotes. Esta función proporciona resultados en tiempo real a medida que se procesan las entradas. Si la persona que llama cancela una solicitud, los resultados parciales (en el caso de un archivo de entrada, se trata de todo o nada) pueden seguir estando disponibles en la ubicación de salida especificada. Esta llamada se devuelve inmediatamente y puedes usar google.longrunning.Operation.name para sondear el estado de la llamada.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import translate_v3

def sample_batch_translate_document():
    # Create a client
    client = translate_v3.TranslationServiceClient()

    # Initialize request argument(s)
    input_configs = translate_v3.BatchDocumentInputConfig()
    input_configs.gcs_source.input_uri = "input_uri_value"

    output_config = translate_v3.BatchDocumentOutputConfig()
    output_config.gcs_destination.output_uri_prefix = "output_uri_prefix_value"

    request = translate_v3.BatchTranslateDocumentRequest(
        parent="parent_value",
        source_language_code="source_language_code_value",
        target_language_codes=['target_language_codes_value1', 'target_language_codes_value2'],
        input_configs=input_configs,
        output_config=output_config,
    )

    # Make the request
    operation = client.batch_translate_document(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

Parámetros
Nombre	Descripción
`request`	`Union[google.cloud.translate_v3.types.BatchTranslateDocumentRequest, dict]` El objeto de solicitud. La solicitud BatchTranslateDocument.
`parent`	`str` Obligatorio. Ubicación para hacer una llamada regional. Formato: `projects/{project-number-or-id}/locations/{location-id}`. La ubicación `global` no se admite en la traducción por lotes. Solo se pueden usar modelos o glosarios de AutoML Translation que estén en la misma región (que tengan el mismo ID de ubicación). De lo contrario, se devolverá un error INVALID_ARGUMENT (400). Corresponde al campo `parent` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`source_language_code`	`str` Obligatorio. El código de idioma ISO-639 del documento de entrada, si se conoce. Por ejemplo, "en-US" o "sr-Latn". Los códigos de idioma admitidos se indican en `Language Support https://cloud.google.com/translate/docs/languages`__. Corresponde al campo `source_language_code` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`target_language_codes`	`MutableSequence[str]` Obligatorio. El código de idioma ISO-639 que se usará para traducir el documento de entrada. Especifica hasta 10 códigos de idioma. Corresponde al campo `target_language_codes` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`input_configs`	`MutableSequence[google.cloud.translate_v3.types.BatchDocumentInputConfig]` Obligatorio. Configuraciones de entrada. El número total de archivos coincidentes debe ser igual o inferior a 100. El tamaño total del contenido que se va a traducir debe ser de 100 millones de puntos de código Unicode como máximo. Los archivos deben usar la codificación UTF-8. Corresponde al campo `input_configs` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`output_config`	`google.cloud.translate_v3.types.BatchDocumentOutputConfig` Obligatorio. Configuración de salida. Si dos configuraciones de entrada coinciden con el mismo archivo (es decir, tienen la misma ruta de entrada), no generamos una salida para las entradas duplicadas. Corresponde al campo `output_config` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`retry`	`google.api_core.retry.Retry` Designación de los errores que se deben reintentar (si los hay).
`timeout`	`float` Tiempo de espera de esta solicitud.
`metadata`	`Sequence[Tuple[str, str]]` Cadenas que se deben enviar junto con la solicitud como metadatos.

Devoluciones
Tipo	Descripción
`google.api_core.operation.Operation`	Objeto que representa una operación de larga duración. El tipo de resultado de la operación será BatchTranslateDocumentResponse, que se almacenará en el campo `google.longrunning.Operation.response][google.longrunning.Operation.response]` devuelto por BatchTranslateDocument si se traduce correctamente al menos un documento.

batch_translate_text

batch_translate_text(
    request: typing.Optional[
        typing.Union[
            google.cloud.translate_v3.types.translation_service.BatchTranslateTextRequest,
            dict,
        ]
    ] = None,
    *,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.api_core.operation.Operation

Traduce un gran volumen de texto en modo asíncrono por lotes. Esta función proporciona resultados en tiempo real a medida que se procesan las entradas. Si la persona que llama cancela una solicitud, los resultados parciales (en el caso de un archivo de entrada, se trata de todo o nada) pueden seguir estando disponibles en la ubicación de salida especificada. Esta llamada se devuelve inmediatamente y puedes usar google.longrunning.Operation.name para sondear el estado de la llamada.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import translate_v3

def sample_batch_translate_text():
    # Create a client
    client = translate_v3.TranslationServiceClient()

    # Initialize request argument(s)
    input_configs = translate_v3.InputConfig()
    input_configs.gcs_source.input_uri = "input_uri_value"

    output_config = translate_v3.OutputConfig()
    output_config.gcs_destination.output_uri_prefix = "output_uri_prefix_value"

    request = translate_v3.BatchTranslateTextRequest(
        parent="parent_value",
        source_language_code="source_language_code_value",
        target_language_codes=['target_language_codes_value1', 'target_language_codes_value2'],
        input_configs=input_configs,
        output_config=output_config,
    )

    # Make the request
    operation = client.batch_translate_text(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

Parámetros
Nombre	Descripción
`request`	`Union[google.cloud.translate_v3.types.BatchTranslateTextRequest, dict]` El objeto de solicitud. La solicitud de traducción por lotes.
`retry`	`google.api_core.retry.Retry` Designación de los errores que se deben reintentar (si los hay).
`timeout`	`float` Tiempo de espera de esta solicitud.
`metadata`	`Sequence[Tuple[str, str]]` Cadenas que se deben enviar junto con la solicitud como metadatos.

Devoluciones
Tipo	Descripción
`google.api_core.operation.Operation`	Objeto que representa una operación de larga duración. El tipo de resultado de la operación será BatchTranslateResponse, que se almacenará en el campo `google.longrunning.Operation.response][google.longrunning.Operation.response]` devuelto por BatchTranslateText si se traduce correctamente al menos una frase.

create_glossary

create_glossary(
    request: typing.Optional[
        typing.Union[
            google.cloud.translate_v3.types.translation_service.CreateGlossaryRequest,
            dict,
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    glossary: typing.Optional[
        google.cloud.translate_v3.types.translation_service.Glossary
    ] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.api_core.operation.Operation

Crea un glosario y devuelve la operación de larga duración. Devuelve NOT_FOUND si el proyecto no existe.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import translate_v3

def sample_create_glossary():
    # Create a client
    client = translate_v3.TranslationServiceClient()

    # Initialize request argument(s)
    glossary = translate_v3.Glossary()
    glossary.name = "name_value"

    request = translate_v3.CreateGlossaryRequest(
        parent="parent_value",
        glossary=glossary,
    )

    # Make the request
    operation = client.create_glossary(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

Parámetros
Nombre	Descripción
`request`	`Union[google.cloud.translate_v3.types.CreateGlossaryRequest, dict]` El objeto de solicitud. Mensaje de solicitud de CreateGlossary.
`parent`	`str` Obligatorio. Nombre del proyecto. Corresponde al campo `parent` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`glossary`	`google.cloud.translate_v3.types.Glossary` Obligatorio. Glosario que se va a crear. Corresponde al campo `glossary` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`retry`	`google.api_core.retry.Retry` Designación de los errores que se deben reintentar (si los hay).
`timeout`	`float` Tiempo de espera de esta solicitud.
`metadata`	`Sequence[Tuple[str, str]]` Cadenas que se deben enviar junto con la solicitud como metadatos.

Devoluciones
Tipo	Descripción
`google.api_core.operation.Operation`	Objeto que representa una operación de larga duración. El tipo de resultado de la operación será Glossary, que representa un glosario creado a partir de datos proporcionados por los usuarios.

delete_glossary

delete_glossary(
    request: typing.Optional[
        typing.Union[
            google.cloud.translate_v3.types.translation_service.DeleteGlossaryRequest,
            dict,
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.api_core.operation.Operation

Elimina una glosario o cancela su creación si aún no se ha creado. Devuelve NOT_FOUND si el glosario no existe.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import translate_v3

def sample_delete_glossary():
    # Create a client
    client = translate_v3.TranslationServiceClient()

    # Initialize request argument(s)
    request = translate_v3.DeleteGlossaryRequest(
        name="name_value",
    )

    # Make the request
    operation = client.delete_glossary(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

Parámetros
Nombre	Descripción
`request`	`Union[google.cloud.translate_v3.types.DeleteGlossaryRequest, dict]` El objeto de solicitud. Mensaje de solicitud de DeleteGlossary.
`name`	`str` Obligatorio. Nombre de la glosario que se va a eliminar. Corresponde al campo `name` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`retry`	`google.api_core.retry.Retry` Designación de los errores que se deben reintentar (si los hay).
`timeout`	`float` Tiempo de espera de esta solicitud.
`metadata`	`Sequence[Tuple[str, str]]` Cadenas que se deben enviar junto con la solicitud como metadatos.

Devoluciones
Tipo	Descripción
`google.api_core.operation.Operation`	Objeto que representa una operación de larga duración. El tipo de resultado de la operación será DeleteGlossaryResponse, que se almacenará en el campo `google.longrunning.Operation.response][google.longrunning.Operation.response]` devuelto por DeleteGlossary.

detect_language

detect_language(
    request: typing.Optional[
        typing.Union[
            google.cloud.translate_v3.types.translation_service.DetectLanguageRequest,
            dict,
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    model: typing.Optional[str] = None,
    mime_type: typing.Optional[str] = None,
    content: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.translate_v3.types.translation_service.DetectLanguageResponse

Detecta el idioma del texto de una petición.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import translate_v3

def sample_detect_language():
    # Create a client
    client = translate_v3.TranslationServiceClient()

    # Initialize request argument(s)
    request = translate_v3.DetectLanguageRequest(
        content="content_value",
        parent="parent_value",
    )

    # Make the request
    response = client.detect_language(request=request)

    # Handle the response
    print(response)

Parámetros
Nombre	Descripción
`request`	`Union[google.cloud.translate_v3.types.DetectLanguageRequest, dict]` El objeto de solicitud. Mensaje de solicitud para la detección de idiomas.
`parent`	`str` Obligatorio. Proyecto o ubicación desde la que hacer la llamada. Debe hacer referencia al proyecto de un llamante. Formato: `projects/{project-number-or-id}/locations/{location-id}` o `projects/{project-number-or-id}`. Para llamadas internacionales, usa `projects/{project-number-or-id}/locations/global` o `projects/{project-number-or-id}`. Solo se pueden usar modelos de la misma región (con el mismo location-id). De lo contrario, se devolverá un error INVALID_ARGUMENT (400). Corresponde al campo `parent` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`model`	`str` Opcional. El modelo de detección de idioma que se va a usar. Formato: `projects/{project-number-or-id}/locations/{location-id}/models/language-detection/{model-id}` actualmente solo se admite un modelo de detección de idioma: `projects/{project-number-or-id}/locations/{location-id}/models/language-detection/default`. Si no se especifica, se usa el modelo predeterminado. Corresponde al campo `model` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`mime_type`	`str` Opcional. El formato del texto de origen, por ejemplo, "text/html" o "text/plain". Si se deja en blanco, el tipo MIME será "text/html" de forma predeterminada. Corresponde al campo `mime_type` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`content`	`str` El contenido de la entrada almacenado como una cadena. Corresponde al campo `content` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`retry`	`google.api_core.retry.Retry` Designación de los errores que se deben reintentar (si los hay).
`timeout`	`float` Tiempo de espera de esta solicitud.
`metadata`	`Sequence[Tuple[str, str]]` Cadenas que se deben enviar junto con la solicitud como metadatos.

Parámetro
Nombre	Descripción
`filename`	`str` Ruta al archivo JSON de la clave privada de la cuenta de servicio.

Devoluciones
Tipo	Descripción
`TranslationServiceClient`	El cliente creado.

get_glossary

get_glossary(
    request: typing.Optional[
        typing.Union[
            google.cloud.translate_v3.types.translation_service.GetGlossaryRequest, dict
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.translate_v3.types.translation_service.Glossary

Obtiene un glosario. Devuelve NOT_FOUND si el glosario no existe.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import translate_v3

def sample_get_glossary():
    # Create a client
    client = translate_v3.TranslationServiceClient()

    # Initialize request argument(s)
    request = translate_v3.GetGlossaryRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_glossary(request=request)

    # Handle the response
    print(response)

Parámetros
Nombre	Descripción
`request`	`Union[google.cloud.translate_v3.types.GetGlossaryRequest, dict]` El objeto de solicitud. Mensaje de solicitud de GetGlossary.
`name`	`str` Obligatorio. Nombre de la glosario que se quiere obtener. Corresponde al campo `name` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`retry`	`google.api_core.retry.Retry` Designación de los errores que se deben reintentar (si los hay).
`timeout`	`float` Tiempo de espera de esta solicitud.
`metadata`	`Sequence[Tuple[str, str]]` Cadenas que se deben enviar junto con la solicitud como metadatos.

Excepciones
Tipo	Descripción
`google.auth.exceptions.MutualTLSChannelError`	Si se produce algún error.

Devoluciones
Tipo	Descripción
`Tuple[str, Callable[[], Tuple[bytes, bytes]]]`	Devuelve el endpoint de la API y el origen del certificado de cliente que se va a usar.

get_supported_languages

get_supported_languages(
    request: typing.Optional[
        typing.Union[
            google.cloud.translate_v3.types.translation_service.GetSupportedLanguagesRequest,
            dict,
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    model: typing.Optional[str] = None,
    display_language_code: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.translate_v3.types.translation_service.SupportedLanguages

Devuelve una lista de los idiomas disponibles para la traducción.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import translate_v3

def sample_get_supported_languages():
    # Create a client
    client = translate_v3.TranslationServiceClient()

    # Initialize request argument(s)
    request = translate_v3.GetSupportedLanguagesRequest(
        parent="parent_value",
    )

    # Make the request
    response = client.get_supported_languages(request=request)

    # Handle the response
    print(response)

Parámetros
Nombre	Descripción
`request`	`Union[google.cloud.translate_v3.types.GetSupportedLanguagesRequest, dict]` El objeto de solicitud. Mensaje de solicitud para descubrir los idiomas admitidos.
`parent`	`str` Obligatorio. Proyecto o ubicación desde la que hacer la llamada. Debe hacer referencia al proyecto de un llamante. Formato: `projects/{project-number-or-id}` o `projects/{project-number-or-id}/locations/{location-id}`. Para llamadas internacionales, usa `projects/{project-number-or-id}/locations/global` o `projects/{project-number-or-id}`. Es obligatorio indicar una ubicación no global para los modelos de AutoML. Solo se pueden usar modelos de la misma región (con el mismo location-id). De lo contrario, se devolverá un error INVALID_ARGUMENT (400). Corresponde al campo `parent` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`model`	`str` Opcional. Obtiene los idiomas admitidos de este modelo. El formato depende del tipo de modelo: - Modelos de AutoML Translation: `projects/{project-number-or-id}/locations/{location-id}/models/{model-id}` - Modelos generales (integrados): `projects/{project-number-or-id}/locations/{location-id}/models/general/nmt`. Devuelve los idiomas admitidos por el modelo especificado. Si falta, obtenemos los idiomas admitidos del modelo general de NMT de Google. Corresponde al campo `model` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`display_language_code`	`str` Opcional. El idioma que se utilizará para devolver nombres localizados y legibles de los idiomas admitidos. Si falta, los nombres visibles no se devuelven en una respuesta. Corresponde al campo `display_language_code` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`retry`	`google.api_core.retry.Retry` Designación de los errores que se deben reintentar (si los hay).
`timeout`	`float` Tiempo de espera de esta solicitud.
`metadata`	`Sequence[Tuple[str, str]]` Cadenas que se deben enviar junto con la solicitud como metadatos.

Devoluciones
Tipo	Descripción
`google.cloud.translate_v3.types.SupportedLanguages`	El mensaje de respuesta para descubrir los idiomas compatibles.

glossary_path

glossary_path(project: str, location: str, glossary: str) -> str

Devuelve una cadena de glosario completa.

list_glossaries

list_glossaries(
    request: typing.Optional[
        typing.Union[
            google.cloud.translate_v3.types.translation_service.ListGlossariesRequest,
            dict,
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.translate_v3.services.translation_service.pagers.ListGlossariesPager

Muestra las glosarios de un proyecto. Devuelve NOT_FOUND si el proyecto no existe.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import translate_v3

def sample_list_glossaries():
    # Create a client
    client = translate_v3.TranslationServiceClient()

    # Initialize request argument(s)
    request = translate_v3.ListGlossariesRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_glossaries(request=request)

    # Handle the response
    for response in page_result:
        print(response)

Parámetros
Nombre	Descripción
`request`	`Union[google.cloud.translate_v3.types.ListGlossariesRequest, dict]` El objeto de solicitud. Mensaje de solicitud de ListGlossaries.
`parent`	`str` Obligatorio. Nombre del proyecto del que se van a enumerar todas las glosarios. Corresponde al campo `parent` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`retry`	`google.api_core.retry.Retry` Designación de los errores que se deben reintentar (si los hay).
`timeout`	`float` Tiempo de espera de esta solicitud.
`metadata`	`Sequence[Tuple[str, str]]` Cadenas que se deben enviar junto con la solicitud como metadatos.

Devoluciones
Tipo	Descripción
`google.cloud.translate_v3.services.translation_service.pagers.ListGlossariesPager`	Mensaje de respuesta a ListGlossaries. Al iterar sobre este objeto, se obtendrán resultados y se resolverán páginas adicionales automáticamente.

parse_glossary_path

parse_glossary_path(path: str) -> typing.Dict[str, str]

Analiza una ruta de glosario en sus segmentos de componentes.

translate_document

translate_document(
    request: typing.Optional[
        typing.Union[
            google.cloud.translate_v3.types.translation_service.TranslateDocumentRequest,
            dict,
        ]
    ] = None,
    *,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.translate_v3.types.translation_service.TranslateDocumentResponse

Traduce documentos en modo síncrono.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import translate_v3

def sample_translate_document():
    # Create a client
    client = translate_v3.TranslationServiceClient()

    # Initialize request argument(s)
    document_input_config = translate_v3.DocumentInputConfig()
    document_input_config.content = b'content_blob'

    request = translate_v3.TranslateDocumentRequest(
        parent="parent_value",
        target_language_code="target_language_code_value",
        document_input_config=document_input_config,
    )

    # Make the request
    response = client.translate_document(request=request)

    # Handle the response
    print(response)

Parámetros
Nombre	Descripción
`request`	`Union[google.cloud.translate_v3.types.TranslateDocumentRequest, dict]` El objeto de solicitud. Una solicitud de traducción de un documento.
`retry`	`google.api_core.retry.Retry` Designación de los errores que se deben reintentar (si los hay).
`timeout`	`float` Tiempo de espera de esta solicitud.
`metadata`	`Sequence[Tuple[str, str]]` Cadenas que se deben enviar junto con la solicitud como metadatos.

Devoluciones
Tipo	Descripción
`google.cloud.translate_v3.types.TranslateDocumentResponse`	Un mensaje de respuesta de un documento traducido.

translate_text

translate_text(
    request: typing.Optional[
        typing.Union[
            google.cloud.translate_v3.types.translation_service.TranslateTextRequest,
            dict,
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    target_language_code: typing.Optional[str] = None,
    contents: typing.Optional[typing.MutableSequence[str]] = None,
    model: typing.Optional[str] = None,
    mime_type: typing.Optional[str] = None,
    source_language_code: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.translate_v3.types.translation_service.TranslateTextResponse

Traduce el texto introducido y devuelve el texto traducido.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import translate_v3

def sample_translate_text():
    # Create a client
    client = translate_v3.TranslationServiceClient()

    # Initialize request argument(s)
    request = translate_v3.TranslateTextRequest(
        contents=['contents_value1', 'contents_value2'],
        target_language_code="target_language_code_value",
        parent="parent_value",
    )

    # Make the request
    response = client.translate_text(request=request)

    # Handle the response
    print(response)

Parámetros
Nombre	Descripción
`request`	`Union[google.cloud.translate_v3.types.TranslateTextRequest, dict]` El objeto de solicitud. Mensaje de solicitud de traducción síncrona.
`parent`	`str` Obligatorio. Proyecto o ubicación desde la que hacer la llamada. Debe hacer referencia al proyecto de un llamante. Formato: `projects/{project-number-or-id}` o `projects/{project-number-or-id}/locations/{location-id}`. Para llamadas internacionales, usa `projects/{project-number-or-id}/locations/global` o `projects/{project-number-or-id}`. Se requiere una ubicación no global para las solicitudes que usen modelos de AutoML o glosarios personalizados. Los modelos y los glosarios deben estar en la misma región (tener el mismo ID de ubicación). De lo contrario, se devolverá un error INVALID_ARGUMENT (400). Corresponde al campo `parent` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`target_language_code`	`str` Obligatorio. Código de idioma ISO-639 que se va a usar para traducir el texto de entrada. Debe ser uno de los códigos de idioma que se indican en la sección Idiomas admitidos. Corresponde al campo `target_language_code` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`contents`	`MutableSequence[str]` Obligatorio. El contenido de la entrada en formato de cadena. Recomendamos que el contenido total no supere los 30.000 puntos de código. La longitud máxima de este campo es de 1024 caracteres. Usa BatchTranslateText para textos más largos. Corresponde al campo `contents` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`model`	`str` Opcional. El tipo `model` solicitado para esta traducción. El formato depende del tipo de modelo: - Modelos de AutoML Translation: `projects/{project-number-or-id}/locations/{location-id}/models/{model-id}` - Modelos generales (integrados): `projects/{project-number-or-id}/locations/{location-id}/models/general/nmt`. En el caso de las solicitudes globales (no regionalizadas), usa `location-id` `global`. Por ejemplo, `projects/{project-number-or-id}/locations/global/models/general/nmt`. Si no se proporciona, se usará el modelo predeterminado de Google (NMT). Esto corresponde al campo `model` de la instancia `request`. Si se proporciona `request`, no se debe definir este campo.
`mime_type`	`str` Opcional. El formato del texto de origen, por ejemplo, "text/html" o "text/plain". Si se deja en blanco, el tipo MIME será "text/html" de forma predeterminada. Corresponde al campo `mime_type` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`source_language_code`	`str` Opcional. El código de idioma ISO-639 del texto de entrada, si se conoce. Por ejemplo, "en-US" o "sr-Latn". Los códigos de idioma admitidos se indican en la página de idiomas admitidos. Si no se especifica el idioma de origen, la API intenta identificarlo automáticamente y lo devuelve en la respuesta. Corresponde al campo `source_language_code` de la instancia `request`. Si se proporciona `request`, no se debe definir este valor.
`retry`	`google.api_core.retry.Retry` Designación de los errores que se deben reintentar (si los hay).
`timeout`	`float` Tiempo de espera de esta solicitud.
`metadata`	`Sequence[Tuple[str, str]]` Cadenas que se deben enviar junto con la solicitud como metadatos.