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
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 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
TipoDescrição
google.auth.exceptions.MutualTLSChannelErrorSe 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
NomeDescriçã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
TipoDescrição
google.api_core.operation.OperationUm 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
NomeDescriçã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
TipoDescrição
google.api_core.operation.OperationUm 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
NomeDescriçã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
TipoDescrição
google.api_core.operation.OperationUm 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
NomeDescriçã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
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] 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
NomeDescriçã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
NomeDescrição
filename str

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

Devoluções
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

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
NomeDescriçã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
TipoDescrição
google.auth.exceptions.MutualTLSChannelErrorSe ocorrerem erros.
Devoluções
TipoDescriçã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
NomeDescriçã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
TipoDescrição
google.cloud.translate_v3.types.SupportedLanguagesA 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
NomeDescriçã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
TipoDescrição
google.cloud.translate_v3.services.translation_service.pagers.ListGlossariesPagerMensagem 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
NomeDescriçã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
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 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
NomeDescriçã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.