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

Fornece operações de tradução de idioma natural.

Propriedades

transport

Retorna o transporte usado pela instância do cliente.

Retorna
TipoDescrição
TranslationServiceTransportO 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
NomeDescrição
credentials Optional[google.auth.credentials.Credentials]

As credenciais de autorização a serem anexadas às solicitações. Essas credenciais identificam o aplicativo para o serviço. Se nenhuma for especificada, o cliente tentará determinar as credenciais do ambiente.

transport Union[str, TranslationServiceTransport]

O transporte a ser usado. Se definido como "None", um transporte será escolhido automaticamente.

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

Opções personalizadas para o cliente. Ele não vai entrar em vigor se uma instância transport for fornecida. (1) A propriedade api_endpoint pode ser usada para substituir o endpoint padrão fornecido pelo cliente. A variável de ambiente GOOGLE_API_USE_MTLS_ENDPOINT também pode ser usada para substituir o endpoint: "always" (sempre use o endpoint mTLS padrão), "never" (sempre use o endpoint regular padrão) e "auto" (mude automaticamente para o endpoint mTLS padrão se o certificado do cliente estiver presente, esse é o valor padrão). No entanto, a propriedade api_endpoint tem precedência se for fornecida. (2) Se a variável de ambiente GOOGLE_API_USE_CLIENT_CERTIFICATE for "true", a propriedade client_cert_source poderá ser usada para fornecer o certificado do cliente para o transporte TLS mútuo. Se não for fornecido, o certificado de cliente SSL padrão será usado, se estiver presente. Se GOOGLE_API_USE_CLIENT_CERTIFICATE for "false" ou não estiver definido, nenhum certificado de cliente será usado.

client_info google.api_core.gapic_v1.client_info.ClientInfo

As informações do cliente usadas para enviar uma string de user agent com solicitações de API. Se for None, as informações padrão serão usadas. Em geral, só é necessário definir isso se você estiver desenvolvendo sua própria biblioteca de cliente.

Exceções
TipoDescrição
google.auth.exceptions.MutualTLSChannelErrorSe a criação do transporte TLS mútuo falhar por qualquer motivo.

__exit__

__exit__(type, value, traceback)

Libera 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. Essa função fornece saída em tempo real à medida que as entradas são processadas. Se o autor da chamada cancelar uma solicitação, os resultados parciais (para um arquivo de entrada, é tudo ou nada) ainda poderão estar disponíveis no local de saída especificado. Essa chamada retorna imediatamente, e você pode usar google.longrunning.Operation.name para pesquisar o status 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
NomeDescrição
request Union[google.cloud.translate_v3.types.BatchTranslateDocumentRequest, dict]

O objeto de solicitação. A solicitação BatchTranslateDocument.

parent str

Obrigatório. Local para fazer uma chamada regional. Formato: projects/{project-number-or-id}/locations/{location-id}. O local global não é compatível com a tradução em lote. Só é possível usar modelos ou glossários do AutoML Translation na mesma região (com o mesmo location-id). Caso contrário, um erro INVALID_ARGUMENT (400) será retornado. Isso corresponde ao campo parent na instância request. Se request for fornecido, esse campo não poderá 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 aceitos estão listados em Language Support https://cloud.google.com/translate/docs/languages__. Isso corresponde ao campo source_language_code na instância request. Se request for fornecido, esse campo não poderá ser definido.

target_language_codes MutableSequence[str]

Obrigatório. O código de idioma ISO-639 a ser usado para tradução do documento de entrada. Especifique até 10 códigos de idioma aqui. Isso corresponde ao campo target_language_codes na instância request. Se request for fornecido, esse campo não poderá ser definido.

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

Obrigatório. Configurações de entrada. O número total de arquivos correspondentes precisa ser menor ou igual a 100. O tamanho total do conteúdo a ser traduzido precisa ter no máximo 100 milhões de pontos de código Unicode. Os arquivos precisam usar a codificação UTF-8. Isso corresponde ao campo input_configs na instância request. Se request for fornecido, esse campo não poderá ser definido.

output_config google.cloud.translate_v3.types.BatchDocumentOutputConfig

