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 en lenguaje natural.

Propiedades

transporte

Devuelve el transporte que usa la instancia del cliente.

Qué muestra
TipoDescripción
TranslationServiceTransportEs 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
NombreDescripción
credentials Optional[google.auth.credentials.Credentials]

Son las credenciales de autorización que se adjuntan a las solicitudes. Estas credenciales identifican la aplicación ante el servicio. Si no se especifica ninguna, el cliente intentará determinar las credenciales del entorno.

transport Union[str, TranslationServiceTransport]

Es el transporte que se usará. Si se configura como None, se elige un transporte automáticamente.

client_options Optional[Union[google.api_core.client_options.ClientOptions, dict]]

Son 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 extremo predeterminado que proporciona el cliente. La variable de entorno GOOGLE_API_USE_MTLS_ENDPOINT también se puede usar para anular el extremo: "always" (siempre usa el extremo mTLS predeterminado), "never" (siempre usa el extremo regular predeterminado) y "auto" (cambia automáticamente al extremo 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 de TLS mutuo. Si no se proporciona, se usará el certificado de cliente SSL predeterminado, si está presente. Si GOOGLE_API_USE_CLIENT_CERTIFICATE es "false" o no está configurado, no se usará ningún certificado de cliente.

client_info google.api_core.gapic_v1.client_info.ClientInfo

Es la información del cliente que se usa para enviar una cadena de usuario-agente junto con las solicitudes a la API. Si es None, se usará la información predeterminada. Por lo general, solo necesitas configurar este parámetro si desarrollas tu propia biblioteca cliente.

Excepciones
TipoDescripción
google.auth.exceptions.MutualTLSChannelErrorSi falló la creación del transporte de TLS mutuo por algún motivo.

__exit__

__exit__(type, value, traceback)

Libera los recursos de transporte subyacentes.

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 por lotes asíncrono. Esta función proporciona resultados en tiempo real a medida que se procesan las entradas. Si el llamador cancela una solicitud, es posible que los resultados parciales (para un archivo de entrada, son todos o ninguno) sigan disponibles en la ubicación de salida especificada. Esta llamada se devuelve de inmediato, 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
NombreDescripción
request Union[google.cloud.translate_v3.types.BatchTranslateDocumentRequest, dict]

Objeto de solicitud. Es la solicitud de BatchTranslateDocument.

parent str

Obligatorio. Ubicación para realizar una llamada regional. Formato: projects/{project-number-or-id}/locations/{location-id}. La ubicación global no es compatible con la traducción por lotes. Solo se pueden usar modelos o glosarios de AutoML Translation dentro de la misma región (que tengan el mismo ID de ubicación). De lo contrario, se devolverá un error INVALID_ARGUMENT (400). Esto corresponde al campo parent en la instancia de request. Si se proporciona request, no se debe configurar este campo.

source_language_code str

Obligatorio. Es 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__. Esto corresponde al campo source_language_code en la instancia de request. Si se proporciona request, no se debe configurar este campo.

target_language_codes MutableSequence[str]

Obligatorio. Es el código de idioma ISO-639 que se usará para traducir el documento de entrada. Aquí puedes especificar hasta 10 códigos de idioma. Esto corresponde al campo target_language_codes en la instancia de request. Si se proporciona request, no se debe configurar este campo.

input_configs MutableSequence[google.cloud.translate_v3.types.BatchDocumentInputConfig]

Obligatorio. Configuraciones de entrada La cantidad total de archivos coincidentes debe ser menor o igual a 100. El tamaño total del contenido que se traducirá debe ser menor o igual que 100 millones de puntos de código Unicode. Los archivos deben usar la codificación UTF-8. Esto corresponde al campo input_configs en la instancia de request. Si se proporciona request, no se debe configurar este campo.

output_config google.cloud.translate_v3.types.BatchDocumentOutputConfig

Obligatorio. Es la configuración de salida. Si 2 parámetros de configuración de entrada coinciden con el mismo archivo (es decir, la misma ruta de entrada), no generamos resultados para las entradas duplicadas. Esto corresponde al campo output_config en la instancia de request. Si se proporciona request, no se debe configurar este campo.

retry google.api_core.retry.Retry

Es la designación de qué errores, si los hay, se deben volver a intentar.

timeout float

Es el tiempo de espera de esta solicitud.

metadata Sequence[Tuple[str, str]]

Son cadenas que se deben enviar junto con la solicitud como metadatos.

Qué muestra
TipoDescripción
google.api_core.operation.OperationEs un objeto que representa una operación de larga duración. El tipo de resultado de la operación será BatchTranslateDocumentResponse, almacenado en el campo google.longrunning.Operation.response][google.longrunning.Operation.response] que devuelve 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 por lotes asíncrono. Esta función proporciona resultados en tiempo real a medida que se procesan las entradas. Si el llamador cancela una solicitud, es posible que los resultados parciales (para un archivo de entrada, son todos o ninguno) sigan disponibles en la ubicación de salida especificada. Esta llamada se devuelve de inmediato, 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
NombreDescripción
request Union[google.cloud.translate_v3.types.BatchTranslateTextRequest, dict]

