Esta página foi traduzida pela API Cloud Translation.

Classe 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>)

Oferece operações de tradução de linguagem natural.

Propriedades

transportes

Devolve o transporte usado pela instância do cliente.

Devoluções
Tipo	Descrição
`TranslationServiceTransport`	O transporte usado pela instância do 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>)

Instancia o cliente do serviço de tradução.

Parâmetros
Nome	Descrição
`credentials`	`Optional[google.auth.credentials.Credentials]` As credenciais de autorização a anexar aos pedidos. Estas credenciais identificam a aplicação junto do serviço. Se não forem especificadas, o cliente tenta determinar as credenciais a partir do ambiente.
`transport`	`Union[str, TranslationServiceTransport]` O transporte a usar. Se estiver definido como Nenhum, é escolhido um transporte automaticamente.
`client_options`	`Optional[Union[google.api_core.client_options.ClientOptions, dict]]` Opções personalizadas para o cliente. Não tem efeito se for fornecida uma instância de `transport`. (1) A propriedade `api_endpoint` pode ser usada para substituir o ponto final predefinido fornecido pelo cliente. A variável de ambiente GOOGLE_API_USE_MTLS_ENDPOINT também pode ser usada para substituir o ponto final: "always" (usar sempre o ponto final mTLS predefinido), "never" (usar sempre o ponto final normal predefinido) e "auto" (mudar automaticamente para o ponto final mTLS predefinido se o certificado do cliente estiver presente. Este é o valor predefinido). No entanto, a propriedade `api_endpoint` tem prioridade se for fornecida. (2) Se a variável de ambiente GOOGLE_API_USE_CLIENT_CERTIFICATE for "true", a propriedade `client_cert_source` pode ser usada para fornecer o certificado de cliente para o transporte TLS mútuo. Se não for fornecido, é usado o certificado de cliente SSL predefinido, se estiver presente. Se GOOGLE_API_USE_CLIENT_CERTIFICATE for "false" ou não estiver definido, não é usado nenhum certificado de cliente.
`client_info`	`google.api_core.gapic_v1.client_info.ClientInfo` As informações do cliente usadas para enviar uma string do agente do utilizador juntamente com os pedidos de API. Se `None`, são usadas as informações predefinidas. Geralmente, só precisa de definir esta opção se estiver a desenvolver a sua própria biblioteca de cliente.

Exceções
Tipo	Descrição
`google.auth.exceptions.MutualTLSChannelError`	Se a criação do transporte TLS mútuo falhou por algum motivo.

exit

__exit__(type, value, traceback)

Liberta os recursos de transporte subjacentes.

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

Traduz um grande volume de documentos no modo de lote assíncrono. Esta função fornece resultados em tempo real à medida que as entradas são processadas. Se o autor da chamada cancelar um pedido, os resultados parciais (para um ficheiro de entrada, é tudo ou nada) podem continuar disponíveis na localização de saída especificada. Esta chamada é devolvida imediatamente e pode usar google.longrunning.Operation.name para sondar o estado da chamada.

# 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
Nome	Descrição
`request`	`Union[google.cloud.translate_v3.types.BatchTranslateDocumentRequest, dict]` O objeto de pedido. O pedido BatchTranslateDocument.
`parent`	`str` Obrigatório. Localização para fazer uma chamada regional. Formato: `projects/{project-number-or-id}/locations/{location-id}`. A localização `global` não é suportada para tradução em lote. Só é possível usar modelos do AutoML Translation ou glossários na mesma região (com o mesmo location-id). Caso contrário, é devolvido um erro INVALID_ARGUMENT (400). Corresponde ao campo `parent` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`source_language_code`	`str` Obrigatório. O código de idioma ISO-639 do documento de entrada, se conhecido, por exemplo, "en-US" ou "sr-Latn". Os códigos de idioma suportados estão listados em `Language Support https://cloud.google.com/translate/docs/languages`__. Corresponde ao campo `source_language_code` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`target_language_codes`	`MutableSequence[str]` Obrigatório. O código de idioma ISO-639 a usar para a tradução do documento de entrada. Especifique até 10 códigos de idioma aqui. Corresponde ao campo `target_language_codes` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`input_configs`	`MutableSequence[google.cloud.translate_v3.types.BatchDocumentInputConfig]` Obrigatório. Configurações de entrada. O número total de ficheiros correspondentes deve ser <= 100. O tamanho total do conteúdo a traduzir deve ser <= 100 milhões de pontos de código Unicode. Os ficheiros têm de usar a codificação UTF-8. Corresponde ao campo `input_configs` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`output_config`	`google.cloud.translate_v3.types.BatchDocumentOutputConfig` Obrigatório. Configuração de saída. Se 2 configurações de entrada corresponderem ao mesmo ficheiro (ou seja, o mesmo caminho de entrada), não geramos saída para entradas duplicadas. Corresponde ao campo `output_config` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`retry`	`google.api_core.retry.Retry` Designação dos erros, se existirem, que devem ser repetidos.
`timeout`	`float` O tempo limite para este pedido.
`metadata`	`Sequence[Tuple[str, str]]` Strings que devem ser enviadas juntamente com o pedido como metadados.