Obrigatório. Configuração de saída. Se duas configurações de entrada corresponderem ao mesmo arquivo (ou seja, mesmo caminho de entrada), não vamos gerar saída para entradas duplicadas. Isso corresponde ao campo output_config na instância request. Se request for fornecido, esse campo não poderá ser definido.

retry google.api_core.retry.Retry

Designação de quais erros, se houver, devem ser repetidos.

timeout float

O tempo limite desta solicitação.

metadata Sequence[Tuple[str, str]]

Strings que precisam ser enviadas com a solicitação como metadados.

Retorna
TipoDescrição
google.api_core.operation.OperationUm objeto que representa uma operação de longa duração. O tipo de resultado da operação será BatchTranslateDocumentResponse armazenado no campo google.longrunning.Operation.response][google.longrunning.Operation.response] retornado por BatchTranslateDocument se pelo menos um documento for traduzido com sucesso.

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. Essa função fornece saída em tempo real à medida que as entradas são processadas. Se o autor da chamada cancelar uma solicitação, os resultados parciais (para um arquivo de entrada, é tudo ou nada) ainda poderão estar disponíveis no local de saída especificado. Essa chamada retorna imediatamente, e você pode usar google.longrunning.Operation.name para pesquisar o status 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
NomeDescrição
request Union[google.cloud.translate_v3.types.BatchTranslateTextRequest, dict]

O objeto de solicitação. A solicitação de tradução em lote.

retry google.api_core.retry.Retry

Designação de quais erros, se houver, devem ser repetidos.

timeout float

O tempo limite desta solicitação.

metadata Sequence[Tuple[str, str]]

Strings que precisam ser enviadas com a solicitação como metadados.

Retorna
TipoDescrição
google.api_core.operation.OperationUm objeto que representa uma operação de longa duração. O tipo de resultado da operação será BatchTranslateResponse, armazenado no campo google.longrunning.Operation.response][google.longrunning.Operation.response] retornado por BatchTranslateText se pelo menos uma frase for traduzida com sucesso.

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 retorna a operação de longa duração. Retorna 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
NomeDescrição
request Union[google.cloud.translate_v3.types.CreateGlossaryRequest, dict]

O objeto de solicitação. Mensagem de solicitação para "CreateGlossary".

parent str

Obrigatório. O nome do projeto. Isso corresponde ao campo parent na instância request. Se request for fornecido, esse campo não poderá ser definido.

glossary google.cloud.translate_v3.types.Glossary

Obrigatório. O glossário a ser criado. Isso corresponde ao campo glossary na instância request. Se request for fornecido, esse campo não poderá ser definido.

retry google.api_core.retry.Retry

Designação de quais erros, se houver, devem ser repetidos.

timeout float

O tempo limite desta solicitação.

metadata Sequence[Tuple[str, str]]

Strings que precisam ser enviadas com a solicitação como metadados.

Retorna
TipoDescrição
google.api_core.operation.OperationUm objeto que representa uma operação de longa duração. O tipo de resultado da operação será Glossary, que representa um glossário criado com dados fornecidos pelo usuário.

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

Exclui um glossário ou cancela a construção dele se ainda não tiver sido criado. Retorna 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
NomeDescrição
request Union[google.cloud.translate_v3.types.DeleteGlossaryRequest, dict]

O objeto de solicitação. Mensagem de solicitação para DeleteGlossary.

name str

Obrigatório. O nome do glossário a ser excluído. Isso corresponde ao campo name na instância request. Se request for fornecido, esse campo não poderá ser definido.

retry google.api_core.retry.Retry

Designação de quais erros, se houver, devem ser repetidos.

timeout float

O tempo limite desta solicitação.

metadata Sequence[Tuple[str, str]]

Strings que precisam ser enviadas com a solicitação como metadados.

Retorna
TipoDescrição
google.api_core.operation.OperationUm 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] retornado 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 o idioma do texto em uma solicitaçã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_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
NomeDescrição
request Union[google.cloud.translate_v3.types.DetectLanguageRequest, dict]

O objeto de solicitação. A mensagem de solicitação para detecção do idioma.

parent str