Objeto de solicitud. Es la solicitud de traducción por lotes.

retry google.api_core.retry.Retry

Es la designación de qué errores, si los hay, se deben volver a intentar.

timeout float

Es el tiempo de espera de esta solicitud.

metadata Sequence[Tuple[str, str]]

Son cadenas que se deben enviar junto con la solicitud como metadatos.

Qué muestra
TipoDescripción
google.api_core.operation.OperationEs un 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] que devuelve BatchTranslateText si al menos una oración se traduce correctamente.

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. Muestra 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
NombreDescripción
request Union[google.cloud.translate_v3.types.CreateGlossaryRequest, dict]

Objeto de solicitud. Es el mensaje de solicitud para CreateGlossary.

parent str

Obligatorio. Es el nombre del proyecto. Esto corresponde al campo parent en la instancia de request. Si se proporciona request, no se debe configurar este campo.

glossary google.cloud.translate_v3.types.Glossary

Obligatorio. Es el glosario que se creará. Esto corresponde al campo glossary en la instancia de request. Si se proporciona request, no se debe configurar este campo.

retry google.api_core.retry.Retry

Es la designación de qué errores, si los hay, se deben volver a intentar.

timeout float

Es el tiempo de espera de esta solicitud.

metadata Sequence[Tuple[str, str]]

Son cadenas que se deben enviar junto con la solicitud como metadatos.

Qué muestra
TipoDescripción
google.api_core.operation.OperationEs un 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 el usuario.

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

Borra un glosario o cancela su construcción si aún no se creó. Muestra 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
NombreDescripción
request Union[google.cloud.translate_v3.types.DeleteGlossaryRequest, dict]

Objeto de solicitud. Es el mensaje de solicitud para DeleteGlossary.

name str

Obligatorio. Es el nombre del glosario que se borrará. Esto corresponde al campo name en la instancia de request. Si se proporciona request, no se debe configurar este campo.

retry google.api_core.retry.Retry

Es la designación de qué errores, si los hay, se deben volver a intentar.

timeout float

Es el tiempo de espera de esta solicitud.

metadata Sequence[Tuple[str, str]]

Son cadenas que se deben enviar junto con la solicitud como metadatos.

Qué muestra
TipoDescripción
google.api_core.operation.OperationEs un 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] que devuelve 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 en una solicitud.

# 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
NombreDescripción
request Union[google.cloud.translate_v3.types.DetectLanguageRequest, dict]

Objeto de solicitud. Es el mensaje de solicitud para la detección de idioma.

parent str

Obligatorio. Proyecto o ubicación para realizar una llamada. Debe hacer referencia al proyecto de un llamador. Formato: projects/{project-number-or-id}/locations/{location-id} o projects/{project-number-or-id}. Para las llamadas globales, usa projects/{project-number-or-id}/locations/global o projects/{project-number-or-id}. Solo se pueden usar los modelos que se encuentran en la misma región (tienen el mismo ID de ubicación). De lo contrario, se muestra un error INVALID_ARGUMENT (400). Esto corresponde al campo parent en la instancia de request. Si se proporciona request, no se debe configurar este campo.