Devoluções
Tipo	Descrição
`google.api_core.operation.Operation`	Um objeto que representa uma operação de longa duração. O tipo de resultado da operação é BatchTranslateDocumentResponse. Este é armazenado no campo `google.longrunning.Operation.response][google.longrunning.Operation.response]` devolvido por BatchTranslateDocument se, pelo menos, um documento for traduzido com êxito.

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

Traduz um grande volume de texto no modo de lote assíncrono. Esta função fornece resultados em tempo real à medida que as entradas são processadas. Se o autor da chamada cancelar um pedido, os resultados parciais (para um ficheiro de entrada, é tudo ou nada) podem continuar disponíveis na localização de saída especificada. Esta chamada é devolvida imediatamente e pode usar google.longrunning.Operation.name para sondar o estado da chamada.

# 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
Nome	Descrição
`request`	`Union[google.cloud.translate_v3.types.BatchTranslateTextRequest, dict]` O objeto de pedido. O pedido de tradução em lote.
`retry`	`google.api_core.retry.Retry` Designação dos erros, se existirem, que devem ser repetidos.
`timeout`	`float` O tempo limite para este pedido.
`metadata`	`Sequence[Tuple[str, str]]` Strings que devem ser enviadas juntamente com o pedido como metadados.

Devoluções
Tipo	Descrição
`google.api_core.operation.Operation`	Um objeto que representa uma operação de longa duração. O tipo de resultado da operação é BatchTranslateResponse, armazenado no campo `google.longrunning.Operation.response][google.longrunning.Operation.response]` devolvido por BatchTranslateText se, pelo menos, uma frase for traduzida com êxito.

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

Cria um glossário e devolve a operação de longa duração. Devolve NOT_FOUND se o projeto não existir.

# 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
Nome	Descrição
`request`	`Union[google.cloud.translate_v3.types.CreateGlossaryRequest, dict]` O objeto de pedido. Mensagem de pedido para CreateGlossary.
`parent`	`str` Obrigatório. O nome do projeto. Corresponde ao campo `parent` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`glossary`	`google.cloud.translate_v3.types.Glossary` Obrigatório. O glossário a criar. Corresponde ao campo `glossary` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`retry`	`google.api_core.retry.Retry` Designação dos erros, se existirem, que devem ser repetidos.
`timeout`	`float` O tempo limite para este pedido.
`metadata`	`Sequence[Tuple[str, str]]` Strings que devem ser enviadas juntamente com o pedido como metadados.

Devoluções
Tipo	Descrição
`google.api_core.operation.Operation`	Um objeto que representa uma operação de longa duração. O tipo de resultado da operação é Glossary. Representa um glossário criado a partir de dados fornecidos pelos utilizadores.

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 um glossário ou cancela a construção do glossário se este ainda não tiver sido criado. Devolve NOT_FOUND se o glossário não existir.

# 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
Nome	Descrição
`request`	`Union[google.cloud.translate_v3.types.DeleteGlossaryRequest, dict]` O objeto de pedido. Mensagem de pedido para DeleteGlossary.
`name`	`str` Obrigatório. O nome do glossário a eliminar. Corresponde ao campo `name` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`retry`	`google.api_core.retry.Retry` Designação dos erros, se existirem, que devem ser repetidos.
`timeout`	`float` O tempo limite para este pedido.
`metadata`	`Sequence[Tuple[str, str]]` Strings que devem ser enviadas juntamente com o pedido como metadados.

Devoluções
Tipo	Descrição
`google.api_core.operation.Operation`	Um objeto que representa uma operação de longa duração. O tipo de resultado da operação será DeleteGlossaryResponse armazenado no campo `google.longrunning.Operation.response][google.longrunning.Operation.response]` devolvido 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

Deteta o idioma do texto num pedido.