Obrigatório. Projeto ou local para fazer uma chamada. Precisa se referir 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, um erro INVALID_ARGUMENT (400) será retornado. Isso corresponde ao campo parent na instância request. Se request for fornecido, esse campo não poderá ser definido.

model str

Opcional. O modelo de detecção de idioma a ser usado. Formato: projects/{project-number-or-id}/locations/{location-id}/models/language-detection/{model-id} No momento, só há suporte para um modelo de detecção de idioma: projects/{project-number-or-id}/locations/{location-id}/models/language-detection/default. Se não for especificado, o modelo padrão será usado. Isso corresponde ao campo model na instância request. Se request for fornecido, esse campo não poderá ser definido.

mime_type str

Opcional. O formato do texto de origem, por exemplo, "text/html", "text/plain". Se for deixado em branco, o tipo MIME será "text/html" por padrão. Isso corresponde ao campo mime_type na instância request. Se request for fornecido, esse campo não poderá ser definido.

content str

O conteúdo da entrada armazenado como uma string. Isso corresponde ao campo content na instância request. Se request for fornecido, esse campo não poderá ser definido.

retry google.api_core.retry.Retry

Designação de quais erros, se houver, devem ser repetidos.

timeout float

O tempo limite desta solicitação.

metadata Sequence[Tuple[str, str]]

Strings que precisam ser enviadas com a solicitação como metadados.

Parâmetro
NomeDescrição
filename str

O caminho para o arquivo JSON da chave privada da conta de serviço.

Retorna
TipoDescrição
TranslationServiceClientO 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

Recebe um glossário. Retorna 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
NomeDescrição
request Union[google.cloud.translate_v3.types.GetGlossaryRequest, dict]

O objeto de solicitação. Mensagem de solicitação para GetGlossary.

name str

Obrigatório. O nome do glossário a ser recuperado. Isso corresponde ao campo name na instância request. Se request for fornecido, esse campo não poderá ser definido.

retry google.api_core.retry.Retry

Designação de quais erros, se houver, devem ser repetidos.

timeout float

O tempo limite desta solicitação.

metadata Sequence[Tuple[str, str]]

Strings que precisam ser enviadas com a solicitação como metadados.

Exceções
TipoDescrição
google.auth.exceptions.MutualTLSChannelErrorSe ocorrerem erros.
Retorna
TipoDescrição
Tuple[str, Callable[[], Tuple[bytes, bytes]]]retorna o endpoint de API e a origem do certificado do cliente a serem usados.

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

Retorna uma lista de idiomas aceitos 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
NomeDescrição
request Union[google.cloud.translate_v3.types.GetSupportedLanguagesRequest, dict]

O objeto de solicitação. A mensagem de solicitação para descobrir idiomas aceitos.

parent str

Obrigatório. Projeto ou local para fazer uma chamada. Precisa se referir 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}. Um local não global é necessário para modelos do AutoML. Só é possível usar modelos na mesma região (com o mesmo location-id). Caso contrário, um erro INVALID_ARGUMENT (400) será retornado. Isso corresponde ao campo parent na instância request. Se request for fornecido, esse campo não poderá ser definido.

model str

Opcional. Recebe os idiomas compatíveis com este 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 (integrados): projects/{project-number-or-id}/locations/{location-id}/models/general/nmt. Retorna os idiomas compatíveis com o modelo especificado. Se estiver faltando, vamos receber os idiomas aceitos pelo modelo NMT geral do Google. Isso corresponde ao campo model na instância request. Se request for fornecido, esse campo não poderá ser definido.

display_language_code str

Opcional. O idioma a ser usado para retornar nomes localizados e legíveis de idiomas aceitos. Se estiver ausente, os nomes de exibição não serão retornados em uma resposta. Isso corresponde ao campo display_language_code na instância request. Se request for fornecido, esse campo não poderá ser definido.

retry google.api_core.retry.Retry

Designação de quais erros, se houver, devem ser repetidos.

timeout float

O tempo limite desta solicitação.

metadata Sequence[Tuple[str, str]]

Strings que precisam ser enviadas com a solicitação como metadados.