model str

Opcional. Es el modelo de detección de idioma que se 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. Esto corresponde al campo model en la instancia de request. Si se proporciona request, no se debe configurar este campo.

mime_type str

Opcional. Es el formato del texto fuente, por ejemplo, "text/html" o "text/plain". Si se deja en blanco, el tipo de MIME predeterminado es "text/html". Esto corresponde al campo mime_type en la instancia de request. Si se proporciona request, no se debe configurar este campo.

content str

Es el contenido de la entrada almacenado como una cadena. Esto corresponde al campo content en la instancia de request. Si se proporciona request, no se debe configurar este campo.

retry google.api_core.retry.Retry

Es la designación de qué errores, si los hay, se deben volver a intentar.

timeout float

Es el tiempo de espera de esta solicitud.

metadata Sequence[Tuple[str, str]]

Son cadenas que se deben enviar junto con la solicitud como metadatos.

Parámetro
NombreDescripción
filename str

Es la ruta de acceso al archivo JSON de la clave privada de la cuenta de servicio.

Qué muestra
TipoDescripción
TranslationServiceClientEs el cliente construido.

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. Muestra 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
NombreDescripción
request Union[google.cloud.translate_v3.types.GetGlossaryRequest, dict]

Objeto de solicitud. Es el mensaje de solicitud para GetGlossary.

name str

Obligatorio. Nombre del glosario que se recuperará. Esto corresponde al campo name en la instancia de request. Si se proporciona request, no se debe configurar este campo.

retry google.api_core.retry.Retry

Es la designación de qué errores, si los hay, se deben volver a intentar.

timeout float

Es el tiempo de espera de esta solicitud.

metadata Sequence[Tuple[str, str]]

Son cadenas que se deben enviar junto con la solicitud como metadatos.

Excepciones
TipoDescripción
google.auth.exceptions.MutualTLSChannelErrorSi se produce algún error
Qué muestra
TipoDescripción
Tuple[str, Callable[[], Tuple[bytes, bytes]]]Devuelve el extremo de API y la fuente del certificado del cliente que se usarán.

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 admitidos 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
NombreDescripción
request Union[google.cloud.translate_v3.types.GetSupportedLanguagesRequest, dict]

Objeto de solicitud. Es el mensaje de solicitud para descubrir los idiomas admitidos.

parent str

Obligatorio. Proyecto o ubicación para realizar una llamada. Debe hacer referencia al proyecto de un llamador. Formato: projects/{project-number-or-id} o projects/{project-number-or-id}/locations/{location-id}. Para las llamadas globales, usa projects/{project-number-or-id}/locations/global o projects/{project-number-or-id}. Se requiere una ubicación no global para los modelos de AutoML. Solo se pueden usar los modelos que se encuentran en la misma región (tienen el mismo ID de ubicación). De lo contrario, se devuelve un error INVALID_ARGUMENT (400). Esto corresponde al campo parent en la instancia de request. Si se proporciona request, no se debe configurar este campo.

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. Esto corresponde al campo model en la instancia de request. Si se proporciona request, no se debe configurar este campo.

display_language_code str

Opcional. Es el idioma que se usará para mostrar nombres localizados y legibles de los idiomas admitidos. Si falta, no se mostrarán los nombres visibles en la respuesta. Esto corresponde al campo display_language_code en la instancia de request. Si se proporciona request, no se debe configurar este campo.

retry google.api_core.retry.Retry

Es la designación de qué errores, si los hay, se deben volver a intentar.

timeout float

Es el tiempo de espera de esta solicitud.

metadata Sequence[Tuple[str, str]]

Son cadenas que se deben enviar junto con la solicitud como metadatos.