# 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
Nome	Descrição
`request`	`Union[google.cloud.translate_v3.types.DetectLanguageRequest, dict]` O objeto de pedido. A mensagem de pedido para a deteção de idioma.
`parent`	`str` Obrigatório. Projeto ou localização para fazer uma chamada. Tem de referir-se ao projeto de um autor da chamada. Formato: `projects/{project-number-or-id}/locations/{location-id}` ou `projects/{project-number-or-id}`. Para chamadas globais, use `projects/{project-number-or-id}/locations/global` ou `projects/{project-number-or-id}`. Só é possível usar modelos na mesma região (com o mesmo location-id). Caso contrário, é devolvido um erro INVALID_ARGUMENT (400). Corresponde ao campo `parent` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`model`	`str` Opcional. O modelo de deteção de idioma a usar. Formato: `projects/{project-number-or-id}/locations/{location-id}/models/language-detection/{model-id}` atualmente, apenas é suportado um modelo de deteção de idioma: `projects/{project-number-or-id}/locations/{location-id}/models/language-detection/default`. Se não for especificado, é usado o modelo predefinido. Corresponde ao campo `model` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`mime_type`	`str` Opcional. O formato do texto de origem, por exemplo, "text/html" ou "text/plain". Se for deixado em branco, o tipo MIME usa como predefinição "text/html". Corresponde ao campo `mime_type` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`content`	`str` O conteúdo da entrada armazenado como uma string. Corresponde ao campo `content` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`retry`	`google.api_core.retry.Retry` Designação dos erros, se existirem, que devem ser repetidos.
`timeout`	`float` O tempo limite para este pedido.
`metadata`	`Sequence[Tuple[str, str]]` Strings que devem ser enviadas juntamente com o pedido como metadados.

Parâmetro
Nome	Descrição
`filename`	`str` O caminho para o ficheiro JSON da chave privada da conta de serviço.

Devoluções
Tipo	Descrição
`TranslationServiceClient`	O cliente construído.

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

Aceder a um glossário. Devolve NOT_FOUND se o glossário não existir.

# 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
Nome	Descrição
`request`	`Union[google.cloud.translate_v3.types.GetGlossaryRequest, dict]` O objeto de pedido. Mensagem de pedido para GetGlossary.
`name`	`str` Obrigatório. O nome do glossário a obter. Corresponde ao campo `name` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`retry`	`google.api_core.retry.Retry` Designação dos erros, se existirem, que devem ser repetidos.
`timeout`	`float` O tempo limite para este pedido.
`metadata`	`Sequence[Tuple[str, str]]` Strings que devem ser enviadas juntamente com o pedido como metadados.

Exceções
Tipo	Descrição
`google.auth.exceptions.MutualTLSChannelError`	Se ocorrerem erros.

Devoluções
Tipo	Descrição
`Tuple[str, Callable[[], Tuple[bytes, bytes]]]`	devolve o ponto final da API e a origem do certificado do cliente 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

Devolve uma lista de idiomas compatíveis para tradução.

# 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
Nome	Descrição
`request`	`Union[google.cloud.translate_v3.types.GetSupportedLanguagesRequest, dict]` O objeto de pedido. A mensagem de pedido para descobrir idiomas suportados.
`parent`	`str` Obrigatório. Projeto ou localização para fazer uma chamada. Tem de referir-se ao projeto de um autor da chamada. Formato: `projects/{project-number-or-id}` ou `projects/{project-number-or-id}/locations/{location-id}`. Para chamadas globais, use `projects/{project-number-or-id}/locations/global` ou `projects/{project-number-or-id}`. É necessária uma localização não global para os modelos do AutoML. Só é possível usar modelos na mesma região (com o mesmo location-id). Caso contrário, é devolvido um erro INVALID_ARGUMENT (400). Corresponde ao campo `parent` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`model`	`str` Opcional. Obtenha os idiomas suportados deste modelo. O formato depende do tipo de modelo: - Modelos do AutoML Translation: `projects/{project-number-or-id}/locations/{location-id}/models/{model-id}` - Modelos gerais (incorporados): `projects/{project-number-or-id}/locations/{location-id}/models/general/nmt`. Devolve os idiomas suportados pelo modelo especificado. Se estiver em falta, obtemos os idiomas suportados do modelo de NMT geral da Google. Corresponde ao campo `model` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`display_language_code`	`str` Opcional. O idioma a usar para devolver nomes legíveis localizados dos idiomas suportados. Se estiver em falta, os nomes a apresentar não são devolvidos numa resposta. Corresponde ao campo `display_language_code` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`retry`	`google.api_core.retry.Retry` Designação dos erros, se existirem, que devem ser repetidos.
`timeout`	`float` O tempo limite para este pedido.
`metadata`	`Sequence[Tuple[str, str]]` Strings que devem ser enviadas juntamente com o pedido como metadados.

Devoluções
Tipo	Descrição
`google.cloud.translate_v3.types.SupportedLanguages`	A mensagem de resposta para descobrir idiomas compatíveis.

glossary_path

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

Devolve uma string de glossário totalmente qualificada.

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

Apresenta glossários num projeto. Devolve NOT_FOUND se o projeto não existir.