Retorna
TipoDescrição
google.cloud.translate_v3.types.SupportedLanguagesA mensagem de resposta para descobrir idiomas aceitos.

glossary_path

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

Retorna 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

Lista os glossários em um projeto. Retorna 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
NomeDescrição
request Union[google.cloud.translate_v3.types.ListGlossariesRequest, dict]

O objeto de solicitação. Mensagem de solicitação para ListGlossaries.

parent str

Obrigatório. O nome do projeto em que todos os glossários serão listados. Isso corresponde ao campo parent na instância request. Se request for fornecido, esse campo não poderá ser definido.

retry google.api_core.retry.Retry

Designação de quais erros, se houver, devem ser repetidos.

timeout float

O tempo limite desta solicitação.

metadata Sequence[Tuple[str, str]]

Strings que precisam ser enviadas com a solicitação como metadados.

Retorna
TipoDescrição
google.cloud.translate_v3.services.translation_service.pagers.ListGlossariesPagerMensagem de resposta para "ListGlossaries". A iteração nesse objeto vai gerar resultados e resolver outras páginas automaticamente.

parse_glossary_path

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

Analisa um caminho de glossário nos segmentos de componentes dele.

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
NomeDescrição
request Union[google.cloud.translate_v3.types.TranslateDocumentRequest, dict]

O objeto de solicitação. Uma solicitação de tradução de documento.

retry google.api_core.retry.Retry

Designação de quais erros, se houver, devem ser repetidos.

timeout float

O tempo limite desta solicitação.

metadata Sequence[Tuple[str, str]]

Strings que precisam ser enviadas com a solicitação como metadados.

Retorna
TipoDescrição
google.cloud.translate_v3.types.TranslateDocumentResponseUma 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 de entrada e retorna 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
NomeDescrição
request Union[google.cloud.translate_v3.types.TranslateTextRequest, dict]

O objeto de solicitação. A mensagem de solicitação para tradução síncrona.

parent str

Obrigatório. Projeto ou local para fazer uma chamada. Precisa se referir 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}. Um local não global é necessário para solicitações que usam modelos do AutoML ou glossários personalizados. Os modelos e glossários precisam estar na mesma região (ter o mesmo location-id). Caso contrário, um erro INVALID_ARGUMENT (400) será retornado. Isso corresponde ao campo parent na instância request. Se request for fornecido, esse campo não poderá ser definido.

target_language_code str

Obrigatório. O código de idioma ISO-639 a ser usado para tradução do texto de entrada, definido como um dos códigos de idioma listados em "Suporte a idiomas". Isso corresponde ao campo target_language_code na instância request. Se request for fornecido, esse campo não poderá ser definido.

contents MutableSequence[str]

Obrigatório. O conteúdo da entrada em formato de string. Recomendamos que o conteúdo total tenha menos de 30.000 pontos de código. O tamanho máximo desse campo é 1024. Use BatchTranslateText para textos maiores. Isso corresponde ao campo contents na instância request. Se request for fornecido, esse campo não poderá ser definido.

model str

Opcional. O tipo model solicitado 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 solicitações globais (não regionalizadas), use location-id global. Por exemplo, projects/{project-number-or-id}/locations/global/models/general/nmt. Se não for fornecido, o modelo padrão do Google (NMT) será usado. Isso corresponde ao campo model na instância request. Se request for fornecido, esse campo não poderá ser definido.

mime_type str

Opcional. O formato do texto de origem, por exemplo, "text/html", "text/plain". Se for deixado em branco, o tipo MIME será "text/html" por padrão. Isso corresponde ao campo mime_type na instância request. Se request for fornecido, esse campo não poderá 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 aceitos estão listados em "Suporte a idiomas". Se o idioma de origem não for especificado, a API tentará identificá-lo automaticamente e o retornará na resposta. Isso corresponde ao campo source_language_code na instância request. Se request for fornecido, esse campo não poderá ser definido.

retry google.api_core.retry.Retry

Designação de quais erros, se houver, devem ser repetidos.

timeout float

O tempo limite desta solicitação.

metadata Sequence[Tuple[str, str]]

Strings que precisam ser enviadas com a solicitação como metadados.