Qué muestra
TipoDescripción
google.cloud.translate_v3.types.SupportedLanguagesEs el mensaje de respuesta para descubrir los idiomas admitidos.

glossary_path

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

Devuelve una cadena de glosario completamente calificada.

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

Enumera los glosarios de un proyecto. Muestra 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
NombreDescripción
request Union[google.cloud.translate_v3.types.ListGlossariesRequest, dict]

Objeto de solicitud. Es el mensaje de solicitud de ListGlossaries.

parent str

Obligatorio. Es el nombre del proyecto del que se enumerarán todos los glosarios. Esto corresponde al campo parent en la instancia de request. Si se proporciona request, no se debe configurar este campo.

retry google.api_core.retry.Retry

Es la designación de qué errores, si los hay, se deben volver a intentar.

timeout float

Es el tiempo de espera de esta solicitud.

metadata Sequence[Tuple[str, str]]

Son cadenas que se deben enviar junto con la solicitud como metadatos.

Qué muestra
TipoDescripción
google.cloud.translate_v3.services.translation_service.pagers.ListGlossariesPagerEs el mensaje de respuesta para ListGlossaries. Si iteras sobre este objeto, se generará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 acceso al 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
NombreDescripción
request Union[google.cloud.translate_v3.types.TranslateDocumentRequest, dict]

Objeto de solicitud. Es una solicitud de traducción de documentos.

retry google.api_core.retry.Retry

Es la designación de qué errores, si los hay, se deben volver a intentar.

timeout float

Es el tiempo de espera de esta solicitud.

metadata Sequence[Tuple[str, str]]

Son cadenas que se deben enviar junto con la solicitud como metadatos.

Qué muestra
TipoDescripción
google.cloud.translate_v3.types.TranslateDocumentResponseEs un mensaje de respuesta de 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 de entrada 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
NombreDescripción
request Union[google.cloud.translate_v3.types.TranslateTextRequest, dict]

Objeto de solicitud. Es el mensaje de solicitud para la traducción síncrona.

parent str

Obligatorio. Proyecto o ubicación para realizar una llamada. Debe hacer referencia al proyecto de un llamador. Formato: projects/{project-number-or-id} o projects/{project-number-or-id}/locations/{location-id}. Para las llamadas globales, 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 usan 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). Esto corresponde al campo parent en la instancia de request. Si se proporciona request, no se debe configurar este campo.

target_language_code str

Obligatorio. Es el código de idioma ISO-639 que se usará para traducir el texto de entrada. Se debe establecer en uno de los códigos de idioma que se indican en Idiomas admitidos. Esto corresponde al campo target_language_code en la instancia de request. Si se proporciona request, no se debe configurar este campo.

contents MutableSequence[str]

Obligatorio. Es el contenido de la entrada en formato de cadena. Recomendamos que el contenido total tenga menos de 30,000 puntos de código. La longitud máxima de este campo es de 1,024. Usa BatchTranslateText para textos más grandes. Esto corresponde al campo contents en la instancia de request. Si se proporciona request, no se debe configurar este campo.

model str

Opcional. Es el tipo de 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. Para 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 en la instancia de request. Si se proporciona request, no se debe configurar este campo.

mime_type str

Opcional. Es el formato del texto fuente, por ejemplo, "text/html" o "text/plain". Si se deja en blanco, el tipo de MIME predeterminado es "text/html". Esto corresponde al campo mime_type en la instancia de request. Si se proporciona request, no se debe configurar este campo.

source_language_code str

Opcional. Es 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 Idiomas admitidos. Si no se especifica el idioma de origen, la API intenta identificarlo automáticamente y lo devuelve en la respuesta. Esto corresponde al campo source_language_code en la instancia de request. Si se proporciona request, no se debe configurar este campo.

retry google.api_core.retry.Retry

Es la designación de qué errores, si los hay, se deben volver a intentar.

timeout float

Es el tiempo de espera de esta solicitud.

metadata Sequence[Tuple[str, str]]

Son cadenas que se deben enviar junto con la solicitud como metadatos.