# 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
Nome	Descrição
`request`	`Union[google.cloud.translate_v3.types.ListGlossariesRequest, dict]` O objeto de pedido. Mensagem de pedido para ListGlossaries.
`parent`	`str` Obrigatório. O nome do projeto a partir do qual listar todos os glossários. Corresponde ao campo `parent` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`retry`	`google.api_core.retry.Retry` Designação dos erros, se existirem, que devem ser repetidos.
`timeout`	`float` O tempo limite para este pedido.
`metadata`	`Sequence[Tuple[str, str]]` Strings que devem ser enviadas juntamente com o pedido como metadados.

Devoluções
Tipo	Descrição
`google.cloud.translate_v3.services.translation_service.pagers.ListGlossariesPager`	Mensagem de resposta para ListGlossaries. A iteração sobre este objeto produz resultados e resolve automaticamente páginas adicionais.

parse_glossary_path

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

Analisa um caminho do glossário nos respetivos 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

Traduz documentos no 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
Nome	Descrição
`request`	`Union[google.cloud.translate_v3.types.TranslateDocumentRequest, dict]` O objeto de pedido. Um pedido de tradução de documentos.
`retry`	`google.api_core.retry.Retry` Designação dos erros, se existirem, que devem ser repetidos.
`timeout`	`float` O tempo limite para este pedido.
`metadata`	`Sequence[Tuple[str, str]]` Strings que devem ser enviadas juntamente com o pedido como metadados.

Devoluções
Tipo	Descrição
`google.cloud.translate_v3.types.TranslateDocumentResponse`	Uma mensagem de resposta de documento traduzido.

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

Traduz o texto introduzido e devolve o texto traduzido.

# 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
Nome	Descrição
`request`	`Union[google.cloud.translate_v3.types.TranslateTextRequest, dict]` O objeto de pedido. A mensagem de pedido para tradução síncrona.
`parent`	`str` Obrigatório. Projeto ou localização para fazer uma chamada. Tem de referir-se ao projeto de um autor da chamada. Formato: `projects/{project-number-or-id}` ou `projects/{project-number-or-id}/locations/{location-id}`. Para chamadas globais, use `projects/{project-number-or-id}/locations/global` ou `projects/{project-number-or-id}`. É necessária uma localização não global para pedidos que usem modelos do AutoML ou glossários personalizados. Os modelos e os glossários têm de estar na mesma região (ter o mesmo location-id). Caso contrário, é devolvido um erro INVALID_ARGUMENT (400). Corresponde ao campo `parent` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`target_language_code`	`str` Obrigatório. O código de idioma ISO-639 a usar para a tradução do texto de entrada, definido para um dos códigos de idioma indicados em Suporte de idiomas. Corresponde ao campo `target_language_code` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`contents`	`MutableSequence[str]` Obrigatório. O conteúdo da entrada no formato de string. Recomendamos que o conteúdo total tenha menos de 30 000 pontos de código. O comprimento máximo deste campo é de 1024 carateres. Use BatchTranslateText para texto maior. Corresponde ao campo `contents` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`model`	`str` Opcional. O `model` tipo pedido para esta tradução. O formato depende do tipo de modelo: - Modelos do AutoML Translation: `projects/{project-number-or-id}/locations/{location-id}/models/{model-id}` - Modelos gerais (integrados): `projects/{project-number-or-id}/locations/{location-id}/models/general/nmt`. Para pedidos globais (não regionalizados), use `location-id` `global`. Por exemplo, `projects/{project-number-or-id}/locations/global/models/general/nmt`. Se não for fornecido, é usado o modelo Google predefinido (NMT). Isto corresponde ao campo `model` na instância `request`. Se `request` for fornecido, isto não deve ser definido.
`mime_type`	`str` Opcional. O formato do texto de origem, por exemplo, "text/html" ou "text/plain". Se for deixado em branco, o tipo MIME usa como predefinição "text/html". Corresponde ao campo `mime_type` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`source_language_code`	`str` Opcional. O código de idioma ISO-639 do texto de entrada, se conhecido, por exemplo, "en-US" ou "sr-Latn". Os códigos de idioma suportados estão listados no artigo Suporte de idiomas. Se o idioma de origem não for especificado, a API tenta identificar o idioma de origem automaticamente e devolve o idioma de origem na resposta. Corresponde ao campo `source_language_code` na instância `request`. Se `request` for fornecido, este campo não deve ser definido.
`retry`	`google.api_core.retry.Retry` Designação dos erros, se existirem, que devem ser repetidos.
`timeout`	`float` O tempo limite para este pedido.
`metadata`	`Sequence[Tuple[str, str]]` Strings que devem ser enviadas juntamente com o pedido como metadados.